BroadRouter
始める

IP 許可リストで API キーを自社サーバーに限定する

更新日

サーバーの送信元 IPv4・IPv6 アドレスまたは CIDR 範囲を、アカウントの許可リストに最大 32 件追加します。新しいキーは、作成時に allowed_ips を渡さない限りこのリストを引き継ぎます。ほかのアドレスからのリクエストは 403 になり、許可リストの変更や失効は 5 秒以内に反映されます。

API の請求が膨れ上がる原因として最も多いのは、キーの漏えいです。BroadNet Inference には、IP 許可リストとすばやい失効という 2 つの対策があります。

2 種類の認証情報

認証情報 用途 扱い方
推論用キー /v1/* へのモデルのリクエスト 1 つのアプリやエージェント専用のシークレット
ポータル認証情報 アカウントの自動化:キー、許可 IP、購入 アカウントの全権限

どちらも表示されるのは一度だけです。ポータルは SHA-256 ハッシュしか保存しないため、キーを再表示できません。従量課金の推論用キーの有効期間は作成から 1 年で、1 つのアカウントで有効なキーは最大 10 個までです。

許可リストを設定する

アカウントページで、IPv4・IPv6 アドレスまたは CIDR 範囲を 1 行に 1 つずつ、最大 32 件追加します。空のリストは IP 制限なしを意味します。新しいキーはこのアカウントのリストを引き継ぎます。エッジは API リクエストごとに、Cloudflare が報告するクライアント IP を確認します。

スクリプトからアカウントのリストを管理するには、PUT /portal/allowed_ips で 1 回の呼び出しでまとめて置き換えます(ポータル認証情報が必要です)。

ポータル認証情報でキーを作成するときに、そのキー専用のリストを指定できます。

curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'

キーごとの allowed_ips は、そのキーについては引き継いだアカウントのリストを置き換えます。レスポンスには生のキーが一度だけ含まれるので、すぐに保存してください。

漏えいしたキーをすばやく失効させる

DELETE /portal/keys/{alias} は従量課金のキーを、DELETE /portal/keys/hourly/{alias} は時間制キーを失効させます(元の購入代金はそのまま請求されます)。失効や許可リストの変更から 5 秒以内に、新しいリクエストは止まります。

curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"

KEY_ALIAS には、アカウントページか GET /portal/keys に表示されるそのキーのエイリアスを設定します。エイリアスはシークレットキーではありません。ポータル認証情報が漏えいした場合は、DELETE /portal/credentials/{id} で失効させてください。アカウントでできることはすべてできてしまいます。

トラブルシューティング

  • リストに登録したサーバーから 403 が返る。 エッジに見えるのは公開側の送信元アドレスで、サーバーのプライベート IP ではありません。NAT ゲートウェイ、プロキシ、ロードバランサーの背後にあるサーバーは、その機器のアドレスから外に出ます。IPv6 を持つサーバーは、IPv4 アドレスだけを登録していても IPv6 で出ていくことがあります。リクエストが実際に出ていくアドレスか、それを含む CIDR 範囲を登録してください。
  • 新しいキーがアカウントのリストを無視する。 キーごとの allowed_ips 配列は、そのキーについては引き継いだアカウントのリストを置き換えます。作成時に何を渡したか確認してください。
  • 409 key_limit_reached。 アカウントにすでに有効なキーが 10 個あります。使わなくなったキーを失効させてください。
  • 失効後の数秒間、リクエストがまだ成功する。 キャッシュが追いつくまでの最大 5 秒間は想定どおりの動作です。

リストにないアドレスからのリクエストは 403 になります。BroadNet のすべてのエラーコードとリトライすべき場面を参照してください。新しいキーで最初のリクエストを送るには、OpenAI Python SDK のガイドに従ってください。IP 許可リストの用語集の項目では、考え方を一般的に説明しています。

A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."

よくある質問

LLM の API キーを自分のサーバーの IP アドレスだけで使えるようにするには?

BroadNet のアカウントページで、サーバーの公開送信元アドレスか CIDR 範囲をアカウントの許可リストに追加するか、POST /portal/keys でキーを作成するときに allowed_ips を渡します。それ以外のアドレスからのリクエストは 403 で拒否されます。

許可リストが空だとすべてブロックされますか?

いいえ。空のリストは IP 制限なしを意味し、キーはどのアドレスからでも使えます。制限を有効にするには少なくとも 1 件追加してください。

推論用キーでほかのキーを作成できますか?

できません。推論用キーが呼び出せるのは /v1/* のモデルのルートだけです。キーの作成と失効、許可 IP の変更、時間制キーの購入にはポータル認証情報が必要で、これはアカウントの全権限を持ちます。

漏えいしたキーを失効させると、どのくらいで効きますか?

BroadNet のドキュメントによると、失効や許可リストの変更から 5 秒以内に新しいリクエストは止まります。認可の判定が複製されたキャッシュにその間残る場合があるためです。

Markdown で読むChatGPT に聞くClaude に聞くPerplexity に聞く