Supprimer un verrouillage de compte
DELETE /v1/attack-protection/lockouts/{lockout_id} · autorisation attack-protection:write
Supprime un verrouillage de compte ouvert : l'utilisateur peut de nouveau se connecter par ce chemin, et le compteur d'échecs de ce chemin repart de zéro. L'événement user.unlocked (by = admin) et un enregistrement d'audit de gestion (user.unlocked, cible l'utilisateur) sont écrits dans la même transaction, votre clé d'API étant l'acteur. Pour supprimer en une seule fois tous les verrouillages d'un utilisateur, utilisez POST /v1/users/{user_id}:unlock.
Demande
| Paramètre | Dans | Obligatoire | Description |
|---|---|---|---|
lockout_id |
chemin | oui | Identifiant du verrouillage, préfixé lck_. |
Réponse
204 No Content, sans corps.
Erreurs
Chaque erreur est un corps application/problem+json accompagné d'un code stable.
| HTTP | code |
Quand |
|---|---|---|
| 404 | not_found |
Aucun verrouillage ouvert ne porte cet identifiant dans cet environnement : il n'a jamais existé, il a déjà été supprimé ou il a expiré (ou l'identifiant est mal formé). |
| 401 | unauthenticated |
La clé d'API est absente, invalide ou révoquée. |
| 403 | insufficient_permissions |
La clé ne dispose pas de l'autorisation attack-protection:write. |
| 429 | rate_limited |
La limite de débit a été dépassée ; respectez l'en-tête Retry-After. |
| 503 | service_unavailable |
Une dépendance est temporairement indisponible ; réessayez plus tard. |
Exemple
curl -X DELETE https://api.eu.keenauth.com/v1/attack-protection/lockouts/lck_01jaz8m5c3f6t9w2y4b7d0g3k6 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI : keenauth attack-protection lockouts delete lck_01jaz8m5c3f6t9w2y4b7d0g3k6