AuthenticatorAttestationResponse

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.

* Some parts of this feature may have varying levels of support.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Das AuthenticatorAttestationResponse Interface der Web Authentication API ist das Ergebnis einer WebAuthn-Credential-Registrierung. Es enthält Informationen über das Credential, die der Server benötigt, um WebAuthn-Bestätigungen durchzuführen, wie z. B. seine Credential-ID und den öffentlichen Schlüssel.

Eine Instanz des AuthenticatorAttestationResponse-Objekts ist in der response Eigenschaft eines PublicKeyCredential Objekts verfügbar, das von einem erfolgreichen Aufruf von CredentialsContainer.create() zurückgegeben wurde.

Dieses Interface erbt von AuthenticatorResponse.

AuthenticatorResponse AuthenticatorAttestationResponse

Hinweis: Dieses Interface ist auf Top-Level-Kontexte beschränkt. Die Nutzung seiner Funktionen innerhalb eines <iframe>-Elements wird keine Wirkung haben.

Instanz-Eigenschaften

Erbt auch Eigenschaften von seinem Elterninterface, AuthenticatorResponse.

AuthenticatorAttestationResponse.attestationObject Schreibgeschützt

Ein ArrayBuffer, der Authentifikator-Daten und eine Attestierungserklärung für ein neues Schlüsselpaar enthält, das vom Authentifikator generiert wurde.

AuthenticatorResponse.clientDataJSON Schreibgeschützt

Geerbt von AuthenticatorResponse, enthält diese Eigenschaft die JSON-kompatible Serialisierung der Daten, die vom Browser an den Authentifikator übergeben wurden, um dieses Credential zu erstellen — d.h. wenn CredentialsContainer.create() mit einer publicKey-Option aufgerufen wird. Diese Daten enthalten einige Informationen aus den Optionen, die in den create()-Aufruf übergeben wurden, sowie einige vom Browser kontrollierte Informationen.

Instanz-Methoden

AuthenticatorAttestationResponse.getAuthenticatorData()

Gibt ein ArrayBuffer zurück, das die Authentifikator-Daten enthält, die innerhalb der AuthenticatorAttestationResponse.attestationObject-Eigenschaft enthalten sind.

AuthenticatorAttestationResponse.getPublicKey()

Gibt ein ArrayBuffer zurück, das die DER SubjectPublicKeyInfo des neuen Credentials enthält (siehe Subject Public Key Info), oder null, falls diese Information nicht verfügbar ist.

AuthenticatorAttestationResponse.getPublicKeyAlgorithm()

Gibt eine Zahl zurück, die einem COSE Algorithm Identifier entspricht und den kryptografischen Algorithmus darstellt, der für das neue Credential verwendet wird.

AuthenticatorAttestationResponse.getTransports()

Gibt ein Array von Strings zurück, das beschreibt, welche Transportmethoden (z.B. usb, nfc) voraussichtlich mit dem Authentifikator unterstützt werden. Das Array kann leer sein, wenn die Informationen nicht verfügbar sind.

Beispiele

Siehe Erstellen eines öffentlichen Schlüssel-Credentials für ein detailliertes Beispiel.

Spezifikationen

Specification
Web Authentication: An API for accessing Public Key Credentials - Level 3
# authenticatorattestationresponse

Browser-Kompatibilität

Siehe auch