5. Compatibility Notes (Notes de compatibilité)

Les identifiants /.well-known/openid-configuration, "op_policy_uri" et "op_tos_uri" contiennent des chaînes faisant référence à la famille de spécifications OpenID Connect [OpenID.Core], qui ont été définies à l'origine par "OpenID Connect Discovery 1.0" [OpenID.Discovery]. Bien que ces identifiants apparemment spécifiques à OpenID soient réutilisés, leur utilisation dans cette spécification se réfère en fait à une fonctionnalité OAuth 2.0 générale et n'est pas spécifique à OpenID Connect.

L'algorithme pour transformer l'identifiant d'émetteur en emplacement de métadonnées du serveur d'autorisation défini dans la section 3 est équivalent à la transformation correspondante définie dans la section 4 de "OpenID Connect Discovery 1.0" [OpenID.Discovery], à condition que l'identifiant d'émetteur ne contienne pas de composant chemin. Cependant, ils diffèrent lorsqu'un composant chemin est présent, car OpenID Connect Discovery 1.0 stipule que la chaîne URI bien connue est ajoutée à l'identifiant d'émetteur (par exemple, https://example.com/issuer1/.well-known/openid-configuration), tandis que cette spécification stipule que la chaîne URI bien connue est insérée avant le composant chemin de l'identifiant d'émetteur (par exemple, https://example.com/.well-known/openid-configuration/issuer1).

À l'avenir, les emplacements de métadonnées du serveur d'autorisation OAuth devraient utiliser la transformation définie dans cette spécification. Cependant, lors du déploiement dans des environnements existants utilisant déjà la transformation OpenID Connect Discovery 1.0, il peut être nécessaire de publier les métadonnées aux deux emplacements pour les identifiants d'émetteur contenant des composants de chemin pendant une période de transition. Pendant cette période de transition, les applications devraient d'abord appliquer la transformation définie dans cette spécification et tenter de récupérer les métadonnées du serveur d'autorisation à partir de l'emplacement résultant ; ce n'est que si la récupération à partir de cet emplacement échoue qu'elles devraient se rabattre sur une tentative de récupération à partir de l'emplacement alternatif obtenu à l'aide de la transformation définie par OpenID Connect Discovery 1.0. Ce comportement de compatibilité ascendante n'est nécessaire que lorsque le suffixe URI bien connu utilisé par l'application est "openid-configuration".