Wiz Scanner Parser | DefectDojo Documentation

Wiz Scanner Parser

The Wiz parser for DefectDojo supports imports from both Wiz Scanner Standard and SCA (Software Composition Analysis) .csv output from Wiz.io. This document details the parsing of both formats into DefectDojo field mappings, unmapped fields, and location of each field’s parsing code for easier troubleshooting and analysis.

⚠️ DefectDojo Pro Users can also automatically create Findings directly from Wiz using the Wiz Connector. See our Connectors documentation for more details.

Supported File Types

The Wiz parser accepts CSV file format. There are two primary formats supported:

  1. Standard Format - Issues exports with “Title” field (processed by WizParserByTitle class)
  2. SCA Format - Vulnerability exports with “Name” and “DetailedName” fields (processed by WizParserByDetailedName class)

To generate these files, export the findings from the Wiz platform by:

Sample Scan Data

Sample Wiz Scanner scans can be found in the sample scan data folder.

Default Deduplication Hashcode Fields

By default, DefectDojo identifies duplicate Findings using these hashcode fields:

Mapped Fields Dictionary

Standard Format CSV

This format applies the WizParserByTitle parser class.

Total Fields in Standard Format CSV

Standard Format Field Mapping Details

CSV Field Finding Field Parser Line # Notes
Created At date 68 Parsed using the parse_wiz_datetime function to convert to datetime object
Title title 67 Direct mapping to Finding title
Severity severity 69 Converted to lowercase then capitalized to match DefectDojo’s severity format
Status active, is_mitigated, mitigated 65 Converted through WizcliParsers.convert_status function to determine active status and mitigation status
Description description (partial) 79-81 Added to description with “Description:” prefix
Resource Type description (partial) 79-81 Added to description with “Resource Type:” prefix
Resource external ID description (partial) 79-81 Added to description with “Resource external ID:” prefix
Subscription ID description (partial) 79-81 Added to description with “Subscription ID:” prefix
Project IDs description (partial) 79-81 Added to description with “Project IDs:” prefix
Project Names description (partial) 79-81 Added to description with “Project Names:” prefix
Resolved Time mitigated 71-74 Used to set mitigated timestamp if finding is marked as mitigated
Resolution mitigation (partial) 62-63 Added to mitigation text with “Resolution:” prefix
Control ID description (partial) 79-81 Added to description with “Control ID:” prefix
Resource Name description (partial) 79-81 Added to description with “Resource Name:” prefix
Resource Region description (partial) 79-81 Added to description with “Resource Region:” prefix
Resource Status description (partial) 79-81 Added to description with “Resource Status:” prefix
Resource Platform description (partial) 79-81 Added to description with “Resource Platform:” prefix
Resource OS description (partial) 79-81 Added to description with “Resource OS:” prefix
Resource original JSON description (partial) 79-81 Added to description with “Resource original JSON:” prefix
Issue ID unique_id_from_tool 85 Used as unique identifier for the finding
Resource vertex ID description (partial) 79-81 Added to description with “Resource vertex ID:” prefix
Ticket URLs description (partial) 79-81 Added to description with “Ticket URLs:” prefix
Note description (partial) 79-81 Added to description with “Note:” prefix
Due At description (partial) 79-81 Added to description with “Due At:” prefix
Remediation Recommendation mitigation 61 Direct mapping to mitigation field
Subscription Name description (partial) 79-81 Added to description with “Subscription Name:” prefix
Wiz URL description (partial) 79-81 Added to description with “Wiz URL:” prefix
Cloud Provider URL description (partial) 79-81 Added to description with “Cloud Provider URL:” prefix
Resource Tags description (partial) 79-81 Added to description with “Resource Tags:” prefix
Kubernetes Cluster description (partial) 79-81 Added to description with “Kubernetes Cluster:” prefix
Kubernetes Namespace description (partial) 79-81 Added to description with “Kubernetes Namespace:” prefix
Container Service description (partial) 79-81 Added to description with “Container Service:” prefix

Additional Finding Field Settings (Standard Format)

Finding Field Default Value Parser Line # Notes
static_finding False 84 Set to False for all findings
dynamic_finding True 84 Set to True for all findings

SCA Format

This format applies the WizParserByDetailedName parser class.

Total Fields in SCA CSV

SCA Format Field Mapping Details

CSV Field Finding Field Parser Line # Notes
ID unique_id_from_tool 182 Used as unique identifier for the finding
WizURL description 150-154 Added to description with “Wiz URL” prefix
Name title, vulnerability_ids 169, 182-184 Used in title format as vulnerability ID and added to vulnerability_ids list
CVSSSeverity Not parsed - Not used in mapping
HasExploit description 150-154 Added to description with “Has Exploit” prefix
HasCisaKevExploit description 150-154 Added to description with “Has Cisa Kev Exploit” prefix
FindingStatus active, is_mitigated 180 Mapped through convert_status function to determine active state
VendorSeverity severity 181 Mapped through _validate_severities to convert to DefectDojo severity format
FirstDetected date 185 Parsed into date object using date_parser
LastDetected Not parsed - Not used in mapping
ResolvedAt Not parsed - Not used in mapping
ResolutionReason Not parsed - Not used in mapping
Remediation mitigation 155-159 Added to mitigation with “Remediation” prefix
LocationPath description, mitigation 150-159 Added to both description and mitigation with “Location Path” prefix
DetailedName title, component_name 169, 183 Used in title format and mapped to component_name
Version description, component_version 150-154, 184 Added to description with “Version” prefix and mapped to component_version
FixedVersion mitigation 155-159 Added to mitigation with “Fixed Version” prefix
DetectionMethod description 150-154 Added to description with “Detection Method” prefix
Link description 150-154 Added to description with “Link” prefix
Projects description 150-154 Added to description with “Projects” prefix
AssetID description 150-154 Added to description with “Asset ID” prefix
AssetName description 150-154 Added to description with “Asset Name” prefix
AssetRegion description 150-154 Added to description with “Asset Region” prefix
ProviderUniqueId description 150-154 Added to description with “Provider Unique Id” prefix
CloudProviderURL description 150-154 Added to description with “Cloud Provider URL” prefix
CloudPlatform description 150-154 Added to description with “Cloud Platform” prefix
Status Not parsed - Not directly used (FindingStatus is used instead)
SubscriptionExternalId description 150-154 Added to description with “Subscription External Id” prefix
SubscriptionId description 150-154 Added to description with “Subscription Id” prefix
SubscriptionName description 150-154 Added to description with “Subscription Name” prefix
Tags unsaved_tags 186 Parsed into tags list using _parse_tags function
ExecutionControllers description 150-154 Added to description with “Execution Controllers” prefix
ExecutionControllersSubscriptionExternalIds description 150-154 Added to description with “Execution Controllers Subscription External Ids” prefix
ExecutionControllersSubscriptionNames description 150-154 Added to description with “Execution Controllers Subscription Names” prefix
CriticalRelatedIssuesCount Not parsed - Not used in mapping
HighRelatedIssuesCount Not parsed - Not used in mapping
MediumRelatedIssuesCount Not parsed - Not used in mapping
LowRelatedIssuesCount Not parsed - Not used in mapping
InfoRelatedIssuesCount Not parsed - Not used in mapping
OperatingSystem description 150-154 Added to description with “Operating System” prefix
IpAddresses description 150-154 Added to description with “Ip Addresses” prefix

Additional Finding Field Settings (SCA Format)

Finding Field Default Value Parser Line # Notes
static_finding True 182 Set to True for SCA format findings
Severity “Info” 210 Default if not a valid severity

Special Processing Notes

Date Processing

Status Conversion

Description Construction

Title Format

Mitigation Construction

Deduplication

Tags Handling (SCA Format)

Source Code

Source code for the Wiz parser can be found on GitHub.