-
Notifications
You must be signed in to change notification settings - Fork 75
Description
Issue with existing content
Link to content
https://passkeys.dev/docs/advanced/related-origins/
What is the issue?
The documentation examples show the RP ID's matching origin included in the origins array of the /.well-known/webauthn JSON document, which may cause confusion about whether this is required or recommended.
For example, when RP ID is shopping.com, the examples include "https://shopping.com" in the origins array:
{
"origins": [
"https://shopping.com",
"https://shopping.co.uk",
"https://shopping.co.jp",
...
]
}Since https://shopping.com is already the valid origin for RP ID shopping.com through standard WebAuthn without ROR, it's unclear whether:
- Including the matching origin is required by the specification
- It's optional but recommended for consistency
- It's simply redundant but harmless
- It should be excluded as it's already implicitly valid
Proposed changes
The documentation should explicitly clarify whether the RP ID's matching origin should be included in the origins array or not. Suggested additions:
Any other notes
This affects implementers who need to decide how to construct their origins array and may be confused by seeing what appears to be redundant information in the examples without explanation.