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.

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

Die AuthenticatorAttestationResponse-Schnittstelle der Web Authentication API ist das Ergebnis einer WebAuthn-Anmeldeinformationen Registrierung. Sie enthält Informationen über die Anmeldeinformationen, die der Server benötigt, um WebAuthn-Bestätigungen durchzuführen, wie z.B. die Anmeldeinformations-ID und den öffentlichen Schlüssel.

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

Diese Schnittstelle erbt von AuthenticatorResponse.

AuthenticatorResponse AuthenticatorAttestationResponse

Hinweis: Diese Schnittstelle ist auf Kontexte der obersten Ebene beschränkt. Die Verwendung ihrer Funktionen innerhalb eines <iframe>-Elements wird keine Auswirkungen haben.

Instanz-Eigenschaften

Erbt auch Eigenschaften von ihrem Elternteil, AuthenticatorResponse.

AuthenticatorAttestationResponse.attestationObject Nur lesbar

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

AuthenticatorResponse.clientDataJSON Nur lesbar

Von AuthenticatorResponse geerbt, enthält diese Eigenschaft die JSON-kompatible Serialisierung der Daten, die vom Browser an den Authentifikator übergeben werden, um diese Anmeldeinformationen zu generieren — d.h., wenn CredentialsContainer.create() mit einer publicKey-Option aufgerufen wird. Diese Daten enthalten einige Informationen aus den in den create()-Aufruf übergebenen Optionen und einige Informationen, die vom Browser kontrolliert werden.

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 das DER SubjectPublicKeyInfo der neuen Anmeldeinformationen enthält (siehe Subject Public Key Info), oder null, wenn dies nicht verfügbar ist.

AuthenticatorAttestationResponse.getPublicKeyAlgorithm()

Gibt eine Zahl zurück, die einem COSE-Algorithmus-Identifier entspricht und den kryptografischen Algorithmus darstellt, der für die neuen Anmeldeinformationen verwendet wird.

AuthenticatorAttestationResponse.getTransports()

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

Beispiele

Siehe Erstellen einer öffentlichen Schlüssel-Anmeldeinformation mit der WebAuthn API für ein detailliertes Beispiel.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch