Date de l’annonce Déploiement de la phase 1 Déploiement de la phase 2
30 avril 2025 Du 30 avril au 30 mai 2025 Du 30 juin 2026 au 1er avril 2027

À partir d’aujourd’hui, les clients peuvent adopter le type d’octroi de token d’actualisation OAuth conformément à la norme OAuth 2.0, avec prise en charge de l’expiration des tokens d’accès et d’actualisation. Les développeurs d’applications tiers (ceux qui publient des intégrations et des applications sur la Marketplace) devront adopter lerefresh_token flux OAuth d’ici le 31 janvier 2026. Les clients doivent le faire avant le 1 avril 2027.

Cette annonce couvre les sujets suivants :

  • Qu’est-ce qui va changer ?
  • Pourquoi cette modification ?
  • Que dois-je faire ?

Qu’est-ce qui va changer ?

Zendesk introduit le type d’octroi de token d’actualisation OAuth en deux phases pour passer à l’expiration obligatoire des tokens. Ce type d’octroi sert à actualiser un token d’accès déjà arrivé à expiration ou qui arrivera bientôt à expiration. L’équipe met ce workflow à votre disposition dès maintenant. Les développeurs d'applications tierces devront adopter le flux d'actualisation OAuth avant le 31 janvier 2026 et avant le 1 avril 2027, il sera obligatoire pour tous les clients de l'utiliser.

Le workflow est utilisé en transmettant un paramètre refresh_token valide au point de terminaison /oauth/tokens en utilisant grant_type: refresh_token pour générer un nouveau token d’accès OAuth. Une demande réussie renverra également un token d’actualisation et supprimera les tokens d’accès et d’actualisation précédents. Pour permettre des tests complets de l’intégration refresh_token et d’expiration du token, vous pouvez aussi transférerexpires_in etrefresh_token_expires_in au point de terminaison /oauth/tokens quand vous utilisez les deux paramètres authorization_code et refresh_token types d’octroi pour configurer les expirations des tokens d’accès. Si vous configurez une expiration, elle sera appliquée.

Important : Avec les tokens d’actualisation, les tokens d’accès doivent arriver à expiration. Pour les clients OAuth créés avant l’ajout par Zendesk de la assistance des tokens d’actualisation, vous devez explicitement transférerexpires_in pendant la demande d’autorisation. Sinon, le token d’accès n’expirera pas et aucun token d’actualisation ne sera émis. Pour les clients OAuth créés le 30 avril 2026 ou plus tard, l’expiration du token est configurée automatiquement. Pour les anciens clients, l’adoption du workflow de token d’actualisation nécessite aussi la définition explicite deexpires_in .

Les tokens d’actualisation seront accordés pour toutes les nouvelles demandes de token OAuth . Les tokens OAuth existants ne pourront pas être actualisés. Les applications et intégrations existantes continueront de fonctionner normalement. La valeur TTL (Durée de vie) par défaut est appliquée automatiquement aux clients OAuth créés après le 30 avril 2026.

Type de token TTL par défaut TTL minimum TTL maximum
Token d’accès 30 minutes 5 minutes 48 heures
Actualiser le token 30 jours 7 jours 90 jours

Phase 1 : Adoption (disponible dès maintenant)

Les clients et les développeurs d’applications tiers peuvent désormais adopter l’refresh_token en toute fluidité. Ce type d’octroi sert à actualiser un token d’accès déjà arrivé à expiration ou qui arrivera bientôt à expiration.

Phase 2 : Entrée en vigueur (à partir de juin 2026)

Zendesk commencera à appliquer l’expiration des tokens pour les clients OAuth locaux existants. La phase d’entrée en vigueur 2 a lieu tous les mois, du 30 juin 2026 au 1er avril 2027. À la date prévue, l’expiration du token sera appliquée pour tous les clients OAuth locaux dans votre compte. Nous vous informerons directement avant votre date d’entrée en vigueur planifiée.

Pourquoi cette modification ?

Cette mise à jour nous aligne encore plus avec les normes OAuth 2.0 et fournit ainsi aux clients et aux développeurs une authentification API plus solide et plus souple. 

Que dois-je faire ?

Si vous utilisez OAuth pour authentifier les demandes d’API, votre application ou intégration doit adopter le type d’octroi refresh_token. Pour en savoir plus, consultez Utilisation de l’authentification OAuth avec votre application.

Si votre client OAuth a été créé avant l’introduction de la assistance du token d’actualisation, vous devez explicitement transférerexpires_in pendant l’autorisation. Vous ne pouvez pas émettre de token d’actualisation sauf si le token d’accès est configuré pour arriver à expiration. Cette option n’est pas configurée automatiquement pour les clients plus anciens. Vérifiez vos demandes d'autorisation pour confirmationexpires_in est en cours d’exécution avant votre date d’exécution.

Si vous avez des commentaires ou des questions au sujet de cette annonce, consultez le forum communautaire, sur lequel nous recueillons et gérons les commentaires des clients sur nos produits. Pour obtenir de l’aide d’ordre général concernant vos produits Zendesk, contactez l’Assistance client Zendesk.

Traduction - exonération : cet article a été traduit par un logiciel de traduction automatisée pour permettre une compréhension élémentaire de son contenu. Des efforts raisonnables ont été faits pour fournir une traduction correcte, mais Zendesk ne garantit pas l’exactitude de la traduction.

Si vous avez des questions quant à l’exactitude des informations contenues dans l’article traduit, consultez la version anglaise de l’article, qui représente la version officielle.

Réalisé par Zendesk