Skip to main content

Service AutoDiscovery

The Service AutoDiscovery will create a 'ScheduledScanwith the given parameters (see [readme](https://github.com/secureCodeBox/secureCodeBox/blob/main/auto-discovery/kubernetes/README.md) for config options) for each KubernetesService` it detects.

The Service AutoDiscovery will ignore services where the underlying pods do not serve http(s). It does this by checking for open ports 80, 443, 3000, 5000, 8000, 8443, 8080. It is also sufficient to name the ports http or https when a different port is used than the ports specified above. Services without a matching port number or name are currently ignored.

By default the Service AutoDiscovery creates ZAP Advanced for each service. These scans are relatively generic and don't include any configuration regarding authentication / authorization. As the setup and configuration of the ZAP-Advanced Chart is located in each namespace it is possible to tweak the default configuration to support authenticated and more highly configured scans. For guides on how to configure ZAP Advanced refer to the ZAP Advanced Documentation.

Setup

By default the Service AutoDiscovery creates ScheduledScans using the ZAP Advanced ScanType. It has to be installed in the same namespace as the containers that you wish to scan. The following steps will install zap-advanced in the default namespace:

helm upgrade --install zap-advanced secureCodeBox/zap-advanced

Deactivation

The Service AutoDiscovery is enabled by default but can be disabled manually.

helm upgrade --namespace securecodebox-system --install auto-discovery-kubernetes secureCodeBox/auto-discovery-kubernetes --set config.serviceAutoDiscovery.enabled=false