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 der AuthenticatorAttestationResponse-Schnittstelle gibt ein Array von Zeichenfolgen zurück, die die verschiedenen Transporte beschreiben, die vom Authentifikator verwendet werden können.

Solche Transporte können USB, NFC, BLE, intern (anwendbar, 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 Aufruf von navigator.credentials.get() 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 Behauptung für diese Anmeldeinformationen gemacht wird.

Syntax

js
getTransports()

Parameter

Keine.

Rückgabewert

Ein Array von Zeichenfolgen, die die verschiedenen vom Authentifikator unterstützten Transporte in lexikographischer Reihenfolge darstellen. Mögliche Werte sind:

  • "ble": Der Authentifikator kann über BLE (Bluetooth Low Energy) verwendet werden.
  • "hybrid": Der Authentifikator kann über eine Kombination von (oft getrennten) Datenübertragungs- und Näherungsmechanismen verwendet werden. Dies unterstützt beispielsweise die Authentifizierung auf einem Desktop-Computer mit einem Smartphone.
  • "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