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.

The Scans contextโ€‹

Everything lives under DevSecOps โ†’ AST in the side menu, which opens a context with three tabs:

TabWhat it holds
ExecutionsEvery scan that already ran, with status, duration, asset, and branch
Scan ConfigsThe saved configurations โ€” one row per asset/type, plus one row per AST branch profile
AST defaultsThe company-wide AST baseline that every asset inherits from

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 the AST defaults tab.
  • 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 the AST defaults tab
Company Admin profileCreating, editing, and deleting AST configurations and rules
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.

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.