Jetons d'actualisation

Les jetons d'actualisation permettent d'accorder un accès à long terme aux API. Vous devez garder la durée de vie des jetons d'accès aussi courte que possible. Cependant, vous voulez éviter de forcer l'utilisateur à effectuer des allers-retours répétés sur le canal avant vers le serveur d'authentification pour demander de nouveaux jetons d'accès.

Les jetons d'actualisation permettent de demander de nouveaux jetons d'accès sans interaction de l'utilisateur. Chaque fois que le client actualise un jeton, il doit effectuer un appel de canal arrière authentifié vers le serveur d'authentification. Cet appel permet de vérifier si le jeton d'actualisation est toujours valide ou s'il a été révoqué.

Les jetons d'actualisation sont pris en charge dans les flux de code d'autorisation et de mot de passe du propriétaire de la ressource. Pour demander un jeton d'actualisation, le client doit inclure l'étendue offline_access dans la demande de jeton et doit être autorisé pour cette étendue.

Les jetons d'actualisation expirent après 30 jours. Les jetons d'actualisation ont une fenêtre de durée de vie glissante de 15 jours. La durée de vie d'un jeton d'actualisation est renouvelée du temps spécifié dans le paramètre SlidingRefreshTokenLifetime. Après 30 jours, le client doit se réauthentifier, quelle que soit la période de validité du jeton d'actualisation le plus récent acquis par l'application.

Pour obtenir un nouveau jeton d'accès à partir d'un jeton d'actualisation, envoyez les informations suivantes :

URL : https://<server>/AuthServices/Auth/connect/token

Verbe HTTP : POST

Paramètres :

  • client_id <client_id>
  • client_secret : <secret>
  • grant_type : refresh_token
  • refresh_token : <current valid refresh token>

Voici une requête et une réponse Postman pour l'octroi refresh_token :


Requête et réponse pour l'octroi de jeton d'actualisation