Scanner onboarding and coverage rollout workflow
one engagement record from pilot scope through fleet coverage and steady-state operation
Every internal security, AppSec, vulnerability management, cloud security, and security engineering programme reaches the point of bringing a new scanner online. The pilot fires false positives, the coverage map is incomplete, the severity defaults do not match the workspace policy, the owners are not yet routed, and the audit cycle that follows the rollout has no defensible record of how the scanner got from pilot to production. Run the rollout as a chartered engagement on the workspace with a documented pilot scope, structured coverage phases, calibrated severity normalisation, named owner routing, an exception register filter, and an activity-log trail that the next audit reads against rather than a folder of one-off screenshots.
No credit card required. Free plan available forever.
Run scanner onboarding and coverage rollout on one engagement record, not on a deployment ticket
Every internal security, AppSec, vulnerability management, cloud security, and security engineering programme reaches the point of bringing a new scanner online. The pilot fires false positives, the coverage map is incomplete, the severity defaults do not match the workspace policy, the owners are not yet routed, the exception register is invisible to the new intake, and the audit cycle that follows the rollout has no defensible record of how the scanner got from pilot to production. The risk is not that the scanner does not work; it is that the scanner reaches fleet scope before the discipline is in place and the operating noise then drowns the underlying signal for two cycles.
SecPortal models scanner onboarding as a chartered engagement on the workspace, scoped per scanner with named rollout phases (pilot, expanded pilot, fleet rollout, steady state, sunset), documented success criteria per phase, a documented rollback condition per phase, and a phase-gate approval discipline with the named approver. The calibration map lives on the engagement record. The owner-routing rules live on the engagement record. The exception register filter is wired into the new intake from phase one. Bulk finding import preserves source attribution. The activity log carries the audit-trail chronology from pilot day one through steady-state operation and eventual sunset. AI-assisted reporting drafts the phase-gate review pack and the quarterly operating review pack from the structured record.
Five rollout phases the engagement record holds
A defensible scanner rollout proceeds in five named phases with documented scope, duration, and exit criteria per phase. The phase-gate decision is recorded on the engagement record with the named approver. The phases are not a calendar; they are an operating contract between the programme owner and the named approver who decides when the scanner is ready for the next perimeter.
| Phase | Scope | Duration | Exit criteria |
|---|---|---|---|
| Phase 1: Pilot | A deliberate subset: a single application, a single repository, a single cluster, a single business unit, or a single asset tier. The pilot scope is named on the engagement record so the audit lookback reads the boundary the scanner first operated against rather than guessing. | Two to six weeks, with a documented start and end date. The duration is long enough to capture multiple scan cycles, a calibration adjustment pass, and a sample-based false-positive review, and short enough to avoid the scanner silently expanding beyond the pilot before the discipline lands. | Signal-to-noise ratio above the documented threshold against the manually validated sample, false-positive rate at or below the programme target per rule class, coverage of the in-scope surface confirmed against the expected attack surface, named owners agreed for each finding class, and the calibration map documented on the engagement record. |
| Phase 2: Expanded pilot | A second business unit, a second application stack, a second cluster fleet, or a second asset tier. The scope expansion is documented on the engagement record with the named additional perimeter, the rationale for the next perimeter rather than the eventual full fleet, and the differences between the pilot scope and the expanded scope. | Two to four weeks per expansion increment, with the option to extend if the new scope surfaces calibration adjustments the pilot did not encounter. | Calibration adjustments captured against the new scope, no regression of pilot success criteria against the original perimeter, no parallel-record duplication against the existing finding catalogue, and the named owners for the new scope confirmed. |
| Phase 3: Fleet rollout | The complete eventual coverage perimeter: every repository the scanner will run against, every cluster the scanner will read posture from, every authenticated target the scanner will run credentials against, every external surface the scanner will reach. The fleet rollout is the operating mode the scanner will live in for the long term. | Four to twelve weeks depending on the size of the eventual perimeter and the per-target onboarding work (credential provisioning, asset binding, owner assignment). The rollout proceeds in named increments rather than as a single big-bang. | Every in-scope target has the scanner configured, the credentials in the workspace credential vault where authentication is required, the asset binding resolved against the verified domain list or the repository connections, the named owner on the asset record, and the SLA assignment derived from the calibrated severity. |
| Phase 4: Steady state | The scanner operates against the full perimeter on the documented operating cadence. The engagement record holds the operating posture (signal-to-noise, false-positive rate, coverage drift, time-to-acknowledge, time-to-close, exception register churn, rule-pack update cadence) as a recurring read against the quarterly operating review. | Indefinite, with quarterly operating reviews that surface drift before it becomes a governance issue. | A documented quarterly review pack that names the operating signals, the calibration adjustments since the prior review, the owner-routing changes, the scope expansions or reductions, and the decision to continue or move to a sunset cycle. |
| Phase 5: Sunset | The scanner is consolidating with another tool, retiring an unused capability, or being replaced by a better alternative. The sunset engagement carries the migration path for open findings, the closure of findings produced exclusively by the sunsetting scanner, and the audit-trail export. | Six to twelve weeks depending on the open-finding backlog and the migration target. The sunset is not a same-day decommission; it is a documented wind-down that preserves the audit trail and migrates the operating state to the replacement tool or to the consolidating platform. | Every open finding produced exclusively by the sunsetting scanner has a documented disposition (migrated, closed with rationale, accepted with override, transferred to the replacement tool), the activity-log export is filed against the engagement record, and the named approver of the sunset is captured on the engagement. |
Five pilot success criteria that gate the phase transition
The pilot phase is a deliberate first read of whether the scanner produces operationally useful work in the workspace. Five criteria gate the transition to expanded pilot. Each criterion is documented on the engagement record so the next phase reads the pilot decision rather than re-deriving it.
Signal-to-noise ratio against a manually validated sample
A documented sample (typically 30 to 100 findings depending on the pilot scope) where each finding has been manually reviewed for true-positive status. The ratio is the share of true positives in the sample. The threshold is a programme decision rather than a vendor default; common thresholds sit between 70 and 90 percent depending on the rule class.
False-positive rate per rule class
The complement of the signal-to-noise read split by rule class. The split surfaces rule classes that drive most of the false positives so the rule-pack tuning targets the right rules rather than disabling the scanner because of a handful of noisy rules. The programme keeps the rule-class breakdown on the engagement record for the fleet rollout phase.
Time-to-first-actionable-finding
The wall-clock time from the scanner running its first scan in the pilot scope to the first finding the programme accepted onto the open queue with a named owner, a calibrated severity, an asset binding, and a remediation owner who has acknowledged the assignment. The signal that distinguishes a scanner that produced operationally useful work in the pilot from one that produced output nobody acted on.
Coverage of the in-scope surface against the expected attack surface
For an external scanner: the share of the in-scope external surface the scanner reached relative to the documented external attack surface. For a SAST scanner: the share of in-scope repositories the scanner ran against relative to the documented codebase scope. For a KSPM or CSPM scanner: the share of in-scope clusters or cloud accounts the scanner read posture from. The signal that distinguishes a deployed scanner from a configured-but-not-running scanner.
Operator burden per finding triaged
The wall-clock time per finding from the scanner output landing on the engagement to a named owner accepting the assignment with a calibrated severity, an asset binding, and a remediation plan. The signal that distinguishes a scanner whose output is operationally cheap to triage from one whose output requires three operator passes before it becomes useful work.
Six calibration dimensions the rollout maps before fleet expansion
Before the scanner expands beyond the pilot scope, the calibration map captures six dimensions on the engagement record. The map is the operating contract between the scanner defaults and the workspace policy: what the scanner emits, what the workspace records, and why the mapping moves in either direction.
Source severity to workspace severity by rule class
Vendor severity scales rarely match the workspace policy. The calibration map names the source severity per rule class and the workspace severity per rule class, with cited rationale where the mapping moves the severity (asset criticality of the typical target, exploitability under the typical deployment, blast radius of the typical fix). The calibration lands on the engagement as a versioned configuration so the audit lookback reads the mapping with provenance.
CVSS 3.1 vector capture
Where the scanner provides a CVSS vector, the calibration preserves the full vector string on the finding so the workspace policy can derive the score from the metrics rather than from the unsourced number. Where the scanner does not provide a vector, the calibration documents the per-rule-class default vector the workspace will apply, with cited rationale for the metric choices.
Asset binding from scanner output to workspace asset identifiers
Scanner output names assets in scanner-native form (a hostname, an IP, a repository URL, a cluster ARN, a cloud-account ID, a container image tag). The asset binding maps those to the workspace identifiers (the verified domain, the repository connection, the engagement scope) so the cross-engagement view groups findings by asset rather than by scanner-native string.
Category or CWE mapping where the scanner ships its own taxonomy
Many scanners ship category taxonomies that do not align with CWE or with the workspace controlled-vocabulary. The calibration map names the scanner category, the workspace category, the CWE reference (where applicable), and the rationale for the mapping. The reporting view reads the workspace category rather than the scanner-native string.
Dedup rules against the existing finding catalogue
A new scanner that does not deduplicate against the existing catalogue will mint parallel records for findings the workspace already holds. The dedup rules name the identity key (asset plus rule reference, asset plus CWE, asset plus title pattern) the workspace uses to recognise an existing finding so the new scanner attaches its detection as evidence rather than creating a new parallel record.
SLA mapping derived from the calibrated severity
The SLA breach calculation reads against the calibrated severity rather than the vendor default. The SLA mapping ties the workspace severity to the SLA policy (typically tied to severity bands such as Critical/High/Medium/Low with corresponding day counts) so the breach posture from day one of the fleet rollout reads from the calibrated severity.
Five owner-routing archetypes the rollout assigns per finding class
Each finding class the scanner produces gets a named owner archetype on the engagement record. The archetype is the routing anchor the queue view, the notification schedule, and the SLA breach calculation read against. Where the scanner output does not carry an owner field, the routing rule resolves the class-to-owner mapping at intake against the asset record and the workspace membership.
Repository owner
For SAST and SCA findings, the repository owner on the workspace repository-connection record inherits the routing. The named owner is responsible for the per-repository disposition: code change, dependency upgrade, accepted-risk override with cited rationale, or false-positive suppression with rule-pack tuning. The owner archetype maps to the application security programme leads and the engineering teams that own the repositories.
Application owner
For DAST and authenticated DAST findings, the application owner on the engagement scope inherits the routing. The named owner is responsible for the per-application disposition. The owner archetype maps to the application security programme leads, the product security teams, and the engineering teams that own the applications.
Platform owner or cluster owner
For KSPM and cluster-posture findings, the platform team that owns the cluster lifecycle inherits the routing. The named owner is responsible for the cluster-level disposition. The owner archetype maps to the platform engineering teams.
Cloud account owner
For CSPM and cloud-posture findings, the cloud account owner on the workspace account record inherits the routing. The named owner is responsible for the account-level disposition. The owner archetype maps to the cloud security teams and the platform engineering teams.
External attack-surface owner
For external scanning findings, the attack-surface owner on the verified-domain record inherits the routing. The named owner is responsible for the per-host or per-service disposition. The owner archetype maps to the internal security teams, the AppSec teams, and the platform engineering teams that own the external footprint.
Where scanner rollouts usually fail
Eight failure modes account for most scanner rollouts that absorb noise at fleet scale before the discipline is ready. Each failure mode reads as a process gap at the next assessment because the audit lookback cannot reconstruct the decisions the operating cycle did not capture.
Pilot silently expanded into fleet before the calibration was ready
The pilot ran for two weeks against one application, the team enabled the scanner against the full fleet on a Friday afternoon, and Monday morning brought 4,000 open findings most of which were false positives or duplicates of records the existing catalogue already held. The fix is the documented phase plan with named expansion criteria, the phase-gate review with the named approver before the scope widens, and the rollback condition that returns the scanner to the prior phase if the next-phase criteria do not hold.
Scanner findings landed without an asset binding because the import did not resolve against the inventory
The CSV import accepted the scanner output as is, the asset reference was a hostname the scanner emitted but the workspace inventory does not recognise, and the owner-routing rules could not match the finding to a named owner. The fix is requiring the asset binding to resolve against the verified domain list, the repository connections, or the engagement scope before the finding opens on the open queue. Imports that do not resolve land in a hygiene queue rather than corrupting the operational view.
Severity defaults did not match the workspace policy so the SLA breach calculation read against the wrong distribution
The scanner classified every detection as High because the vendor scale defaults to High for any rule fire, the workspace SLA policy then treated every finding as a 30-day SLA, and the queue blew past breach within a cycle. The fix is the explicit severity calibration map on the engagement record: the source severity per rule class, the workspace severity per rule class, the rationale where the mapping moves the severity, the named approver of the mapping, and the activity-log capture so the audit lookback reads the calibrated severity with provenance.
Exception register was not consulted at intake so accepted risks reopened on every cycle
Findings the programme accepted as a risk last quarter with a documented expiry landed again from the new scanner, opened on the queue as new records, and the team re-debated whether to accept. The exception register was invisible to the new scanner intake path. The fix is wiring the exception register filter into the new scanner intake from phase one so findings that match an active acceptance, deferral, or false-positive suppression inherit the existing record and the existing expiry rather than minting a new ticket the team has to dismiss.
No named owner archetype per finding class so routing fell back to a shared mailbox nobody read
The scanner produced findings across SAST rule classes, the scanner finding output did not carry an owner field, and the routing rule defaulted to the AppSec lead inbox where everything queued behind everything else. The fix is the per-finding-class routing rule documented on the engagement record before the fleet rollout: which finding classes route to repository owners, which to AppSec leads, which to platform owners, which to cluster owners. The named owner on the asset record is the routing anchor; the routing rule resolves the class-to-owner mapping at intake.
False-positive triage during the pilot was anecdotal so the fleet rollout absorbed the same false positives at scale
The pilot logged false positives in chat, no rule-pack tuning was recorded, and the fleet rollout brought the same false positives onto a 50x larger surface. The fix is the documented false-positive review during the pilot: a manually validated sample, a structured tuning record per rule, the rule-pack overrides the programme is willing to maintain, and the named owner of the rule-pack tuning so the fleet rollout starts from a tuned baseline rather than the vendor default.
Scanner output did not preserve source attribution so the audit lookback could not reconstruct provenance
Findings imported as bulk records with no scanner name, no rule reference, no rule-pack version, and no scan ID. Six months later the audit assessor asked which scanner produced which finding and the answer was a folder of CSV files in shared storage. The fix is the structured source-attribution capture on every import: the scanner name, the rule reference, the rule-pack version, the scan ID, the scan timestamp, the engagement reference. The activity-log chronology reads from the import event through the closure event without gaps.
No documented sunset path so retired scanners left orphan findings the next audit could not place
The programme moved off a scanner after the quarterly review, the replacement tool was already in fleet rollout, and the old scanner findings sat on the queue without a documented disposition. Six months later the audit asked who owned a five-year-old open finding from a scanner the company no longer ran. The fix is the documented sunset engagement that closes or migrates every open finding produced exclusively by the sunsetting scanner, captures the named approver of the sunset, and exports the activity-log chronology so the historical record stays defensible.
How the rollout looks in SecPortal
The rollout runs on the same feature surfaces the rest of the security programme already uses: the engagement record holds the scanner, the phases, and the calibration; the findings view holds the live triage queue under the rollout calibration; the activity log carries the chronology; finding overrides hold severity recalibrations and exception register entries; team management routes ownership; bulk finding import preserves source attribution; the credential vault holds the authentication material for authenticated scanners; retesting workflows verify closures; AI-assisted reporting drafts the phase-gate review and the quarterly operating review.
Engagement as the rollout charter
Engagement management carries the scanner identity, the named programme owner, the rollout phases, the per-phase scope, the per-phase exit criteria, the rollback condition, the framework citations, and the named approvers. The engagement is the boundary every rollout decision lands on.
Findings under the calibration map
Findings management carries the calibrated severity, the workspace category, the CVSS 3.1 vector, the asset binding, and the named owner under the rollout calibration. Every finding the scanner produces lands under the calibration map rather than the vendor default.
Bulk import that preserves source attribution
Bulk finding import maps the source CSV columns onto the workspace finding fields and saves the mapping as a reusable template. The scanner name, the rule reference, the rule-pack version, the scan ID, and the scan timestamp ride along on every imported finding so the audit lookback reads the source.
Overrides for calibration and exceptions
Finding overrides hold severity recalibrations against the calibration map and exception register entries with cited reason, named approver, scope, and hard expiry. The exception filter blocks accepted risks from reopening as parallel records on every scan cycle.
Owner routing through team management
Team management with role-based access carries the workspace membership and the engagement access list. The owner-routing archetype on each finding class resolves to a named workspace member rather than a shared inbox.
Credential vault for authenticated scanners
Encrypted credential storage holds the authentication material for authenticated scanners under AES-256-GCM at rest. The credential vault is the source of truth for the scan-time credentials rather than scanner-native configuration files.
Native scan surfaces for in-platform rollouts
External scanning, authenticated scanning, and code scanning cover the native rollout paths for external, authenticated DAST, and SAST plus SCA workloads. The rollout phases apply identically to native scans and to imported third-party scanners.
Retesting for closure verification
Retesting workflows verify that the new scanner closure path works as intended: a finding closed by remediation is confirmed by a follow-up scan rather than by an engineering assertion. The closure path is part of the steady-state success criteria.
Activity log as the rollout audit trail
Activity log captures every phase-gate decision, calibration adjustment, owner-routing change, scope expansion, and rule-pack update with timestamp, user, and rationale. The CSV export carries the rollout chronology into the next audit binder.
Six signals the rollout surfaces by default
When scanner onboarding runs as a structured engagement on the workspace, six signals come straight off the record without a manual reporting pass. They drive the phase-gate decision, the quarterly operating review, and the audit lookback.
Pilot signal-to-noise trend by rule class
The view that distinguishes a scanner ready to expand from one that needs calibration adjustment before the next phase. The trend lives on the engagement record and the manually validated sample feeds the read.
Per-phase scope coverage against the documented perimeter
The proportion of the in-scope surface the scanner is configured against versus the documented eventual perimeter. The view that distinguishes a scanner in active rollout from one that is configured for a perimeter but not running against it.
Owner-routing resolution rate at intake
The proportion of new scanner findings that resolve to a named owner at intake without manual handoff. The view that distinguishes a calibrated owner-routing rule set from one that defaults to a shared inbox.
Calibration provenance coverage
The proportion of new scanner findings whose severity carries the calibration rationale and the named approver on the activity log. The signal that distinguishes a scanner whose severity is reproducible from one whose severity reads as the unsourced vendor default.
Exception register filter hit rate at intake
The proportion of new scanner findings that match an active acceptance, deferral, or false-positive suppression and inherit the existing record. The signal that distinguishes a scanner intake that respects the exception register from one that reopens accepted risks every cycle.
Source-attribution preservation rate
The proportion of imported scanner findings that carry the scanner name, rule reference, rule-pack version, scan ID, and scan timestamp. The signal that distinguishes a defensible audit trail from a folder of CSV files in shared storage.
Reviewer checklist before each phase-gate decision
Before the named approver agrees to the next phase, the checklist below runs in minutes. Each line names a record-level posture the next phase depends on. A scanner that fails any line goes back to the prior phase rather than expanding its perimeter.
- The engagement record names the scanner, the pilot scope, the rollout phases, the success criteria per phase, and the rollback condition per phase.
- The pilot phase ran for the documented duration with a manually validated sample and a documented signal-to-noise read against the sample.
- The calibration map is on the engagement record with source severity, workspace severity, CVSS handling, asset binding rules, category mapping, dedup rules, and SLA mapping.
- Every finding class the scanner produces has a named owner archetype and a documented routing rule.
- The exception register filter is wired into the new scanner intake so accepted risks do not reopen as parallel records.
- The phase-gate review with the named approver ran before the scope expanded from pilot to expanded pilot, from expanded pilot to fleet rollout, and from fleet rollout to steady state.
- The source attribution is preserved on every imported finding: scanner name, rule reference, rule-pack version, scan ID, scan timestamp.
- The activity-log CSV export covers the rollout chronology from pilot day one through the current phase.
- Where the scanner runs authenticated, the credentials live in the workspace credential vault with documented rotation, not in scanner-native configuration files.
- Where the scanner produces findings that overlap with the existing catalogue, the dedup rules collapse duplicates onto one primary record rather than minting parallel records.
What auditors expect from a defensible scanner rollout
A new scanner reaching production is a material change to the detection layer of the vulnerability management programme. Every modern audit regime treats the change as evidence the programme operates as documented. The frameworks below all expect a documented rollout with calibration, named approvers, and a chronology the assessor reads against rather than reconstructs.
| Framework | What the audit expects |
|---|---|
| ISO 27001 Annex A 8.8 Management of technical vulnerabilities | The standard expects a documented vulnerability management process that includes how vulnerabilities are identified, evaluated, and treated. A new scanner rollout is a material change to the identification stage of that process. The audit reads the documented scope, the calibration map, the owner-routing rules, the exception register check, and the activity-log chronology against the documented process. A scanner that landed without a documented rollout reads as an undocumented change. |
| SOC 2 CC7.1, CC7.2, CC8.1 | Detection, response, and change-management criteria expect that monitoring is implemented to detect security events (CC7.1), that detected events are evaluated and responded to (CC7.2), and that changes to the system are authorised and documented (CC8.1). A new scanner reaching production is a change to the detection layer; the documented rollout, the calibration, and the named approver of each phase carry the change-management evidence. |
| PCI DSS 11.3 and 6.3.1 | External and internal vulnerability scanning cadence and the secure development lifecycle expect documented scanning processes. A new scanner that covers in-scope systems must show the documented scope, the cadence, the calibration, and the remediation pathway. The audit reads the rollout phases as the documented process for bringing the new tool into the compliant cadence. |
| NIST SP 800-53 RA-5 and SI-2 | Vulnerability monitoring (RA-5) and flaw remediation (SI-2) expect documented scanning activities, frequency, and corrective actions. A new scanner is a change to the vulnerability monitoring control; the documented rollout, the calibration, the owner routing, and the activity-log chronology are the evidence the control change is implemented as intended. |
| NIST CSF 2.0 DE.CM and PR.PS | The Detect function (DE.CM continuous monitoring) and Protect function (PR.PS platform security) expect documented activities for monitoring and platform-security testing. A new scanner adds to the continuous monitoring surface and may add to the platform security testing posture. The documented rollout shows that the addition is implemented with the discipline the function expects. |
| DORA Article 9 and NIS2 Article 21 | ICT risk management framework (DORA) and technical and organisational measures (NIS2) expect documented controls for vulnerability management with evidence of operation. A new scanner reaching production is a control change; the rollout engagement record, the calibration map, the named approvers, and the activity-log export carry the supervisory evidence the regime expects. |
Where scanner onboarding sits in the wider security programme
Scanner onboarding composes with the rest of the security programme on the same engagement primitives so the rollout discipline stays connected to the per-finding, per-control, and per-cycle work that runs alongside it. The rollout reads against scanner result triage as the per-finding workflow that runs once the scanner is in steady state, security tool consolidation as the portfolio-level workflow that decides which scanners cover which capabilities, vulnerability management programme onboarding as the wider programme-level workflow inside which the per-scanner rollout operates, security onboarding for new applications as the application-side workflow scanner coverage feeds, and scanner-to-ticket handoff governance as the downstream workflow once findings reach steady state.
Adjacent operating reading covers the scanner coverage and limits documentation the calibration map reads against, the scanner coverage gap analysis discipline the rollout phases close, the scanner authentication failure modes the credential vault rollout prevents, the scanner credential rotation and lifecycle steady-state operation depends on, and the importing third-party scanner results path the bulk-import workflow uses.
The longer-form research reading covers the security tool coverage overlap analysis for the dedup framing, the scanner finding merge economics for the cross-scanner consolidation framing, the severity recalibration drift per scanner generation research for the calibration provenance framing, and the vulnerability management programme guide for the wider operating-model framing.
Buyer and operator pairing
A structured scanner onboarding and coverage rollout workflow is the operating model internal security teams, AppSec teams, product security teams, vulnerability management teams, cloud security teams, security engineering teams, security operations leaders, and CISOs rely on when a new scanner needs an operating contract that holds across pilot, fleet, steady state, and sunset. The framework references that shape the cadence include ISO 27001, SOC 2, PCI DSS, NIST SP 800-53, NIST CSF 2.0, DORA, and NIS2. The supporting templates include the vulnerability management platform RFP template for procurement upstream of rollout, the vulnerability management programme scorecard for the operating posture read, and the security exception register template for the exception filter the new scanner intake reads against.
Frequently asked questions
How is this different from the scanner result triage workflow?
Scanner result triage is the per-finding workflow that runs continuously once a scanner is in steady-state operation: a finding lands, a named owner is assigned, severity is calibrated, the disposition lands. Scanner onboarding and coverage rollout is the chartered programme of work that brings a new scanner online and gets it to the point where triage can run reliably. The two compose on the same engagement primitives: the rollout phases build the scanner into the operating model, and triage is the ongoing work the rollout puts in place. A team that runs triage without the rollout discipline absorbs scanner noise at fleet scale before the calibration is ready.
How is this different from the security tool consolidation workflow?
Security tool consolidation is the programme of work that rationalises an overlapping tool portfolio: which scanners cover which capabilities, where overlapping tools can be retired, and how the consolidated stack covers the eventual coverage map. Scanner onboarding and coverage rollout is the workflow for bringing a single named scanner online from pilot through steady state. Consolidation sets the destination; rollout delivers the path from procurement to operational use. A consolidation decision frequently produces multiple rollout workflows in sequence (decommission the retired tool, onboard the replacement tool) and the rollout workflow is the discipline that prevents either side of that transition from creating an audit gap.
How is this different from the vulnerability management programme onboarding workflow?
Vulnerability management programme onboarding is the wider programme-level workflow that brings a vulnerability management capability into a workspace for the first time: governance, scope, ownership, SLA policy, exception register, and the overall operating cadence. Scanner onboarding and coverage rollout is the per-scanner workflow that operates inside an existing vulnerability management programme. A team that already runs a vulnerability management programme typically runs scanner onboarding workflows multiple times across the programme lifecycle (adding a new SAST tool, adding a new authenticated DAST tool, adding a new KSPM tool, replacing an external scanner).
Does SecPortal support every scanner an enterprise programme will ever adopt natively?
SecPortal includes native scanning across three surfaces: external scanning across 16 modules (TLS configuration, security headers, exposed ports, technology fingerprinting, subdomain enumeration, DNS misconfiguration, mail authentication, and more), authenticated DAST scanning across 17 modules under stored encrypted credentials, and code scanning via Semgrep SAST plus dependency analysis against connected repositories (GitHub, GitLab, or Bitbucket OAuth). For scanners outside those native surfaces (commercial SAST suites, commercial SCA tools, KSPM tools, CSPM tools, container image scanners, secrets scanners, third-party DAST scanners, and other vendor tools), bulk finding import maps the source CSV columns onto the workspace finding fields and saves the mapping as a reusable template so the rollout workflow operates uniformly across native and imported scanners.
How does the workflow handle a scanner that runs continuously rather than on a fixed cadence?
For scanners that run continuously (a SAST scanner that triggers on every commit, a continuous monitoring scanner that runs against the external surface on a daily or weekly cadence, a code-scanning pipeline that runs on every pull request), the rollout phases still apply: pilot scope is the named perimeter the continuous scanner is allowed to run against during the pilot, expanded pilot adds the next perimeter, fleet rollout extends to the full coverage map. The continuous monitoring feature surface holds the cadence and the workspace activity log captures every detection. The rollout discipline does not change because the scan frequency changes; the discipline is about how the coverage perimeter expands rather than how often the scanner runs.
What happens to the open findings produced by a scanner that the programme sunsets?
The sunset phase carries a documented disposition path for every open finding produced exclusively by the sunsetting scanner. Findings that the replacement tool will reproduce migrate by re-import on the replacement scanner. Findings the replacement tool will not reproduce close with a documented rationale and a named approver on the override. Findings the programme has decided to accept with a documented expiry move onto the exception register and inherit the override workflow. The activity-log export filed against the sunset engagement carries the chronology so the historical record stays defensible after the scanner is decommissioned.
How does SecPortal support the per-phase approver discipline the workflow expects?
The engagement record carries the named owner, the named pilot owner, the named platform contact, and the named approver per phase. Team management with role-based access ensures the named approvers have the engagement access required to act. The activity log captures the phase-gate decisions with the named approver, the timestamp, and the rationale. Notifications surface approaching phase-gate dates and the in-app bell delivers the phase-gate context to the named approver. The discipline is the engagement record holding the approver decisions as structured state events rather than as messages in a chat thread.
Does the workflow apply to a regulator-mandated scanner the team did not choose?
Yes, and arguably more so. A regulator-mandated scanner (a PCI DSS approved scanning vendor for external quarterly scans, a sector-specific mandated scanner, an external assessor running a pre-defined scanner pack) often arrives with even less calibration latitude than an internally chosen scanner. The rollout workflow still applies: the engagement names the scanner and the regulator citation, the pilot scope is the in-scope perimeter the regulation requires, the calibration captures the mandated severity treatment, the owner routing is documented, and the activity log carries the chronology the regulator-facing audit reads against. The discipline is more important when the scanner is non-negotiable because the audit trail is the only thing the team controls.
How does the workflow interact with existing engagement records the scanner overlaps?
A new scanner often overlaps with existing engagement records: a new SAST tool overlaps with existing code-review engagements, a new external scanner overlaps with existing external assessments, a new authenticated DAST scanner overlaps with existing authenticated assessments. The rollout workflow documents the overlap on the engagement record and the dedup rules collapse duplicate findings across the overlapping engagements onto one primary record. Cross-engagement finding search surfaces the overlap candidates so the dedup pass operates against ground truth rather than against a sampled subset. The audit lookback reads one closure narrative per underlying finding rather than parallel narratives across the overlapping engagements.
What metrics does the quarterly operating review for a steady-state scanner read against?
The quarterly review reads against the operating signals on the engagement record: signal-to-noise ratio trend, false-positive rate per rule class, coverage drift against the documented perimeter, mean time-to-acknowledge for new findings, mean time-to-close per severity, exception register churn (new acceptances, renewals, lapses), rule-pack update cadence, and the activity-log entries since the prior review. The AI report surface drafts the quarterly review pack from the live record so the rotation lead does not assemble the pack from screenshots. The review writes decisions back to the engagement: rule packs to enable or disable, severity calibration adjustments, owner routing changes, scope expansions or reductions, and the rollback or sunset decision if the scanner is no longer delivering against expectations.
Can the workflow run against a scanner that lives in another team and only forwards exports to security?
Yes. A common pattern is a scanner that lives in the engineering team (a SAST tool the engineering team owns, a dependency scanner that runs in the CI pipeline) and only forwards exports to the security team for triage. The rollout workflow still applies: the engagement record names the upstream owner, the scanner, the export cadence, the in-scope perimeter, and the security-team-side calibration. Bulk finding import maps the export onto the workspace finding fields. The discipline is about the security-side operating record rather than about who owns the scanner; the engagement record holds the security-side rollout regardless of where the scanner runs.
How long should a typical scanner onboarding take from pilot to steady state?
A typical onboarding takes between three and six months from pilot start to steady state: two to six weeks of pilot, two to four weeks per expanded pilot increment (one or two increments), four to twelve weeks of fleet rollout, and one full quarterly operating review against the steady-state metrics before the workflow closes. Faster paths are possible for scanners that overlap heavily with existing native surfaces or that ship with calibration the workspace can adopt without modification. Slower paths are typical for scanners that require new credential vault entries, new asset-binding patterns, new owner-routing rules, or new framework citations. The duration is documented on the engagement so the next rollout uses the prior duration as a baseline rather than as a wall-clock surprise.
Does the workflow apply to scanner rule-pack updates that materially change the false-positive rate?
Yes, with a lighter touch than a full rollout. A material rule-pack update on a steady-state scanner triggers a documented change event on the engagement: the new rule-pack version, the false-positive diff against the prior pack, the calibration adjustments, the rule overrides the programme is enabling or disabling, and the named approver. The change is not a new rollout because the scanner already operates under a documented operating model. The activity log captures the change so the audit lookback reads the calibration provenance as continuous from the original rollout through the rule-pack update.
How it works in SecPortal
A streamlined workflow from start to finish.
Open a scanner-onboarding engagement scoped to the named scanner, pilot perimeter, and rollout phases
The engagement record opens against the named scanner (a SAST tool such as Semgrep, an SCA tool, an authenticated DAST scanner, an external attack-surface scanner, a CSPM rule pack, a KSPM tool, a container image scanner, a secrets scanner, or a third-party vulnerability scanner whose CSV the workspace will ingest). The engagement carries the named programme owner, the named pilot owner, the named platform contact, the rollout phase plan (pilot, expanded pilot, fleet rollout, steady state, sunset), the documented coverage scope per phase, the success criteria per phase, the documented exit criteria, and the framework references the rollout will operate against (ISO 27001 A.8.8, SOC 2 CC7.1, PCI DSS 11.3, NIST SP 800-53 RA-5, NIST CSF 2.0 DE.CM, DORA Article 9, NIS2 Article 21). The engagement record is the boundary every rollout decision lands on.
Run the pilot scope with explicit success criteria, time-bounded coverage, and a documented rollback condition
The pilot scope is a deliberate subset of the eventual coverage: a single application, a single repository, a single cluster, a single business unit, or a single asset tier. The pilot runs for a documented period (typically two to six weeks) with success criteria the programme can read against: signal-to-noise ratio, false-positive rate against a manually validated sample, time-to-first-actionable-finding, coverage of the in-scope surface against the expected attack surface, and operator burden per finding triaged. The rollback condition is documented at pilot start so a scanner that does not meet criteria does not silently expand beyond the pilot. The pilot record holds the cadence, the calibration changes, the rule-pack version, and the encrypted credential references in the workspace credential vault if the scanner runs authenticated.
Calibrate severity, asset binding, and dedup rules against the workspace policy before fleet rollout
A new scanner ships with a vendor severity scale that rarely matches the workspace severity policy without calibration. The calibration step writes the mapping as a structured record on the engagement: source severity to workspace severity by rule class, CVSS 3.1 vector capture where the scanner provides one, asset binding from scanner output fields to workspace asset identifiers, CWE or category mapping where the scanner ships its own taxonomy, and the deduplication rules that prevent the new scanner from minting parallel records against findings the existing catalogue already holds. The calibration lands as a versioned configuration on the engagement so the audit lookback reads the calibration with provenance rather than the unsourced default.
Define the owner routing, exception register filter, and SLA assignment per finding class produced by the scanner
Before fleet rollout, each finding class the scanner produces gets a named owner archetype, a routing rule, an SLA mapping, and an exception register check. The owner routing reads against the asset binding so the named individual on the asset record inherits the finding without a manual handoff. The exception register filter blocks scanner findings that match an active acceptance, deferral, or false-positive suppression from re-opening parallel records every scan cycle. The SLA assignment ties the calibrated severity to the workspace SLA policy so the breach calculation starts from a normalised severity rather than the vendor default.
Expand the coverage phase by phase against documented criteria, not by tool-team availability
Fleet rollout proceeds in documented phases (expanded pilot to a second business unit, expanded coverage to additional repositories or clusters, scope expansion to additional asset tiers) with the same success criteria and rollback conditions the pilot used. Each phase records the in-scope perimeter, the new false-positive sample, the calibration adjustments, the owner-routing adjustments, and the exception register diff against the prior phase. The phase gates prevent the scanner from being silently expanded to fleet scope because nobody owned the next phase decision, and they prevent the programme from absorbing scanner noise across an unbounded perimeter before the discipline is in place.
Bind the scanner output to the workspace evidence trail and to the framework-citation grid
Once the scanner is producing operationally useful findings, the engagement record ties scanner output to the framework references the audit cycle reads against. The bulk finding import path or the scanner-native import preserves the source attribution (the scanner name, the rule reference, the rule-pack version, the scan ID, the scan timestamp) so the audit lookback reads the finding back to the scanner that produced it. Compliance tracking captures the framework citations the scanner output covers (vulnerability identification under ISO 27001 A.8.8, monitoring under SOC 2 CC7.1, external scan cadence under PCI DSS 11.3, vulnerability monitoring under NIST RA-5, continuous monitoring under NIST CSF DE.CM) so the GRC team assembles the evidence pack from the live workspace record.
Move the scanner to steady-state operation with a documented operating cadence and quarterly review
Steady-state operation tracks the scanner against the original success criteria plus the operating metrics the programme reads against: signal-to-noise ratio over the last quarter, false-positive rate per rule class, coverage drift against the documented attack surface, mean time-to-acknowledge a new finding, mean time-to-close per severity, exception register churn, and rule-pack update cadence. The quarterly operating review writes the decisions back to the engagement: rule packs to enable or disable, severity calibration adjustments, owner routing changes, scope expansions, scope reductions, and the rollback or sunset decision if the scanner is no longer delivering against expectations. The retest workflow verifies that the scanner closure path works as intended (a finding closed by remediation is confirmed by a follow-up scan rather than by a comment).
Carry the rollout audit trail through scanner version upgrades, rule-pack changes, and eventual sunset
A scanner that is on the workspace forever drifts. Rule packs update and shift the false-positive rate; vendor severity scales change and shift the calibration; the scanner surface shifts as new modules ship. Each material change lands as a structured event on the engagement: the rule-pack version, the calibration adjustment, the false-positive diff against the prior cycle, and the named approver of the change. When the programme decides to sunset the scanner (consolidating with another tool, retiring an unused capability, or replacing with a better alternative), the engagement carries the sunset record: the named decision date, the named approver, the open-finding migration path to the replacement tool, the closure of open findings produced exclusively by the sunsetting scanner, and the audit-trail export. The activity-log CSV captures the chronology from pilot day one through sunset.
Features that power this workflow
Orchestrate every security engagement from start to finish
Vulnerability management software that tracks every finding
Bulk finding import bring your scanner data with you
Vulnerability scanning tools that map your attack surface
Test web apps behind the login
Find vulnerabilities before they ship
Monitor continuously catch regressions early
Encrypted credential storage for authenticated scans
Finding overrides that survive every scan cycle
Verify fixes and track reopens on the same finding record
Scan-to-scan diff see what changed between any two executions
Every action recorded across the workspace
Collaborate across your entire team
Compliance tracking without a full GRC platform
AI-powered reports in seconds, not days
Notifications and alerts for the people who carry the work
Roll a new scanner out on the workspace, not in a spreadsheet
Pilot scope, phased coverage, calibrated severity, owner routing, exception register filter, and audit-trail export on one engagement record from day one through steady state. Free plan available.
No credit card required. Free plan available forever.