Use Case

Turn preview deploys into security decision points.

Preview environments are where web, API, and AI behavior first becomes testable. ShakerScan uses that moment to produce a verifiable release decision.

Sample gate decision

needs_approval

Preview deploy needs review

The preview target introduced a new authenticated AI route. Policy requires approval before it can promote to production.

preview URL:https://pr-214.example.dev
branch:feature/ai-search
commit:9f31c2a
environment:preview
policy:release-strict
1

A PR, preview deploy, API target, or AI workflow is ready for review.

2

ShakerScan tests the real web, API, or AI behavior with a selected scan profile and policy.

3

Findings, transcripts, and runtime artifacts are normalized into evidence.

4

Policy returns allow, block, or needs_approval.

5

CI/CD verifies the signed evidence and either proceeds, blocks, or waits for an eligible scoped approval-token workflow.

Why ShakerScan

The output is a release control, not just a report.

ShakerScan is built around release evidence: a tested target, a policy result, a verifier command, and an approval path when risk needs human review.

Signed evidence

Evidence hashes and AI Gate attestations bind the decision to the target, environment, policy, probe pack, and release scope when signing is configured.

CI-verifiable decision

GitHub Actions or the shakerscan CLI can verify that the decision matches the expected repo, commit, branch, environment, target, policy, and evidence hash.

Approval workflow

When an eligible workflow is approved, scoped approval tokens record the reason, audience, expiry, and decision path instead of bypassing the gate silently.

Checklist

Preview gate checklist

Create stable preview URLs or expose target metadata to CI.

Run fast smoke gates on every PR and deeper gates on risky changes.

Store evidence and regression history per target.

Require approval tokens for exception paths.

Limitations

What this page does not claim

ShakerScan does not replace human security review, threat modeling, or a scoped penetration test.

AI Gate decisions depend on the configured target, probe pack, policy, scan profile, and available evidence.

Production targets require authorization, safe scope, rate limits, and operational approval.

FAQ

Is ShakerScan an AI pentesting replacement?

No. ShakerScan is a verifiable security gate for release workflows. It complements deeper manual testing by producing repeatable runtime evidence and CI-verifiable allow, block, or needs_approval decisions.

Can ShakerScan scan any target?

No. Targets must be owned by the customer or explicitly authorized. Production scans should use safe profiles, rate limits, and defined scope.