Skip to content

docs: explain DPoP on the OAuth page, link the wiki for use case steps - #4679

Open
reinkrul wants to merge 2 commits into
docs/rtd-move-vcfrom
docs/rtd-move-oauth
Open

reinkrul wants to merge 2 commits into
docs/rtd-move-vcfrom
docs/rtd-move-oauth

Conversation

@reinkrul

@reinkrul reinkrul commented Nov 5, 2026 •

Copy link
Copy Markdown
Member

Part of the Read the Docs → wiki move (stacked on #4678).

deployment/oauth.rst, DPoP section, expanded after review:

  • what DPoP is (RFC 9449), in short
  • how the Nuts node uses it: DPoP-bound tokens by default (token_type: Bearer to opt out), the key comes from the requesting subject's DID document (dpop_kid in the token response), introspection returns the key thumbprint as cnf.jkt
  • how to use it: the client creates a proof per request with POST /internal/auth/v2/dpop/{kid}; the resource server checks cnf.jkt and validates with POST /internal/auth/v2/dpop/validate (what that API checks, and that other RFC 9449 checks are the resource server's job)
  • links to the wiki for the use case step-by-step guides (Make the FHIR call, Validate the access token)

The rest of the page (RFC list, Authorization Code Flow, VP Token Grant, OpenID4VCI, StatusList2021) is unchanged.

Assisted by AI

@reinkrul
reinkrul added this pull request to stack #4674 November 5, 2026 09:00
@reinkrul
reinkrul marked this pull request as ready for review November 5, 2026 09:30
@reinkrul
reinkrul force-pushed the docs/rtd-move-oauth branch 2 times, most recently from b05e5d8 to 03fcc9b Compare November 6, 2026 11:27
@reinkrul reinkrul changed the title docs: move DPoP integration steps to the wiki docs: explain DPoP on the OAuth page, link the wiki for use case steps Nov 6, 2026
@reinkrul
reinkrul force-pushed the docs/rtd-move-oauth branch 3 times, most recently from 407f20d to 4d56714 Compare November 6, 2026 13:07
@reinkrul
reinkrul force-pushed the docs/rtd-move-oauth branch from 4d56714 to 09d83f9 Compare November 6, 2026 15:57

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants