Visual RFC.
ALL RFCs / RFC 7523
Read the RFC ↗
RFC 7523 / SIGNED STATEMENTS FOR OAUTH

Check who sealed the note

03

Anyone can type a name into a note. The server checks the signed bytes using a key already trusted for that issuer.

RFC 7523 · § 3EXAMPLE
1 / 4 · Read the claim without trusting it

Decoding makes labels readable; anyone could have typed them.

Checking bytes is different from trusting a writerReadable claimssub: user-17
Readable subjectuser-17

Offline worked example. Only the public signature/MAC fixtures receive real local cryptographic checks. Other trust, grant, clock and permission inputs are selected teaching cases.

What happens if you change this?

Predict whether the request will pass. Change one choice to see why; use Restart to restore the original example.

Check this fictional signature or MAC in your browser

This checks the exact bytes with the agreed public key or the deliberately public toy shared key. It is separate from trust, names, time and permission checks.

Interactive local signature check loads with the reader.
4 / 4
04
Keep signature and trust separate

A trusted signature supports trusting these bytes; it does not grant permission by itself.

Check who sealed the noteA trusted signature supports trusting these bytes; it does not grant permission by itself.Checking bytes is different from trusting a writerReadable claimssub: user-17Agreed public key ACheck exact encoded header + payload✓Bytes check out✓Trust this signed example

Key idea: Readable claims are not yet trusted claims.

Terms
assertion
A statement another system can check; here it is carried as a JWT.
authorization grant
Evidence supporting a request for an access token.
client authentication
Checking which app made the request.
token endpoint
The server address where an app requests tokens.
JWT
JSON Web Token: a compact container for named statements.
issuer
The system that created the statement.
subject
Who or what the statement is about.
audience
The intended receiver of the statement.
claim
A named piece of information inside the JWT.
signature
A checkable result over bytes made with a secret signing key.
MAC
A check over bytes made with a key shared by the parties.
RS256
A secret signing key makes a checkable signature; a matching shareable key checks it.
HS256
A shared secret lets either party make and check a result over the bytes.
exp
Required ending time for using this JWT.
nbf
Optional time before which this JWT must not be accepted.
iat
Optional time when the JWT was issued.
jti
Optional identifier for this JWT; a server may remember it to detect reuse.
scope
The named permission requested, such as reading pictures.
bearer assertion
A statement usable by someone who possesses it, without proving possession of a separate signing key on each request.

Look up a term in the glossary ↗

Rules & examples

These reference examples may differ from the selected experiment.

  • The issuer MUST digitally sign the JWT or apply a MAC. Invalid signatures or MACs MUST be rejected, as must JWTs invalid in other respects. Trust, allowed algorithms and keys are agreed outside this exchange. RS256 is mandatory to implement for this profile; it is not the only allowed algorithm or a command to accept any presented algorithm.

Bounded offline examples; crypto fixtures are separate from the selected trust and permission policy.

Sources
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.

All chapters in RFC 7523

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 ↗