---
title: Inventaire des clés API
description: Contrôler toutes les clés API personnelles de l'organisation, leur créateur, leurs droits et leur activité, et révoquer une clé.
---

# 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**.

> [!NOTE]
> Cette page ne crée pas de clé. Une clé appartient toujours à la personne qui l'a créée, depuis **Mes clés API**. La création, les droits (scopes) et le renouvellement sont décrits dans [Clés API personnelles](../07-integration-api/02-cles-api-personnelles.md).

## 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

1. Choisissez un **État** : **Toutes**, **Actives**, **Expirées** ou **Révoquées**.
2. Choisissez un **Propriétaire**, ou laissez **Tous**.
3. 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](06-journal-des-actions.md) 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é

> [!WARNING]
> La révocation est immédiate et définitive. Tout outil qui utilise la clé reçoit ensuite une erreur 401. Une demande d'exécution encore en attente, faite avec cette clé, est annulée.

1. Sur la clé, cliquez sur **Révoquer**.
2. 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](01-comptes-et-invitations.md) |
| Changement de mot de passe ou d'adresse e-mail | [Sécurité du compte](02-securite-du-compte.md) |
| Récupération du compte | [Accès perdu et récupération](04-acces-perdu-et-recuperation.md) |

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](08-page-exploitation.md). Pour intégrer un outil externe, voyez aussi les [Ressources pour agents IA](../07-integration-api/07-agent-ia.md).
