oidc-token-endpoint

Implement an OpenID Connect Token Endpoint with authorization_code flow and client authentication.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide provides a standards-aligned blueprint for implementing a secure OpenID Connect Token Endpoint to support Basic OP certification, covering token requests, client authentication, and token response construction.

Core Features & Use Cases

  • TLS-only HTTPS endpoint
  • HTTP POST handling with Content-Type: application/x-www-form-urlencoded
  • Support for authorization_code grant flow with proper code exchange and redirect_uri validation
  • Client authentication methods: client_secret_basic and client_secret_post
  • Robust token response formatting including access_token, id_token, and optional refresh_token
  • Comprehensive error handling and security checks to prevent reuse and leakage

Quick Start

Configure your OpenID Connect provider to expose the /token endpoint and perform a sample authorization_code flow to verify token issuance.

Frequently Asked Questions about oidc-token-endpoint

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

FAQPage Schema
How do I implement an OpenID Connect token endpoint for Basic OP certification?

To implement an OpenID Connect token endpoint for Basic OP certification, configure a TLS-only HTTPS POST endpoint handling authorization_code flow exchanges, client_secret_basic or client_secret_post authentication, and standard token response formatting as specified by OpenID Connect Core sections 3.1.3 and 9.

What client authentication methods are required for an OIDC token endpoint?

OIDC token endpoint client authentication requires either client_secret_basic or client_secret_post methods. Both methods validate the client credentials during the HTTP POST token request to ensure secure authorization_code exchange before issuing access tokens and id_tokens.

How does the authorization_code flow exchange work at the OAuth2 token endpoint?

The authorization_code flow exchange at the OAuth2 token endpoint validates the submitted code and redirect_uri via HTTP POST, authenticates the client, and prevents code reuse by issuing a formatted token response containing the access_token and id_token.

Why does my OpenID Connect token endpoint require TLS enforcement?

OpenID Connect token endpoints require TLS enforcement to prevent credential leakage and interception during client_secret transmission. The HTTPS-only constraint ensures secure HTTP POST handling and protects the authorization_code exchange process from unauthorized access.

What security checks are needed to prevent authorization code reuse in OIDC?

Security checks to prevent authorization code reuse in OIDC include validating the code's single-use status, verifying the redirect_uri matches the initial request, and enforcing comprehensive error handling for invalid or expired code submissions at the token endpoint.

Can I use client_secret_post instead of client_secret_basic for OpenID Connect token requests?

Yes, you can use client_secret_post instead of client_secret_basic for OpenID Connect token requests. The token endpoint accepts both authentication methods, allowing you to pass client credentials in the HTTP POST body rather than the Authorization header.