How oca/server-auth works
server-auth is a collection of Odoo authentication and user-access addons, not one application. Users enter through distinct login, API-request, and administration flows; the addons provide passwordless/admin access, API-key and federated login, session controls, and cross-instance access. SAML’s shown flow routes a browser response through a controller, validates and signs in through the user model, and uses provider configuration and outstanding-request records. Other addon internals are represented from the README and source index; their unsampled wiring is not asserted.
Main entry points: controllers/main.py SAML routes · auth_saml_provider.py SAML provider · res_users.py SAML sign-in · controllers/main.py OIDC login
Components 23
Federated Login
- SAML routes
auth_saml/controllers/main.py - SAML provider
auth_saml/models/auth_saml_provider.py - SAML sign-in
auth_saml/models/res_users.py - Attribute mapping
auth_saml/models/auth_saml_attribute_mapping.py - Outstanding requests
auth_saml/wizards/auth_saml_request.py - OIDC login
auth_oidc/controllers/main.py - OIDC provider
auth_oidc/models/auth_oauth_provider.py - OAuth sessions
auth_oauth_multi_token/models/auth_oauth_multi_token.py
Credentials & Identity
- Admin passkey
auth_admin_passkey/models/res_users.py - API authentication
auth_api_key/models/ir_http.py - API keys
auth_api_key/models/auth_api_key.py - API key settings
auth_api_key/models/res_config_settings.py - API key groups
auth_api_key_group/models/auth_api_key_group.py - Case-insensitive login
auth_user_case_insensitive/models/res_users.py
Access Controls
- Session timeout
auth_session_timeout/models/ir_http.py - Impersonation
impersonate_login/models/res_users.py - User menu
impersonate_login/static/src/js/user_menu.esm.js - Impersonation log
impersonate_login/models/impersonate_log.py
Remote Access
- Cross-connect route
cross_connect_client/controllers/cross_connect.py - Server integration
cross_connect_client/models/cross_connect_server.py - Remote groups
cross_connect_client/models/res_groups.py
User Activity
- User action log
user_log_view/__manifest__.py
Other components
- Odoo user
Connections 22
- Odoo user → SAML routes: starts login
- SAML routes → SAML provider: requests auth
auth_saml/controllers/main.py - SAML routes → SAML sign-in: authenticates response
auth_saml/controllers/main.py - SAML provider → Outstanding requests: records request
auth_saml/models/auth_saml_provider.py - SAML sign-in → SAML provider: validates identity
- Odoo user → OIDC login: starts login
- OIDC login → OIDC provider: builds auth link
auth_oidc/controllers/main.py - Odoo user → OAuth sessions: keeps sessions
- Odoo user → Admin passkey: authenticates as account
- Odoo user → API authentication: sends API request
- API authentication → API keys: checks key
- Odoo user → API key settings: configures keys
- API key groups → API keys: groups keys
auth_api_key_group/models/auth_api_key_group.py - Odoo user → Case-insensitive login: logs in
- Odoo user → Session timeout: uses session
- Odoo user → User menu: requests impersonation
- User menu → Impersonation: initiates action
- Impersonation → Impersonation log: records activity
- Odoo user → Cross-connect route: opens remote app
- Cross-connect route → Server integration: requests access
- Server integration → Remote groups: syncs groups
cross_connect_client/models/cross_connect_server.py - Odoo user → User action log: views actions