Visual RFC.
ALL RFCs / RFC 7662
Read the RFC ↗
RFC 7662 / OAUTH TOKEN INTROSPECTION

Limit disclosure and authenticate the endpoint

06

Token metadata may identify people and reveal other services. The authorization server can tailor the response to the protected resource and avoid unnecessary disclosures.

RFC 7662 · § 5EXAMPLE
3 / 3
Limit disclosure and authenticate the endpointTwo tailored active responses illustrate allowed per-resource metadata: read scope and opaque resource-A-7 subject for A, then write scope and a different resource-B-9 subject for B. No global username is required; these are fictional policy examples, not a mandatory pairwise identifier derivation. The last state stops a token-carrying query before a wrong or unauthenticated endpoint. Both caller authorization and intended TLS endpoint authentication remain necessary; no real identity is disclosed.Disclose only the intended resource contextResource serverWrong endpointTLS endpoint check failsAuthenticate the intended server certificateRequire authorized resource-server callersNo inspected token reaches this wrong endpointPOST body avoids token values in query logs
03
Stop token disclosure when endpoint authentication fails.

The resource server validates the intended authorization-server endpoint and its certificate before sending token information. The failing example delivers no token to the wrong endpoint.

Source for this drawing: RFC 7662 · Read RFC section 5 ↗

Protocol participantThreat or exceptionProtocol controlSimplified drawings · precise section references
New to this? Start hereA quick picture + helpful background

A message needs an address.

Think of a packet as a small addressed envelope. Devices pass it onward; transport protocols decide what delivery promises an application gets.

Helpful first, if these ideas are unfamiliar

These pictures are analogies to help you learn. The linked RFC explains the actual rules.

Terms in this drawing
Pairwise identifier
A service-specific opaque subject string that can differ across resources.
Data minimization
Returning only information needed by the intended recipient.
Related RFCs and changes

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

KEY POINT

Responses MAY differ between protected resources, including limiting disclosed scopes. Privacy-sensitive information MUST be protected against disclosure to unintended parties.

  • Responses MAY differ between protected resources, including limiting disclosed scopes. Privacy-sensitive information MUST be protected against disclosure to unintended parties.
  • Omitting sensitive information is the simplest minimization method. Opaque service-specific subject identifiers can differ between resources; a global username is not required.
  • The endpoint MUST authenticate protected-resource callers and SHOULD specifically authorize them to call it. The server MUST support TLS1.2; certificate checking by the client or resource is a MUST when using TLS.
  • Credentials and inspected tokens must be protected. The server MAY disallow HTTP GET to avoid token values in query logs; the defined request flow uses POST. Extra context extensions have their own privacy implications.
DETAILS

Fictional subject values resource-A-7 and resource-B-9 illustrate one privacy technique, not a required derivation algorithm or two real people. Discovery is outside this RFC; configure a trustworthy endpoint and validate its certificate. TLS1.0/1.1 are not authorized by this guide. No real token, user identity or client IP address is used in these examples. Privacy filtering does not remove the authorization server’s responsibility to perform applicable state checks.

Read the RFC section ↗

All chapters in RFC 7662

Drawing view

Scroll the drawing to see every part. Playback controls stay above it.

RFC 9700 / CHAPTERS

Chapters

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

RFC status and corrections ↗