JustScan Documentation
Scan and analyze

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.

CI build submits to JustScan, which analyzes with Trivy, Grype, or Xray, evaluates policy, and returns either continue or stop and review

Lifecycle states

  1. Submission: the application, CLI, or API accepts a registry image, local image archive, Helm-derived image, or GitOps-discovered image.
  2. 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.
  3. Evidence: completed scans expose findings, package details, available SBOM data, policy context, comments, and comparisons.
  4. 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.

On this page