Skip to content

Commit 98cbd69

Browse files
devGregAclaude
andauthored
docs(connectors): runZero asset connector reference (#15287)
Document the runZero asset / attack-surface connector: prerequisites (XT Export Token, community tier), the Location/Secret/Import-Vulnerabilities/ Minimum-Severity mappings, the whole-org asset -> Record model (site becomes Product Type), and the optional vulnerability -> finding import. Companion to connectors#732 and dojo-pro#1939. sc-13774 Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 parent ffc8c90 commit 98cbd69

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
@@ -846,6 +846,25 @@ Network access from DefectDojo to your Security Console, and a console **user ac
846846

847847
Each InsightVM site becomes a Record; the connector walks the site's assets and imports their vulnerable findings.
848848

849+
## **runZero**
850+
851+
The runZero connector uses the runZero Export API to sync your whole organization's asset inventory into DefectDojo. It is primarily an **asset** connector: DefectDojo discovers every asset and creates a Record for each, grouped into a Product Type by its runZero **site**. It can optionally also import runZero's vulnerabilities as findings.
852+
853+
#### Prerequisites
854+
855+
You will need an organization **Export Token** from runZero (Account → API), which is prefixed `XT`. The token is organization-scoped (the organization is encoded in the token), read-only, and is sent as a Bearer token — it is never logged. A community/starter tier is available.
856+
857+
#### Connector Mappings
858+
859+
1. Enter your runZero console URL in the **Location** field, for example `https://console.runzero.com`. The URL must be HTTPS.
860+
2. Enter the Export Token in the **Secret** field.
861+
3. Optionally set **Import Vulnerabilities** to `true` to also import runZero vulnerabilities as findings; leave it blank to sync assets only.
862+
4. Optionally, set a **Minimum Severity** to limit which vulnerability findings are imported (applies only when vulnerabilities are imported).
863+
864+
DefectDojo maps each runZero **asset** to a Record (VEP): the display name comes from the asset's name or address, and its site, type, OS, addresses and tags are attached as attributes; the asset's **site** becomes its Product Type. Assets are synced with a full export that DefectDojo reconciles (adds/removes). When **Import Vulnerabilities** is enabled, each runZero vulnerability becomes a finding on its asset — mapping the severity, CVSS score, CVE, affected service (`protocol://address:port`) endpoint and the remediation.
865+
866+
See the [runZero API documentation](https://help.runzero.com/) for more information.
867+
849868
## **Semgrep**
850869

851870
This connector uses the Semgrep REST API to fetch data.

0 commit comments

Comments
 (0)