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 許可リストの用語集の項目では、考え方を一般的に説明しています。

