coldbox-security-sso

Official

Secure single sign-on integration for ColdBox apps

AuthorColdBox
Version1.0.0
Installs0

System Documentation

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.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: coldbox-security-sso
Download link: https://github.com/ColdBox/skills/archive/main.zip#coldbox-security-sso

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.