Skip to main content

Creating Scan Configs

A scan configuration is created from the Scan Configs tab. The same form is used to create a new configuration and to edit an existing one โ€” the breadcrumb tells you which mode you are in (New AST scan vs. Edit).

Starting a new configurationโ€‹

Open DevSecOps โ†’ AST โ†’ Scan Configs and press New. The dropdown offers one entry per scan type:

New scan dropdown

OptionEngineUse when
ASTConviso ASTStatic analysis of a repository โ€” SAST, SCA, IaC, Container, Secret, and SBOM
DASTConviso DASTDynamic analysis of a running application or API, from the outside in

Creating an AST configurationโ€‹

New AST configuration

Targetโ€‹

FieldRequiredNotes
AssetYesThe asset this configuration attaches to. Only repository assets can run AST
BranchNoLeave empty to configure the asset for every branch. Pick a branch to create a branch execution profile that applies to that branch alone

Choosing a branch is what separates the two kinds of AST configuration:

  • No branch โ†’ the asset-level configuration. Every branch without a profile of its own inherits it.
  • A branch โ†’ a branch execution profile. It overrides the asset-level configuration for that branch only, and appears in the list as a separate row (AST-3-2) with the branch shown in the Branch column.
tip

Create the asset-level configuration first, then add branch profiles only where a branch genuinely needs different treatment. A profile you never diverge from is a row you have to maintain for no benefit.

Modulesโ€‹

Each of the six modules shows its current state and a Configure link:

  • Inherits default โ€” the module is still linked to the company AST defaults. A change to the defaults reaches this asset on its next run.
  • Overridden โ€” the module carries its own settings for this asset, and no longer follows the defaults.

Pressing Configure opens that module's settings beside the form, so whatever you already selected on this page survives the edit. Overriding is what the act of saving inside the panel does โ€” modules you never open stay inherited.

Edit AST defaults (top right) jumps to the company baseline. Use it when the change you are about to make should apply to every asset, not just this one.

Savingโ€‹

ButtonBehavior
SaveWrites the configuration and returns to the Scan Configs list
Save and RunWrites the configuration, then immediately starts a scan with it

Save and Run never fires a scan on a configuration that failed to save. If the write fails, you stay on the form with the error and no scan is triggered. See Running Scans for what happens after the scan starts.

Creating a DAST configurationโ€‹

New DAST configuration

Targetโ€‹

FieldRequiredNotes
AssetYesThe asset whose URL will be scanned

Technical specificationsโ€‹

FieldNotes
Scan ProfileTrade-off between depth and duration. Balanced is the default
Type of analysisWEB for a web application, or an API format when scanning an API
API schemaFor API analysis, supply the schema by URL or by uploading the specification file
caution

DAST runs from Conviso infrastructure. Allow traffic from the IP shown on the form (52.41.156.39) or the scan will not reach your application.

Scopeโ€‹

Scope restricts what the scanner is allowed to touch:

  • In-scope paths โ€” only these paths are scanned.
  • Out-of-scope paths โ€” these paths are never scanned.

Leave scope off to scan the whole target.

Authenticationโ€‹

Point the configuration at a stored secret so the scanner can authenticate and reach pages behind login. Without it, DAST only sees what an anonymous visitor sees.

Scheduleโ€‹

Enabling scheduling turns the configuration's trigger into Scheduled and the Platform runs it on the chosen interval, weekday, and time. With scheduling off, the configuration is Manual runs only and runs when you press Run scan.

Viewing, editing, and deletingโ€‹

Clicking a row in the Scan Configs list opens the configuration.

Scan config details

The Details tab summarizes what will run:

FieldExample
TypeAST โ€” Conviso AST
AssetThe asset name
BranchThe branch name, or All branches
TriggerManual runs only
Modules6 enabled ยท 0 Overridden
ExecutionsThe runs that used this configuration

The Configuration tab shows the resolved settings โ€” what each module will actually use once inheritance is applied.

Three actions sit in the header:

ActionEffect
Run scanStarts a scan now using this configuration
EditReopens the form
DeleteRemoves the configuration
caution

Deleting an asset configuration also removes the branch profiles derived from it โ€” those profiles only exist as overrides of the asset-level row. Every affected branch falls back to the company AST defaults on its next run.

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.