Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify distinction between PublicKeyCredentialUserEntity name and displayName #1932

Merged
merged 10 commits into from
Sep 12, 2023
22 changes: 15 additions & 7 deletions index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -2784,7 +2784,7 @@ Note: Invoking this method from a [=browsing context=] where the [=Web Authentic
<div link-for-hint="WebAuthentication/isPasskeyPlatformAuthenticatorAvailable">

[=[WRPS]=] use this method to determine whether they can create a new [=passkey=] using a [=user-verifying platform authenticator=] or a {{AuthenticatorTransport/hybrid}} authenticator.
Upon invocation, the [=client=] employs a [=client platform=]-specific procedure to discover available [=user-verifying platform authenticators=] and the
Upon invocation, the [=client=] employs a [=client platform=]-specific procedure to discover available [=user-verifying platform authenticators=] and the
availability of {{AuthenticatorTransport/hybrid}} transport.
If one or both are discovered, the promise is resolved with the value of [TRUE].
If neither is discovered, the promise is resolved with the value of [FALSE].
Expand Down Expand Up @@ -3183,10 +3183,15 @@ associated with or [=scoped=] to, respectively.
on {{PublicKeyCredentialEntity/name}}'s value prior to displaying the value to the user or
including the value as a parameter of the [=authenticatorMakeCredential=] operation.

- When inherited by {{PublicKeyCredentialUserEntity}}, it is a [=human palatability|human-palatable=] identifier for a
[=user account=]. It is intended only for display, i.e., aiding the user in determining the difference between user
accounts with similar {{PublicKeyCredentialUserEntity/displayName}}s. For example, "alexm", "alex.mueller@example.com"
or "+14255551234".
- When inherited by {{PublicKeyCredentialUserEntity}}, it is a
[=human palatability|human-palatable=] identifier for a [=user account=]. This
identifier is the primary value displayed to users by [=Clients=] to help users
understand with which [=user account=] a credential is associated. The [=[RP]=] MAY
extend the identifier to help a user differentiate between multiple credentials for
a single [=user account=] when the same value would otherwise be used for all
credentials.
MasterKale marked this conversation as resolved.
Show resolved Hide resolved

Examples of suitable values for this identifier include, "alex.mueller@example.com (Production)", "alexm", or "+14255551234".

- The [=[RP]=] MAY let the user choose this value. The [=[RP]=] SHOULD perform enforcement,
as prescribed in Section 3.4.3 of [[!RFC8265]] for the UsernameCasePreserved Profile of the PRECIS
Expand Down Expand Up @@ -3254,8 +3259,11 @@ credential.
with more than one [=user account=] at the [=[RP]=].

: <dfn>displayName</dfn>
:: A [=human palatability|human-palatable=] name for the [=user account=], intended only for display. For example, "Alex Müller" or "田中倫". The
[=[RP]=] SHOULD let the user choose this, and SHOULD NOT restrict the choice more than necessary.
:: A [=human palatability|human-palatable=] name for the [=user account=], intended only for
display. The [=[RP]=] SHOULD let the user choose this, and SHOULD NOT restrict the choice
more than necessary. The [=[RP]=] MAY set this to the same value as {{PublicKeyCredentialEntity/name}}.
MasterKale marked this conversation as resolved.
Show resolved Hide resolved

Examples of suitable values for this identifier include, "Alex Müller (ACME Co.)" or "田中倫".
MasterKale marked this conversation as resolved.
Show resolved Hide resolved

- [=[RPS]=] SHOULD perform enforcement, as prescribed in Section 2.3 of
[[!RFC8266]] for the Nickname Profile of the PRECIS FreeformClass [[!RFC8264]],
Expand Down
Loading