cbsecurity-passkeys

Implement WebAuthn passkey registration and authentication ceremonies for ColdBox applications.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adds clear, production-ready guidance and code patterns for implementing WebAuthn/Passkeys authentication in ColdBox applications, removing uncertainty around credential storage, ceremony handling, and security hardening so teams can deploy passwordless login safely.

Core Features & Use Cases

  • Credential repository interface with an example implementation and a database migration for storing passkey metadata.
  • Registration and authentication ceremonies including server-side challenge management, verification, signCount validation, and JWT issuance for authenticated sessions.
  • JavaScript integration and deployment guidance covering client-side option generation, challenge lifecycle, HTTPS requirements, rpId/origin checks, and production hardening recommendations.
  • Use Case: Migrate an existing ColdBox login flow to passwordless authentication, enabling users to register passkeys and authenticate via WebAuthn while maintaining strong anti-replay and origin validation.

Quick Start

Generate registration options on the server, store the challenge in session, return the options to the client, then verify the client's credential response and persist the credential in your repository.

Frequently Asked Questions about cbsecurity-passkeys

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

FAQPage Schema
How do I implement WebAuthn passkeys for passwordless login in ColdBox?

Implement WebAuthn passkeys in ColdBox by generating registration options on the server, storing the challenge in session, returning options to the client, then verifying the credential response and persisting it in your repository.

What is a credential repository for WebAuthn authentication?

A credential repository for WebAuthn authentication is an interface for storing passkey metadata. It requires an implementation that persists credential data alongside a database migration for secure retrieval during registration and authentication ceremonies.

How does challenge lifecycle management work during passkey registration?

Challenge lifecycle management during passkey registration involves generating server-side challenges, storing them in the user session, and validating the client's credential response against the original challenge to prevent replay attacks.

Do I need HTTPS and origin validation for production WebAuthn passkey deployment?

HTTPS and origin validation are required for production WebAuthn passkey deployment. Production hardening demands strict rpId and origin checks, alongside signCount validation, to ensure secure passwordless authentication.

Can I migrate an existing ColdBox login flow to passwordless authentication?

You can migrate an existing ColdBox login flow to passwordless authentication by replacing traditional credentials with WebAuthn passkeys, enabling users to register and authenticate while maintaining anti-replay and origin validation.

Why does signCount validation matter in WebAuthn authentication ceremonies?

SignCount validation matters in WebAuthn authentication ceremonies because it provides anti-replay protection by tracking authenticator usage counters, helping detect cloned or compromised credentials during the verification process.