Révoquer une clé
Désactiver ou supprimer définitivement une clé API compromise ou inutile, et vérifier qu'elle est refusée.
- Duration
- 5 min
This page has not been translated yet and is shown in French.
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
- Contactez le support Wakastart en indiquant le nom, le préfixe, l'application et l'environnement de la clé, et l'action souhaitée.
- 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, 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é), sauf en cas de fuite : là, révoquez d'abord et acceptez l'interruption.
Après une fuite
- Recherchez dans vos journaux et dans le journal d'audit les actions faites avec la clé depuis la date d'exposition.
- Supprimez la clé de l'endroit où elle a été exposée, y compris de l'historique du dépôt de code.
- Rangez la clé de remplacement dans un secret (voir Stocker une clé en sécurité).
Vérifier le résultat
Appelez l'API avec la clé révoquée :
curl -s "https://api.wakastart.app/api/config/users?limit=1" -H "x-api-key: $OLD_KEY"Réponse attendue :
{
"statusCode": 401,
"message": "Cle API utilisateur invalide ou expiree",
"error": "Unauthorized",
"timestamp": "2026-10-23T09:12:44.512Z",
"path": "/api/config/users"
}