How fief-dev/fief works
Fief is a users-and-authentication management service with separate authentication, administration UI, and administration API applications. The main user journey enters the authentication app for registration, sign-in, password recovery, or OAuth/token operations; account-management services support user changes and verification. Admins configure tenants, clients, access control, and customization through the dashboard or API. The tree documents further email, webhook, and background-task capabilities; their exact runtime wiring is not fully evidenced by the sampled source, so uncertain links are omitted.
Main entry points: routers Auth routes · auth/app.py Authentication app · fief/app.py ASGI application · user_manager.py User management
Components 20
Application entrypoints
- ASGI application
fief/app.py - Authentication app
fief/apps/auth/app.py - Admin dashboard
fief/apps/dashboard/app.py - Admin API
fief/apps/api/app.py
Identity workflows
- Auth routes
fief/apps/auth/routers - Registration flow
fief/services/registration_flow.py - Authentication flow
fief/services/authentication_flow.py - OAuth and tokens
fief/apps/auth/routers/oauth.py - User management
fief/services/user_manager.py - Token and crypto
fief/crypto
Administration
- Dashboard routes
fief/apps/dashboard/routers - Admin API routes
fief/apps/api/routers
Shared platform
- Webhook delivery
fief/services/webhooks - Email delivery
fief/services/email - Background tasks
fief/tasks - Data repositories
fief/repositories - SQL database
fief/db/engine.py
Other components
- End user
- Administrator
- Integrating app
Connections 20
- End user → Authentication app: uses
- Integrating app → Authentication app: integrates
- Administrator → Admin dashboard: manages
- Integrating app → Admin API: configures
- ASGI application → Authentication app: mounts
- ASGI application → Admin dashboard: mounts
- ASGI application → Admin API: mounts
- Authentication app → Auth routes: includes
- Admin dashboard → Dashboard routes: includes
- Admin API → Admin API routes: includes
- Auth routes → Registration flow: handles registration
- Auth routes → Authentication flow: handles sign-in
- Auth routes → OAuth and tokens: handles OAuth
- Auth routes → User management: handles accounts
- OAuth and tokens → Token and crypto: uses
- User management → Data repositories: reads and writes
- Data repositories → SQL database: persists
- User management → Background tasks: schedules notifications
- Background tasks → Email delivery: dispatches email
- Background tasks → Webhook delivery: dispatches delivery