openid / openid/OpenID4VCI

Clarify condition for requiring locations field in authorization_details

Open
#767 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
No language data
Stars
125
Forks
41
PR merge metrics
No merged PRs in 30d

Description

In section 5.1.1 (Using Authorization Details Parameter), the spec states:

If the Credential Issuer metadata contains an authorization_servers parameter, the authorization detail's locations
common data field MUST be set to the Credential Issuer Identifier value.

The locations field is needed for an authorization server to distinguish which credential issuer is being targeted, which is only relevant when one auth server protects multiple credential issuers. However, the normative condition (presence of authorization_servers in the credential issuer metadata) does not imply that deployment. A credential issuer can list multiple auth servers in authorization_servers where each one individually only protects a single issuer, making locations unnecessary for those auth servers.

The non-normative example correctly frames the scenario as "an Authorization Server protects multiple Credential Issuers", but the normative condition does not align with it.

Should the condition be tied to that deployment scenario instead?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with section 5.1.1, “Using Authorization Details Parameter,” and compare the normative condition for the locations field with the non-normative example. Review how authorization servers and credential issuers are described in the surrounding specification; done means the normative wording accurately reflects the multiple-credential-issuer deployment scenario.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.