Web Authentication API
The PublicKeyCredential interface provides information about a public key / private key pair, which is a credential for logging in to a service using an un-phishable and data-breach resistant asymmetric key pair instead of a password. It inherits from Credential, and is part of the Web Authentication API extension to the Credential Management API.
[!NOTE] This API is restricted to top-level contexts. Use from within an iframe element will not have any effect.
Instance properties
-
PublicKeyCredential.authenticatorAttachment
- : A string that indicates the mechanism by which the WebAuthn implementation is attached to the authenticator at the time the associated CredentialsContainer.create() or CredentialsContainer.get() call completes.
-
PublicKeyCredential.id
- : Inherited from Credential and overridden to be the base64url encoding of PublicKeyCredential.rawId.
-
PublicKeyCredential.rawId
- : An ArrayBuffer that holds the globally unique identifier for this
PublicKeyCredential. This identifier can be used to look up credentials for future calls to CredentialsContainer.get().
- : An ArrayBuffer that holds the globally unique identifier for this
-
PublicKeyCredential.response
- : An instance of an AuthenticatorResponse object. It is either of type AuthenticatorAttestationResponse if the
PublicKeyCredentialwas the results of a CredentialsContainer.create() call, or of type AuthenticatorAssertionResponse if thePublicKeyCredentialwas the result of a CredentialsContainer.get() call.
- : An instance of an AuthenticatorResponse object. It is either of type AuthenticatorAttestationResponse if the
-
PublicKeyCredential.type- : Inherited from Credential. Always set to
public-keyforPublicKeyCredentialinstances.
- : Inherited from Credential. Always set to
Static methods
- PublicKeyCredential.getClientCapabilities_static
- : Returns a Promise that resolves with an object that can be used to check whether or not particular WebAuthn capabilities and extensions are supported.
- PublicKeyCredential.isConditionalMediationAvailable_static
- : Returns a Promise which resolves to
trueif conditional mediation is available.
- : Returns a Promise which resolves to
- PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable_static
- : Returns a Promise which resolves to
trueif an authenticator bound to the platform is capable of verifying the user.
- : Returns a Promise which resolves to
- PublicKeyCredential.parseCreationOptionsFromJSON_static
- : Convenience method for deserializing server-sent credential registration data when registering a user with credentials.
- PublicKeyCredential.parseRequestOptionsFromJSON_static
- : Convenience method for deserializing server-sent credential request data when authenticating a (registered) user.
- PublicKeyCredential.signalAllAcceptedCredentials_static
- : Signals to the authenticator all of the valid credential IDs that the relying party server still holds for a particular user.
- PublicKeyCredential.signalCurrentUserDetails_static
- : Signals to the authenticator that a particular user has updated their user name and/or display name.
- PublicKeyCredential.signalUnknownCredential_static
- : Signals to the authenticator that a credential ID was not recognized by the relying party server, for example because it was deleted.
Instance methods
- PublicKeyCredential.getClientExtensionResults()
- : If any extensions were requested, this method will return the results of processing those extensions.
- PublicKeyCredential.toJSON()
- : Returns a JSON-serializable plain object representing the
PublicKeyCredentialobject. Automatically called by JSON.stringify().
- : Returns a JSON-serializable plain object representing the
Examples
Creating a new instance of PublicKeyCredential
Here, we use CredentialsContainer.create() to generate a new credential.
const createCredentialOptions = {
publicKey: {
challenge: new Uint8Array([
21, 31, 105 /* 29 more random bytes generated by the server */,
]),
rp: {
name: "Example CORP",
id: "login.example.com",
},
user: {
id: new Uint8Array(16),
name: "canand@example.com",
displayName: "Carina Anand",
},
pubKeyCredParams: [
{
type: "public-key",
alg: -7,
},
],
},
};
navigator.credentials
.create(createCredentialOptions)
.then((newCredentialInfo) => {
const response = newCredentialInfo.response;
const clientExtensionsResults =
newCredentialInfo.getClientExtensionResults();
})
.catch((err) => {
console.error(err);
});
Getting an existing instance of PublicKeyCredential
Here, we fetch an existing credential from an authenticator, using CredentialsContainer.get().
const requestCredentialOptions = {
publicKey: {
challenge: new Uint8Array([/* bytes sent from the server */]),
},
};
navigator.credentials
.get(requestCredentialOptions)
.then((credentialInfoAssertion) => {
// send assertion response back to the server
// to proceed with the control of the credential
})
.catch((err) => {
console.error(err);
});
Specifications
Browser compatibility
See also
- The parent interface Credential
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
