How zalando-incubator/agentic-identity-broker works
Agentic Identity Broker centralizes OAuth2 delegation, consent, token storage, and gateway-side token exchange for AI agents. A user manages grants and sessions in the web portal; the broker supports OAuth2 authorization and third-party sessions, while a separate Envoy external-processing service performs token exchange and authorization checks in gateway traffic. Other documented capabilities include agent administration, tool approvals, impersonation, and signing-key lifecycle. Connections among unsampled handlers and services are intentionally limited; dashed edges mark documented or plausible but unverified integration points.
Main entry points: App.tsx Portal routes · storage.go Storage contracts · server.go Token exchange server · handlers.go Handler wiring
Components 27
Consent portal
- Portal routes
web/src/App.tsx - Consent pages
web/src/pages/ConsentOverviewPage.tsx - Grant details
web/src/pages/AgentGrantDetailPage.tsx - Session management
web/src/pages/ThirdPartySessionsPage.tsx - Tool approvals
web/src/pages/ToolAuthorizationsPage.tsx - Portal API client
web/src/services/api/client.ts - Session API
web/src/services/api/sessions.ts
Broker API
- HTTP server
internal/adapters/http/server.go - Handler wiring
internal/app/handlers.go - Consent handlers
internal/adapters/http/handlers/consent/agent_detail_handler.go - Approval handlers
internal/adapters/http/handlers/approval/scope_preview_handler.go - Agent administration
internal/adapters/http/handlers/admin/agents_handler.go
Delegation and identity
- OAuth2 service
internal/domain/oauth2/service.go - OAuth2 sessions
internal/domain/oauth2session/service.go - Consent and grants
internal/domain/consent/service.go - Tool approval
internal/domain/approval/service.go - Impersonation
internal/domain/impersonation/service.go
Gateway processing
- Token exchange server
internal/extproc/server/server.go - Gateway authorization
internal/extproc/authorization/authorizer.go - Approval gate
internal/extproc/approval/gate.go
Persistence and security
- Storage contracts
internal/ports/storage.go - Approval repository
internal/adapters/storage/postgres/tool_approval_repository.go - Signing-key lifecycle
internal/domain/keylifecycle/engine.go - Audit telemetry
internal/adapters/telemetry/context_handler.go
Other components
- User
- OAuth2 providers
- Envoy gateway
Connections 23
- User → Portal routes: uses
README.md - Portal routes → Consent pages: routes to
web/src/App.tsx - Portal routes → Grant details: routes to
web/src/App.tsx - Portal routes → Session management: routes to
web/src/App.tsx - Portal routes → Tool approvals: routes to
web/src/App.tsx - Session management → Session API: loads sessions
- Session API → Portal API client: calls
web/src/services/api/sessions.ts - Envoy gateway → Token exchange server: dispatches requests
- Token exchange server → Gateway authorization: evaluates policy
internal/extproc/server/server.go - Token exchange server → Approval gate: checks approvals
internal/extproc/server/server.go - Token exchange server → OAuth2 service: exchanges tokens
- OAuth2 providers → OAuth2 sessions: OAuth callbacks
- Consent and grants → Storage contracts: uses repositories
internal/domain/consent/service.go - OAuth2 sessions → Storage contracts: stores sessions
internal/domain/oauth2session/service.go - Tool approval → Storage contracts: uses repositories
internal/domain/approval/service.go - Approval repository → Storage contracts: implements contracts
internal/adapters/storage/postgres/tool_approval_repository.go - Signing-key lifecycle → Storage contracts: persists keys
internal/domain/keylifecycle/engine.go - Handler wiring → Consent handlers: registers
internal/app/handlers.go - Handler wiring → Approval handlers: registers
internal/app/handlers.go - Consent handlers → Consent and grants: invokes
- Approval handlers → Tool approval: invokes
internal/adapters/http/handlers/approval/scope_preview_handler.go - HTTP server → Handler wiring: serves handlers
- HTTP server → Audit telemetry: logs requests