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 AuthenticatorAssertionResponse-Interfaces ist eine schreibgeschützte ArrayBuffer-Objekt, das einen opaken Bezeichner für den gegebenen Benutzer bereitstellt. Ein solcher Bezeichner kann vom Server der vertrauenden Partei verwendet werden, um das Benutzerkonto mit den entsprechenden Anmeldedaten und anderen Daten zu verknüpfen.

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

Wert

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

Für navigator.credentials.create()-Aufrufe, die mit nicht leeren allowCredentials-Eigenschaften getätigt werden, kann der zurückgegebene userHandle null sein.

Beispiele

Siehe Abrufen eines Public Key Credential für ein detailliertes Beispiel.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch