Gérer les jetons d’actualisation avec la Management API

Découvrez comment gérer les jetons d’actualisation avec l’Auth0 Management API.

Les points de terminaison de jetons d’actualisation de l’Auth0 Management API sont actuellement offerts aux clients ayant un forfait Enterprise. Pour en savoir plus, consultez Tarification.

Points de terminaison de la Management API

La Management API d’Auth0 fournit des points de terminaison pour gérer les jetons d’actualisation individuellement ou en tant qu’ensemble.

Ces points de terminaison complètent les autres méthodes de révocation des jetons d’actualisation et remplacent les points de terminaison de la ressource device-credentials en y ajoutant des propriétés étendues et des opérations de révocation en bloc.

Ressource de jeton d’actualisation

Vous pouvez consulter ou révoquer un jeton d’actualisation précis à l’aide des points de terminaison suivants :

Nom	URL	scope(s) requis
Consulter les renseignements d’un jeton d’actualisation par ID	GET /api/v2/refresh-tokens/{tokenId}	read:refresh_tokens
Révoquer un jeton d’actualisation par ID	DELETE /api/v2/refresh-tokens/{tokenId}	delete:refresh_tokens

Ressource utilisateur

Vous pouvez répertorier ou révoquer tous les jetons d’actualisation d’un utilisateur donné à l’aide des points de terminaison suivants :

Nom	URL	scope(s) requis
Répertorier tous les jetons d’actualisation d’un utilisateur	GET /api/v2/users/{userId}/refresh-tokens	read:refresh_tokens
Révoquer tous les jetons d’actualisation d’un utilisateur	DELETE /api/v2/users/{userId}/refresh-tokens	delete:refresh_tokens

Propriétés du jeton d’actualisation

Les points de terminaison de jeton du jeton d’actualisation renvoient des renseignements pertinents sur le jeton et son historique.

Champ	Description
ID du jeton d’actualisation	Identifiant unique du jeton d’actualisation dans l’API, propre au tenant. Il ne s’agit pas du jeton lui-même, qui est un secret à échanger avec le point de terminaison de jeton dans l’API d’authentification. Les jetons d’actualisation peuvent survivre à une session. Le jeton d’actualisation conserve cette information indépendamment du cycle de vie de la session.
ID de session	L’ID de session est un identifiant persistant de la session dans le tenant Auth0. Notez que l’ID de session correspond au claim sid, déjà présent dans les jetons ID et les jetons de déconnexion, et qu’il peut servir à faire le lien entre ces entités. Le jeton d’actualisation contient des références à la session utilisée pour créer le jeton. L’ID de session peut être utilisé pour récupérer des renseignements supplémentaires au moyen du point de terminaison de la Management API inspecter une session précise par ID.
Heure pertinente	Renseignements sur la création et l’expiration du jeton d’actualisation.
Renseignements sur le client et les serveurs de ressources	Renseignements sommaires sur les applications et les API associées à un jeton d’actualisation.

Limitations

• Les opérations de révocation de jetons d’actualisation (DELETE) s’exécutent de façon asynchrone et finissent par devenir cohérentes.
• Les jetons d’actualisation émis le 21-09-2023 ou après cette date (le 22-02-2024 pour les tenants de la région US-3) contiennent la propriété d’ID de session (session_id) avec la valeur appropriée. Les jetons d’actualisation émis avant cette date contiennent cette propriété avec la valeur null.

En savoir plus

• Jetons d’actualisation
• Révoquer les jetons d’actualisation
• Utiliser les jetons d’actualisation