跳到主要内容

6. IANA 考虑事项 (IANA Considerations)

IANA 已根据本文档完成以下注册.

6.1 OAuth 参数注册表 (OAuth Parameters Registry)​

本规范在 OAuth 2.0 [RFC6749] 定义的 IANA "OAuth Parameters" 注册表中注册以下参数.

  • 参数名 (Parameter name): code_verifier
  • 参数使用位置 (Parameter usage location): token request
  • 变更控制方 (Change controller): IESG
  • 规范文档 (Specification document(s)): RFC 7636 (本文档)

  • 参数名 (Parameter name): code_challenge
  • 参数使用位置 (Parameter usage location): authorization request
  • 变更控制方 (Change controller): IESG
  • 规范文档 (Specification document(s)): RFC 7636 (本文档)

  • 参数名 (Parameter name): code_challenge_method
  • 参数使用位置 (Parameter usage location): authorization request
  • 变更控制方 (Change controller): IESG
  • 规范文档 (Specification document(s)): RFC 7636 (本文档)

6.2 PKCE 代码挑战方法注册表 (PKCE Code Challenge Method Registry)​

本规范建立 "PKCE Code Challenge Methods" 注册表. 该新注册表应作为 "OAuth Parameters" 注册表的子注册表.

用于授权端点的其他 "code_challenge_method" 类型按照 Specification Required 策略 [RFC5226] 注册, 该策略包括由一个或多个指定专家 (Designated Experts, DEs) 对请求进行审查. DE 将确保请求在 [email protected] 邮件列表上至少经过两周审查, 并且在回复请求之前该列表上的讨论已经收敛. 为了允许在规范发布前分配值, 指定专家可以在确信可接受的规范将会发布后批准注册.

注册请求以及 [email protected] 邮件列表上的讨论应使用适当主题, 例如 "Request for PKCE code_challenge_method: example".

指定专家在评估注册请求时, 应考虑邮件列表上的讨论以及挑战方法的整体安全属性. 新方法不应在发往 Authorization endpoint 的请求中泄露 code_verifier 的值. 拒绝请求时应包含解释, 并在适用时给出如何使请求成功的建议.

6.2.1 注册模板 (Registration Template)​

Code Challenge Method Parameter Name: : 所请求的名称 (例如 "example"). 由于本规范的核心目标之一是使所得表示保持紧凑, 因此推荐该名称较短, 除非有充分理由, 否则不超过 8 个字符. 该名称区分大小写. 名称不得以不区分大小写的方式匹配其他已注册名称, 除非指定专家说明在该特定情况下存在允许例外的充分理由.

Change Controller: : 对于标准轨 RFC, 填写 "IESG". 对于其他文档, 给出负责方名称. 也可以包含其他详细信息, 例如邮政地址、电子邮件地址和主页 URI.

Specification Document(s): : 引用规定该参数的文档, 最好包含可用于获取文档副本的 URI. 也可以指明相关章节, 但这不是必需的.

6.2.2 初始注册表内容 (Initial Registry Contents)​

根据本文档, IANA 已在该注册表中注册第 4.2 节定义的 Code Challenge Method Parameter Names.

  • Code Challenge Method Parameter Name: plain
  • Change Controller: IESG
  • Specification Document(s): RFC 7636 第 4.2 节 (本文档)

  • Code Challenge Method Parameter Name: S256
  • Change Controller: IESG
  • Specification Document(s): RFC 7636 第 4.2 节 (本文档)
最后于 更新