Rimuovi un blocco dell'account

DELETE /v1/attack-protection/lockouts/{lockout_id} · permesso attack-protection:write

Rimuove un blocco di account attivo: l'utente può di nuovo accedere su quel percorso e il conteggio dei tentativi falliti per il percorso riparte da zero. L'evento user.unlocked (by = admin) e un record di audit di gestione (user.unlocked, con l'utente come destinatario) vengono scritti nella stessa transazione, con la credenziale utilizzata come attore. Per rimuovere in una sola volta tutti i blocchi di un utente, usare POST /v1/users/{user_id}:unlock.

Richiesta

Parametro In Obbligatorio Descrizione
lockout_id path sì ID del blocco, con prefisso lck_.

Risposta

204 No Content, senza corpo.

Errori

Ogni errore è un body application/problem+json con un code stabile.

HTTP code Quando
404 not_found Nell'ambiente non esiste un blocco attivo con questo ID: non è mai esistito, è già stato rimosso, è scaduto, oppure l'ID è malformato.
401 unauthenticated La chiave API manca, non è valida o è stata revocata.
403 insufficient_permissions La chiave non ha il permesso attack-protection:write.
429 rate_limited È stato superato il limite di frequenza; attendi il periodo indicato in Retry-After.
503 service_unavailable Una dipendenza non è disponibile temporaneamente; riprova più tardi.

Esempio

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