PublicKeyCredential:authenticatorAttachment 属性

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在某些或所有支持的浏览器中。

authenticatorAttachmentPublicKeyCredential 接口的只读属性,它是一个字符串,指示在关联的 navigator.credentials.create()navigator.credentials.get() 调用期间使用的身份验证器的常规类别。

一个字符串,其值为以下值之一:

"platform"

身份验证器是 WebAuthn 正在运行的设备的一部分(称为平台身份验证器),因此 WebAuthn 将使用该平台可用的传输方式(例如特定于平台的 API)与其通信。绑定到平台身份验证器的公钥凭据称为平台凭据

"cross-platform"

身份验证器不是 WebAuthn 正在运行的设备的一部分(称为漫游身份验证器,因为它可以在不同的设备之间漫游),因此 WebAuthn 将使用跨平台传输协议(如蓝牙或 NFC)与其通信。绑定到漫游身份验证器的公钥凭据称为漫游凭据

示例

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: "[email protected]",
    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
  });

规范

规范
Web 身份验证:访问公钥凭据的 API - 3 级
# dom-publickeycredential-authenticatorattachment

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。