AuthenticatorAttestationResponse
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The AuthenticatorAttestationResponse
interface of the Web Authentication API is returned by CredentialsContainer.create()
when a PublicKeyCredential
is passed, and provides a cryptographic root of trust for the new key pair that has been generated. This response should be sent to the relying party's server to complete the creation of the credential.
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.
Properties
AuthenticatorAttestationResponse.clientDataJSON
Secure contextRead only-
Client data for the authentication, such as origin and challenge. The
clientDataJSON
property is inherited from theAuthenticatorResponse
. AuthenticatorAttestationResponse.attestationObject
Secure contextRead only-
An
ArrayBuffer
containing authenticator data and an attestation statement for a newly-created key pair.
Methods
AuthenticatorAttestationResponse.getTransports()
Secure context-
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
var publicKey = {
challenge: /* from the server */,
rp: {
name: "Example CORP",
id : "login.example.com"
},
user: {
id: new Uint8Array(16),
name: "jdoe@example.com",
displayName: "John Doe"
},
pubKeyCredParams: [
{
type: "public-key",
alg: -7
}
]
};
navigator.credentials.create({ publicKey })
.then(function (newCredentialInfo) {
var response = newCredentialInfo.response;
// Do something with the response
// (sending it back to the relying party server maybe?)
}).catch(function (err) {
console.error(err);
});
Specifications
Specification |
---|
Web Authentication: An API for accessing Public Key Credentials - Level 3 # authenticatorattestationresponse |
Browser compatibility
BCD tables only load in the browser
See also
AuthenticatorAssertionResponse
: the interface for the type of response given when retrieving an existing credentialAuthenticatorResponse
: the parent interface