Skip to content

docs: define the policy file format, link the wiki for use case design - #4677

Open
reinkrul wants to merge 4 commits into
docs/rtd-move-discoveryfrom
docs/rtd-move-policy
Open

reinkrul wants to merge 4 commits into
docs/rtd-move-discoveryfrom
docs/rtd-move-policy

Conversation

@reinkrul

@reinkrul reinkrul commented Nov 5, 2026 •

Copy link
Copy Markdown
Member

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

After review, deployment/policy.rst keeps its content (it explains how the feature works, not how to use it in a use case). Changes:

  • link to the wiki page OAuth2 Scopes and Presentation Definition Mapping for designing a use case's policy
  • the policy file format is now defined: per scope the organization, service_provider, user and scope_policy fields (profile-only, passthrough, dynamic), and the load rules (at least one PD, PD validated against the PE v2 schema, scope defined once, one profile scope per request)
  • service_provider and user marked experimental (auth.experimental.jwtbearerclient; user only in the OpenID4VP authorization code flow, auth.authorizationendpoint.enabled), both default false
  • two-VP warning: "experimental, under active development"

Fixed: the page described a presentation_definition object and a wallet_owner_type field, which don't exist; the scope holds organization, service_provider and user directly (policy/local.go). scope_policy was not documented.

Assisted by AI

@reinkrul
reinkrul added this pull request to stack #4674 November 5, 2026 08:32
@reinkrul
reinkrul force-pushed the docs/rtd-move-policy branch from c45fde1 to 9b2c7d4 Compare November 5, 2026 08:55
@reinkrul
reinkrul marked this pull request as ready for review November 5, 2026 09:30
@reinkrul
reinkrul force-pushed the docs/rtd-move-policy branch from 9b2c7d4 to ff2beb0 Compare November 6, 2026 11:25
@reinkrul reinkrul changed the title docs: move access token policy design to the wiki docs: define the policy file format, link the wiki for use case design Nov 6, 2026
@reinkrul
reinkrul force-pushed the docs/rtd-move-policy branch from f388e23 to f88eb08 Compare November 6, 2026 13:07
@reinkrul
reinkrul force-pushed the docs/rtd-move-policy branch from f88eb08 to c019226 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