From 39da7b119eabee3b75529586712f28be22cf51de Mon Sep 17 00:00:00 2001 From: Emil Lundberg Date: Mon, 7 Oct 2024 12:50:45 +0200 Subject: [PATCH 1/4] Remove apparent reference to non-existent [[Get]] internal method --- index.bs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.bs b/index.bs index a2b8e1785..5a7b98507 100644 --- a/index.bs +++ b/index.bs @@ -2301,7 +2301,7 @@ The following [=simple exceptions=] can be raised: -### Use an Existing Credential to Make an Assertion - PublicKeyCredential's `[[Get]](options)` Method ### {#sctn-getAssertion} +### Use an Existing Credential to Make an Assertion ### {#sctn-getAssertion} [=[WRPS]=] call navigator.credentials.get({publicKey:..., ...}) to discover and use an existing [=public key credential=], with the [=user consent|user's consent=]. [=[RP]=] script optionally specifies some criteria From c258674eceafbb05545f596cb37b3703b3fbc931 Mon Sep 17 00:00:00 2001 From: Emil Lundberg Date: Mon, 7 Oct 2024 17:05:08 +0200 Subject: [PATCH 2/4] Change "Method" to "Internal Method" in headings where appropriate --- index.bs | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.bs b/index.bs index 5a7b98507..02c042cb3 100644 --- a/index.bs +++ b/index.bs @@ -1739,7 +1739,7 @@ To support obtaining assertions via {{CredentialsContainer/get()|navigator.crede -### Create a New Credential - PublicKeyCredential's [CREATE-METHOD-DEF] Method ### {#sctn-createCredential} +### Create a New Credential - PublicKeyCredential's [CREATE-METHOD-DEF] Internal Method ### {#sctn-createCredential}
{{PublicKeyCredential}}'s [=interface object=]'s implementation of the {{Credential/[CREATE-METHOD]}} [=internal method=] [[!CREDENTIAL-MANAGEMENT-1]] allows @@ -2333,7 +2333,7 @@ Any {{CredentialsContainer/get()|navigator.credentials.get()}} operation can be aborted by leveraging the {{AbortController}}; see [[dom#abortcontroller-api-integration]] for detailed instructions. -#### PublicKeyCredential's [DISCOVER-METHOD-DEF] Method #### {#sctn-discover-from-external-source} +#### PublicKeyCredential's [DISCOVER-METHOD-DEF] Internal Method #### {#sctn-discover-from-external-source}
@@ -2855,7 +2855,7 @@ The following [=simple exceptions=] can be raised: -### Store an Existing Credential - PublicKeyCredential's `[[Store]](credential, sameOriginWithAncestors)` Method ### {#sctn-storeCredential} +### Store an Existing Credential - PublicKeyCredential's `[[Store]](credential, sameOriginWithAncestors)` Internal Method ### {#sctn-storeCredential}
From 8d76185ae7b8c0a3069872fbd1f8d3789b5bfb94 Mon Sep 17 00:00:00 2001 From: Emil Lundberg Date: Mon, 7 Oct 2024 17:07:14 +0200 Subject: [PATCH 3/4] Simplify reference to default [[CollectFromCredentialStore]] --- index.bs | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.bs b/index.bs index 02c042cb3..6ef5bd5fa 100644 --- a/index.bs +++ b/index.bs @@ -2318,9 +2318,9 @@ should be available without [=user mediation=] (roughly, this specification's [= exactly one of those, it then calls PublicKeyCredential.{{PublicKeyCredential/[DISCOVER-METHOD]}} to have the user select a [=public key credential source=]. -Since this specification requires an [=authorization gesture=] to create any [=assertions=], the PublicKeyCredential.\[[CollectFromCredentialStore]](origin, options, sameOriginWithAncestors) [=internal method=] inherits the default behavior of -{{Credential/[[CollectFromCredentialStore]]()|Credential.[[CollectFromCredentialStore]]()}}, of returning an empty set. +Since this specification requires an [=authorization gesture=] to create any [=assertions=], +{{PublicKeyCredential}} inherits the default behavior of +{{Credential/[[CollectFromCredentialStore]](origin, options, sameOriginWithAncestors)}}, of returning an empty set. In general, the user agent SHOULD show some UI to the user to guide them in selecting and authorizing an authenticator with which to complete the operation. By setting |options|.{{CredentialRequestOptions/mediation}} to {{CredentialMediationRequirement/conditional}}, [=[RPS]=] can indicate that a prominent modal UI should not be shown unless credentials are discovered. From 068d7f56764c6a48d7de74f7fcf99267a2b726b1 Mon Sep 17 00:00:00 2001 From: Emil Lundberg Date: Mon, 7 Oct 2024 17:10:53 +0200 Subject: [PATCH 4/4] Add reference to #sctn-discover-from-external-source from discussion of get() internals --- index.bs | 1 + 1 file changed, 1 insertion(+) diff --git a/index.bs b/index.bs index 6ef5bd5fa..af9ab45be 100644 --- a/index.bs +++ b/index.bs @@ -2321,6 +2321,7 @@ the user select a [=public key credential source=]. Since this specification requires an [=authorization gesture=] to create any [=assertions=], {{PublicKeyCredential}} inherits the default behavior of {{Credential/[[CollectFromCredentialStore]](origin, options, sameOriginWithAncestors)}}, of returning an empty set. +{{PublicKeyCredential}}'s implementation of {{PublicKeyCredential/[DISCOVER-METHOD]}} is specified in the next section. In general, the user agent SHOULD show some UI to the user to guide them in selecting and authorizing an authenticator with which to complete the operation. By setting |options|.{{CredentialRequestOptions/mediation}} to {{CredentialMediationRequirement/conditional}}, [=[RPS]=] can indicate that a prominent modal UI should not be shown unless credentials are discovered.