Installing Verdict

Install ObsidianWall Verdict, verify the installation, and run your first command.

Verdict is the pre-deployment governance decision engine for ObsidianWall. It evaluates infrastructure plans against governance policies before deployment executes.

Requirements

  • Python 3.11 or higher
  • pip

Install

pip install obsidianwall-verdict

Verify

verdict --version

Available Commands

verdict --help
evaluate    Evaluate an infrastructure plan against a policy
coverage    Map policy conditions to a compliance framework
simulate    Test a policy without a real infrastructure plan
sentinel    Post-deployment reality verification
validate    Validate a policy file against the schema
test        Assert a plan produces an expected decision
audit       Governance history and insights

Supported Plan Formats

Terraform plan JSON       terraform show -json tfplan > plan.json
CloudFormation JSON       pass template directly
CloudFormation YAML       pass template directly

Format is auto-detected. No --format flag required.

GitHub Action

- name: ObsidianWall Verdict
  uses: ObsidianWall/obsidianwall-verdict@v0.5.0
  with:
    plan:         terraform_plan.json
    policy:       policies/cost/budget.yaml
    role:         engineer
    fail_on_deny: "true"

Continue to the Quickstart Guide