Passer au contenu principal
Les jetons d’accès personnels sont actuellement en bêta fermée et activés par feature flag. Contactez l’assistance pour demander l’accès. Les PAT ne sont pas disponibles pour les comptes SSO/enterprise.

​
Vue d’ensemble

Les jetons d’accès personnels (PAT) permettent aux utilisateurs humains de s’authentifier de manière programmatique sous leur propre identité. Contrairement aux API key d’utilisateur de service (qui s’authentifient comme un utilisateur de service non humain), un PAT s’authentifie comme vous — l’utilisateur humain qui a créé le jeton. Tous les identifiants API utilisent le format de préfixe cog_. Les deux types de jeton s’utilisent de manière identique dans l’en-tête Authorization :

​
Quand utiliser les PAT

Les PAT sont conçus pour les cas où vous avez besoin d’un accès programmatique à l’API en votre nom propre :
  • Scripts et outils personnels — automatisez vos propres workflows sans utilisateur de service partagé
  • Développement local — testez des intégrations d’API avec votre propre compte
  • Automatisation de courte durée — scripts ponctuels qui doivent vous être attribués
Pour les intégrations en production, les pipelines CI/CD et l’automatisation partagée, utilisez plutôt les API keys d’utilisateur de service. Les utilisateurs de service offrent une meilleure traçabilité d’audit, une gestion centralisée des clés et des contrôles RBAC.

​
Fonctionnement

  1. Générez un PAT dans les paramètres de votre compte
  2. Le jeton commence par cog_ et n’est affiché qu’une seule fois, au moment de sa création
  3. Utilisez le jeton dans l’en-tête Authorization — exactement comme une API key d’utilisateur de service
  4. Chaque appel d’API est authentifié avec votre compte utilisateur — vos autorisations, vos appartenances aux org et votre journal d’audit s’appliquent

​
Différences clés par rapport aux API key d’utilisateur de service

​
Limitations

  • Bêta fermée : les PAT nécessitent l’activation d’un feature flag pour votre compte
  • Non disponible pour les comptes SSO/Enterprise : actuellement réservé aux comptes sans SSO
  • Périmètre personnel : les PAT sont liés à votre compte personnel et ne peuvent pas être partagés

​
Considérations de sécurité

  • Traitez les PAT avec le même soin que des mots de passe — ils donnent un accès complet à votre compte
  • Stockez les PAT dans des variables d’environnement ou des gestionnaires de secrets, jamais dans le code source
  • Révoquez immédiatement les PAT s’ils sont compromis
  • Utilisez uniquement le périmètre minimal nécessaire à votre cas d’usage
  • Privilégiez les API key d’utilisateur de service pour toute automatisation partagée ou en production

​
Prochaines étapes