Configurer le profil de jeton d’accès

Configurez un profil de jeton d’accès pour votre API afin de contrôler le format et les claims des jetons d’accès émis.

Vous pouvez choisir le profil de jeton d’accès à utiliser pour vos API : le profil de jeton Auth0 ou le profil de jeton RFC 9068. Le profil de jeton d’accès que vous configurez détermine le format des jetons d’accès émis pour l’API.

Par défaut, Auth0 émet des jetons d’accès à l’aide du profil de jeton Auth0. Le profil de jeton Auth0 émet des jetons d’accès au format JSON Web Tokens (JWTs), qui contiennent de l’information sur une entité sous forme de claims.

Auth0 prend aussi en charge le profil de jeton RFC 9068. Le profil de jeton RFC 9068 émet des jetons d’accès au format JWTs, conformément au profil JWT de l’IETF pour les jetons d’accès OAuth 2.0 (RFC 9068). Pour en savoir plus sur les différences entre ces profils de jeton, consultez Profils de jetons d’accès.

Lorsque vous enregistrez une API, vous pouvez sélectionner le profil de jeton d’accès dans le Auth0 Dashboard. Après avoir enregistré l’API, vous pouvez configurer le profil de jeton d’accès en tout temps à l’aide de la Management API et du Auth0 Dashboard.

​

Configurer le profil de jeton d’accès d’une API

Auth0 Dashboard

1. Accédez à Dashboard > Applications > APIs et cliquez sur le nom de l’API à afficher.

2. Faites défiler jusqu’à Access Token Settings et sélectionnez le profil de jeton d’accès sous JSON Web Token (JWT) Profile. Le profil sélectionné détermine le format et les claims des jetons d’accès émis pour l’API. Les valeurs prises en charge sont Auth0 et RFC 9068. Pour en savoir plus sur la différence entre les deux profils, consultez Profil de jeton d’accès.

3. Cliquez sur Save.

Management API

Lorsque vous utilisez la Management API, les profils de jeton d’accès sont appelés des dialectes de jeton. Pour configurer votre profil de jeton d’accès, définissez le paramètre token_dialect d’une API à l’aide de la Management API.

L’exemple de code suivant effectue une requête PATCH vers le point de terminaison Update a resource server :

Remplacez API_ID, MGMT_API_ACCESS_TOKEN et TOKEN_DIALECT par leurs valeurs respectives, comme décrit dans le tableau suivant :

Paramètre	Description
API_ID	ID de l’API pour laquelle vous souhaitez mettre à jour le dialecte de jeton.
MGMT_API_ACCESS_TOKEN	Access Token for the Management API avec le scope update:resource_servers.
TOKEN_DIALECT	Dialecte du jeton d’accès pour l’API spécifiée. Pour en savoir plus, consultez Token dialect options.

​

Options de dialecte de jeton

Auth0 prend en charge les dialectes de jeton suivants :

Valeur	Description
access_token	Le profil de jeton Auth0 par défaut génère un jeton d’accès au format JSON Web Token (JWT). Pour en savoir plus, consultez Profil de jeton d’accès.
access_token_authz	Le profil de jeton Auth0 par défaut (access_token) avec le claim permissions. Pour en savoir plus sur les permissions RBAC, consultez Enable Role-Based Access Control for APIs.
rfc9068_profile	Le profil de jeton RFC 9068 génère un jeton d’accès au format JWT conformément au profil JWT de l’IETF pour les jetons d’accès OAuth 2.0 (RFC 9068). Pour en savoir plus, consultez Profil de jeton d’accès.
rfc9068_profile_authz	Le profil RFC 9068 (rfc9068_profile) avec le claim permissions. Pour en savoir plus sur les permissions RBAC, consultez Enable Role-Based Access Control for APIs.