ネットワーク
どこからテナントに入れるかと、このサービスから外へ出る通信を、どう絞るかを扱います。
入る側: 4 つの制限
入る側の制限は 4 つあり、それぞれ別に効きます。 1 つを有効にしても、ほかの入口は絞られません。
| 制限 | 絞る入口 | 画面 |
|---|---|---|
| アクセス許可IP設定 | 管理コンソールと、チャット(自己登録を含む) | 「ログインと接続元」>「接続元の制限」>「アクセス許可IP設定」のタブ |
| 外部連携 API 許可IP | 外部連携 API(/api/v1) | 「ログインと接続元」>「接続元の制限」>「外部連携 API 許可IP」のタブ |
| 国制限設定 | ログイン・チャット・管理コンソールへの接続。外部連携 API・LLM Gateway にはかからない | 「ログインと接続元」>「接続元の制限」>「国制限設定」のタブ |
| LLM Gateway 許可IP | LLM Gateway(/llm) | 「LLM Gateway 管理」>「LLM Gateway 許可IP」(セットアップガイド) |
アクセス許可IP設定
管理コンソール(ADMIN)とチャット(WEB)の制限は、別々に有効にします。 許可の一覧は 2 つで共通で、許可する IP アドレスごとに、管理コンソールに入れるか、チャットに入れるかを選びます。WEB の制限を有効にすると、許可していない IP アドレスからは、チャットを使えず、ログイン画面での自己登録(アカウントを自分で作ること)もできません。 自己登録の画面には、その旨が出て、登録のボタンが押せなくなります。
許可 IP の 1 件の項目
| 項目 | 中身 |
|---|---|
| IPアドレス(必須) | IPv4・IPv6・CIDR(例: 192.168.1.100・192.168.1.0/24・2001:db8::/32)。空白は入れられません。すべての IP アドレスを許す値(0.0.0.0/0・::/0)は登録できません |
| 説明 | 用途や場所のメモ(例: 本社オフィス) |
| 適用サービス(1 つ以上) | ADMIN(管理コンソールに入れる)/WEB(チャットに入れる・自己登録ができる) |
| 有効 | 無効にすると、一覧に残したまま許可から外れます |
制限の有効・無効
- 一覧の上で、ADMIN と WEB の制限をそれぞれ有効・無効にします。無効にするときは確認が出ます
- そのサービス向けの有効な許可 IP が 1 件も無いと、制限は有効にできません
- 自分の IP アドレスが一覧に無いと、ADMIN の制限は有効にできません。 自分を締め出さないためです。有効にできないときは、今の自分の IP アドレスを添えて、その旨が出ます
- 一覧の各行の状態は、次のように読みます
| 状態 | 意味 |
|---|---|
| ルール有効 | この許可 IP が効いています |
| ルール有効(未適用) | 許可 IP は有効ですが、そのサービスの制限が無効なので、まだ何も絞っていません |
| ルール無効 | この許可 IP は使われません |
消すときは、画面が影響を出します。 消した後に残る有効な許可 IP の数、今の自分の接続元かどうか、最後の 1 件かどうかです。
- ADMIN の制限が有効なまま、最後の有効な許可 IP を消すと、外から管理コンソールに入れなくなり、この画面にも戻れなくなります。 消す前に、ほかの許可 IP を登録するか、ADMIN の制限を無効にしてください
- WEB の制限だけが有効なら、外からチャットに入れなくなりますが、管理コンソールは使えます
- 今の自分の接続元を消すと、ほかの許可 IP に含まれない限り、その接続元から管理コンソールに戻れなくなります
外部連携 API 許可IP
外部連携 API(/api/v1)への接続元を絞ります。既定は無効です。 LLM Gateway(/llm)の接続元は、「LLM Gateway 許可IP」で別に決めます。
- 1 件の項目は、IPアドレス(IPv4・IPv6・CIDR)・説明・有効です
- 有効な許可 IP が 1 件も無いと、制限は有効にできません
- 有効にすると、許可していない接続元からの呼び出しは
403(error.codeはip_not_allowed)になります - 制限が有効な間は、最後の有効な許可 IP を無効にしたり消したりできません。先に制限を無効にします
国制限設定
国制限設定のルールは、ログイン・チャット・管理コンソールにかかります。外部連携 API・LLM Gateway にはかかりません。 管理コンソールだけ、チャットだけには分けられません。
ルールごとに、動作・優先度・国を決めます。1 つのルールで足りない国は、別のルールに分けます。
| 項目 | 中身 |
|---|---|
| ルール名(必須) | 英字で始まり、英字と数字だけで 128 文字まで(例: GeoBlockedAllServices) |
| 優先度(必須) | 100〜199 の整数。数字が小さいほど先に効きます。ほかのルールと同じ数字は使えません |
| 動作 | 遮断(選んだ国からの接続を止める)/検知のみ(止めずに記録だけする) |
| ブロック対象国(1 つ以上) | 1 つのルールで 10 か国まで |
| 有効にする | 既定は有効です。無効にすると、このルールは効きません。無効にするときは確認が出ます |
設定が効くまで、1 時間ほどかかることがあります。 作る・変える・消すの後に反映に時間がかかっているときは、画面にその旨が出ます。一覧には、ルールごとの直近 30 日の検知の件数が出ます。
制限をかけるときの順番
どの制限も、かけるかどうかはお客様が決めます。かけるときは、締め出されないよう次の順で進めます。
- 先に、使う人全員の IP アドレスを登録します。 在宅や出張先から入る人、管理者も含めます
- 国制限設定は、まず「検知のみ(記録だけ)」で様子を見て、止めてよい国だけを「遮断」にします
- 最後に、各制限を有効にします
出る側: このサービスからお客様のシステムへ
このサービスから外へ出る通信の決まりです。Agent が MCP サーバーやお客様の API を呼ぶときなどに効きます。
送信元の IP アドレス
「ログインと接続元」>「送信元 IP」に出ている IP アドレスを、お客様のファイアウォールですべて許可してください。 このサービスから外へ出る通信の送信元です。
- このテナントの環境から外へ出る通信(Agent が MCP サーバーやお客様の API を呼ぶときなど)の送信元です
- IP アドレスは構築の設定で決まり、この画面では変えられません
- 環境を作り直すと変わることがあります。変わったときは、この画面の値も変わります
- 「未設定」と出ているときは、ソフトバンクにお問い合わせください
使えるポート
Agent が外へつなぐときに使えるポートは、次の 8 つです。
443・80・8080・8443・8000・3000・5000・9000
ほかのポートで待ち受けている MCP サーバーなどには、つなげません。 お客様の側で、これらのポートのどれかで受けられるようにしてください。
Agent が外へつなげるのは、HTTP と HTTPS の通信だけです。 データベース・メールの送信(SMTP)・SSH などには、直接つなげません。外部のデータベースを使うときは、それを包む MCP サーバーなど、HTTP で呼べる口をお客様の側に用意してください。
宛先
Agent は、既定ではすべての宛先に出られます。 止めたい宛先は「禁止URL」に登録します。禁止URLに当たる宛先は、いつも止まります(ガードレールと禁止URL)。
外への通信を許した・止めた記録は「外部への通信の記録」に残ります(ログと監査)。