跳到主要内容

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)