メインコンテンツまでスキップ

ネットワーク

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

入る側: 4 つの制限​

入る側の制限は 4 つあり、それぞれ別に効きます。 1 つを有効にしても、ほかの入口は絞られません。

制限絞る入口画面
アクセス許可IP設定管理コンソールと、チャット(自己登録を含む)「ログインと接続元」>「接続元の制限」>「アクセス許可IP設定」のタブ
外部連携 API 許可IP外部連携 API(/api/v1)「ログインと接続元」>「接続元の制限」>「外部連携 API 許可IP」のタブ
国制限設定ログイン・チャット・管理コンソールへの接続。外部連携 API・LLM Gateway にはかからない「ログインと接続元」>「接続元の制限」>「国制限設定」のタブ
LLM Gateway 許可IPLLM 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 日の検知の件数が出ます。

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

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

  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)。

外への通信を許した・止めた記録は「外部への通信の記録」に残ります(ログと監査)。