oauth2.dev

claims_locales_supported

OpenID_Foundation_Artifact_Binding_WG

Registry Context

RFC 8414 does not define claims_locales_supported. It permits metadata parameters defined by other specifications and permits other claims in successful authorization server metadata responses.

Technical Summary

In an RFC 8414 authorization server metadata response, claims_locales_supported is an additional claim rather than a metadata value defined by RFC 8414 Section 2. Because it returns multiple values, RFC 8414 Section 3.2 represents it as a JSON array and requires omission when it has zero elements.

When Used

Its OpenID Connect-specific semantics are defined outside RFC 8414; RFC 8414 only establishes how additional, multi-valued claims are carried in an OAuth authorization server metadata response.

Normative Requirements

Authorization servers

MAY
1
  1. RFC 8414 - Section 2

    use additional authorization server metadata parameters.

    Condition: when publishing parameters beyond those defined by RFC 8414

    Additional authorization server metadata parameters MAY also be used.

Authorization server metadata responses

MUST
1
  1. RFC 8414 - Section 3.2

    omit claims with zero elements.

    Condition: when a claim has zero elements

    Claims with zero elements MUST be omitted from the response.

MAY
1
  1. RFC 8414 - Section 3.2

    return claims other than the metadata values defined in RFC 8414 Section 2.

    Condition: when returning a successful metadata response

    Other claims MAY also be returned.

Validation Guidance

info

Allow claims_locales_supported as an additional metadata claim; do not reject it solely because RFC 8414 Section 2 does not define it.

error

When claims_locales_supported returns multiple values, verify that its value is a JSON array.

error

If claims_locales_supported is an empty array, report an error because claims with zero elements must be omitted.

Reference

Details

Entry Id
claims_locales_supported
Metadata Name
claims_locales_supported
Metadata Description
Languages and scripts supported for values in Claims being returned, represented as a JSON array of BCP 47 RFC5646 language tag values
Change Controller
OpenID_Foundation_Artifact_Binding_WG
Reference
OpenID Connect Discovery 1.0 - Section 3