coldbox-security-jwt

Generate and validate JWT access and refresh tokens for ColdBox REST APIs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Stateless JWT-based authentication and authorization for ColdBox REST APIs, enabling scalable security without server-side sessions.

Core Features & Use Cases

  • Generate and validate access and refresh tokens using CBSecurity in ColdBox REST APIs.
  • Protect API routes with JWT middleware, enforce role-based access, and support token revocation via storage.
  • Real-world use: secure a public API by issuing short-lived access tokens and long-lived refresh tokens for mobile or web clients.

Quick Start

Configure the JWT settings in config/ColdBox.cfc (issuer, audience, secret), initialize the CBSecurity JWT service, and authenticate to obtain an access token.

Frequently Asked Questions about coldbox-security-jwt

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

FAQPage Schema
How do I secure a ColdBox REST API using JWT authentication?

Secure a ColdBox REST API using JWT authentication by configuring CBSecurity to generate and validate access tokens, applying middleware-based protection to restrict unauthorized route access.

How does JWT token refresh work for ColdBox APIs?

JWT token refresh issues short-lived access tokens and long-lived refresh tokens for ColdBox REST APIs, enabling clients to obtain new access tokens without re-authenticating, ensuring scalable stateless security.

Can I enforce role-based access control with JWT in ColdBox?

Yes, role-based access control is enforced by applying JWT middleware in ColdBox, intercepting requests to validate tokens and verify user roles before granting access to protected API routes.

What's the best way to configure JWT issuer and audience settings in ColdBox?

Configure JWT issuer, audience, and secret directly in config/ColdBox.cfc, then initialize the CBSecurity JWT service to ensure tokens are properly signed and validated against expected parameters.

Does JWT authentication for ColdBox require server-side sessions?

No, JWT authentication provides stateless security for ColdBox REST APIs, eliminating server-side sessions and enabling scalable API access for web and mobile clients through self-contained tokens.

How do I revoke JWT access tokens in a ColdBox application?

Revoke JWT access tokens in ColdBox by enabling token storage within CBSecurity, allowing the application to track and invalidate active tokens before their expiration, preventing unauthorized API access.