用于更改密码的知名 URL

2. 基础设施

本规范依赖 Infra 标准。[INFRA]

本规范使用 Fetch、 HTML、 HTTP 和 URL 标准中的术语。[FETCH] [HTML] [HTTP-SEMANTICS] [URL]

3. 更改密码 URL

一个更改密码 url 是某个源的一个 URL，它指向客户端可用来发现用户应前往何处 在该源上更新其密码的资源。

给定一个 origin，客户端通过运行以下步骤生成更改密码 url：

1. 如果 origin 不是潜在可信源，则返回失败。

2. 断言：origin 是一个元组源。

3. 令 url 为一个新的 URL， 其值设置如下：

   方案

   origin 的方案

   主机

   origin 的主机

   端口

   origin 的端口

   路径

   « ".well-known", "change-password" »。

4. 返回 url。

源 "https://example.com/" 的更改密码 url 是 "https://example.com/.well-known/change-password"。

服务器应将对于某个源的更改密码 url的 HTTP 请求重定向到用户可在其上更改密码的实际页面，方式是返回一个具有 302、303 或 307 重定向状态 的响应，并带有 Location 头。[FETCH] [HTTP-SEMANTICS] 客户端在请求更改密码 url时必须处理此类重定向。

注： 上述段落将服务器限制为使用 临时重定向码。 参见 Issue 13。

如有必要，服务器可以响应一个 HTML 文档，其中包含一个 http-equiv pragma 指令，并处于刷新状态。[HTML] 客户端在请求更改 密码 url时应处理此类重定向。

根据 RFC8615 §1.1 知名 URI 的适当使用，服务器不得将实际的更改密码页面放置在更改密码 url处。客户端在请求更改密码 url时必须处理ok 状态响应。

注： 实现在显示更改密码 url时，可能希望使用 ToUnicode。[IDNA]

使用来自 [RESPONSE-CODE-RELIABILITY] 的测试某个 源的响应状态码的可靠性。

4. IANA 考虑事项

4.1. change-password 知名 URI

本文档定义了“.well-known”URI change-password。 此注册将提交给 IESG 进行审查、批准，并使用 [WELL-KNOWN] 中定义的 模板向 IANA 注册，如下所示：

URI 后缀

change-password

变更控制者

W3C

规范文档

本文档是相关规范。（参见 § 3 更改密码 URL）

相关信息：

无。

致谢

感谢 Anne van Kesteren、 Cl1608Ho、 Dan Bernstein、 David Singer、 Dean Jackson、 Florian Rivoal、 John Wilander、 Maciej Stachowiak、 Mark Nottingham、 Mike West 和 Ricky Mondello 对本提案提供的反馈。它的所有特性都归功于他们，而所有 bug 都归我。