API et intégrations
Créer et révoquer des clés API
Je veux …
… donner à la ligne de commande zl, à Claude Code ou à une GitHub Action l'accès aux tâches de cet espace de travail, puis le leur retirer.
Avant de commencer
- Les clés API sont en bêta. Seuls les espaces de travail qui participent à la bêta affichent
Clés API. - Seuls
PropriétaireetAdminvoient l'entrée. Chaque admin voit toutes les clés de l'espace, celles des autres admins comprises, et peut révoquer n'importe laquelle. - Pour créer une clé, il vous faut votre propre forfait Ultra. Sans Ultra, vous pouvez toujours voir et révoquer les clés.
- Une clé agit comme vous : ce qu'un outil en fait compte comme votre modification. Gardez-la aussi secrète qu'un mot de passe.
- Un espace de travail a au plus 10 clés actives, et chaque personne au plus 5.
Voici comment
- Ouvrez
Réglagesdans l'espace de travail. Dans la sectionEspace de travail, touchezClés API(marquéeBeta). - Touchez
Créer une clé API. Sans Ultra, vous voyez à la place une remarque etPasser à l'offre supérieure. Si la limite est atteinte, révoquez d'abord une clé. - Sous
Nom, indiquez à quoi sert la clé, par exemple « GitHub Actions » ou « Mon portable ». 60 caractères au maximum. - Sous
Tableaux, choisissezTous les tableaux, y compris les nouveaux, ou choisissezTableaux sélectionnéset cochez au moins un tableau (30 au maximum). La clé ne voit jamais les autres tableaux. Les tags et les sujets appartiennent à tout l'espace de travail : seule une clé pour tous les tableaux peut en créer, et seule une telle clé voit les adresses e-mail des membres. - Sous
Autorisations, choisissezLecture seule,Lecture et écritureouAccès complet.Lecture et écriturepermet tout sauf supprimer des tâches.Accès completajouteSupprimer des tâches. - Pour un réglage plus fin, touchez
Avancéet cochez des autorisations isolées :Lire les tâches(Toujours inclus),Créer et modifier des tâches,Assigner des personnes,Modifier les listes,Écrire des commentaires,Ajouter des pièces jointes,Remplir les tests(Instructions, testeurs et bogues) etSupprimer des tâches. Une combinaison qui ne correspond à aucun niveau s'affiche commePersonnalisé. - Sous
Valable pendant, choisissez30 jours,90 jours,180 joursou365 jours. La ligne en dessous indique quand la clé expire. Chaque clé a une date de fin. - Saisissez votre
Mot de passe actuelet touchezCréer la clé. Avec un mot de passe erroné, la boîte de dialogue reste ouverte. Copiez votre clé APIaffiche la clé une seule fois. TouchezCopier, gardez-la dans un gestionnaire de mots de passe ou comme secret dans votre CI, puis touchezFait. Si vous ne l'avez pas copiée, Zeitlicht demande d'abord.Fermer quand mêmeferme la boîte de dialogue, et la clé ne peut plus être affichée.- La nouvelle clé apparaît sous
Activesavec son nom, qui l'a créée, ses autorisations, ses tableaux et ses dates de création, de dernière utilisation et d'expiration. Pendant ses 7 derniers jours, le statut indiqueExpire dans … jours, puisExpire demainetExpire aujourd'hui. - Pour mettre fin à une clé, touchez
Révoquerdans sa ligne et confirmez avecRévoquer. Tout ce qui utilise la clé perd l'accès immédiatement. - En cas d'urgence, touchez
Révoquer toutes les clésen bas et confirmez avecRévoquer toutes les clés. Plus aucune clé active de l'espace ne fonctionne, celles des autres admins comprises. - Les clés révoquées et expirées passent sous
Révoquées et expirées, avec qui les a révoquées et pourquoi. Tirez la liste vers le bas pour l'actualiser.
Le résultat
La clé agit comme vous, sur les tableaux et avec les autorisations choisis, jusqu'à ce qu'elle expire ou que quelqu'un la révoque. Vous et le propriétaire de l'espace recevez un e-mail à chaque nouvelle clé. Sept jours avant l'expiration d'une clé, la personne qui l'a créée reçoit un seul e-mail de rappel avec le bouton Ouvrir les clés API.
Questions fréquentes
J'ai perdu une clé. Puis-je la revoir ?
Non. Zeitlicht ne garde qu'une empreinte de la clé. Révoquez-la et créez-en une nouvelle.
Pourquoi une clé indique-t-elle Inactive ?
La personne qui l'a créée n'a plus Ultra ou n'est plus admin, ou l'accès à l'API est désactivé pour l'espace. La ligne en donne la raison. Dès que cette personne a de nouveau Ultra, la clé fonctionne à nouveau.
Que se passe-t-il quand un admin devient membre, quitte l'espace ou est mis en pause ?
Les clés de cette personne dans cet espace sont révoquées définitivement, même si elle redevient admin plus tard.
Comment prolonger une clé ?
Ce n'est pas possible. Créez une nouvelle clé, faites passer votre outil dessus, puis révoquez l'ancienne. L'e-mail de rappel, une semaine avant la fin, est le bon moment pour le faire.
J'ai changé mon mot de passe. Mes clés fonctionnent-elles encore ?
Oui. Un nouveau mot de passe ne met fin à aucune clé. Si vous pensez qu'une clé a fuité, révoquez-la ou utilisez Révoquer toutes les clés.
J'ai reçu un e-mail à propos d'une clé que je ne connais pas.
Ouvrez immédiatement Clés API et révoquez-la. Changez ensuite votre mot de passe.