oidc-id-token

Implement OpenID Connect ID Tokens with RS256 signing and validation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/maronnjapan/maronn-openid-provider --skill oidc-id-token
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oidc-id-token
Source: https://github.com/maronnjapan/maronn-openid-provider/tree/main/.claude/skills/oidc-id-token
Command: npx skills add https://github.com/maronnjapan/maronn-openid-provider --skill oidc-id-token

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenID Connect ID Token generation and validation is error-prone; this guide helps implement secure, standards-compliant tokens for Basic OP certification.

Core Features & Use Cases

  • ID Token structure and required claims (iss, sub, aud, exp, iat) are defined and generated
  • Nonce, auth_time, at_hash, and c_hash handling are implemented for hybrid/code flows
  • RS256 signing with proper JOSE header (alg: RS256, kid) and token verification guidance
  • Validation guidance for issuer, audience, expiration, and nonce matching

Quick Start

Configure your OpenID Provider to issue RS256-signed ID Tokens including required claims and proper nonce handling.

Frequently Asked Questions about oidc-id-token

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

FAQPage Schema
What are the required claims for an OpenID Connect ID Token?

To generate a compliant OIDC ID Token, include the iss, sub, aud, exp, and iat required claims, handle nonce and auth_time, and sign the token using RS256 with a proper JOSE header containing the alg and kid fields.

How do I validate an OIDC ID Token using RS256?

Validating an OIDC ID Token involves checking the issuer, audience, expiration, and nonce matching. It also requires verifying the JOSE header and confirming proper hash calculations for at_hash and c_hash per OpenID Connect Core.

When do I need to include at_hash and c_hash in an ID Token?

You need to include at_hash and c_hash in an ID Token when handling hybrid or authorization code flows. These conditional claims tie the ID Token to the access token and authorization code to prevent token substitution attacks.

Does OpenID Connect Basic OP certification require RS256 signing?

Yes, Basic OP certification requires ID Tokens to be signed using the RS256 algorithm. The token must include a JOSE header specifying the alg as RS256 and a kid for key identification.

How should nonce handling be implemented for OpenID Connect ID Tokens?

Nonce handling for OpenID Connect ID Tokens requires generating a nonce during the authentication request and matching it against the nonce claim returned in the ID Token. This prevents replay attacks during the flow.