AuthenticatorAssertionResponse

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 AuthenticatorAssertionResponse-Schnittstelle der Web Authentication API enthält eine digitale Signatur des privaten Schlüssels eines bestimmten WebAuthn-Credentials. Der Server der vertrauenden Partei kann diese Signatur zur Authentifizierung eines Benutzers überprüfen, beispielsweise wenn dieser sich anmeldet.

Eine Instanz eines AuthenticatorAssertionResponse-Objekts ist in der response-Eigenschaft eines PublicKeyCredential-Objekts verfügbar, das durch einen erfolgreichen Aufruf von navigator.credentials.get() zurückgegeben wird.

Diese Schnittstelle erbt von AuthenticatorResponse.

AuthenticatorResponse AuthenticatorAssertionResponse

Hinweis: Diese Schnittstelle ist auf Kontexte der obersten Ebene beschränkt. Die Verwendung innerhalb eines <iframe>-Elements hat keine Wirkung.

Instanz-Eigenschaften

Erbt auch Eigenschaften von ihrem Elternteil, AuthenticatorResponse.

AuthenticatorAssertionResponse.authenticatorData Schreibgeschützt

Ein ArrayBuffer, das Informationen vom Authentifikator enthält, wie zum Beispiel den Relying Party ID Hash (rpIdHash), einen Zähler für Signaturen, Prüfflaggen für Anwesenheit und Benutzerüberprüfung sowie alle vom Authentifikator verarbeiteten Erweiterungen.

AuthenticatorResponse.clientDataJSON Schreibgeschützt

Enthält die JSON-kompatible Serialisierung der Daten, die vom Browser an den Authentifikator übergeben wurden, um sich mit diesem Credential zu authentifizieren — das heißt, wenn CredentialsContainer.get() mit der Option publicKey aufgerufen wird. Diese Daten enthalten einige Informationen aus den Optionen, die beim get()-Aufruf übergeben werden, sowie einige Informationen, die vom Browser gesteuert werden.

AuthenticatorAssertionResponse.signature Schreibgeschützt

Eine Assertion-Signatur über AuthenticatorAssertionResponse.authenticatorData und AuthenticatorResponse.clientDataJSON. Die Assertion-Signatur wird mit dem privaten Schlüssel des Schlüsselpaares erstellt, das während des ursprünglichen Aufrufs von navigator.credentials.create() erstellt wurde und durch den öffentlichen Schlüssel desselben Schlüsselpaares verifiziert.

AuthenticatorAssertionResponse.userHandle Schreibgeschützt

Ein ArrayBuffer, das einen undurchsichtigen Benutzer-Identifikator enthält, der als user.id in den Optionen angegeben ist, die an den ursprünglichen Aufruf von navigator.credentials.create() übergeben wurden.

Instanz-Methoden

Keine.

Beispiele

Siehe Abrufen eines öffentlichen Schlüssel-Credentials für ein ausführliches Beispiel.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch