IdentityCredential

实验性: 这是一项 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表格

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

IdentityCredential 接口是 联合凭据管理 API (FedCM) 的一部分,表示来自成功联合登录的用户身份凭据。

一个成功的 navigator.credentials.get() 调用包含 identity 选项,将以 IdentityCredential 实例完成。

Credential IdentityCredential

实例属性

继承其祖先 Credential 的属性。

IdentityCredential.isAutoSelected 只读 实验性 非标准

一个布尔值,指示联合登录是使用 自动重新认证(即无需用户干预)还是未使用。

IdentityCredential.token 实验性

返回用于验证关联登录的令牌。

示例

依赖方 (RP) 可以使用 identity 选项调用 navigator.credentials.get() 来请求用户通过身份提供者 (IdP) 登录 RP,使用身份联合。一个典型的请求如下所示

js
async function signIn() {
  const identityCredential = await navigator.credentials.get({
    identity: {
      providers: [
        {
          configURL: "https://accounts.idp.example/config.json",
          clientId: "********",
          nonce: "******",
        },
      ],
    },
  });
}

如果成功,此调用将以 IdentityCredential 实例完成。例如,您可以从中返回 IdentityCredential.token

js
console.log(identityCredential.token);

查看 联合凭据管理 API (FedCM) 以了解有关其工作原理的更多详细信息。此调用将启动 FedCM 登录流程 中描述的登录流程。

规范

规范
联合凭据管理 API
# browser-api-identity-credential-interface

浏览器兼容性

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

另请参阅