Security

Overview

AgentTrust implements defense-in-depth security: authentication, encryption at rest, audit integrity, PII detection, and tier-based authorization. This page summarizes security controls for operators and developers.

Why It Matters

AI governance systems handle sensitive agent inputs/outputs. Security misconfiguration can expose audit data or bypass policy enforcement.

Prerequisites

• Full edge gateway for production security features
• Enterprise tier for SSO and SOC2 export; Team tier for hash-chain verification

Step-by-Step Guide

Authentication

Critical: Set AUTH_ENABLED=true in all non-dev environments.

Authorization

• JWT contains tier claim — gateway enforces capability matrix
• Rate limiting: 70 req/min (60 + 10 burst) on /v1/runtime/validate, bucketed by the X-Agent-ID header; 20/min per IP on /v1/auth/* (see gateway/config/rate_limits.yaml)
• Team management via /v1/team/*

Encryption

Audit integrity

• Append-only ledger with content hashes
• Hash chain verification: GET /v1/audit/chain/verify (Team tier and above)
• Ledger hashes are permanent (required for integrity; not erasable)

PII handling

• Policy engine detects SSN, email, API keys, passwords
• PII fields masked in hot store within 24 hours
• Erasure endpoint: DELETE /v1/audit/executions/{id}/pii
• LLM judge receives truncated input/output only (never full payload)

Secret management

Kill-switch

export AGENTRUST_ENABLED=false

Instant rollback — all governance paths become no-ops.

Examples

Verify auth:

curl -H "X-AgentTrust-Token: $AGENTRUST_KEY" http://localhost:8000/v1/auth/check

Best Practices

• Never commit API keys or JWT secrets to version control
• Use secret managers (Vault, AWS Secrets Manager, K8s Secrets)
• Enable audit encryption in production
• Run AUTH_ENABLED=true always in production
• Complete AIIA for high-risk domains
• Follow Incident Response procedures

Common Mistakes

• AUTH_ENABLED=false in production
• Exposing gateway port 8000 without TLS/reverse proxy
• Storing production keys in .env files in git repos
• Using embedded gateway for regulated production data

Troubleshooting

Related Resources

• Data Governance
• Compliance
• Incident Response
• .github/SECURITY.md in the repository — vulnerability disclosure policy