アカウントロックを削除する

DELETE /v1/attack-protection/lockouts/{lockout_id} · 権限 attack-protection:write

未解除のアカウントロックを 1 件削除します。ユーザーはその経路で再びサインインできるようになり、その経路の失敗カウントは最初からやり直しになります。user.unlocked イベント(by = admin)と管理監査記録(user.unlocked、対象はユーザー)が、同じトランザクション内で書き込まれます。実行者はお客様の認証情報です。ユーザーのロックをすべて一度に削除する場合は、POST /v1/users/{user_id}:unlock を使用してください。

リクエスト

パラメータ 入力 必須 説明
lockout_id path はい ロック ID。lck_ で始まります。

レスポンス

204 No Content。ボディはありません。

エラー

すべてのエラーは、安定した code を含む application/problem+json ボディとして返されます。

HTTP code 発生条件
404 not_found この環境に未解除のロックがこの ID で存在しません。存在しなかったか、すでに削除されたか、期限切れになっています(または ID の形式が不正です)。
401 unauthenticated API キーがない、無効、または失効しています。
403 insufficient_permissions キーに attack-protection:write 権限がありません。
429 rate_limited レート制限を超えました。Retry-After に従ってください。
503 service_unavailable 依存先が一時的に利用できません。後で再試行してください。

例

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

CLI: keenauth attack-protection lockouts delete lck_01jaz8m5c3f6t9w2y4b7d0g3k6