How microsoft/moodle-auth_oidc works
This Moodle authentication plugin provides configurable OpenID Connect single sign-on. Users enter through Moodle’s login integration or the plugin landing page, are redirected to an identity provider, and return through the authorization-code flow for token validation and Moodle account matching or creation. Separate settings and account-management surfaces configure providers and handle linking or disconnection; privacy, events, and scheduled cleanup support the lifecycle. The workflow edges reflect excerpts and README documentation; unsampled subsystem connections are omitted where their callers are not shown.
Main entry points: settings.php Provider settings · authcode.php Authorization code flow · oidcclient.php OIDC client · auth.php Auth entry points
Components 25
Configuration
- Provider settings
settings.php - Application form
classes/form/application.php - Endpoint validation
classes/adminsetting/auth_oidc_admin_setting_endpoint.php - Login flow setting
classes/adminsetting/auth_oidc_admin_setting_loginflow.php - Redirect URI setting
classes/adminsetting/auth_oidc_admin_setting_redirecturi.php - Provider icon setting
classes/adminsetting/auth_oidc_admin_setting_iconselect.php
Authentication
- Auth entry points
auth.php - OIDC landing
index.php - Authorization code flow
classes/loginflow/authcode.php - Login flow base
classes/loginflow/base.php - OIDC client
classes/oidcclient.php - HTTP client
classes/httpclient.php - JWT handling
classes/jwt.php
Account lifecycle
- Account management forms
classes/form/disconnect.php - Claim binding tool
change_binding_username_claim_tool.php - Application management
manageapplication.php
Lifecycle support
- Privacy provider
classes/privacy/provider.php - Authentication events
classes/event/user_created.php - Event observers
classes/observers.php - Scheduled cleanup
classes/task/cleanup_oidc_state_and_token.php - Session cleanup
classes/task/cleanup_oidc_sid.php - OIDC token records
Other components
- Moodle user
- OIDC provider
- Site administrator
Connections 22
- Moodle user → Auth entry points: starts login
- Auth entry points → Login flow base: selects flow
- OIDC landing → Authorization code flow: handles redirect
index.php - Authorization code flow → OIDC client: requests authorization
classes/loginflow/authcode.php - OIDC client → OIDC provider: authorization exchange
- OIDC client → HTTP client: uses HTTP
- Authorization code flow → JWT handling: validates tokens
- Authorization code flow → Moodle user: completes login
classes/loginflow/authcode.php - Authorization code flow → Authentication events: fires events
classes/loginflow/authcode.php - Site administrator → Provider settings: configures
- Provider settings → Endpoint validation: registers setting
settings.php - Provider settings → Login flow setting: registers setting
settings.php - Provider settings → Redirect URI setting: registers setting
settings.php - Provider settings → Provider icon setting: registers setting
settings.php - Site administrator → Application form: edits provider
- Moodle user → Account management forms: manages connection
- Moodle user → Claim binding tool: updates claim binding
- Site administrator → Application management: manages application
- Privacy provider → OIDC token records: handles personal data
- Event observers → Authentication events: observes events
- Scheduled cleanup → OIDC token records: cleans records
- Session cleanup → OIDC token records: cleans sessions