手動の攻撃モードを終了する
POST /v1/attack-protection/attack-mode:deactivate · 権限 attack-protection:write
activate で有効にした攻撃モードの期間を、今すぐ終了します。attack_mode_deactivated イベントと管理監査レコード（attack_mode.deactivated）が書き込まれ、操作主体はお客様の認証情報です。
終了するのはお客様が開いた手動の期間だけです。自動トリガーまたは KeenAuth の運用チームが開いた期間は、途中で終了できません。そのような期間が開いている間、レスポンスは引き続き active: true を返します。開いている手動の期間がない場合は、何も書き込まれず、現在の状態が返されます。そのため、この呼び出しは繰り返しても安全です。
リクエスト
ボディはありません。
レスポンス
200 OK と現在の状態が返ります。形式は GET /v1/attack-protection/attack-mode と同じです。
エラー
すべてのエラーは、安定した code を含む application/problem+json 本文です。
| HTTP | code |
発生条件 |
|---|---|---|
| 401 | unauthenticated |
API キーがない、無効、または失効している場合です。 |
| 403 | insufficient_permissions |
キーに attack-protection:write 権限がない場合です。 |
| 429 | rate_limited |
レート制限を超えた場合です。Retry-After に従ってください。 |
| 503 | service_unavailable |
依存サービスが一時的に利用できない場合です。後で再試行してください。 |
例
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