MDN self-hosted library · e01.org

AuthenticatorAttestationResponse

Web Authentication API

no runnable cells web-api-interface upstream source

Web Authentication API

The AuthenticatorAttestationResponse interface of the Web Authentication API is the result of a WebAuthn credential registration. It contains information about the credential that the server needs to perform WebAuthn assertions, such as its credential ID and public key.

An AuthenticatorAttestationResponse object instance is available in the response property of a PublicKeyCredential object returned by a successful CredentialsContainer.create() call.

This interface inherits from AuthenticatorResponse.

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

Instance properties

Also inherits properties from its parent, AuthenticatorResponse.

  • AuthenticatorAttestationResponse.attestationObject
  • : An ArrayBuffer containing authenticator data and an attestation statement for a new key pair generated by the authenticator.

  • AuthenticatorResponse.clientDataJSON

  • : Inherited from AuthenticatorResponse, this property contains the JSON-compatible serialization of the data passed from the browser to the authenticator in order to generate this credential — i.e., when CredentialsContainer.create() is called with a publicKey option. This data contains some information from the options passed into the create() call, and some information controlled by the browser.

Instance methods

  • AuthenticatorAttestationResponse.getAuthenticatorData()
  • : Returns an ArrayBuffer containing the authenticator data contained within the AuthenticatorAttestationResponse.attestationObject property.
  • AuthenticatorAttestationResponse.getPublicKey()
  • : Returns an ArrayBuffer containing the DER SubjectPublicKeyInfo of the new credential (see Subject Public Key Info), or null if this is not available.
  • AuthenticatorAttestationResponse.getPublicKeyAlgorithm()
  • : Returns a number that is equal to a COSE Algorithm Identifier, representing the cryptographic algorithm used for the new credential.
  • AuthenticatorAttestationResponse.getTransports()
  • : Returns an array of strings describing which transport methods (e.g., usb, nfc) are believed to be supported with the authenticator. The array may be empty if the information is not available.

Examples

See Creating a public key credential for a detailed example.

Specifications

Browser compatibility

See also

  • AuthenticatorAssertionResponse: the interface for the type of response given when retrieving an existing credential
  • AuthenticatorResponse: the parent interface