What problem does it solve?
SSO integration for ColdBox apps using the cbsso module and OAuth2/OpenID Connect, enabling users to authenticate with external providers while maintaining local user mappings.
Core Features & Use Cases
- OAuth2 / OpenID Connect based authentication with external providers (Google, Azure AD, Okta, GitHub, etc.)
- Provider configuration, including client IDs, secrets, and redirect URIs
- End-to-end login flow: redirect to provider, handle callback, map to local users, and establish sessions
- User provisioning and metadata syncing when new users authenticate via SSO
- UI integration: social login buttons and provider switcher for the login page
- Route and security best practices: CSRF protection, token validation, HTTPS redirects
Quick Start
Configure your cbsso providers in config/ColdBox.cfc and define routes for /sso/login, /sso/callback, and /sso/logout, then trigger /sso/login/google to start a sign-in.