Aller au contenu

Révoquer une clé

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

GuideDéveloppeur
Durée
5 min
Voir en Markdown

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ésactivationRévocation
EffetLa clé est refuséeLa clé est supprimée
RéversibleOui, elle peut être réactivéeNon
QuandDoute, enquête en cours, pause d'une intégrationClé 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 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, 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

  1. Recherchez dans vos journaux et dans le 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é).

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