AuthenticatorAssertionResponse
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
Secure context: This feature is available only insecure contexts (HTTPS), in some or allsupporting browsers.
TheAuthenticatorAssertionResponse interface of theWeb Authentication API contains adigital signature from the private key of a particular WebAuthn credential. The relying party's server can verify this signature to authenticate a user, for example when they sign in.
AnAuthenticatorAssertionResponse object instance is available in theresponse property of aPublicKeyCredential object returned by a successfulnavigator.credentials.get() call.
This interface inherits fromAuthenticatorResponse.
Note:This interface is restricted to top-level contexts. Use from within an<iframe> element will not have any effect.
In this article
Instance properties
Also inherits properties from its parent,AuthenticatorResponse.
AuthenticatorAssertionResponse.authenticatorDataRead onlyAn
ArrayBuffercontaining information from the authenticator such as the Relying Party ID Hash (rpIdHash), a signature counter, test of user presence and user verification flags, and any extensions processed by the authenticator.AuthenticatorResponse.clientDataJSONRead onlyContains the JSON-compatible serialization of the data passed from the browser to the authenticator in order to authenticate with this credential — i.e., when
CredentialsContainer.get()is called with apublicKeyoption. This data contains some information from the options passed into theget()call, and some information controlled by the browser.AuthenticatorAssertionResponse.signatureRead onlyAn assertion signature over
AuthenticatorAssertionResponse.authenticatorDataandAuthenticatorResponse.clientDataJSON. The assertion signature is created with the private key of the key pair that was created during the originatingnavigator.credentials.create()call and verified using the public key of that same key pair.AuthenticatorAssertionResponse.userHandleRead onlyAn
ArrayBuffercontaining an opaque user identifier, specified asuser.idin the options passed to the originatingnavigator.credentials.create()call.
Instance methods
None.
Examples
SeeRetrieving a public key credential for a detailed example.
Specifications
| Specification |
|---|
| Web Authentication: An API for accessing Public Key Credentials - Level 3> # iface-authenticatorassertionresponse> |
Browser compatibility
See also
AuthenticatorAttestationResponse: the interface for the type of response given when creating a new credentialAuthenticatorResponse: the parent interface