How zubir2k/cloudflare-oidc-broker works
Cloudflare OIDC Broker federates configured upstream identity providers and issues broker-controlled identities to downstream applications. The principal flow validates a client, stores short-lived authorization state, redirects to an upstream provider, checks the returned identity against per-client mappings and policy, then issues a broker code and signed tokens. D1 holds clients and mappings; KV holds ephemeral state. The Worker also exposes discovery, userinfo, revocation, logout, and administration. Relationships for unsampled endpoint logic are limited to those documented in the README; provider modules are grouped by their shared registry.
Main entry points: src/index.ts OIDC Worker · registry.ts Provider registry · providers/index.ts Provider loading · google.ts Google provider
Components 24
OIDC broker
- OIDC Worker
src/index.ts - D1 registry and mappings
- KV session state
- OIDC discovery and JWKS
src/utils/oidc.ts - Authorization form response
src/views/formPost.ts - Access denied page
src/views/errorPage.ts
Provider federation
- Provider loading
src/providers/index.ts - Provider registry
src/providers/registry.ts - Google provider
src/providers/google.ts - GitHub provider
src/providers/github.ts - Microsoft provider
src/providers/microsoft.ts - Apple provider
src/providers/apple.ts - Discord provider
src/providers/discord.ts - MyDigital ID provider
src/providers/mydigitalid.ts
Identity security
- Client credentials
src/utils/clientAuth.ts - PKCE verification
src/utils/pkce.ts - Isolated subject IDs
src/utils/subHash.ts - Broker token signing
src/utils/jwt.ts - Admin access check
src/utils/access.ts - Issuer origin
src/utils/origin.ts
Administration
- Admin console
src/views/adminConsole.ts
Other components
- User
- Downstream application
- Upstream identity providers
Connections 35
- User → Downstream application: starts login
README.md - Downstream application → OIDC Worker: requests authorization
README.md - OIDC Worker → D1 registry and mappings: checks client and policy
README.md - OIDC Worker → KV session state: stores transaction state
README.md - OIDC Worker → Provider loading: selects provider
src/index.ts - Provider loading → Provider registry: exports lookup
src/providers/index.ts - Provider registry → Google provider: creates provider
src/providers/google.ts - Provider registry → GitHub provider: creates provider
src/providers/github.ts - Provider registry → Microsoft provider: creates provider
src/providers/microsoft.ts - Provider registry → Apple provider: creates provider
src/providers/apple.ts - Provider registry → Discord provider: creates provider
src/providers/discord.ts - Provider registry → MyDigital ID provider: creates provider
src/providers/mydigitalid.ts - Google provider → Upstream identity providers: authenticates upstream
- GitHub provider → Upstream identity providers: authenticates upstream
- Microsoft provider → Upstream identity providers: authenticates upstream
- Apple provider → Upstream identity providers: authenticates upstream
src/providers/apple.ts - Discord provider → Upstream identity providers: authenticates upstream
- MyDigital ID provider → Upstream identity providers: exchanges code
src/providers/mydigitalid.ts - Upstream identity providers → OIDC Worker: returns callback
README.md - OIDC Worker → D1 registry and mappings: checks user mapping
README.md - OIDC Worker → KV session state: stores broker code
README.md - OIDC Worker → Downstream application: returns broker code
README.md - Downstream application → OIDC Worker: exchanges code
README.md - OIDC Worker → PKCE verification: verifies challenge
src/index.ts - OIDC Worker → Client credentials: parses credentials
src/index.ts - OIDC Worker → Isolated subject IDs: derives subject
src/index.ts - OIDC Worker → Broker token signing: mints ID token
src/index.ts - OIDC Worker → Downstream application: returns signed tokens
README.md - OIDC Worker → OIDC discovery and JWKS: serves discovery and keys
src/index.ts - OIDC Worker → Issuer origin: resolves issuer
src/index.ts - OIDC Worker → Access denied page: renders denied response
src/index.ts - OIDC Worker → Authorization form response: renders form response
src/index.ts - OIDC Worker → Admin console: renders console
src/index.ts - OIDC Worker → Admin access check: verifies admin access
src/index.ts - Admin console → OIDC Worker: calls admin operations
README.md