Wiz (Pro)

The Wiz connector imports Issues and vulnerability findings. DefectDojo creates a Record for each Wiz Project, plus a tenant-level Record named after the tenant itself, for example Wiz Tenant abc12, that covers the entire Wiz tenant.

You do not need Wiz Projects to use this connector. If your tenant has no Projects, map the that tenant-level Record Record and DefectDojo imports every Issue and vulnerability finding your service account can see. That Record also picks up findings on resources that no Project covers, so map it alongside your Project Records if your Projects do not cover everything. Mapping both a Project Record and the that tenant-level Record Record imports that Project’s findings into two Assets, so only do that if you want both views.

Using the Wiz connector requires you to create a service account: see the Wiz documentation for more info. You will need a Wiz account to access the documentation.

The service account must meet all of the following requirements. A service account that misses one of them can still authenticate successfully but will import nothing:

  • Type: Custom Integration (GraphQL API).
  • API scopes: at minimum read:projects, read:issues, and read:vulnerabilities. read:projects is required even on a tenant with no Projects, because Discover still asks Wiz for the Project list.
  • Project visibility: the service account must be scoped to every Wiz Project you want imported (or to all Projects). An account that can read issues but has no Project visibility discovers no Project Records, and only the that tenant-level Record Record is available.

Connector Mappings

  1. Enter your Wiz Client ID in the Client ID field.
  2. Enter the Wiz Client Secret in the Secret field.
  3. Choose which data classes to import in Import Finding Types. Both are selected by default.

Import Finding Types

Wiz serves two different data classes, and the connector imports both by default:

  • Issues: a Wiz Control fired on a resource. These are policy and posture violations. A typical tenant has hundreds or thousands.
  • Vulnerability Findings: one CVE on one package on one asset. A tenant with a few thousand assets can hold millions. Each asset carries many packages, and each package can carry many CVEs.

If your DefectDojo finding count is far higher than your asset count, Vulnerability Findings are the reason. That is expected: a finding is one problem on one asset, not one asset.

Deselect Vulnerability Findings to import Issues only. The connector then skips the vulnerability query entirely, so nothing is fetched from Wiz rather than fetched and discarded.

Two things to know before you change this setting:

  • Changing it triggers one full resync. The connector normally asks Wiz only for what changed since the last sync. That cursor is cleared when you change the selection, so the next sync re-reads everything. Without the reset, re-enabling a data class never backfills the rows it skipped while it was off.
  • Deselecting a data class closes its existing findings. The next sync sends none of that class, and DefectDojo closes what it no longer receives. Suppose you turn off Vulnerability Findings on a connector that already imported a million of them. That sync closes all one million.

Minimum Severity is a separate control and cannot be changed after the connector is created.