Visual RFC.
ALL RFCs / RFC 8414
Read the RFC ↗
RFC 8414 / Authorization server metadata

Construct the metadata request location

01

Start with an issuer identifier and insert the application’s well-known path before the issuer’s own path.

RFC 8414 · § 3.1EXAMPLE
4 / 4
Construct the metadata request locationIssuer https://as.example/team. Metadata request location https://as.example/.well-known/openid-configuration/team. Compare insertion with OpenID Connect append rule using the same suffix; legacy fallback is scoped, not a response-validation bypass.Insert the well-known part before the issuer pathConfigured issuerDifferent path transformationLegacy fallback only in its stated transitionFull URLs in notes · keep the original expected issuer
04
Distinguish the OpenID Connect path rule

Separate comparison using openid-configuration: RFC 8414 inserts before /team; OpenID Connect appends after it. The legacy transition fallback is scoped to retrieval failure and that suffix.

Source for this drawing: RFC 8414 · Read RFC section 3.1 ↗

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.

Related RFCs and changes

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

KEY POINT

Derive a metadata location without changing the issuer you expect.

  • OAuth 2.0 is an authorization framework. An authorization server issues credentials that a client app uses to access protected resources. Metadata is configuration data describing that server’s endpoints and capabilities. RFC 8414 does not choose which authorization server a client should trust; the issuer identifier may already be configured or discovered by other means (§1).
  • The REQUIRED issuer is an HTTPS URL with no query or fragment (§2). A metadata-supporting server MUST publish a JSON document at a location formed by inserting a well-known URI string between the issuer’s host and path. The default string is /.well-known/oauth-authorization-server; the application MUST specify which registered well-known suffix it uses (§3).
  • Metadata MUST be requested with HTTP GET. For issuer https://as.example, the default location is https://as.example/.well-known/oauth-authorization-server. For https://as.example/team, it is https://as.example/.well-known/oauth-authorization-server/team. This enables multiple issuers on a host; it is not generic information about that host (§3.1).
  • If the issuer has a path, a terminating slash MUST be removed before constructing the request path. The retrieval-location operation does not erase the original expected issuer: https://as.example/team/ and https://as.example/team remain different strings for the later exact issuer check (§§3.1,3.3,4).
  • For path-bearing issuers the OpenID Connect Discovery transformation appends its well-known string, while RFC 8414 inserts it before the path. The fourth scene compares both with the same openid-configuration suffix. For the example origin, the two locations are https://as.example/.well-known/openid-configuration/team and https://as.example/team/.well-known/openid-configuration. Transitional fallback is described only for legacy deployments using that suffix, first trying this RFC’s location and only falling back if retrieval fails. It is not permission to accept an issuer mismatch (§5).
  • The drawing splits origin, well-known path and issuer path into explicitly joined components for readability. Full HTTPS example URLs are given in these notes. No network discovery, redirects, arbitrary host probing or real authorization service is used.
DETAILS

Examples use reserved .example names. URL helper covers an explicitly bounded ASCII HTTPS subset, not every URI, IRI, host literal or discovery deployment.

Read the RFC section ↗

All chapters in RFC 8414

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 ↗