Skip to main content

Authorize (Phase 2)

The Authorize phase defines what the agent is allowed to perform. Configure guardrails, policies, and behavioral rules to enforce governance.

Access via Agent Detail → Authorize tab.

Authorization Pipeline

Operations flow through three layers:

Incoming Operation


┌─────────────┐
│ Guardrails │ Input/output validation and transformation
└─────────────┘


┌─────────────┐
│ OPA Policy │ Stateless permission checks
└─────────────┘


┌─────────────┐
│ Behavioral │ Stateful multi-step pattern detection
│ Rules │
└─────────────┘


Governance Decision

Sub-tabs

The Authorize tab has three sub-tabs:

Guardrails

Pre/post-processing validation and transformation:

TypePurposeExamples
Input GuardrailsValidate/transform incoming dataPII detection, rate limiting
Output GuardrailsValidate/transform responsesPII redaction, format enforcement

Creating a Guardrail:

  1. Click Add Guardrail
  2. Select type (Input or Output)
  3. Configure trigger conditions
  4. Define action (Block, Transform, Log)
  5. Save and enable

Policies

OPA/Rego policies for stateless permission checks:

package openbox.agent.policy

default allow = false

allow {
input.operation.type == "read"
input.agent.trust_tier <= 2
}

allow {
input.operation.type == "write"
input.agent.trust_tier == 1
input.context.approved == true
}

Creating a Policy:

  1. Click Create Policy
  2. Opens the Policy Editor
  3. Write Rego code
  4. Test against sample inputs
  5. Save and attach to agent

Policy Context Available:

FieldDescription
input.agent.idAgent identifier
input.agent.trust_tierCurrent trust tier (1-5)
input.agent.trust_scoreCurrent trust score (0-100)
input.operation.typeOperation type (21 semantic types)
input.operation.targetTarget resource
input.contextSession and request context

Behavioral Rules

Stateful rules that detect multi-step patterns:

PatternExample
SequencePII access → External API call (without approval)
FrequencyMore than 10 failed auth attempts in 1 minute
CombinationDatabase write + File export + External send

Creating a Behavioral Rule:

  1. Click Add Rule
  2. Wizard opens with steps:
    • Trigger: What event starts tracking?
    • Conditions: What must happen?
    • Window: Time frame for pattern
    • Action: What happens on match?
  3. Test with sample session data
  4. Save and enable

Behavioral Rule Actions:

ActionDescription
ALLOWPermit and log
CONSTRAINApply additional limits
REQUIRE_APPROVALSend to HITL queue
DENY_ACTIONBlock the specific operation
TERMINATE_AGENTHalt the entire agent session

Governance Decisions

The authorization pipeline produces one of five decisions:

DecisionEffectTrust Impact
ALLOWOperation proceedsPositive (compliance)
CONSTRAINProceeds with limitsNeutral
REQUIRE_APPROVALPauses for HITLNeutral (pending)
DENY_ACTIONBlocks operationNegative
TERMINATE_AGENTHalts sessionSignificant negative

Trust Tier-Based Defaults

Lower trust tiers receive stricter defaults:

TierDefault Behavior
Tier 1Most operations allowed, logging only
Tier 2Standard policies enforced
Tier 3Enhanced checks, some HITL
Tier 4Strict controls, frequent HITL
UntrustedAll significant operations require approval

Next Phase

Once you've configured governance controls:

Monitor - Start your agent and observe its runtime behavior with Session Replay