AuthenticatorAttestationResponse: getTransports() Methode
Baseline 2023Newly available
Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die getTransports() Methode der AuthenticatorAttestationResponse Schnittstelle gibt ein Array von Zeichenfolgen zurück, das die verschiedenen Transports beschreibt, die vom Authenticator verwendet werden können.
Solche Transports können USB, NFC, BLE, intern (zutreffend, wenn der Authenticator nicht vom Gerät entfernt werden kann) oder ein hybrider Ansatz sein. Websites sollten dieses Array nicht interpretieren, sondern es zusammen mit den restlichen Anmeldedaten speichern. Bei einem nachfolgenden Aufruf von navigator.credentials.get() sollte der transports Wert innerhalb von publicKey.allowCredentials auf den gespeicherten Array-Wert gesetzt werden. Dies gibt dem Browser einen Hinweis darauf, welche Arten von Authenticatoren er ausprobieren soll, wenn eine Bestätigung für diesen Anmeldedatensatz vorgenommen wird.
Syntax
getTransports()
Parameter
Keine.
Rückgabewert
Ein Array von Zeichenfolgen, das die verschiedenen vom Authenticator unterstützten Transports in lexikographischer Reihenfolge darstellt.
Die Werte können umfassen:
"ble"-
Der Authenticator kann über BLE (Bluetooth Low Energy) verwendet werden.
"hybrid"-
Der Authenticator kann über eine Kombination von (oft getrennten) Datentransport- und Näherungsmechanismen verwendet werden. Dies unterstützt beispielsweise die Authentifizierung auf einem Desktop-Computer mit einem Smartphone.
"internal"-
Der Authenticator ist spezifisch an das Client-Gerät gebunden (kann nicht entfernt werden).
"nfc"-
Der Authenticator kann über NFC (Near Field Communication) verwendet werden.
"usb"-
Der Authenticator kann über USB kontaktiert werden.
Beispiele
Siehe Erstellen eines öffentlichen Schlüsselanmeldedatensatzes für ein detailliertes Beispiel.
Spezifikationen
| Specification |
|---|
| Web Authentication: An API for accessing Public Key Credentials - Level 3 # dom-authenticatorattestationresponse-gettransports |