IdentityCredentialRequestOptions

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

IdentityCredentialRequestOptions 字典表示传递给 CredentialsContainer.get() 作为 identity 选项值的对象。

它用于请求由支持 联合凭据管理 (FedCM) API联合身份提供商 提供的 IdentityCredential

实例属性

context 可选

一个字符串,指定用户使用 FedCM 进行身份验证的上下文。浏览器使用此值来更改其 FedCM UI 中的文本,以更好地适应上下文。可能的值为

"continue"

适用于用户选择身份以继续流程中的下一页的情况,该页面需要登录。浏览器将提供类似于以下内容的文本字符串:

使用 <IdP> 继续访问 <page-origin>

"signin"

适用于用户使用其在此来源上已使用过的 IdP 帐户登录的一般情况。浏览器将提供类似于以下内容的文本字符串:

使用 <IdP> 登录 <page-origin>

"signup"

适用于用户使用之前从未在此处使用过的新的 IdP 帐户登录到来源的情况。浏览器将提供类似于以下内容的文本字符串:

使用 <IdP> 注册 <page-origin>

"use"

适用于执行其他操作(例如验证付款)的情况。浏览器将提供类似于以下内容的文本字符串:

使用 <IdP> 使用 <page-origin>

默认值为 "signin"

providers

一个数组,包含一个指定要用于登录的 IdP 详细信息的对象。此对象可以包含以下属性

configURL

一个字符串,指定 IdP 配置文件的 URL。有关更多信息,请参阅提供配置文件

clientId

一个字符串,指定 RP 的客户端标识符。此信息由 IdP 在特定于 IdP 的单独流程中发布给 RP。

loginHint 可选

一个字符串,提供有关浏览器应为用户提供的帐户选项的提示,以便用户使用这些帐户登录。这在用户已登录并且站点要求他们重新进行身份验证的情况下很有用。否则,当用户有多个帐户并且记不住之前使用哪个帐户登录时,重新身份验证过程可能会令人困惑。loginHint 属性的值可以取自用户的先前登录,并与 IdP 在从 IdP 的 帐户列表端点 返回的用户数据数组中提供的 login_hints 值进行匹配。

nonce 可选

一个随机字符串,可以包含在内以确保响应专门为此请求发出,并防止 重放攻击

注意:目前 FedCM 仅允许使用单个 IdP 调用 API,即 providers 数组的长度必须为 1。必须通过不同的 get() 调用支持多个 IdP。

规范

规范
未知规范
# dictdef-identitycredentialrequestoptions