Inventaire des clés API
L'inventaire Clés API de l'organisation liste toutes les clés API personnelles créées dans votre organisation. Il sert à contrôler qui peut piloter la plateforme depuis un outil externe, et à couper une clé si besoin.
Qui peut le faire : l'Administrateur. Chaque personne voit et gère ses propres clés dans Mes clés API.
Ouvrir l'inventaire#
Deux chemins mènent à la même page :
- dans la barre Supervision, cliquez sur Clés de l'organisation ;
- dans Sécurité, cliquez sur Inventaire des clés de l'organisation.
Ces liens n'apparaissent que pour l'Administrateur.
Filtrer les clés#
- Choisissez un État : Toutes, Actives, Expirées ou Révoquées.
- Choisissez un Propriétaire, ou laissez Tous.
- Cliquez sur Filtrer.
Lire une clé#
Chaque clé affiche :
| Information | Contenu |
|---|---|
| Libellé | Nom donné par le créateur de la clé |
| Propriétaire | Nom et identifiant du compte |
| État | Active, En fin de rotation, Expirée ou Révoquée, avec la date d'expiration |
| Périmètre | Projets autorisés. Un projet que vous ne pouvez plus ouvrir s'affiche « projet hors de votre périmètre ». |
| Droits | Par exemple Lire les projets, Démarrer une exécution, Lire la consommation |
| Dates | Création, dernière utilisation ou « jamais utilisée », révocation |
« En fin de rotation » signifie que le créateur de la clé l'a renouvelée la clé : l'ancienne reste valable au plus cinq minutes.
Le secret d'une clé n'est jamais réaffiché, ni à l'Administrateur ni au créateur de la clé. Il n'est montré qu'une fois, à la création.
Voir l'activité d'une clé#
Cliquez sur Activité des clés de ce propriétaire. Le journal des actions s'ouvre, filtré sur le type d'acteur Clé API et sur le compte qui a créé la clé. Chaque appel y figure avec l'identifiant de la clé, y compris les appels refusés.
Révoquer une clé#
- Sur la clé, cliquez sur Révoquer.
- Cliquez sur Confirmer la révocation, ou sur Annuler.
L'Administrateur peut révoquer une clé, mais pas la transférer à un autre compte, ni la renouveler, ni en créer une au nom d'un autre compte. La révocation est inscrite au journal des actions.
Quand révoquer#
- Un outil externe n'est plus utilisé.
- Une clé a peut-être fuité (dépôt de code, journal, capture d'écran).
- Une clé « jamais utilisée » reste active sans raison.
- Une personne change de mission sans que son compte soit suspendu.
Révocations automatiques#
Vous n'avez rien à faire dans ces cas : toutes les clés du compte sont révoquées automatiquement.
| Événement | Où il se produit |
|---|---|
| Suspension ou suppression du compte | Comptes et invitations |
| Changement de mot de passe ou d'adresse e-mail | Sécurité du compte |
| Récupération du compte | Accès perdu et récupération |
Par ailleurs, une clé ne donne jamais plus que les droits actuels du compte qui l'a créée. Si ce compte perd son rôle sur un projet, la clé perd aussi l'accès à ce projet, sans révocation.
Limites des clés#
| Règle | Valeur |
|---|---|
| Durée de validité | 1 à 90 jours |
| Projets par clé | 1 à 20 |
| Clés valides par compte | 20 au plus |
Pour continuer#
Surveillez l'état technique de l'instance sur la Page Exploitation. Pour intégrer un outil externe, voyez aussi les Ressources pour agents IA.