AuthenticatorAssertionResponse: userHandle-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2021 browserübergreifend verfügbar.
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
| Spezifikation |
|---|
| Web Authentication: An API for accessing Public Key Credentials - Level 3 # dom-authenticatorassertionresponse-userhandle |
Browser-Kompatibilität
Siehe auch
CredentialsContainer.create(), das den Wert dieser Eigenschaft festlegt.