Basics

To perform its scans, Verdex needs the URL of the target to scan, for example:

-target
URL
verdex -target https://keycloak.example.com

By default, Verdex tries to automatically detect the target product.
Use -product to specify the product to scan (see Products section for options).

Multiple targets

To scan multiple targets at the same time, use -list (one target per line):

-list
filepath
verdex -list ./targets.txt

Output formats

To change the output format of Verdex results, see dedicated page:

Logging

To display verbose output (useful for debug), use -verbose:

-verbose
boolean
default: false
verdex -target https://example.com -verbose

Improvement Reports

Sometimes, Verdex cannot determine version for multiple reasons (missing or incorrect rules, specific configuration, …). Use -report-errors to automatically report failures to Verdex maintainers for manual debugging. By default, targets are not reported.

URLs of reported targets will NOT be publicly visible and will be accessed by Verdex maintainers for debugging purposes only.

-report-errors
boolean
default: false
verdex -target https://example.com -report-errors

Custom templates

Verdex uses templates to run scans (see Contribute section for more information).

By default, templates are loaded from latest release of official Verdex repository.

To run scans with custom templates, use -templates-directory:

-templates-directory
dirpath
verdex -target https://example.com -templates-directory ./templates

If Verdex is run locally with go run ., templates directory is automatically set to ./templates