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-Anmeldeinformationsregistrierung. Es enthält Informationen über die Anmeldeinformationen, die der Server benötigt, um WebAuthn-Behauptungen auszuführen, wie z. B. deren Anmeldekennungen und öffentliche 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 wird.

Dieses Interface erbt von AuthenticatorResponse.

AuthenticatorResponse AuthenticatorAttestationResponse

Hinweis: Dieses Interface ist auf oberste Kontexte beschränkt. Die Verwendung seiner Funktionen innerhalb eines <iframe>-Elements hat keine Wirkung.

Instanz-Eigenschaften

Erbt auch Eigenschaften von seinem übergeordneten Element, AuthenticatorResponse.

AuthenticatorAttestationResponse.attestationObject Schreibgeschützt

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

AuthenticatorResponse.clientDataJSON Schreibgeschützt

Diese von AuthenticatorResponse geerbte Eigenschaft enthält die JSON-kompatible Serialisierung der Daten, die vom Browser an den Authentifikator übergeben wurden, 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 einen ArrayBuffer zurück, der die Authentifikator-Daten enthält, die in der AuthenticatorAttestationResponse.attestationObject-Eigenschaft enthalten sind.

AuthenticatorAttestationResponse.getPublicKey()

Gibt einen ArrayBuffer zurück, der die DER SubjectPublicKeyInfo der neuen Anmeldeinformationen enthält (siehe Subject Public Key Info), oder null, falls diese nicht verfügbar ist.

AuthenticatorAttestationResponse.getPublicKeyAlgorithm()

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

AuthenticatorAttestationResponse.getTransports()

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

Beispiele

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch