AuthenticatorAttestationResponse: getTransports() Methode
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die getTransports() Methode des AuthenticatorAttestationResponse-Interfaces gibt ein Array von Strings zurück, das die verschiedenen Transporte beschreibt, die vom Authentifikator verwendet werden können.
Solche Transporte können USB, NFC, BLE, intern (zutreffend, wenn der Authentifikator nicht vom Gerät entfernt werden kann) oder ein hybrider Ansatz sein. Websites sollten dieses Array nicht interpretieren, sondern es zusammen mit den restlichen Anmeldeinformationen speichern. Bei einem nachfolgenden navigator.credentials.get()-Aufruf sollte der in publicKey.allowCredentials angegebene transports-Wert auf den gespeicherten Array-Wert gesetzt werden. Dies gibt dem Browser einen Hinweis darauf, welche Arten von Authentifikatoren versucht werden sollen, wenn eine Assertion für diese Anmeldeinformation gemacht wird.
Syntax
getTransports()
Parameter
Keine.
Rückgabewert
Ein Array von Strings, das die verschiedenen vom Authentifikator unterstützten Transporte in lexikographischer Reihenfolge darstellt.
Zu den Werten können gehören:
ble-
Der Authentifikator kann über BLE (Bluetooth Low Energy) verwendet werden.
"hybrid"-
Der Authentifikator kann über eine Kombination von (oft getrennten) Datentransport- und Näherungsmechanismen verwendet werden. Dies unterstützt beispielsweise die Authentifizierung auf einem Desktop-Computer mithilfe eines Smartphones.
"internal"-
Der Authentifikator ist speziell an das Client-Gerät gebunden (kann nicht entfernt werden).
"nfc"-
Der Authentifikator kann über NFC (Near Field Communication) verwendet werden.
"usb"-
Der Authentifikator kann über USB kontaktiert werden.
Beispiele
Siehe Erstellen eines öffentlichen Schlüsselanmeldedatensatzes mit der WebAuthn API für ein detailliertes Beispiel.
Spezifikationen
| Specification |
|---|
| Web Authentication: An API for accessing Public Key Credentials - Level 3 # dom-authenticatorattestationresponse-gettransports |
Browser-Kompatibilität
BCD tables only load in the browser