7. IANA 注意事项 (IANA Considerations)
7.1. OAuth Authorization Server Metadata 注册表
本规范在 OAuth Parameters 注册表中建立 "OAuth Authorization Server Metadata" 注册表, 并注册第 2 节中定义的 metadata parameter names.
注册过程为 "Specification Required" [RFC8126], 并需要 designated expert 审查. 但是, 为了保留值, designated expert MAY在没有事先审查的情况下临时批准注册.
注册请求SHOULD包含以下信息, 并符合 OAuth Authorization Server Metadata 注册表的相应字段:
-
Metadata Name: 要注册的 metadata parameter 的名称. 名称是用于大小写不敏感匹配的 ASCII [USASCII] 字符串. RECOMMENDED 名称不要包含
_(underscore),-(hyphen) 和.(period) 以外的字符. -
Metadata Description: metadata 的简要描述.
-
Change Controller: 对于 IETF 规范, 该值为 "IESG". 对于其他规范, 给出负责方名称, 如果规范在 IETF 工作组内开发, 则为 IETF 工作组名称, 否则为个人名称.
-
Specification Document(s): 对包含该 parameter 初始定义的可发布规范的引用.
注册表的初始内容如下:
-
Metadata Name:
issuer -
Metadata Description: Authorization server 的 issuer identifier
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
authorization_endpoint -
Metadata Description: Authorization server 的 authorization endpoint URL
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
token_endpoint -
Metadata Description: Authorization server 的 token endpoint URL
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
jwks_uri -
Metadata Description: Authorization server 的 JWK Set document URL
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
registration_endpoint -
Metadata Description: Authorization server 的 dynamic client registration endpoint URL
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
scopes_supported -
Metadata Description: 支持的 scope values 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
response_types_supported -
Metadata Description: 支持的 response_type values 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
response_modes_supported -
Metadata Description: 支持的 response_mode values 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
grant_types_supported -
Metadata Description: 支持的 grant type values 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
token_endpoint_auth_methods_supported -
Metadata Description: 支持的 token endpoint authentication methods 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
token_endpoint_auth_signing_alg_values_supported -
Metadata Description: token endpoint 支持的 JWS signing algorithms 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
service_documentation -
Metadata Description: 包含关于 authorization server 的人类可读信息的页面 URL
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
ui_locales_supported -
Metadata Description: 支持的 UI locales 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
op_policy_uri -
Metadata Description: 与 OP policy 相关的 URL
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
op_tos_uri -
Metadata Description: 与 OP terms of service 相关的 URL
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
revocation_endpoint -
Metadata Description: Authorization server 的 revocation endpoint URL
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
revocation_endpoint_auth_methods_supported -
Metadata Description: 支持的 revocation endpoint authentication methods 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
revocation_endpoint_auth_signing_alg_values_supported -
Metadata Description: revocation endpoint 支持的 JWS signing algorithms 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
introspection_endpoint -
Metadata Description: Authorization server 的 introspection endpoint URL
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
introspection_endpoint_auth_methods_supported -
Metadata Description: 支持的 introspection endpoint authentication methods 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
introspection_endpoint_auth_signing_alg_values_supported -
Metadata Description: introspection endpoint 支持的 JWS signing algorithms 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
code_challenge_methods_supported -
Metadata Description: 支持的 PKCE code challenge methods 的 JSON array
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2 节
-
Metadata Name:
signed_metadata -
Metadata Description: 作为 signed JWT 的 metadata values
-
Change Controller: IESG
-
Specification Document(s): RFC 8414 第 2.1 节
7.2. 更新后的注册说明
IANA 已将 IANA "OAuth Token Endpoint Authentication Methods" 注册表 [IANA.OAuth.Parameters] 的注册过程从 "Expert Review" 改为 "Specification Required", 并将 IANA "OAuth Access Token Types" 注册表 [IANA.OAuth.Parameters] 的注册过程从 "Expert Review" 改为 "Specification Required".
7.3. Well-Known URI 注册表
本规范在 RFC 5785 [RFC5785] 建立的 IANA "Well-Known URIs" 注册表中注册 well-known URI oauth-authorization-server.
- URI Suffix:
oauth-authorization-server - Change Controller: IESG
- Specification Document(s): RFC 8414
- Related Information: (none)