Visual RFC.
ALL RFCs / RFC 8725
Read the RFC ↗
RFC 8725 / MECHANISMS

Do not let alg choose the policy

01

The receiving application limits acceptable algorithms instead of trusting the token header to decide.

Related RFCs and changes

“Updates” changes part of an earlier RFC. “Obsoletes” replaces it. This list shows selected related documents.

DIAGRAM§ 3.1 ↗
RFC 8725 · § 3.1EXAMPLE
3 / 3
Do not let alg choose the policyThe receiving application limits acceptable algorithms instead of trusting the token header to decide. Current state: Mismatch rejected.Do not let alg choose the policyconfigured policyalgorithm A + key Auntrusted tokenalg: Balg mismatchreject before claims
03
Mismatch rejected

A token claiming an unauthorized algorithm stops before claims are used.

Protocol participantThreat or exceptionProtocol controlSimplified drawings · precise section references
WHAT CHANGED
RFC 7519 JWT formatRFC 8725 § 3.1

This BCP updates JWT processing with explicit algorithm verification and per-key algorithm binding to prevent algorithm confusion.

Read the updated RFC section ↗
KEY POINT

The caller specifies a supported set of algorithms.

  • The caller specifies a supported set of algorithms.
  • Ensure the algorithm matches the cryptographic operation and key.
  • Each key must be used with exactly one algorithm.
DETAILS

The illustration is schematic. Example values are illustrative; profiles and later security guidance can add requirements.

Read the RFC section ↗

Diagrams simplify the RFC. Read the linked sections for complete requirements.

Privacy
All chapters in this RFC
  1. Do not let alg choose the policy
  2. A password is a weak MAC key
  3. Nested tokens need every check
  4. Bind issuer and audience
  5. Different purposes need different rules
RFC 9700 / CHAPTERS

Chapters

For full details, tables, algorithms, and exceptions, read the original RFC.

RFC status and corrections ↗