AuthenticatorAssertionResponse

Secure context

The AuthenticatorAssertionResponse interface of the Web Authentication API contains a digital 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.

An AuthenticatorAssertionResponse object instance is available in the response property of a PublicKeyCredential object returned by a successful navigator.credentials.get() call.

This interface inherits from AuthenticatorResponse.

[!NOTE] This interface is restricted to top-level contexts. Use from within an <iframe> element will not have any effect.

Instance properties

Also inherits properties from its parent, AuthenticatorResponse.

• authenticatorData Read only
  • : An ArrayBuffer containing 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.
• clientDataJSON Read only
  • : Contains the JSON-compatible serialization of the data passed from the browser to the authenticator in order to authenticate with this credential — i.e., when get() is called with a publicKey option. This data contains some information from the options passed into the get() call, and some information controlled by the browser.
• signature Read only
  • : An assertion signature over authenticatorData and clientDataJSON. The assertion signature is created with the private key of the key pair that was created during the originating navigator.credentials.create() call and verified using the public key of that same key pair.
• userHandle Read only
  • : An ArrayBuffer containing an opaque user identifier, specified as user.id in the options passed to the originating navigator.credentials.create() call.

Instance methods

None.

Examples

See Retrieving a public key credential for a detailed example.

Specifications

Browser compatibility

See also

• AuthenticatorAttestationResponse: the interface for the type of response given when creating a new credential
• AuthenticatorResponse: the parent interface