Scan lifecycle and release decision
Understand how an artifact becomes scan evidence and a policy-aware CI decision.
After deployment and first-time setup, every JustScan workflow follows the same decision path: identify an artifact, submit it to a configured scanner provider, collect evidence, evaluate organization policy, and expose the terminal outcome to people or automation.
Lifecycle states
- Submission: the application, CLI, or API accepts a registry image, local image archive, Helm-derived image, or GitOps-discovered image.
- Analysis: JustScan pulls or receives the artifact and uses the selected provider. Scan step details reveal whether work is queued, active, waiting on Xray, importing results, or needs attention.
- Evidence: completed scans expose findings, package details, available SBOM data, policy context, comments, and comparisons.
- Verdict: organization policy evaluates the completed evidence. A policy failure is distinct from an operational or scan-execution error.
The verdict is immutable scan-time evidence. Later CVE Intelligence updates can produce a separate current policy projection for an authorized completed scan, but they never rewrite the original finding, compliance result, compliance history, or scan status. A rejected or not-affected CVE can resolve the current projection, while disputed, unknown, incomplete, or conflicting intelligence conservatively holds the failure as needs validation. Review the Scan Details banner and run a confirming rescan before treating any current projection as authoritative.
Choose the source deliberately
Use a registry image when JustScan can authenticate to the registry; use CLI local-image or archive mode for unpublished build outputs; use Helm for rendered chart workloads; and use GitOps discovery for continuously managed deployment repositories. See scan sources for the selection table.
For CI, make the terminal verdict the gate. The CLI returns 0 for pass, 1 for policy failure, and 2 for an operational error. Do not configure a fallback that turns errors into a release pass.