Skip to content

Commit 624cb8d

Browse files
devGregAclaude
andauthored
docs(connectors): Deepfence ThreatMapper connector reference (#15337)
Document the Deepfence ThreatMapper connector: the console API-token prerequisite, the Location/Secret/Skip-TLS/Minimum-Severity mappings, and the whole-console node -> Record + CVE -> finding model (dynamic findings, dedupe key). Companion to connectors#755 and dojo-pro#2005. sc-13884 Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 45717fa commit 624cb8d

1 file changed

Lines changed: 19 additions & 0 deletions

File tree

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

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -413,6 +413,25 @@ A Falcon **API client** (Client ID and secret), created in the Falcon console un
413413

414414
Each Falcon host becomes a Record, named for its hostname, OS, and type. Only **open** and **reopened** Spotlight vulnerabilities are imported, so reimport closes remediated findings.
415415

416+
## **Deepfence ThreatMapper**
417+
418+
The Deepfence ThreatMapper connector uses the [ThreatMapper](https://github.com/deepfence/ThreatMapper) management-console REST API to import **vulnerability scan** results. DefectDojo discovers every node ThreatMapper has scanned — a container image, host, or container — and creates a Record for each, then imports that node's most recent completed scan as findings.
419+
420+
#### Prerequisites
421+
422+
You will need a ThreatMapper **API token**, found in the console under **Settings → User Management** (your user's API key). The connector exchanges it for a short-lived access token on each sync; the API token is never logged.
423+
424+
#### Connector Mappings
425+
426+
1. Enter your ThreatMapper console URL in the **Location** field (for example `https://threatmapper.example.com`).
427+
2. In the **Secret** field, enter the ThreatMapper API token.
428+
3. If your console uses a self-signed certificate, set **Skip TLS Verification** to `true`.
429+
4. Optionally, set a **Minimum Severity** to limit which findings are imported.
430+
431+
DefectDojo maps each scanned **node** to a Record and each **CVE** in its latest completed vulnerability scan to a finding. The severity comes from ThreatMapper's own rating, and the affected package, CVSS score, fix version (as mitigation), reference links, and a details block are carried over. Findings are recorded as dynamic findings and de-duplicated on the node, CVE, package and package path.
432+
433+
See the [ThreatMapper documentation](https://community.deepfence.io/threatmapper/docs/v2.5/) for more information.
434+
416435
## Dependency\-Track
417436

418437
This connector fetches data from a on\-premise Dependency\-Track instance, via REST API.

0 commit comments

Comments
 (0)