Saldırı modu durumunu al

GET /v1/attack-protection/attack-mode · izin attack-protection:read

Ortamın saldırı modunda olup olmadığını ve son 90 gün içinde başlamış ya da hâlâ açık olan saldırı modu dönemlerini, en yeniden eskiye doğru döndürür (en fazla 100; more, bu pencerede daha eski dönemler olduğunu gösterir).

Ortam saldırı modundayken her parola ve tek kullanımlık kod adımı, bot_protection.mode değeri ne olursa olsun daha sıkı bir bot doğrulaması ister. Passkey ve sosyal giriş doğrulamaya tabi tutulmaz. Bir dönem üç yoldan biriyle açılır:

auto: 5 dakikalık bir pencerede başarısız girişler tetikleme eşiğini geçtiğinde (50 ile ortamın medyanının on katından büyük olanı). credential_stuffing modunun log modunda dönem would_have: true ile kaydedilir ve zorlama uygulanmaz; ancak pencere eşiğin üç katını geçerse zorlama uygulanır.
manual_customer: activate ile siz etkinleştirdiniz.
manual_platform: KeenAuth operasyon ekibi etkinleştirdi.

active yalnızca ortamın tamamını kapsayan zorlanmış bir dönem (would_have: false) varken true olur; bu durumda active_until, bu dönemlerin en geç bitiş zamanıdır. Bitiş zamanı geçmiş ama temizlik işlemi henüz kapatmamış bir dönem, ends_at anında sona ermiş gibi görünür. Manuel bir dönemi kimin açtığı bu yanıtta değil, yönetim denetim günlüğünde yer alır.

Yanıt

200 OK

Alan	Tür	Açıklama
`active`	boolean	Ortam şu anda saldırı modunda.
`active_until`	string (date-time) veya null	Mevcut saldırı modunun ne zaman biteceği; otomatik bir dönem uzatılmadıkça geçerlidir. `active` değeri `false` ise `null`.
`periods[]`	array	Dönemler, en yeniden eskiye doğru.
`periods[].id`	string	Dönem kimliği, `atm_` ön ekiyle.
`periods[].scope`	string	`environment` veya `org_domain`.
`periods[].org_domain`	string veya null	`org_domain` dönemine ait kuruluş e-posta alan adı.
`periods[].trigger`	string	`auto`, `manual_customer` veya `manual_platform`.
`periods[].would_have`	boolean	`true`: `log` modunda kaydedildi, zorlanmadı.
`periods[].trigger_value`	integer veya null	Bir `auto` dönemini açan 5 dakikalık pencerede başarısız deneme sayısı; manuel dönemlerde `null`.
`periods[].threshold`	integer veya null	Bu pencerenin geçtiği eşik; manuel dönemlerde `null`.
`periods[].started_at`	string (date-time)	Dönemin başlangıç zamanı.
`periods[].ends_at`	string (date-time)	Dönemin kendiliğinden biteceği zaman. Saldırı sürdükçe `auto` dönemi uzatılır.
`periods[].ended_at`	string (date-time) veya null	Dönemin bittiği zaman; dönem açıkken `null`.
`more`	boolean	Son 90 gün içinde daha eski dönemler var.

{
  "active": true,
  "active_until": "2026-10-20T10:00:00Z",
  "periods": [
    {
      "id": "atm_01jaz8m5c3f6t9w2y4b7d0g3k6",
      "scope": "environment",
      "org_domain": null,
      "trigger": "manual_customer",
      "would_have": false,
      "trigger_value": null,
      "threshold": null,
      "started_at": "2026-10-20T09:00:00Z",
      "ends_at": "2026-10-20T10:00:00Z",
      "ended_at": null
    }
  ],
  "more": false
}

Hatalar

Her hata, sabit bir code içeren bir application/problem+json gövdesidir.

HTTP	`code`	Ne zaman
401	`unauthenticated`	API anahtarı eksik, geçersiz ya da iptal edilmiş.
403	`insufficient_permissions`	Anahtarda `attack-protection:read` izni yok.
429	`rate_limited`	Hız sınırı aşıldı; `Retry-After` başlığına uyun.
503	`service_unavailable`	Bir bağımlılık geçici olarak kullanılamıyor; daha sonra yeniden deneyin.

Örnek

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

CLI: keenauth attack-protection attack-mode get