# ネットワーク

**どこからテナントに入れるか**と、**このサービスから外へ出る通信**を、どう絞るかを扱います。

## 入る側: 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」（[セットアップガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/llm-gateway/guide/setup.md)） |

### アクセス許可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 日の検知の件数が出ます。

### 制限をかけるときの順番

どの制限も、かけるかどうかはお客様が決めます。かけるときは、締め出されないよう次の順で進めます。

1. **先に、使う人全員の IP アドレスを登録します。** 在宅や出張先から入る人、管理者も含めます
2. 国制限設定は、まず「**検知のみ（記録だけ）**」で様子を見て、止めてよい国だけを「遮断」にします
3. 最後に、各制限を有効にします

## 出る側: このサービスからお客様のシステムへ

**このサービスから外へ出る通信**の決まりです。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](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/admin/guide/guardrail-guide.md#%E7%A6%81%E6%AD%A2url)）。

外への通信を許した・止めた記録は「**外部への通信の記録**」に残ります（[ログと監査](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/admin/guide/audit-log-guide.md)）。
