# Révoquer une clé

> Désactiver ou supprimer définitivement une clé API compromise ou inutile, et vérifier qu'elle est refusée.

Révoquez une clé dès qu'elle est exposée (publiée dans un dépôt, un journal, un ticket), qu'un serveur qui la détient est compromis, ou qu'elle ne sert plus. Deux actions existent : la désactivation, réversible, et la révocation, définitive.

## Avant de commencer

- Identifiez la clé par son nom et ses 10 premiers caractères, par exemple `sk_test_ex`, ainsi que son application et son environnement.

## Choisir entre désactivation et révocation

| | Désactivation | Révocation |
|---|---|---|
| Effet | La clé est refusée | La clé est supprimée |
| Réversible | Oui, elle peut être réactivée | Non |
| Quand | Doute, enquête en cours, pause d'une intégration | Clé exposée, usage terminé, après une rotation |

En cas de fuite, demandez la révocation : une clé exposée ne doit jamais être réactivée.

## Demander la révocation

1. Contactez le [support Wakastart](/v1.0/support) en indiquant le nom, le préfixe, l'application et l'environnement de la clé, et l'action souhaitée.
2. En cas de fuite, signalez-la comme urgente et précisez depuis quand la clé a pu être exposée.

Résultat : la clé est refusée dès la prise en compte de la demande, à l'appel suivant. Les créations, activations, désactivations et révocations de clés sont tracées dans le [journal d'audit](/v1.0/journal-d-audit), avec un instantané des droits de la clé.

:::important
Si la clé alimente un service en production, obtenez d'abord une clé de remplacement (voir [Faire tourner une clé](/v1.0/cles-api/faire-tourner-une-cle)), sauf en cas de fuite : là, révoquez d'abord et acceptez l'interruption.
:::

## Après une fuite

1. Recherchez dans vos journaux et dans le [journal d'audit](/v1.0/journal-d-audit) les actions faites avec la clé depuis la date d'exposition.
2. Supprimez la clé de l'endroit où elle a été exposée, y compris de l'historique du dépôt de code.
3. Rangez la clé de remplacement dans un secret (voir [Stocker une clé en sécurité](/v1.0/cles-api/stocker-une-cle-en-securite)).

## Vérifier le résultat

Appelez l'API avec la clé révoquée :

```bash
curl -s "https://api.wakastart.app/api/config/users?limit=1" -H "x-api-key: $OLD_KEY"
```

Réponse attendue :

```json
{
  "statusCode": 401,
  "message": "Cle API utilisateur invalide ou expiree",
  "error": "Unauthorized",
  "timestamp": "2026-10-23T09:12:44.512Z",
  "path": "/api/config/users"
}
```

## Voir aussi

- [Faire tourner une clé](/v1.0/cles-api/faire-tourner-une-cle).
- [Journal d'audit](/v1.0/journal-d-audit).
