跳到主要内容

9. IANA 考量

9. IANA 考量 (IANA Considerations)​

以下注册过程适用于本规范建立的所有注册表.

值按照 Specification Required [RFC5226] 的原则注册, 注册前需要在 [email protected] 邮件列表上经过三周审查期, 并依据一名或多名指定专家 (Designated Experts) 的建议进行. 但是, 为了允许在规范发布前分配值, 一旦指定专家确信此类规范将会发布, 即可批准注册.

发送到邮件列表进行审查的注册请求应使用适当的主题 (例如, "Request to register header parameter: example").

在审查期内, 指定专家将批准或拒绝注册请求, 并将此决定通知审查列表和 IANA. 拒绝时应包含说明, 并在适用时给出如何使请求成功的建议. 对于超过 21 天仍未确定的注册请求, 可以提交给 IESG (使用 [email protected] 邮件列表) 以便解决.

指定专家应采用的判定标准包括: 拟议注册是否重复已有功能, 它是否可能具有通用适用性或仅对单个应用有用, 以及注册说明是否清晰.

IANA 必须只接受来自指定专家的注册表更新, 并应将所有注册请求引导至审查邮件列表.

建议任命多名指定专家, 使其能够代表使用本规范的不同应用视角, 从而对注册决定进行信息更充分的审查. 如果某项注册决定可能被认为会对特定专家造成利益冲突, 该专家应服从其他专家的判断.

9.1 JSON Web Signature and Encryption Header Parameters 注册表​

本规范为 Header Parameter 名称建立 IANA "JSON Web Signature and Encryption Header Parameters" 注册表. 该注册表记录 Header Parameter 名称以及定义该名称的规范引用. 只要不同规范之间的参数用法兼容, 同一个 Header Parameter 名称可以注册多次. 同一 Header Parameter 名称的不同注册通常会使用不同的 Header Parameter Usage Locations 值.

9.1.1 注册模板​

Header Parameter Name: : 请求的名称 (例如, "kid"). 由于本规范的核心目标之一是使所得表示形式紧凑, 因此 RECOMMENDED 使用简短名称 -- 除非有充分理由, 否则不超过 8 个字符. 该名称区分大小写. 除非指定专家说明存在允许例外的充分理由, 否则名称不得以大小写不敏感的方式匹配其他已注册名称.

Header Parameter Description: : Header Parameter 的简短说明 (例如, "Key ID").

Header Parameter Usage Location(s): : Header Parameter 使用位置, 应为 "JWS" 或 "JWE" 中的一个或多个值.

Change Controller: : 对于 Standards Track RFC, 列出 "IESG". 对于其他规范, 给出责任方名称. 也可以包含其他详细信息 (例如, 邮政地址, 电子邮件地址, 主页 URI).

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

9.1.2 初始注册表内容​

本节在此注册表中注册 Section 4.1 定义的 Header Parameter 名称.

  • Header Parameter Name: "alg"
  • Header Parameter Description: 算法 (Algorithm)
  • Header Parameter Usage Location(s): JWS
  • Change Controller: IESG
  • Specification Document(s): Section 4.1.1 of RFC 7515
  • Header Parameter Name: "jku"
  • Header Parameter Description: JWK Set URL
  • Header Parameter Usage Location(s): JWS
  • Change Controller: IESG
  • Specification Document(s): Section 4.1.2 of RFC 7515
  • Header Parameter Name: "jwk"
  • Header Parameter Description: JSON Web Key
  • Header Parameter Usage Location(s): JWS
  • Change Controller: IESG
  • Specification Document(s): Section 4.1.3 of RFC 7515
  • Header Parameter Name: "kid"
  • Header Parameter Description: Key ID
  • Header Parameter Usage Location(s): JWS
  • Change Controller: IESG
  • Specification Document(s): Section 4.1.4 of RFC 7515
  • Header Parameter Name: "x5u"
  • Header Parameter Description: X.509 URL
  • Header Parameter Usage Location(s): JWS
  • Change Controller: IESG
  • Specification Document(s): Section 4.1.5 of RFC 7515
  • Header Parameter Name: "x5c"
  • Header Parameter Description: X.509 证书链 (X.509 Certificate Chain)
  • Header Parameter Usage Location(s): JWS
  • Change Controller: IESG
  • Specification Document(s): Section 4.1.6 of RFC 7515
  • Header Parameter Name: "x5t"
  • Header Parameter Description: X.509 证书 SHA-1 指纹 (X.509 Certificate SHA-1 Thumbprint)
  • Header Parameter Usage Location(s): JWS
  • Change Controller: IESG
  • Specification Document(s): Section 4.1.7 of RFC 7515
  • Header Parameter Name: "x5t#S256"
  • Header Parameter Description: X.509 证书 SHA-256 指纹 (X.509 Certificate SHA-256 Thumbprint)
  • Header Parameter Usage Location(s): JWS
  • Change Controller: IESG
  • Specification Document(s): Section 4.1.8 of RFC 7515
  • Header Parameter Name: "typ"
  • Header Parameter Description: 类型 (Type)
  • Header Parameter Usage Location(s): JWS
  • Change Controller: IESG
  • Specification Document(s): Section 4.1.9 of RFC 7515
  • Header Parameter Name: "cty"
  • Header Parameter Description: 内容类型 (Content Type)
  • Header Parameter Usage Location(s): JWS
  • Change Controller: IESG
  • Specification Document(s): Section 4.1.10 of RFC 7515
  • Header Parameter Name: "crit"
  • Header Parameter Description: 关键 (Critical)
  • Header Parameter Usage Location(s): JWS
  • Change Controller: IESG
  • Specification Document(s): Section 4.1.11 of RFC 7515

9.2 媒体类型注册​

9.2.1 注册表内容​

本节按照 RFC 6838 [RFC6838] 中描述的方式, 在 "Media Types" 注册表 [IANA.MediaTypes] 中注册 "application/jose" 媒体类型 [RFC2046]. 该媒体类型可用于指示内容是使用 JWS Compact Serialization 或 JWE Compact Serialization 的 JWS 或 JWE. 本节还在 "Media Types" 注册表中注册 "application/jose+json" 媒体类型, 该媒体类型可用于指示内容是使用 JWS JSON Serialization 或 JWE JSON Serialization 的 JWS 或 JWE.

application/jose:

  • Type name: application
  • Subtype name: jose
  • Required parameters: n/a
  • Optional parameters: n/a
  • Encoding considerations: 8bit; application/jose 值编码为一系列 base64url 编码值 (其中一些值可以为空字符串), 每个值与下一个值之间由单个句点 ('.') 字符分隔.
  • Security considerations: 见 RFC 7515 的 Security Considerations 章节.
  • Interoperability considerations: n/a
  • Published specification: RFC 7515
  • Applications that use this media type: OpenID Connect, Mozilla Persona, Salesforce, Google, Android, Windows Azure, Xbox One, Amazon Web Services, 以及使用 JWT 的许多其他应用
  • Fragment identifier considerations: n/a
  • Additional information:
    • Magic number(s): n/a
    • File extension(s): n/a
    • Macintosh file type code(s): n/a
  • Person & email address to contact for further information: Michael B. Jones, [email protected]
  • Intended usage: COMMON
  • Restrictions on usage: none
  • Author: Michael B. Jones, [email protected]
  • Change Controller: IESG
  • Provisional registration? No

application/jose+json:

  • Type name: application
  • Subtype name: jose+json
  • Required parameters: n/a
  • Optional parameters: n/a
  • Encoding considerations: 8bit; application/jose+json 值表示为 JSON Object; JSON 对象 SHOULD 使用 UTF-8 编码.
  • Security considerations: 见 RFC 7515 的 Security Considerations 章节
  • Interoperability considerations: n/a
  • Published specification: RFC 7515
  • Applications that use this media type: Nimbus JOSE + JWT library
  • Fragment identifier considerations: n/a
  • Additional information:
    • Magic number(s): n/a
    • File extension(s): n/a
    • Macintosh file type code(s): n/a
  • Person & email address to contact for further information: Michael B. Jones, [email protected]
  • Intended usage: COMMON
  • Restrictions on usage: none
  • Author: Michael B. Jones, [email protected]
  • Change Controller: IESG
  • Provisional registration? No
最后于 更新