Eliminar un bloqueo de cuenta
DELETE /v1/attack-protection/lockouts/{lockout_id} · permiso attack-protection:write
Elimina un bloqueo de cuenta abierto: el usuario puede volver a iniciar sesión por esa vía, y el contador de fallos de esa vía empieza de nuevo. El evento user.unlocked (by = admin) y un registro de auditoría de gestión (user.unlocked, con el usuario como destino) se escriben en la misma transacción, con su credencial como actor. Para eliminar a la vez todos los bloqueos de un usuario, use POST /v1/users/{user_id}:unlock.
Solicitud
| Parámetro | En | Obligatorio | Descripción |
|---|---|---|---|
lockout_id |
path | sí | Id del bloqueo, con el prefijo lck_. |
Respuesta
204 No Content, sin cuerpo.
Errores
Cada error es un cuerpo application/problem+json con un code estable.
| HTTP | code |
Cuándo |
|---|---|---|
| 404 | not_found |
Ningún bloqueo abierto tiene este id en este entorno: nunca existió, ya se eliminó, o expiró (o el id está mal formado). |
| 401 | unauthenticated |
Falta la clave de API, no es válida o está revocada. |
| 403 | insufficient_permissions |
La clave no tiene el permiso attack-protection:write. |
| 429 | rate_limited |
Se superó el límite de frecuencia; respete Retry-After. |
| 503 | service_unavailable |
Una dependencia no está disponible temporalmente; reintente más tarde. |
Ejemplo
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