Mettre fin au mode d'attaque manuel

POST /v1/attack-protection/attack-mode:deactivate · autorisation attack-protection:write

Met fin immédiatement à la période de mode d'attaque que vous avez activée avec activate. Elle écrit l'événement attack_mode_deactivated et un enregistrement d'audit de gestion (attack_mode.deactivated), votre identifiant étant l'acteur.

Seule votre période manuelle prend fin. Une période ouverte par le déclencheur automatique ou par les opérations KeenAuth ne peut pas être arrêtée plus tôt : tant qu'elle est ouverte, la réponse indique toujours active: true. Lorsque vous n'avez aucune période manuelle ouverte, rien n'est écrit et l'état actuel est renvoyé ; l'appel peut donc être répété sans risque.

Requête

Aucun corps.

Réponse

200 OK avec l'état actuel, tel que le renvoie GET /v1/attack-protection/attack-mode.

Erreurs

Chaque erreur est un corps application/problem+json contenant un code stable.

HTTP code Quand
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 Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez plus tard.

Exemple

curl -X POST https://api.eu.keenauth.com/v1/attack-protection/attack-mode:deactivate \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI : keenauth attack-protection attack-mode deactivate