Skip to content

Commit cac35fe

Browse files
authored
docs(connectors): add Kubescape connector reference (#15283)
Document the new Kubescape connector on the Pro connectors reference: it reads the Kubescape operator's in-cluster posture results (WorkloadConfigurationScan objects, spdx.softwarecomposition.kubescape.io) via the Kubernetes API — no ARMO SaaS account required — mapping each namespace to a Product and each failed control to a Finding. Adds it to the tool reference and the supported-connectors list. Story: sc-13764
1 parent a8895a1 commit cac35fe

2 files changed

Lines changed: 18 additions & 0 deletions

File tree

docs/content/import_data/pro/connectors/about_connectors.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,7 @@ We currently support Connectors for the following tools, with more on the way:
3636
* **Group-IB ASM**
3737
* **IriusRisk**
3838
* **JFrog Xray**
39+
* **Kubescape** (Kubernetes posture: reads the Kubescape operator's in-cluster results)
3940
* **Probely**
4041
* **Semgrep**
4142
* **SonarQube**

docs/content/import_data/pro/connectors/connectors_tool_reference.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -634,6 +634,23 @@ The JSM Assets connector is an **Asset Connector**: it enumerates the objects in
634634

635635
Each Assets object becomes a Record named after the object's label, grouped by its **object schema**.
636636

637+
## **Kubescape**
638+
639+
The Kubescape connector reads Kubernetes posture (misconfiguration) results produced by the [Kubescape operator](https://kubescape.io/docs/install-operator/) directly from the cluster's Kubernetes API — no ARMO SaaS account is required. It reads the `WorkloadConfigurationScan` objects served by the operator's in-cluster storage aggregated API (`spdx.softwarecomposition.kubescape.io/v1beta1`). Each Kubernetes **namespace** that has posture results is mapped to a Record (Product); each failed control on a workload becomes a Finding.
640+
641+
#### Prerequisites
642+
643+
- The Kubescape operator must be installed in the target cluster with configuration scanning enabled (see [Installing in your cluster](https://kubescape.io/docs/install-operator/)). Confirm results exist with `kubectl get workloadconfigurationscans -A`.
644+
- A **kubeconfig** granting read access to the `spdx.softwarecomposition.kubescape.io` API group (list/get on `workloadconfigurationscans`) for the target cluster.
645+
646+
#### Connector Mappings
647+
648+
1. Enter the cluster's API server URL (or a friendly cluster identifier) in the **Location** field.
649+
2. Paste the **kubeconfig** for the target cluster in the `kubeconfig` field. Optionally set `kube_context` to select a context within it, and `cluster_name` to label the discovered Products.
650+
3. Each namespace with posture results is discovered as a Record; map the ones you want to import to DefectDojo Products.
651+
652+
Findings are derived per failed control: the control name and workload identify the Finding, severity comes from the control's score factor, the control ID becomes the vulnerability ID, and each Finding links to its control reference at `https://hub.armosec.io/docs/`.
653+
637654
## **Microsoft Defender**
638655

639656
The Microsoft Defender connector imports device vulnerability findings from **Microsoft Defender Vulnerability Management (MDVM)** — one finding per device / software version / CVE combination, including severity, CVSS score, exploitability level and recommended security updates. DefectDojo will discover your Defender **device groups** and create a Record for each one; devices that aren't assigned to any device group are collected under a synthetic **Unassigned** group.

0 commit comments

Comments
 (0)