Démarrer

Clés d'API

Créez, utilisez et révoquez les clés qui authentifient la CLI et l'API.

La CLI et l'API s'authentifient avec une clé d'API, envoyée dans l'en-tête Authorization: Bearer ah_… ou par l'option --token. L'équipe vient toujours de la clé : un identifiant d'équipe dans l'URL est ignoré.

Créer une clé

  1. Ouvrez l'onglet Clés d'API de l'équipe

    Seul un propriétaire de l'équipe voit cet onglet et peut créer ou révoquer une clé.

  2. Nommez la clé

    Un nom qui dit où elle sert : « Poste de Léa », « CI GitHub ». Il vous aidera à savoir quoi révoquer.

  3. Copiez-la tout de suite

    La clé complète ne s'affiche qu'une fois. SmartFlow Host n'en garde qu'une empreinte : impossible de vous la remontrer. Perdue, elle se remplace par une nouvelle.

Deux sortes de clés

CléCréée parAccès
Clé d'équipeUn propriétaire, dans la consoleTous les projets de l'équipe ; peut en créer de nouveaux.
Clé limitée au projetL'app GitHub, à l'import d'un dépôtUn seul projet. Toute autre ressource répond 404. Seule à recevoir les variables sensibles.

La clé limitée au projet est posée dans le dépôt comme secret SMARTFLOW_HOST_TOKEN. Elle ne peut pas créer de projet.

Durée de validité

Une clé n'expire pas d'elle-même. Elle cesse de fonctionner quand :

  • un propriétaire la révoque ;
  • la personne qui l'a créée quitte l'équipe, ou passe en lecture seule ;
  • le projet relié à GitHub est débranché (pour la clé limitée au projet).

Dernière utilisation

La liste des clés indique quand chacune a servi pour la dernière fois, à la minute près. Une clé inutilisée depuis longtemps se révoque sans risque.