Créer et gérer des jetons d’API
Un jeton d’accès personnel permet à un script ou à un client MCP d’agir en votre nom par l’API. Sa forme, sa durée, ses portées, et comment le révoquer.
Sur cette page
Un jeton d’accès personnel permet à un script, à une tâche de CI ou à un client MCP d’appeler l’API d’iyedy en votre nom. Il atteint une seule organisation, ne porte que les portées que vous avez choisies, et cesse de fonctionner quand il expire ou quand il est révoqué.
Créer un jeton
BientôtCréer et révoquer vos jetons depuis votre compte iyedy.
Il n’existe pas encore d’écran dans iyedy pour créer un jeton. Si vous avez besoin d’un accès à l’API d’ici là, écrivez à support@iyedy.com en précisant à quoi servira le jeton. Cette page décrit les règles que suit un jeton, qui ne dépendent pas de l’endroit où il est créé.
Ce qu’est un jeton
| Forme | crt_pat_ suivi de 16 lettres et chiffres, d’un tiret bas, puis de 43 caractères |
| Agit en tant que | vous, dans une organisation, éventuellement dans un seul espace de travail |
| Portées | au choix parmi cartouche.read, cartouche.graph, cartouche.write, cartouche.propose : voir Portées |
| Durée de vie | de 1 à 365 jours, 90 par défaut |
| Nombre | 50 jetons actifs par personne et par organisation |
Pour créer un jeton, votre compte a besoin d’une adresse e-mail vérifiée et d’une connexion récente : dans les 10 dernières minutes. Quand votre organisation impose l’authentification unique, la règle vaut aussi pour les jetons. En Enterprise, les jetons d’accès personnels sont coupés sauf si l’organisation les active ; la politique est vérifiée à la création du jeton puis à chaque usage.
Garder le secret
iyedy ne garde qu’une empreinte du jeton, jamais le jeton lui-même. Copiez-le quand il s’affiche : personne ne pourra vous le remontrer. Si vous le perdez, révoquez-le et créez-en un autre.
- Rangez-le dans un coffre à secrets : les secrets de votre CI, un gestionnaire de mots de passe, les identifiants de votre client MCP. Jamais dans un dépôt, un ticket ou une messagerie.
- Un jeton par tâche, avec le moins de portées possible, pour pouvoir en révoquer un sans arrêter les autres.
- iyedy retire les jetons de ses journaux et ne les met jamais dans le journal d’audit.
Utiliser un jeton
Envoyez-le dans l’en-tête Authorization de chaque requête :
GET /v1/token HTTP/1.1
Host: app.iyedy.com
Authorization: Bearer crt_pat_…
GET /v1/token fonctionne avec n’importe quelle portée et décrit le jeton : son nom, son propriétaire, son organisation, ses espaces de travail avec votre rôle dans chacun, ses portées et son expiration. Sur une requête avec jeton, un cookie de session est ignoré.
Ce qu’un jeton peut faire est la rencontre de ses portées et de votre rôle, vérifiée à chaque requête. Si votre rôle baisse dans un espace de travail, le jeton perd aussitôt cet accès. Si vous quittez l’organisation, le jeton n’atteint plus rien.
Révoquer un jeton
Un jeton cesse de fonctionner à la requête qui suit sa révocation. Il peut être révoqué :
- par vous, son propriétaire ;
- par un propriétaire ou un administrateur de la sécurité de l’organisation, un jeton ou tous les jetons de l’organisation d’un coup.
En attendant l’écran des jetons, écrivez à support@iyedy.com pour révoquer un jeton. Dans une organisation, la création et la révocation des jetons sont enregistrées dans le journal d’audit, tout comme le premier usage refusé d’un jeton expiré, révoqué ou bloqué.
Si cela ne fonctionne pas
401 avec la raison invalid_token
Le jeton est mal recopié ou incomplet. Vérifiez que l’en-tête contient Authorization: Bearer suivi du jeton entier, sans retour à la ligne.
401 avec la raison token_expired ou token_revoked
Le jeton est arrivé au bout de sa durée de vie, ou quelqu’un l’a révoqué. Créez-en un nouveau.
401 avec la raison pats_disabled
Votre organisation n’autorise pas les jetons d’accès personnels. En Enterprise, ils sont coupés par défaut ; demandez à un propriétaire. Pour la CI, un compte de service est peut-être le bon outil.
403 avec la raison insufficient_scope
Le jeton n’a pas la portée dont la route a besoin ; la réponse la nomme dans required. Créez un jeton avec cette portée.
Tous les codes : Limites de débit et erreurs.
Cette page vous a-t-elle aidé ?Réponse anonyme, comptée seulement si vous avez accepté la mesure.
Qu’est-ce qui n’a pas marché ?
N’écrivez pas de données personnelles.