You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/content/import_data/pro/connectors/connectors_tool_reference.md
+33Lines changed: 33 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -281,6 +281,22 @@ You will need a Cloudflare **API token** (not the legacy Global API Key). Create
281
281
282
282
DefectDojo auto-discovers the accounts and zones the token can access — no account ID is required. Only open (active, non-dismissed) insights are imported, so insights you resolve or dismiss in Cloudflare are automatically mitigated in DefectDojo on the next sync.
283
283
284
+
## **Cobalt.io**
285
+
286
+
The Cobalt.io connector uses the Cobalt.io API (v2) to pull pentest findings from your Cobalt.io organization. DefectDojo discovers every organization your API token can access and creates a separate Record for each **asset** (the unit Cobalt pentests).
287
+
288
+
#### Prerequisites
289
+
290
+
You will need a Cobalt.io **personal API token**. We recommend creating a dedicated service account for DefectDojo to clearly distinguish automated activity from manual team actions. Generate a token from **Settings \> API Tokens** in the Cobalt.io UI. Organization tokens are discovered automatically \- you do not need to supply them.
291
+
292
+
#### Connector Mappings
293
+
294
+
1. Enter the Cobalt.io API base URL in the **Location** field: `https://api.cobalt.io`(or your regional host, for example `https://api.us.cobalt.io`).
295
+
2. Enter your **personal API token** in the **Secret** field.
296
+
3. Optionally, enter an **Organization Token** to pin the sync to a single organization. When left blank, DefectDojo syncs every organization the personal API token can access.
297
+
298
+
DefectDojo maps each Cobalt.io **asset** as a separate Record. Findings are imported for each mapped asset, with their Cobalt.io state (for example `valid_fix`, `wont_fix`, `invalid`) driving the finding status in DefectDojo.
299
+
284
300
## **Contrast**
285
301
286
302
The Contrast connector uses the Contrast Assess REST API to import application vulnerabilities. DefectDojo discovers the applications in your Contrast organization and creates a Record for each one.
@@ -658,6 +674,23 @@ Unlike the device\-based Microsoft Defender connector, no API permissions or adm
658
674
659
675
Each enabled Azure subscription becomes a Record. Findings are read through Azure Resource Graph, so they surface promptly once Defender for Cloud has scanned your resources — but the scans themselves run on Microsoft's schedule: container\-registry images are usually scanned within an hour of being pushed, while a VM's first agentless vulnerability scan can take several hours. A newly enabled subscription will legitimately Sync zero findings until its resources have been scanned.
660
676
677
+
## **Nuclei (ProjectDiscovery Cloud)**
678
+
679
+
The Nuclei connector uses the ProjectDiscovery Cloud Platform (PDCP) REST API to pull [nuclei](https://github.com/projectdiscovery/nuclei) scan results from your PDCP account. DefectDojo discovers every scan in the account and creates a separate Record for each **scan**.
680
+
681
+
#### Prerequisites
682
+
683
+
You will need a ProjectDiscovery Cloud **API key**. We recommend creating a dedicated service account for DefectDojo to clearly distinguish automated activity from manual team actions. Generate a key from **Settings \> API Key** in the ProjectDiscovery Cloud UI ([cloud.projectdiscovery.io](https://cloud.projectdiscovery.io)). Results reach PDCP either from hosted scans or from the nuclei CLI run with `-dashboard`.
684
+
685
+
#### Connector Mappings
686
+
687
+
1. Enter the PDCP API base URL in the **Location** field: `https://api.projectdiscovery.io`.
688
+
2. Enter your **API key** in the **Secret** field.
689
+
3. Optionally, enter a **Team ID** to scope the sync to a team workspace (found under **Settings \> Team**). When left blank, DefectDojo syncs your personal workspace.
690
+
4. Optionally, set a **Minimum Severity** to limit which findings are imported.
691
+
692
+
DefectDojo maps each PDCP **scan** as a separate Record and imports that scan's findings across every severity, including informational.
693
+
661
694
## **OpenVAS / Greenbone**
662
695
663
696
The OpenVAS / Greenbone connector imports **network vulnerability findings** from a Greenbone (Greenbone Community Edition or Greenbone Enterprise) instance. It talks to `gvmd` over **GMP (Greenbone Management Protocol)** — an XML protocol over a TLS socket, not HTTP — and syncs the whole instance: it enumerates scan **tasks** and creates a DefectDojo product for each, importing the results of each task's latest report.
0 commit comments