Retour à l’aperçu

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étaire et Admin voient 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

  1. Ouvrez Réglages dans l'espace de travail. Dans la section Espace de travail, touchez Clés API (marquée Beta).
  2. Touchez Créer une clé API. Sans Ultra, vous voyez à la place une remarque et Passer à l'offre supérieure. Si la limite est atteinte, révoquez d'abord une clé.
  3. Sous Nom, indiquez à quoi sert la clé, par exemple « GitHub Actions » ou « Mon portable ». 60 caractères au maximum.
  4. Sous Tableaux, choisissez Tous les tableaux, y compris les nouveaux, ou choisissez Tableaux sélectionnés et 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.
  5. Sous Autorisations, choisissez Lecture seule, Lecture et écriture ou Accès complet. Lecture et écriture permet tout sauf supprimer des tâches. Accès complet ajoute Supprimer des tâches.
  6. 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) et Supprimer des tâches. Une combinaison qui ne correspond à aucun niveau s'affiche comme Personnalisé.
  7. Sous Valable pendant, choisissez 30 jours, 90 jours, 180 jours ou 365 jours. La ligne en dessous indique quand la clé expire. Chaque clé a une date de fin.
  8. Saisissez votre Mot de passe actuel et touchez Créer la clé. Avec un mot de passe erroné, la boîte de dialogue reste ouverte.
  9. Copiez votre clé API affiche la clé une seule fois. Touchez Copier, gardez-la dans un gestionnaire de mots de passe ou comme secret dans votre CI, puis touchez Fait. Si vous ne l'avez pas copiée, Zeitlicht demande d'abord. Fermer quand même ferme la boîte de dialogue, et la clé ne peut plus être affichée.
  10. La nouvelle clé apparaît sous Actives avec 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 indique Expire dans … jours, puis Expire demain et Expire aujourd'hui.
  11. Pour mettre fin à une clé, touchez Révoquer dans sa ligne et confirmez avec Révoquer. Tout ce qui utilise la clé perd l'accès immédiatement.
  12. En cas d'urgence, touchez Révoquer toutes les clés en bas et confirmez avec Révoquer toutes les clés. Plus aucune clé active de l'espace ne fonctionne, celles des autres admins comprises.
  13. 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.

Sujets liés