How sollutionsit/agentgate works
AgentGate is a zero-trust gateway for agent-to-agent requests. Agents call its API with a signed JWT and capability request; the gateway authenticates identity, applies rate limits, evaluates policy or a delegation, checks replay protection for sensitive actions, then returns a decision or forwards an allowed request to a fixed registered target. Delegation creation and validation are distinct authorization stages. Audit events and Prometheus metrics provide operational visibility; Redis stores quotas, nonces and grants. The README documents the local policy-regression and security labs, but their internal wiring is not fully shown.
Main entry points: gateway.py Gateway service · routes.py HTTP routes · main.py App assembly · engine.py Authorization engine
Components 26
API and Runtime
- HTTP routes
src/agentgate/api/routes.py - Request dependencies
src/agentgate/api/dependencies.py - Body limit
src/agentgate/api/middleware.py - App assembly
src/agentgate/main.py - Gateway service
src/agentgate/services/gateway.py - Runtime settings
src/agentgate/config.py
Identity and Security
- Agent identity
src/agentgate/auth/identity.py - JWT verifier
src/agentgate/auth/jwt.py - Rate limiter
src/agentgate/security/rate_limit.py - Replay guard
src/agentgate/security/replay.py - Delegation grants
src/agentgate/security/delegation.py
Authorization
- Authorization engine
src/agentgate/authorization/engine.py - Capability registry
src/agentgate/authorization/models.py - Request models
src/agentgate/domain/requests.py - Decision models
src/agentgate/domain/decisions.py - OPA client
src/agentgate/policy/client.py - Rego rules
policies/agentgate.rego
State and Observability
- Redis security state
- Audit logger
src/agentgate/audit/logger.py - Prometheus metrics
src/agentgate/telemetry/metrics.py
Policy and Lab Tools
- AgentGate CLI
src/agentgate/cli.py - Policy regression
src/agentgate/policy/loader.py - Security lab
src/agentgate/lab.py
Other components
- Calling agent
- Registered workloads
- OPA policy service
Connections 29
- Calling agent → HTTP routes: sends requests
README.md - App assembly → HTTP routes: registers routes
src/agentgate/main.py - App assembly → Body limit: adds middleware
src/agentgate/main.py - HTTP routes → Gateway service: invokes services
src/agentgate/api/routes.py - HTTP routes → Request dependencies: uses dependencies
src/agentgate/api/routes.py - Request dependencies → Gateway service: provides service
src/agentgate/api/dependencies.py - App assembly → Gateway service: assembles
src/agentgate/main.py - App assembly → Runtime settings: loads settings
src/agentgate/main.py - Gateway service → JWT verifier: verifies tokens
src/agentgate/services/gateway.py - JWT verifier → Agent identity: creates identity
src/agentgate/auth/jwt.py - Gateway service → Rate limiter: checks quota
src/agentgate/services/gateway.py - Gateway service → Authorization engine: evaluates access
src/agentgate/services/gateway.py - Authorization engine → Capability registry: checks capability
src/agentgate/authorization/engine.py - Authorization engine → OPA client: evaluates policy
src/agentgate/authorization/engine.py - OPA client → OPA policy service: posts evaluation
src/agentgate/policy/client.py - OPA policy service → Rego rules: evaluates rules
README.md - Gateway service → Delegation grants: creates or validates
src/agentgate/services/gateway.py - Delegation grants → Authorization engine: checks grant policy
src/agentgate/security/delegation.py - Gateway service → Replay guard: consumes nonce
src/agentgate/services/gateway.py - Gateway service → Registered workloads: forwards allowed calls
src/agentgate/services/gateway.py - Gateway service → Redis security state: uses security state
README.md - Delegation grants → Redis security state: stores and reads grants
src/agentgate/security/delegation.py - Gateway service → Audit logger: records events
src/agentgate/services/gateway.py - Gateway service → Prometheus metrics: updates counters
src/agentgate/services/gateway.py - OPA client → Prometheus metrics: records latency
src/agentgate/policy/client.py - HTTP routes → Decision models: returns decisions
src/agentgate/api/routes.py - HTTP routes → Request models: accepts requests
src/agentgate/api/routes.py - AgentGate CLI → Policy regression: runs policy checks
src/agentgate/cli.py - Calling agent → AgentGate CLI: runs local lab
README.md