IP 許可リスト

IP 許可リスト

各 API キーに個別の IP 許可リストを設定でき、指定した送信元 IP からのリクエストだけがそのキーを使用できます。

適した利用場面

固定の送信元 IP を持つ本番サーバーや企業内ネットワークへのデプロイに適しています。自宅ネットワーク、モバイルネットワーク、その他変動するアドレスから利用する場合は、まず送信元 IP が安定していることを確認してください。確認しないと自分を締め出す可能性があります。

設定方法

「 /keys 」で対象キーの「…」メニューを開き、「IP 許可リスト」を選択して項目を入力し、保存します。

ログイン済みセッションまたは Management API key で PATCH /api/v1/keys/:id を使って設定することもできます。

PATCH https://api.bazaarlink.ai/v1/keys/KEY_ID
Authorization: Bearer sk-bl-YOUR_MANAGEMENT_KEY
Content-Type: application/json

{
"allowedCidrs": [
  "203.0.113.7",
  "198.51.100.0/24"
]
}

# Clear the allowlist and return to unrestricted access
{"allowedCidrs": []}

項目の形式

UI では 1 行に 1 つの値を入力します。API では同じ値を `allowedCidrs` 配列に入れます。裸の IPv4 アドレス、IPv4 CIDR、または IPv6 リテラル（完全一致のみ）を指定できます。

203.0.113.7
198.51.100.0/24
2001:db8::1

動作

空欄（空の [] 配列を送信）はすべての送信元 IP を許可します。これがデフォルトなので、既存キーの動作は変わりません。

送信元 IP は `cf-connecting-ip` ヘッダーから取得されます。

リストが空でないのに送信元 IP を解決できない場合、リクエストは拒否されます（fail-closed）。