Reference
Look up the terms, parameters, and specifications used in the lessons.
Terminology
- Authorization grant
- A credential representing authorization that a client can use to obtain an access token. The authorization code is one type of grant.
- Authorization endpoint
- The endpoint the browser visits to request authorization from the resource owner.
- Token endpoint
- The endpoint a client contacts directly to obtain or refresh tokens.
- Redirect URI
- The registered client callback destination where the browser delivers the authorization result to the client.
- Scope
- A value that describes requested or granted access. Its meaning is defined by the authorization server and resource policy.
- Audience
- The intended recipient of a token. An API checks that an access token is intended for it.
- Issuer
- The authority that issued the token or authentication result.
- Bearer token
- A token that can be used by whoever holds it. The recipient checks the token and its authorization.
- Introspection
- An authenticated request to learn whether a token is active and obtain applicable metadata.
- PKCE
- Proof Key for Code Exchange. A client commits to a fresh verifier using a challenge and presents the verifier when redeeming the code.
Authorization Code + PKCE parameters
response_type=code- Requests an authorization code at the authorization endpoint.
state- Client-generated value returned in the authorization response. The client can use it to bind the callback to the initiating browser session.
code_challenge,code_challenge_method=S256- The verifier commitment and its transformation, sent through the browser.
grant_type=authorization_code,code_verifier- The grant type and the original verifier in the token request body.
Bearer token request
GET /v1/saved-books HTTP/1.1
Host: library-api.example
Authorization: Bearer demo_at_TVW6gksBwL4MSee the complete HTTP exchange for the fictional Reading List client.
Specifications
- RFC 6749 · OAuth 2.0
- RFC 9700 · OAuth 2.0 Security Best Current Practice
- RFC 7636 · Proof Key for Code Exchange
- RFC 6750 · Bearer Token Usage
- OpenID Connect Core 1.0
- RFC 7519 · JSON Web Token
- RFC 8725 · JWT Best Current Practices
- RFC 9068 · JWT Profile for OAuth Access Tokens
- RFC 7662 · Token Introspection
- RFC 7009 · Token Revocation