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é
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é.
Nommez la clé
Un nom qui dit où elle sert : « Poste de Léa », « CI GitHub ». Il vous aidera à savoir quoi révoquer.
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 par | Accès |
|---|---|---|
| Clé d'équipe | Un propriétaire, dans la console | Tous les projets de l'équipe ; peut en créer de nouveaux. |
| Clé limitée au projet | L'app GitHub, à l'import d'un dépôt | Un 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.