PublicKeyCredential: authenticatorAttachment-Eigenschaft

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die schreibgeschützte Eigenschaft authenticatorAttachment des PublicKeyCredential-Interfaces ist ein String, der die allgemeine Kategorie des Authentifikators angibt, der während des zugehörigen Aufrufes von navigator.credentials.create() oder navigator.credentials.get() verwendet wird.

Wert

Ein String, welcher einer der folgenden Werte sein wird:

"platform"

Der Authentifikator ist Teil des Geräts, auf dem WebAuthn läuft (als Plattform-Authenticator bezeichnet), daher wird WebAuthn mit ihm über ein für diese Plattform verfügbares Transportmittel kommunizieren, wie zum Beispiel eine plattformspezifische API. Ein öffentlicher Schlüssel, der an einen Plattform-Authenticator gebunden ist, wird als Plattform-Anmeldedaten bezeichnet.

"cross-platform"

Der Authentifikator ist nicht Teil des Geräts, auf dem WebAuthn läuft (als Roaming-Authenticator bezeichnet, da er zwischen verschiedenen Geräten wechseln kann), daher wird WebAuthn mit ihm über ein plattformübergreifendes Transportprotokoll wie Bluetooth oder NFC kommunizieren. Ein öffentlicher Schlüssel, der an einen Roaming-Authenticator gebunden ist, wird als Roaming-Anmeldedaten bezeichnet.

Beispiele

js
const options = {
  challenge: new Uint8Array(26) /* from the server */,
  rp: {
    name: "Example CORP",
    id: "login.example.com",
  },
  user: {
    id: new Uint8Array(26) /* To be changed for each user */,
    name: "canand@example.com",
    displayName: "Carina Anand",
  },
  pubKeyCredParams: [
    {
      type: "public-key",
      alg: -7,
    },
  ],
};

navigator.credentials
  .create({ publicKey: options })
  .then((pubKeyCredential) => {
    const attachment = pubKeyCredential.authenticatorAttachment;
    // Do something with authenticatorAttachment
  })
  .catch((err) => {
    // Deal with any error
  });

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser