Skip to main content

Scan Configs

Scan Configs is where you define how a scan runs, separately from when it runs and what it found. One configuration is stored per asset and per scan type, and every execution โ€” manual, scheduled, or triggered by your pipeline โ€” reuses the closest matching configuration.

Edit a configuration once, and the next run picks it up. You never have to re-declare scanner options inside your CI/CD files.

Where it livesโ€‹

ScreenWhere to open itWhat it holds
Scan ConfigsDevSecOps โ†’ Scan Setup, Asset tabThe saved configurations โ€” one row per asset/type, plus one row per AST branch profile
AST Global ConfigAST Global Config, in the toolbar of Scan SetupThe company-wide AST baseline that every asset inherits from. See AST Defaults
Scan ExecutionsDevSecOps โ†’ Scan ExecutionsEvery scan that already ran, with status, duration, asset, and branch

How AST and PR scans run on their own in each ALM organization, through the orchestrator pipeline and pull request checks, is set on the Organization tab of Scan Setup.

Scan Configs list

The configuration modelโ€‹

Three levels resolve from most specific to most general. A scan always uses the closest one that exists:

  • Company AST defaults โ€” the baseline for the whole company. Managed in AST Global Config.
  • Asset configuration โ€” overrides the defaults for one asset. Applies to every branch that has no profile of its own.
  • Branch execution profile โ€” overrides the asset configuration for one specific branch. A release branch and a feature branch rarely need the same scan.

Inheritance is per module, not all-or-nothing. An asset can override SAST while still inheriting SCA, IaC, Container, SBOM, and Secret from the company defaults.

note

Overriding is a deliberate act. Creating a configuration does not copy the defaults into it โ€” the modules you do not touch stay linked to the defaults, so a later change to the company baseline still reaches them.

Reading the listโ€‹

Each row is one configuration.

ColumnMeaning
IDStable identifier. AST-3 is the asset configuration; AST-3-2 is a branch profile derived from it
AssetThe asset the configuration is attached to
TypeAST or DAST
BranchThe branch for a branch profile; - when the configuration covers every branch
TriggerHow this configuration gets executed โ€” see below
ScopeWhat narrows the scan: ignored paths, plus which modules are overridden
ExecutionsHow many scans have used this configuration
Last executionStatus of the most recent run, or No executions yet

Trigger kindsโ€‹

TriggerMeaning
CI/CD pipelineYour pipeline (or the AST Orchestrator) starts the scan
ScheduledThe Platform starts the scan on a recurring schedule โ€” DAST only
Manual runs onlyThe scan runs when someone presses Run scan or Save and Run

The trigger is derived, not chosen from a dropdown. It reflects how the asset is actually wired: an asset connected to a repository integration with an orchestrator reads as CI/CD pipeline; a DAST configuration with scheduling enabled reads as Scheduled; anything else reads as Manual runs only.

What each scan type configuresโ€‹

AST covers six modules, each configured independently:

ModuleAnalyzes
SASTYour own source code
SCAThird-party dependencies
IaCInfrastructure-as-code misconfigurations
ContainerOS-level vulnerabilities in container images
SBOMSoftware Bill of Materials generation
SecretCredentials and secrets committed to the repository

DAST configures a single dynamic analysis against a running application or API: scan profile, analysis type, scope, authentication, and schedule.

Access requirementsโ€‹

RequirementApplies to
AST_SCAN_ACCESS plan permissionThe whole AST experience, including AST Global Config
Company Admin profileCreating, editing, and deleting AST configurations and rules
Run permission (Conviso AST section of the profile)Running Conviso AST in Dry-Run mode
Write results to the platform permissionRunning Conviso AST and sending its results to the Platform
Asset visibilityStarting a scan from an asset you can already see

Reading and editing AST configuration requires an Admin profile in that company. Starting a scan on an asset you can already see does not. An Admin can always run Conviso AST and send its results; for any other profile, the Conviso AST permissions decide.

Where AST is documentedโ€‹

AST spans three concerns, and each has its own home in these docs. Start from the one that matches what you are doing:

You want toRead
Configure what a scan does, in the PlatformThis section โ€” Scan Configs
Understand the scanner itself, or run it from a terminalConviso AST (CLI), under Scanners
Wire your repository provider so the Platform can trigger scansThe AST Orchestrator guide for your provider, under Integrations โ†’ Source Code Management: GitHub ยท GitLab ยท Azure DevOps ยท Bitbucket

The orchestrator guides live with their provider integration because they are provider setup, not scan configuration โ€” you follow one of them once, then never again.

Where to go nextโ€‹

Contribute to the Docs

Found something outdated or missing? Help us improve the documentation with a quick suggestion or edit.

How to contribute

Resources

By exploring our content, you'll find resources that will enhance your understanding of the importance of a Security Application Program.

Conviso Blog: Explore our blog, which offers a collection of articles and posts covering a wide range of AppSec topics. The content on the blog is primarily in English.

Conviso's YouTube Channel: Access a wealth of informative videos covering various topics related to AppSec. Please note that the content is primarily in Portuguese.