AuthenticatorAssertionResponse: userHandle-Eigenschaft

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 userHandle-Eigenschaft des Lesezugriffs des AuthenticatorAssertionResponse-Interfaces ist ein ArrayBuffer-Objekt, das einen undurchsichtigen Bezeichner für den angegebenen Benutzer bereitstellt. Ein solcher Bezeichner kann vom Server der vertrauenden Partei verwendet werden, um das Benutzerkonto mit den entsprechenden Anmeldeinformationen und anderen Daten zu verknüpfen.

Dieser Wert wird als user.id in den Optionen angegeben, die dem ursprünglichen navigator.credentials.create()-Aufruf übergeben werden.

Wert

Ein ArrayBuffer-Objekt, das einen Bezeichner für den aktuellen Benutzer darstellt. Dieser ist nicht für den Menschen lesbar. Die vertrauende Partei sollte sicherstellen, dass die in den ursprünglichen create()-Aufruf übergebene user.id keine persönlich identifizierbaren Informationen (wie zum Beispiel Benutzername, E-Mail oder Telefonnummer) enthält.

Für navigator.credentials.create()-Aufrufe, die mit nicht-leeren allowCredentials-Eigenschaften erfolgen, kann das zurückgegebene userHandle null sein.

Beispiele

Siehe Benutzeranmeldung mit der WebAuthn-API für ein ausführliches Beispiel.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch