cbsso

Configure SAML2, OAuth2, or OIDC Single Sign-On for ColdBox and BoxLang applications.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ColdBox/skills --skill cbsso
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cbsso
Source: https://github.com/ColdBox/skills/tree/main/modules/cbsso
Command: npx skills add https://github.com/ColdBox/skills --skill cbsso

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Simplifies integrating Single Sign-On into ColdBox/BoxLang applications by providing patterns and guidance for SAML2 and OAuth2/OIDC flows, callback handling, token validation, and user provisioning so teams can avoid common security pitfalls and implementation errors.

Core Features & Use Cases

  • Provider configuration for SAML2, OAuth2, and OIDC including client credentials, endpoints, PKCE, and certificate settings.
  • Authorization and callback flows including state validation, token exchange, and claim extraction for secure authentication.
  • Just-in-time user provisioning and session management with examples for provisioning users on first login and integrating with cbauth/cbsecurity.
  • Single logout handling and best practices for storing secrets, enforcing HTTPS, and validating claims.

Quick Start

Use the cbsso skill to generate a ColdBox module configuration and a callback handler that implements OAuth2/OIDC authorization, validates state, exchanges tokens, and provisions users on first login.

Frequently Asked Questions about cbsso

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement SSO in a ColdBox application?

Implement SSO in a ColdBox application by configuring provider settings for SAML2, OAuth2, or OIDC, then generating an authorization URL and callback handler to process token exchanges and extract claims.

What is the best way to handle just-in-time user provisioning during OIDC login?

Handle just-in-time user provisioning during OIDC login by extracting claims from the validated token, creating the user record on first login, and integrating the session with cbauth or cbsecurity.

How do I configure SAML2 single logout in ColdBox?

Configure SAML2 single logout in ColdBox by setting up provider logout endpoints and handling session termination flows to ensure users are properly logged out of the identity provider.

Does the cbsso Skill support PKCE for OAuth2 flows?

Yes, OAuth2 flows support optional PKCE to enhance security. You can enable PKCE during provider configuration to protect authorization code exchanges from interception.

What security prerequisites are needed for OAuth2 callback processing in ColdBox?

OAuth2 callback processing requires securely stored client secrets, HTTPS redirect URIs, and state validation to prevent CSRF attacks during token exchange.

How does state validation work during SSO callback processing?

State validation works by comparing the state parameter returned from the identity provider callback against the value generated during the initial authorization URL creation to prevent CSRF attacks.