凭证管理级别 1

1. 引言

本节不具有规范性。

登录网站比应当更加困难。用户代理在以多种方式改善体验方面处于独特地位，大多数现代用户代理已通过在浏览器中提供一定程度的凭据管理功能来认识到这一点。例如，用户可以保存网站的用户名和密码；这些凭据随后会被自动填充到登录表单中，尽管成功率各不相同。

autocomplete 属性提供了一种声明式机制，网站可以通过该机制与用户代理协作，提高后者检测和填充登录表单的能力，方法是将特定字段标记为“用户名”或“密码”。用户代理实现了多种检测启发法，以与未在标记中提供此详细信息的网站协作。

虽然这种启发式和声明式检测的结合工作得相对较好，但现状留下了一些检测存在问题的巨大差距。具有不常见登录机制（例如通过 XMLHttpRequest [XMLHTTPREQUEST] 提交凭据）的网站很难可靠地检测到，用户希望使用联合身份提供商进行身份验证的情况也越来越普遍。允许网站更直接地与用户代理的凭据管理器交互，一方面可以使凭据管理器更加准确，另一方面可以协助用户进行联合登录。

这些用例在 § 1.1 用例 以及 凭据管理：用例与要求 中进行了更详细的探讨；本规范试图通过定义凭据管理器 API 来解决该文档概述的许多要求，网站可以使用该 API 为用户请求凭据，并请求用户代理在用户成功登录时持久化凭据。

注意：此处定义的 API 有意保持简洁：它本身并不打算提供身份验证，而是仅限于提供一个接口，连接到现有用户代理实现的现有凭据管理器。该功能在目前就很有价值，无需供应商或作者付出巨大的努力。当然，还有很多工作可以做。请参阅 § 9 未来工作，了解我们暂时搁置但可以在此 API 的未来迭代中探索的一些想法。

1.1. 用例

现代用户代理通常为用户提供在登录网站时保存密码的能力，同样也提供在用户返回网站时全自动或半自动地将这些密码填充到登录表单中的能力。从网站的角度来看，这种行为是完全不可见的：网站不知道密码已被存储，也不知道密码已被填充。这既有优点也有缺点。一方面，用户代理的密码管理器无论网站是否配合都能工作，这对用户来说是非常好的。另一方面，密码管理器的行为是一个脆弱且专有的启发式混合体，旨在检测和填充登录表单、密码修改表单等。

现状中的几个问题尤其值得注意。

• 用户代理在协助用户使用联合身份提供商方面非常困难。虽然检测用户名/密码表单提交相当简单，但要可靠地检测通过第三方进行的登录却非常困难。如果网站能够帮助用户代理理解典型联合登录操作背后相关的重定向意图，那将是非常好的。

• 同样，用户代理在检测比简单用户名/密码表单更深奥的登录机制方面也存在困难。为了改善体验并更好地控制呈现，作者越来越多地通过 XMLHttpRequest 或类似机制异步登录用户。这对用户有好处，但对于用户代理集成到密码管理器中来说很困难。如果网站能够帮助用户代理理清他们选择使用的登录机制，那将是非常好的。

• 最后，如果网站明确告知用户代理凭据已更改，则修改密码的支持将比目前更好。

2. 核心 API

从开发者的角度来看，凭据是一个对象，允许开发者为特定操作做出身份验证决策。本节定义了一个通用且可扩展的 Credential 接口，作为本文档和其他文档中定义的凭据的基类，以及挂载在 navigator.credentials.* 上的一组 API，使开发者能够获取它们。

各种凭据类型在 JavaScript 中分别表示为一个接口，该接口直接或间接地继承自 Credential 接口。本文档定义了两个此类接口：PasswordCredential 和 FederatedCredential。其他规范（例如 [WEBAUTHN]）定义了其他凭据类型。

如果一个凭据被特定源接受为该源上的身份验证，则它对该源是有效的。即使凭据在特定时间点有效，用户代理也不能假设同一个凭据在未来的任何时间点仍然有效，原因有两个：

1. 如果账户持有人更改了密码，密码凭据可能会停止有效。

2. 通过短信收到的令牌制作的凭据可能仅对单次使用有效。

一次性凭据是由凭据来源生成的，这可能是私钥、对联合账户的访问权限、在特定电话号码上接收短信的能力或其他事物。凭据来源不会暴露给 Javascript，也不会在本规范中明确表示。为了统一模型，我们将密码视为一种独立的凭据来源，仅仅通过复制它来创建密码凭据。

即使 UA 不能假设有效的凭据如果再次使用仍然有效，或者产生有效凭据的凭据来源将来能够产生第二个有效凭据，但第二种情况比第一种更有可能。通过记录（使用 store()）哪些凭据在过去是有效的，UA 在将来更有可能向用户提供有效的凭据来源。

2.1. 基础设施

凭据管理器是一个应用程序、硬件设备或服务，它存储、组织、管理并允许选择凭据。示例凭据管理器包括数字钱包、密码管理器和通行密钥 (passkey) 管理器。

用户代理必须在内部提供一个凭据存储，这是一个特定于供应商的不透明存储机制，用于记录哪些凭据是有效的。它为凭据访问和持久化提供以下能力：

1. 存储凭据以供日后检索。此操作接受一个凭据，并将其插入凭据存储中。

2. 检索凭据列表。此操作接受任意过滤器，并返回与过滤器匹配的一组凭据。

3. 修改凭据。此操作接受一个凭据，并覆盖凭据存储中现有凭据的状态。

此外，凭据存储应为源维护一个禁止静默访问标志（除非另有说明，否则设置为 true）。如果源的标志设置为 true，则该源需要用户中介。

注意：用户中介的重要性在 § 5 用户中介 中有更详细的讨论。

注意：凭据存储是用户代理实现本文档中指定的 API 的内部实现细节，不会直接暴露给 Web。为了支持特定凭据类型，其他文档可能会指定更多能力。

本文档依赖于 Infra 标准来获取其算法和正文中使用的许多基础概念 [INFRA]。

每个环境设置对象都有一个关联的激活的凭据类型，这是一个初始为空的集合。

2.1.1. 基础设施算法

2.1.1.1. 与祖先同源

如果以下算法返回 true，则环境设置对象（settings）被认为是与祖先同源的：

1. 如果 settings 的相关全局对象没有关联文档，则返回 false。

2. 令 document 为 settings 的相关全局对象的关联文档。

3. 如果 document 没有浏览上下文，则返回 false。

4. 令 origin 为 settings 的源。

5. 令 navigable 为 document 的节点导航器。

6. 当 navigable 具有非空的父级时：

   1. 将 navigable 设置为 navigable 的父级。

   2. 如果 navigable 的活动文档的源与 origin 不同源，则返回 false。

7. 返回 true。

2.1.2. 凭据类型注册表

该注册表将凭据类型（即 [[type]] 值）映射到与给定凭据类型关联的各种值。例如：选项成员标识符（形式上是一个字典成员标识符），其规范在 CredentialCreationOptions 和 CredentialRequestOptions（即“选项字典”）中使用。

注意：此注册表由相关凭据接口对象算法使用。

2.1.2.1. 注册条目要求与更新流程

• 每个凭据类型在凭据类型集合中必须是唯一的。

• 每个注册条目必须声明在凭据规范的 CredentialCreationOptions 和 CredentialRequestOptions 扩展中使用的字典成员标识符（在注册表中称为选项成员标识符）。

• 每个注册条目必须声明该凭据类型的适当接口对象标识符。

• 每个注册条目必须声明执行该凭据类型的请求 Credential 时使用的 Get 权限策略许可，如果未指定权限策略，则为 null。

• 每个注册条目必须声明执行该凭据类型的创建 Credential 时使用的 Create 权限策略许可，如果未指定权限策略，则为 null。

• 虽然 get() 请求支持在同一请求中查询多种类型，但并非所有组合都被允许。每个注册条目必须声明一组凭据类型，该集合表示该凭据类型在同一 get() 请求中允许的类型；如果它不能与同一 get() 请求中的任何其他类型混合，则为空。每个凭据类型都可以在同一 get() 请求中与自身混合。

• 每个注册条目必须包含一个引用公开可用规范的链接，该规范定义了凭据类型和字典成员标识符。

• 每个注册条目的规范必须包含请求者的联系信息。

此注册表的更新是对凭据类型注册条目的添加、更改或删除。任何人都可以通过向 webappsec-credential-management 仓库提交 pull request 来请求更新此注册表。Web 应用安全工作组将把它放入即将召开的会议议程中，并通知请求者。对请求的审议和处置由 W3C Web 应用安全工作组通过共识决定。主席随后将通知请求者结果并相应地更新注册表。

2.2. Credential 接口

[Exposed=Window, SecureContext]
interface Credential {
  readonly attribute USVString id;
  readonly attribute DOMString type;
  static Promise<boolean> isConditionalMediationAvailable();
};

与 Tobie/Dominic 讨论接口对象部分，这里和 § 2.5.1 请求 Credential 等处。我不确定我是否理解对了术语。接口原型对象，也许？

一些 Credential 对象是源绑定的：它们包含一个名为 [[origin]] 的内部插槽，用于存储 Credential 可能有效的源。

2.2.1. Credential 内部方法

Credential 接口对象具有多个促进 Credential 对象检索和存储的内部方法，并带有本节定义的默认“无操作”实现。

除非另有说明，否则为继承自 Credential 的接口创建的每个接口对象必须提供至少一个这些内部方法的实现，覆盖 Credential 的默认实现，具体取决于凭据类型。例如：§ 3.2 PasswordCredential 接口、§ 4.1 FederatedCredential 接口 和 [WEBAUTHN]。

2.2.1.1. [[CollectFromCredentialStore]] 内部方法

Credential 的 [[CollectFromCredentialStore]](origin, options, sameOriginWithAncestors) 默认实现

1. 返回一个空集。

2.2.1.2. [[DiscoverFromExternalSource]] 内部方法

Credential 的 [[DiscoverFromExternalSource]](origin, options, sameOriginWithAncestors) 默认实现

1. 返回 null。

2.2.1.3. [[Store]] 内部方法

Credential 的 [[Store]](credential, sameOriginWithAncestors) 默认实现

1. 抛出 NotSupportedError。

2.2.1.4. [[Create]] 内部方法

• 创建一个 Credential，或者

• 不创建凭据并返回 null，或者

• 如果创建由于异常情况失败（例如，错误的选项可能会产生 TypeError），则抛出错误。

创建 Credential 时，它将返回一个接收全局对象并返回继承自 Credential 的接口对象的算法。此算法必须从任务中调用。

注意：此算法的步骤基于每个凭据类型进行定义。

Credential 的 [[Create]](origin, options, sameOriginWithAncestors) 默认实现

1. 返回 null。

2.2.2. CredentialUserData 混合项

一些 Credential 对象包含的数据旨在通过提供友好的名称和图标，在凭据选择器中为用户提供人类可读的消歧机制：

[SecureContext]
interface mixin CredentialUserData {
  readonly attribute USVString name;
  readonly attribute USVString iconURL;
};

2.3. navigator.credentials

开发者通过暴露在 CredentialsContainer 接口上的方法检索 Credential 并与用户代理的凭据存储交互，该接口挂载在 Navigator 对象上，作为 navigator.credentials。

partial interface Navigator {
  [SecureContext, SameObject] readonly attribute CredentialsContainer credentials;
};

credentials 属性必须返回与活动文档的浏览上下文关联的 CredentialsContainer。

注意：如 § 6.3 不安全站点 中所述，凭据管理 API 仅在安全上下文中暴露。

[Exposed=Window, SecureContext]
interface CredentialsContainer {
  Promise<Credential?> get(optional CredentialRequestOptions options = {});
  Promise<undefined> store(Credential credential);
  Promise<Credential?> create(optional CredentialCreationOptions options = {});
  Promise<undefined> preventSilentAccess();
};

dictionary CredentialData {
  required USVString id;
};

2.3.1. CredentialRequestOptions 字典

为了通过 get() 检索 Credential，调用者在 CredentialRequestOptions 对象中指定一些参数。

注意：CredentialRequestOptions 字典是一个扩展点。如果引入了需要选项的新类型凭据，它们的字典类型将被添加到字典中，以便它们可以传递到请求中。请参阅 § 8.2 扩展点。

dictionary CredentialRequestOptions {
  CredentialMediationRequirement mediation = "optional";
  DOMString uiMode;
  AbortSignal signal;
};

2.3.2. 中介要求

当通过 get(options) 或 create(options) 发出请求时，开发者可以通过选择适当的 CredentialMediationRequirement 枚举值，为用户中介设置具体的要求。

注意：§ 5 用户中介 节更详细地介绍了该概念，以及它如何影响用户代理处理给定源的单个请求的方式。

enum CredentialMediationRequirement {
  "silent",
  "optional",
  "conditional",
  "required"
};

2.3.3. UI 模式

当通过 get(options) 发出请求时，开发者可以通过选择适当的 CredentialUiMode 枚举值来指定所需用户中介模式。

UI Mode 字段没有默认值。当未指定时，[[DiscoverFromExternalSource]](origin, options, sameOriginWithAncestors) 方法必须独立考量 CredentialMediationRequirement，以指定用户代理的行为。

注意： 当 用户调解 发生时，这允许调用者区分不同可用的 用户调解 形式。是否显示 UI 取决于请求的 CredentialMediationRequirement 值。并非 CredentialUiMode 的所有值都与所有 CredentialMediationRequirement 值组合都有意义，并且其交互取决于支持该操作的凭据类型的 [[DiscoverFromExternalSource]](origin, options, sameOriginWithAncestors) 方法。

enum CredentialUiMode {
  "immediate"
};

2.3.3.1. 示例

window.addEventListener('load', async () => {
  const credentials = await navigator.credentials.get({
    ...,
    mediation: 'silent'
  });
  if (credentials) {
    // Hooray! Let's sign the user in using these credentials!
  }
});

document.querySelector('#sign-in').addEventListener('click', async () => {
  const credentials = await navigator.credentials.get({
    ...,
    mediation: 'optional'
  });
  if (credentials) {
    // Hooray! Let's sign the user in using these credentials!
  }
});

document.querySelector('#important-form').addEventListener('submit', async () => {
  const credentials = await navigator.credentials.get({
    ...,
    mediation: 'required'
  });
  if (credentials) {
    // Verify that |credentials| enables access, and cancel the submission
    // if it doesn't.
  } else {
    e.preventDefault();
  }
});

document.querySelector('#switch-button').addEventListener('click', e => {
  var c = await navigator.credentials.get({
    ...,
    mediation: 'required'
  });
  if (c) {
    // Sign the user in using |c|.
  }
});

2.4. CredentialCreationOptions 字典

为了通过 create() 创建 Credential，调用者需要在 CredentialCreationOptions 对象中指定一些参数。

注意： CredentialCreationOptions 字典是一个扩展点。如果引入新的凭据类型，它们将添加到此字典中，以便可以传递到创建方法中。请参阅 § 8.2 Extension Points 以及本文档中引入的扩展：§ 3.2 The PasswordCredential Interface 和 § 4.1 The FederatedCredential Interface。

dictionary CredentialCreationOptions {
  CredentialMediationRequirement mediation = "optional";
  AbortSignal signal;
};

2.5. 算法

2.5.1. 请求 Credential

请求 Credential 算法接受一个 CredentialRequestOptions (options)，并返回一个 Promise，如果能明确获取到凭据，则该 Promise 解析为 Credential；否则，解析为 null。

1. 令 settings 为 当前设置对象。

2. 断言：settings 是一个 安全上下文。

3. 令 document 为 settings 的 相关全局对象 的 关联文档。

4. 如果 document 不是 完全活动的，则返回 一个被拒绝的 promise，并带有 "InvalidStateError" DOMException。

5. 如果 options.signal 已 中止，则返回 一个被拒绝的 promise，并带有 options.signal 的 中止原因。

6. 令 interfaces 为 options 的 相关凭据接口对象。

7. 如果 interfaces 为 空，则返回 一个被拒绝的 promise，并带有 "NotSupportedError" DOMException。

8. 遍历 interfaces 中的每个 interface1

   1. 令 type1 为 interface1 的 [[type]]。

   2. 遍历 interfaces 中的每个 interface2

      1. 令 type2 为 interface2 的 [[type]]。

      2. 如果 type1 等于 type2，则继续。

      3. 如果 type1 的 同一 get() 请求中允许的类型 不 包含 type2，则返回 一个被拒绝的 promise，并带有 "NotSupportedError" DOMException。

9. 遍历 interfaces 中的每个 interface

   1. 如果 options.mediation 为 conditional 且 interface 不支持 conditional 用户调解，则返回 一个被拒绝的 promise，并带有 TypeError。

   2. 如果 options.uiMode 为 immediate 且 interface 不支持 immediate 用户调解，则返回 一个被拒绝的 promise，并带有 TypeError。

   3. 如果 settings 的 活动凭据类型 包含 interface 的 [[type]]，则返回 一个被拒绝的 promise，并带有 "NotAllowedError" DOMException。

   4. 追加 interface 的 [[type]] 到 settings 的 活动凭据类型 中。

10. 令 origin 为 settings 的 源。

11. 令 sameOriginWithAncestors 为：如果 settings 与 其祖先同源，则为 true，否则为 false。

12. 遍历 options 的 相关凭据接口对象 中的每个 interface

    1. 令 permission 为 interface 的 [[type]] 的 获取权限策略。

    2. 如果 permission 为 null，则继续。

    3. 如果 document 不 被允许使用 permission，则返回 一个被拒绝的 promise，并带有 "NotAllowedError" DOMException。

13. 令 p 为一个新的 promise。

14. 在 并行中 运行以下步骤：

    1. 令 credentials 为 从凭据存储收集 Credentials 的结果，传入 origin、options 和 sameOriginWithAncestors。

    2. 如果 credentials 是一个 异常，则 拒绝 p，并带有 credentials。

    3. 如果以下所有陈述均为真，则解析 p 并带有 credentials[0]，并跳过剩余步骤

       1. credentials 的 大小 为 1

       2. origin 不 要求用户调解

       3. options 是 先验可匹配的。

       4. options.mediation 不为 "required"。

       5. options.mediation 不为 "conditional"。

       这可能是一个错误的模型。如果能支持希望同时接受用户名/密码或 webauthn 类型凭据的网站，而无需强迫那些使用前者且希望保持登录状态的用户进行选择，那就太好了。

    4. 如果 options 的 mediation 为 "silent"，则 解析 p 并带有 null，并跳过剩余步骤。

    5. 令 result 为 请求用户选择一个 Credential 的结果，传入 options 和 credentials。

    6. 如果 result 是一个 接口对象

       1. 将 result 设置为执行 result 的 [[DiscoverFromExternalSource]](origin, options, sameOriginWithAncestors) 的结果，传入 origin、options 和 sameOriginWithAncestors。

          如果该操作抛出一个 异常

          1. 令 e 为抛出的 异常。

          2. 在全局对象 的 DOM 操作任务源 上排队一个任务以运行以下子步骤

             1. 拒绝 p，并带有 e。

          3. 终止这些子步骤。

    7. 断言：result 为 null 或一个 Credential。

    8. 如果 result 是一个 Credential，则 解析 p 并带有 result。

    9. 如果 result 为 null 且 options.mediation 不为 conditional，则 解析 p 并带有 result。

       注意：如果 options.mediation 为 conditional 且发现了一个 null 凭据，则 promise p 不会解析。

15. 对 p 做出反应

    1. 遍历 interfaces 中的每个 interface

       1. 移除 interface 的 [[type]] 从 settings 的 活动凭据类型 中。

16. 返回 p。

2.5.2. 从凭据存储收集 Credentials

给定一个 源 (origin)、一个 CredentialRequestOptions (options) 以及一个布尔值（当且仅当调用上下文为 与其祖先同源 时为 true，否则为 false）(sameOriginWithAncestors)，用户代理可以 从凭据存储收集 Credentials，返回存储在用户代理本地且匹配 options 过滤器的 Credential 对象集合。如果不存在此类已知的 Credential 对象，则返回的集合为空。

1. 令 possible matches 为一个空集合。

2. 遍历 options 的 相关凭据接口对象 中的每个 interface

   1. 令 r 为执行 interface 的 [[CollectFromCredentialStore]](origin, options, sameOriginWithAncestors) 内部方法的结果，作用于 origin、options 和 sameOriginWithAncestors。如果该操作抛出一个 异常，则重新抛出该异常。

   2. 断言：r 是一个 接口对象 列表。

   3. 遍历 r 中的每个 c

      1. 追加 c 到 possible matches 中。

3. 返回 possible matches。

2.5.3. 存储 Credential

存储 Credential 算法接受一个 Credential (credential)，并返回一个 Promise，该 Promise 在对象持久化到 凭据存储 后解析。

1. 令 settings 为 当前设置对象。

2. 断言：settings 是一个 安全上下文。

3. 如果 settings 的 相关全局对象 的 关联文档 不是 完全活动的，则返回 一个被拒绝的 promise，并带有 "InvalidStateError" DOMException。

4. 令 sameOriginWithAncestors 为：如果 当前设置对象 与 其祖先同源，则为 true，否则为 false。

5. 令 p 为 一个新的 promise。

6. 如果 settings 的 活动凭据类型 包含 credential 的 [[type]]，则返回 一个被拒绝的 promise，并带有 "NotAllowedError" DOMException。

7. 追加 credential 的 [[type]] 到 settings 的 活动凭据类型 中。

8. 按以下步骤并行运行：

   1. 在 credential 和 sameOriginWithAncestors 上执行 credential 的 接口对象 的 [[Store]](credential, sameOriginWithAncestors) 内部方法。

      如果该操作抛出一个 异常

      1. 令 e 为抛出的 异常。

      2. 在全局对象 的 DOM 操作任务源 上排队一个任务以运行以下子步骤

         1. 拒绝 p，并带有 e。

      否则，解析 p 并带有 undefined。

9. 对 p 做出反应

   1. 移除 credential 的 [[type]] 从 settings 的 活动凭据类型 中。

10. 返回 p。

2.5.4. 创建 Credential

创建 Credential 算法接受一个 CredentialCreationOptions (options)，并返回一个 Promise，如果能使用提供的选项创建一个 Credential，则该 Promise 解析为该凭据；否则，如果无法创建，则解析为 null。在特殊情况下，Promise 可能会拒绝并抛出相应的异常。

1. 令 settings 为 当前设置对象。

2. 断言：settings 是一个 安全上下文。

3. 令 global 为 settings 的 全局对象。

4. 令 document 为 相关全局对象 的 关联文档。

5. 如果 document 不是 完全活动的，则返回 一个被拒绝的 promise，并带有 "InvalidStateError" DOMException。

6. 令 sameOriginWithAncestors 为：如果 当前设置对象 与 其祖先同源，则为 true，否则为 false。

7. 令 interfaces 为 options 的 相关凭据接口对象 的 集合。

8. 如果以下任何陈述为真，则返回 一个被拒绝的 promise，并带有 NotSupportedError

   1. global 没有 关联文档。

   2. interfaces 的 大小 大于 1。

      注意： 在未来的某个时候放宽此限制以允许用户代理帮助用户在多种潜在凭据类型中进行选择以支持“注册”用例可能是合理的。但目前，我们通过将字典限制为单个条目来搁置此问题。

9. 遍历 interfaces 中的每个 interface

   1. 令 permission 为 interface 的 [[type]] 的 创建权限策略。

   2. 如果 permission 为 null，则继续。

   3. 如果 document 不 被允许使用 permission，则返回 一个被拒绝的 promise，并带有 "NotAllowedError" DOMException。

10. 如果 options.signal 已 中止，则返回 一个被拒绝的 promise，并带有 options.signal 的 中止原因。

11. 令 type 为 interfaces[0] 的 [[type]]。

12. 如果 settings 的 活动凭据类型 包含 type，则返回 一个被拒绝的 promise，并带有 "NotAllowedError" DOMException。

13. 追加 type 到 settings 的 活动凭据类型 中。

14. 令 origin 为 settings 的 源。

15. 令 p 为 一个新的 promise。

16. 并行运行以下步骤

    1. 令 r 为执行 interfaces[0] 的 [[Create]](origin, options, sameOriginWithAncestors) 内部方法的结果，作用于 origin、options 和 sameOriginWithAncestors。

       如果该操作抛出一个 异常

       1. 令 e 为抛出的 异常。

       2. 在全局对象 的 DOM 操作任务源 上排队一个任务以运行以下子步骤

          1. 拒绝 p，并带有 e。

       3. 终止这些子步骤。

    2. 如果 r 是一个 Credential 或 null，则 解析 p 并带有 r，并终止这些子步骤。

    3. 断言：r 是一个算法（如 § 2.2.1.4 [[Create]] internal method 中所定义）。

    4. 在全局对象 的 DOM 操作任务源 上排队一个任务以运行以下子步骤

       1. 解析 p，带有 promise 调用 r 的结果，并给定 global。

17. 对 p 做出反应

    1. 移除 type 从 settings 的 活动凭据类型 中。

18. 返回 p。

2.5.5. 防止静默访问

防止静默访问 算法接受一个 环境设置对象 (settings)，并返回一个 Promise，该 Promise 在 prevent silent access 标志持久化到 凭据存储 后解析。

1. 令 origin 为 settings 的 源。

2. 如果 settings 的 相关全局对象 的 关联文档 不是 完全活动的，则返回 一个被拒绝的 promise，并带有 "InvalidStateError" DOMException。

3. 令 p 为 一个新的 promise。

4. 并行 运行以下步骤

   1. 设置 origin 在 凭据存储 中的 防止静默访问标志。

   2. 解析 p 并带有 undefined。

5. 返回 p。

3. 密码凭据

无论好坏，许多网站都依赖用户名/密码对作为身份验证机制。PasswordCredential 接口是一种旨在启用此用例的 凭据，它存储用户名和密码，以及可以帮助用户从 凭据选择器 中选择正确账户的元数据。

3.1. 示例

3.1.1. 基于密码的登录

navigator.credentials
  .get({ 'password': true })
  .then(credential => {
    if (!credential) {
      return; // as above...
    }
    if (credential.type === 'password') {
      document.querySelector('input[name=username_field]').value =
        credential.id;
      document.querySelector('input[name=password_field]').value =
        credential.password;
      document.getElementById('myform').submit();
    }
  });

注意： 用户代理呈现的 凭据选择器 可能允许用户选择实际上未存储在当前源中的凭据。例如，在登录 https://www.example.com 时，它可能会提供来自 https://m.example.com 的凭据（如 § 6.1 Cross-domain credential access 中所述），或者可能允许用户即时创建新凭据。开发者可以通过在凭据成功使用时每次都调用 store() 来妥善处理这种不确定性，即使是在刚刚从 get() 获取凭据之后：如果凭据尚未为该源存储，用户将获得存储的机会。如果它们已存储，则不会提示用户。

3.1.2. 登录后确认

为了确保在登录成功后向用户提供存储新凭据的建议，可以将它们传递给 store()。

document.querySelector('#theForm').addEventListener('submit', e => {
    if (window.PasswordCredential) {
      e.preventDefault();

      // Construct a new PasswordCredential from the HTMLFormElement
      // that fired the "submit" event: this will suck up the values of the fields
      // labeled with "username" and "current-password" autocomplete
      // attributes:
      var c = new PasswordCredential(e.target);

      // Fetch the form's action URL, passing that new credential object in
      // as a FormData object. If the response indicates success, tell the user agent
      // so it can ask the user to store the password for future use:
      var opt = {
        method: 'POST',
        body: new FormData(e.target),
        credentials: 'include'  // Send cookies.
      };
      fetch(e.target.action, opt).then(r => {
        if (/* |r| is a "successful" Response */)
          navigator.credentials.store(c);
      });
    }
});

3.1.3. 更改密码

同样的存储机制可以复用于“更改密码”，无需修改：如果用户更改了其凭据，网站可以通知用户代理他们已使用新凭据成功登录。然后，用户代理可以更新其存储的凭据。

<form action="https://example.com/changePassword" method="POST" id="theForm">
  <input type="hidden" name="username" autocomplete="username" value="user">
  <label for="password">New Password</label>
  <input type="password" id="password" name="password" autocomplete="new-password">
  <input type="submit">
</form>

document.querySelector('#theForm').addEventListener('submit', e => {
  if (window.PasswordCredential) {
    e.preventDefault();

    // Construct a new PasswordCredential from the HTMLFormElement
    // that fired the "submit" event: this will suck up the values of the fields
    // labeled with "username" and "new-password" autocomplete
    // attributes:
    var c = new PasswordCredential(e.target);

    // Fetch the form's action URL, passing that new credential object in
    // as a FormData object. If the response indicates success, tell the user agent
    // so it can ask the user to store the password for future use:
    var opt = {
      method: 'POST',
      body: new FormData(e.target),
      credentials: 'include'  // Send cookies.
    };
    fetch(e.target.action, opt).then(r => {
      if (/* |r| is a "successful" Response */)
        navigator.credentials.store(c);
    });
  }
});

3.2. PasswordCredential 接口

[Exposed=Window,
 SecureContext]
interface PasswordCredential : Credential {
  constructor(HTMLFormElement form);
  constructor(PasswordCredentialData data);
  readonly attribute USVString password;
};
PasswordCredential includes CredentialUserData;

partial dictionary CredentialRequestOptions {
  boolean password = false;
};

dictionary PasswordCredentialData : CredentialData {
  USVString name;
  USVString iconURL;
  required USVString origin;
  required USVString password;
};

typedef (PasswordCredentialData or HTMLFormElement) PasswordCredentialInit;

partial dictionary CredentialCreationOptions {
  PasswordCredentialInit password;
};