rul1an/Assay - AI Agent Security

Policy-as-code CI gate for AI agents: verify evidence bundles, run compliance packs, and publish SARIF to GitHub Security.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
namedescriptionrequireddefault
bundlesGlob pattern for evidence bundlesno""
fail_onFail threshold: error, warn, info, nonenoerror
sarifUpload SARIF to GitHub Security tabnotrue
categorySARIF category (auto-generated if omitted)no""
baseline_dirPath to baseline bundles for diffno""
baseline_keyKey for baseline cache lookupno""
write_baselineWrite baseline after successful run (main branch only)nofalse
comment_diffPost PR comment with diff summarynotrue
upload_artifactsDeprecated. Use reports_dir output instead.nofalse
versionAssay CLI version to installnolatest
packCompliance pack(s) to apply (comma-separated). Examples: eu-ai-act-baseline, soc2-baseline, ./custom.yaml no""
storeBYOS store URL for evidence push. Examples: s3://bucket/prefix, az://container, gs://bucket Requires OIDC trust relationship configured. no""
store_providerCloud provider for OIDC authentication. Options: aws, gcp, azure, auto (detect from URL) noauto
store_roleIAM role/identity for OIDC authentication. AWS: arn:aws:iam::ACCOUNT:role/ROLE GCP: projects/PROJECT/locations/global/workloadIdentityPools/POOL/providers/PROVIDER no""
store_regionAWS region (AWS only)nous-east-1
azure_client_idAzure App Registration client ID (required for azure)no""
azure_tenant_idAzure AD tenant ID (required for azure)no""
azure_subscription_idAzure subscription ID (required for azure)no""
attestGenerate SLSA-aligned artifact attestation for evidence bundles. Requires permissions: attestations: write, id-token: write Only runs on push to default branch. nofalse
badge_gistGist ID for dynamic coverage badge. Only runs on push to default branch. no""
badge_tokenGitHub PAT for badge gist update. Requires gist scope. Pass via secrets.GIST_TOKEN. Only used when badge_gist is set. no""
sandbox-commandOptional. A command to run under `assay sandbox` (Landlock) so the action records the coding agent's observed effects as an evidence bundle and verifies/lints it. Requires a Linux runner. Empty disables the step. no""
attest-keyOptional. Ed25519 private key (PKCS#8 PEM) used to sign the evidence bundle's manifest as an in-toto/DSSE attestation via `assay evidence attest`. Pass via a secret. Empty disables the step. no""
namedescription
verifiedtrue if all bundles passed verification
findings_errorCount of error-level findings
findings_warnCount of warning-level findings
sarif_pathPath to generated SARIF file
sarif_uploadedtrue if SARIF was successfully uploaded to Code Scanning
diff_summaryOne-line diff summary
diff_new_findingsCount of new findings vs baseline
reports_dirPath to reports directory (for artifact upload)
pack_appliedComma-separated list of applied pack IDs
resolved_pack_refsResolved pack references as name@version list
pack_scoreCompliance score (0-100) across all packs
pack_articlesComma-separated list of covered articles (e.g., "12(1),12(2)(a)")
pack_statusCompliance pack status: disabled, success, missing_pack, invalid_pack, runtime_error
pack_error_kindPack error category when pack_status is not success
bundle_urlURL of pushed evidence bundle in BYOS (if store set)
attestation_idArtifact attestation UUID (if attest=true)
attestation_urlURL to view attestation in GitHub UI (if attest=true)
attestation_bundle_pathLocal path to Sigstore bundle file
coverage_percentEvidence coverage percentage (tools with policy / total tools)
attestation_envelopeLocal path to the in-toto/DSSE attestation envelope (if attest-key set)