openid / openid/OpenID4VC-HAIP

Section 4.3 incorrectly references Section 4.4 for PAR client authentication

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

Nobody has claimed this yet.

Dominant language
Makefile
Stars
57
Forks
17
PR merge metrics
No merged PRs in 30d

Description

Section 4.3 currently states:

Wallets MUST authenticate themselves at the PAR endpoint using the same rules as defined in Section 4.4 for client authentication at the token endpoint.

However, Section 4.4 does not define any rules for client authentication at the token endpoint, so the reference is currently incorrect.

In practice, because HAIP requires FAPI, client authentication at the PAR endpoint is mandatory through the referenced FAPI requirements. Nevertheless, the current wording is confusing because it points to a section that does not actually define the referenced behavior.

Proposal:

Update the text in Section 4.3 to reference the appropriate normative source for client authentication, rather than Section 4.4, or alternatively add the missing client authentication rules to Section 4.4 if that was the original intent.

This would make the specification internally consistent while preserving the existing interoperability requirements.

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

Locate the specification text containing Sections 4.3 and 4.4, then compare the authentication statement in Section 4.3 with the requirements it cites. Done means the specification either references the correct normative source or defines the intended client-authentication rules in Section 4.4 without weakening the existing interoperability requirements.

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
65/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.