3. IANA 考量
3.1. OAuth Token Introspection Response 注册表
本规范建立 "OAuth Token Introspection Response" 注册表.
OAuth 注册客户端元数据名称和描述通过 Specification Required [RFC5226] 注册, 注册前需在 [email protected] 邮件列表上经过两周审查期, 并依据一个或多个 Designated Experts 的建议. 但是, 为允许在发布前分配名称, Designated Expert(s) 在确信相关规范将会发布后, 可以批准注册.
发送到邮件列表进行审查的注册请求应使用适当主题 (例如 "Request to register OAuth Token Introspection Response name: example").
在审查期内, Designated Expert(s) 将批准或拒绝注册请求, 并将决定告知审查列表和 IANA. 拒绝应包含解释, 并在适用时给出如何使请求成功的建议.
IANA 必须只接受来自 Designated Expert(s) 的注册表更新, 并应将所有注册请求引导至审查邮件列表.
3.1.1. 注册模板
Name: 请求的名称 (例如 "example"). 该名称区分大小写. 不应接受以大小写不敏感方式匹配其他已注册名称的名称. 与 [RFC7519] 建立的 "JSON Web Token Claims" 注册表中已注册 claim 匹配的名称, 应具有可比的定义和语义.
Description: 元数据值的简要描述 (例如 "Example description").
Change controller: 对于 Standards Track RFC, 填写 "IESG". 对于其他文档, 给出负责方名称. 也可以包含其他详细信息 (例如邮政地址, 电子邮件地址, 主页 URI).
Specification document(s): 引用规定 token endpoint 授权方法的文档, 最好包含可用于获取该文档副本的 URI. 也可以包含相关章节说明, 但不是必需的.
3.1.2. 初始注册表内容
"OAuth Token Introspection Response" 注册表的初始内容如下:
- Name: "active"
- Description: Token active status
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).
- Name: "username"
- Description: User identifier of the resource owner
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).
- Name: "client_id"
- Description: Client identifier of the client
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).
- Name: "scope"
- Description: Authorized scopes of the token
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).
- Name: "token_type"
- Description: Type of the token
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).
- Name: "exp"
- Description: Expiration timestamp of the token
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).
- Name: "iat"
- Description: Issuance timestamp of the token
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).
- Name: "nbf"
- Description: Timestamp before which the token is not valid
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).
- Name: "sub"
- Description: Subject of the token
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).
- Name: "aud"
- Description: Audience of the token
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).
- Name: "iss"
- Description: Issuer of the token
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).
- Name: "jti"
- Description: Unique identifier of the token
- Change Controller: IESG
- Specification Document(s): Section 2.2 of RFC 7662 (this document).