oauth21-refresh-token

Issue and rotate OAuth 2.1 refresh tokens with client binding and revocation policies.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Implementing and securing refresh tokens in OAuth 2.1, including issuance decisions, binding, rotation, and public client constraints.

Core Features & Use Cases

  • Token issuance policy: Decide when to issue refresh tokens based on client type, risk, and server policy.
  • Binding & rotation: Support DPoP, mTLS binding, and refresh token rotation to mitigate theft and misuse.
  • Scope & revocation handling: Enforce scope binding to original grants and support token revocation workflows.

Quick Start

Configure your authorization server to issue and rotate refresh tokens per client policy and enable DPoP or mTLS binding as appropriate.

Frequently Asked Questions about oauth21-refresh-token

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

FAQPage Schema
How do I implement refresh token rotation in an OAuth 2.1 authorization server?

OAuth 2.1 refresh token rotation issues a new token on each use and revokes the previous one. Configure your authorization server to enforce rotation across token endpoints, applying client binding and no-store caching.

What is sender-constrained token binding in OAuth 2.1?

Token binding in OAuth 2.1 ties refresh tokens to a specific client using cryptographic proofs. You can apply DPoP or mTLS binding strategies across authorization and token endpoints to mitigate token theft and misuse.

When should I issue refresh tokens to public clients in OAuth 2.1?

Issue refresh tokens to public clients based on client type, risk, and server policy. OAuth 2.1 enables secure issuance for public clients by enforcing strict binding and rotation strategies to mitigate inherent security risks.

How do I enforce scope constraints on OAuth 2.1 refresh tokens?

Enforce scope constraints by binding refresh tokens strictly to their original granted scopes. The authorization server ensures requested scopes during token refresh do not exceed the initial authorization grant boundaries.

Does OAuth 2.1 require no-store caching for refresh tokens?

OAuth 2.1 refresh token handling enforces no-store caching. This prevents persistent storage of sensitive tokens, ensuring the authorization server validates tokens without retaining vulnerable copies in intermediate cache layers.

What is the best way to revoke a refresh token in an OAuth 2.1 server?

The best way to revoke an OAuth 2.1 refresh token is through the token revocation endpoint. Configure your authorization server to support token revocation workflows, immediately invalidating the token and halting further rotation.