Activer le mode d'attaque
POST /v1/attack-protection/attack-mode:activate · autorisation attack-protection:write
Place l'environnement en mode d'attaque pendant duration_minutes (de 15 à 1 440) à partir de maintenant, quelles que soient les valeurs de bot_protection.mode et de credential_stuffing. Chaque étape de mot de passe et de code à usage unique exige alors une vérification anti-bot plus stricte ; la connexion par passkey et la connexion sociale ne sont pas soumises à cette vérification. Utilisez cette action lorsque vous détectez une attaque avant le déclenchement automatique.
Si votre période manuelle est déjà ouverte, sa fin passe à maintenant plus duration_minutes, lorsque cette date est postérieure. Une durée plus courte ne la termine jamais plus tôt (utilisez deactivate pour cela). L'ouverture d'une période écrit l'événement attack_mode_activated et un enregistrement d'audit de gestion (attack_mode.activated) ; une prolongation écrit l'enregistrement d'audit attack_mode.extended. Votre identifiant est l'acteur. Envoyez un en-tête Idempotency-Key pour pouvoir réessayer sans risque.
Requête
{ "duration_minutes": 60 }
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
duration_minutes |
integer | oui | De 15 à 1 440. |
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 |
|---|---|---|
| 400 | malformed_request |
Le corps n'est pas un objet JSON. |
| 400 | unknown_field |
Le corps contient un champ autre que duration_minutes. |
| 422 | validation_failed |
duration_minutes est absent, n'est pas un entier ou est hors de la plage 15 à 1 440 (errors[].pointer vaut /duration_minutes). |
| 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:activate \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 7b2f0c1e-attack-mode-1" \
-d '{"duration_minutes": 60}'
CLI : keenauth attack-protection attack-mode activate --duration-minutes 60