Kontosperre aufheben
DELETE /v1/attack-protection/lockouts/{lockout_id} · Berechtigung attack-protection:write
Hebt eine offene Kontosperre auf: Der Benutzer kann sich auf diesem Weg wieder anmelden, und der Fehlerzähler für diesen Weg beginnt von vorn. Das Ereignis user.unlocked (by = admin) und ein Verwaltungs-Audit-Datensatz (user.unlocked, Ziel der Benutzer) werden in derselben Transaktion geschrieben, mit Ihren Zugangsdaten als Akteur. Um alle Sperren eines Benutzers auf einmal aufzuheben, verwenden Sie POST /v1/users/{user_id}:unlock.
Anfrage
| Parameter | In | Erforderlich | Beschreibung |
|---|---|---|---|
lockout_id |
path | ja | Sperr-ID mit Präfix lck_. |
Antwort
204 No Content, ohne Body.
Fehler
Jeder Fehler ist ein application/problem+json-Body mit einem stabilen code.
| HTTP | code |
Wann |
|---|---|---|
| 404 | not_found |
Keine offene Sperre hat diese ID in dieser Umgebung: Sie hat nie existiert, wurde bereits aufgehoben oder ist abgelaufen (oder die ID ist fehlerhaft). |
| 401 | unauthenticated |
Der API-Schlüssel fehlt, ist ungültig oder widerrufen. |
| 403 | insufficient_permissions |
Dem Schlüssel fehlt die Berechtigung attack-protection:write. |
| 429 | rate_limited |
Das Ratenlimit wurde überschritten; beachten Sie Retry-After. |
| 503 | service_unavailable |
Eine Abhängigkeit ist vorübergehend nicht verfügbar; später erneut versuchen. |
Beispiel
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