Skip to content

feat(plugins): add GateProve safety boundary & hash-chained action ledger plugin - #3410

Open
AAH20 wants to merge 1 commit into
apache:masterfrom
AAH20:feat/gate-prove-safety-plugin
Open

feat(plugins): add GateProve safety boundary & hash-chained action ledger plugin#3410
AAH20 wants to merge 1 commit into
apache:masterfrom
AAH20:feat/gate-prove-safety-plugin

Conversation

@AAH20

@AAH20 AAH20 commented Aug 17, 2026

Copy link
Copy Markdown

Summary

Adds gate_prove, a native safety boundary and hash-chained Action Ledger plugin for MITRE Caldera operations.

Problem Solved

When running automated adversary emulation against enterprise or staging infrastructure, executing high-blast abilities (such as T1562 Impair Defenses, T1070 Indicator Removal, or T1485 Data Destruction) without strict safety controls creates acute operational risk and potential production downtime.

This plugin introduces a zero-trust safety boundary:

  1. never_equate_intent_to_approval: true: High planner confidence or automated execution does not authorize destructive techniques.
  2. Simulation Fallback: Unapproved destructive abilities automatically default to safe simulation mode without mutating underlying systems.
  3. HITL Prove Token: Destructive execution requires an authorized cryptographic token (CALDERA_PROVE_TOKEN).
  4. Append-Only Action Ledger: Every ability evaluation, receipt, and hash is recorded into an append-only JSONL ledger with SHA-256 chain verification for audit compliance (SOC 2, ISO 27001, NIST CSF).
  5. Atomic Kill-Switch: Immediate freeze of operation ability dispatch via environment variable (CALDERA_KILL_SWITCH=1) or file sentinel (artifacts/KILL).

Testing & Validation

  • Added plugins/gate_prove/tests/test_gate_prove.py verifying safe ability allowance, destructive technique simulation, HITL prove token validation, and SHA-256 ledger hash-chain integrity (all unit tests passing).

Upstream & Production Context

Maintained by A2Z SOC for safe purple-team adversary emulation, Cyber Risk Quantification (CRQ), and SOC 2 Type II audit readiness.

For teams deploying adversary emulation requiring safety audits or purple team sprints:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant