Saldırı modunu aç
POST /v1/attack-protection/attack-mode:activate · izin attack-protection:write
Ortamı, bot_protection.mode ve credential_stuffing değerleri ne olursa olsun, şu andan itibaren duration_minutes (15 ila 1.440) dakika boyunca saldırı modunda tutar. Ardından her parola ve tek kullanımlık kod adımı daha sıkı bir bot sınaması ister; passkey ve sosyal giriş sınanmaz. Saldırıyı otomatik tetikleyiciden önce fark ettiğinizde kullanın.
Manuel döneminiz zaten açıksa, bitiş zamanı şimdi + duration_minutes olarak güncellenir; bu daha sonraysa. Daha kısa bir süre dönemi daha erken bitirmez (bunun için deactivate kullanın). Dönem açmak attack_mode_activated olayını ve bir yönetim denetim kaydını (attack_mode.activated) yazar; uzatma ise attack_mode.extended denetim kaydını yazar. Aktör sizin kimlik bilginizdir. Güvenli yeniden deneme için Idempotency-Key başlığı gönderin.
İstek
{ "duration_minutes": 60 }
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
duration_minutes |
integer | evet | 15 ila 1.440. |
Yanıt
200 OK, mevcut durumla birlikte; GET /v1/attack-protection/attack-mode bu durumu aynı biçimde döndürür.
Hatalar
Her hata, kararlı bir code içeren application/problem+json gövdesidir.
| HTTP | code |
Ne zaman |
|---|---|---|
| 400 | malformed_request |
Gövde bir JSON nesnesi değil. |
| 400 | unknown_field |
Gövdede duration_minutes dışında bir alan var. |
| 422 | validation_failed |
duration_minutes eksik, tam sayı değil veya 15 ila 1.440 dışında (errors[].pointer değeri /duration_minutes). |
| 401 | unauthenticated |
API anahtarı eksik, geçersiz veya iptal edilmiş. |
| 403 | insufficient_permissions |
Anahtarda attack-protection:write izni yok. |
| 429 | rate_limited |
Hız sınırı aşıldı; Retry-After değerine uyun. |
| 503 | service_unavailable |
Bir bağımlılık geçici olarak kullanılamıyor; daha sonra yeniden deneyin. |
Örnek
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