# 管理コンソール リファレンス

この区分の表記と、管理コンソールで決まっている値の一覧です。項目の名前は画面の表示に合わせています。どれを選ぶかの考え方は、各ガイドにあります。

## 表記

このサービスには、管理のための画面が 2 つあります。DevPortal では次のように書きます。

| 表記          | 何の画面か                                                                                                                                           |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **管理コンソール** | テナントごとにある、管理者がテナントの利用者・Agent・記録・セキュリティを管理する画面。画面の題は「AGENTIC STAR ADMIN」。この区分（Admin）で扱います                                                        |
| **Console** | API のクライアントと LLM Gateway のキーを管理する画面（[Console ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/guide/console-guide.md)） |

## ログイン

| 項目                   | 値                                           | 既定        |
| -------------------- | ------------------------------------------- | --------- |
| 管理コンソールへのログイン        | パスワードで入るときは、毎回メールの認証コード。パスキー・SSO で入るときは求めない | —         |
| 自己登録                 | 既定（今の動き）・有効・無効                              | 既定（有効と同じ） |
| パスワードの再設定            | 既定（今の動き）・有効・無効                              | 既定（有効と同じ） |
| 操作が無い時にログインが切れるまでの時間 | 15 分〜24 時間。最長の時間以下。管理コンソール自身のログインにも効く       | —         |
| ログインを続けられる最長の時間      | 1 日〜30 日。管理コンソール自身のログインにも効く                 | —         |

## 外部認証設定

| 項目              | 値                                                 | 既定                     |
| --------------- | ------------------------------------------------- | ---------------------- |
| 外部認証を有効にする      | 有効・無効                                             | 無効                     |
| Entry ID        | 英小文字で始まり、英小文字・数字・ハイフン・アンダースコアの 2〜64 文字。あとから変えられない | —                      |
| アイコン            | PNG・JPEG。512KB まで                                 | —                      |
| IdP タイプ         | OIDC / OAuth2・SAML 2.0。あとから変えられない                 | —                      |
| Scopes（OIDC）    | 空白かカンマで区切る                                        | `openid profile email` |
| 紐付けキー           | メールアドレス・サブジェクト（sub）                               | メールアドレス                |
| ユーザー自動作成        | 有効・無効                                             | 有効                     |
| 自動承認            | 承認しない（管理者が承認）・指定したドメインだけ自動承認・全員を自動承認              | —                      |
| IdP クレーム値の変換ルール | IdP 側の値は完全一致で当たる                                  | —                      |

## ネットワーク

| 項目                    | 値                                                                       | 既定  |
| --------------------- | ----------------------------------------------------------------------- | --- |
| アクセス許可IP の書き方         | IPv4・IPv6・CIDR。`0.0.0.0/0`・`::/0` は登録できない                               | —   |
| アクセス許可IP の適用サービス      | ADMIN・WEB（1 つ以上）                                                        | —   |
| 外部連携 API 許可IP の制限     | 有効・無効                                                                   | 無効  |
| 国制限設定がかかる所            | ログイン・チャット・管理コンソール。外部連携 API・LLM Gateway にはかからない。サービスごとには分けられない           | —   |
| 国制限設定のルール名            | 英字で始まり、英字と数字だけで 128 文字まで                                                | —   |
| 国制限設定の国               | 1 つのルールで 1〜10 か国                                                        | —   |
| 国制限設定の優先度             | 100〜199 の整数。数字が小さいほど先に効く。ルールの間で重ねられない                                   | —   |
| 国制限設定の動作              | 遮断・検知のみ                                                                 | —   |
| 国制限設定が効くまで            | 1 時間ほど                                                                  | —   |
| 国制限設定の検知の件数           | 直近 30 日                                                                 | —   |
| Agent が外へつなぐときに使えるポート | `443`・`80`・`8080`・`8443`・`8000`・`3000`・`5000`・`9000`。HTTP と HTTPS の通信だけ | —   |
| Agent が出られる宛先         | 禁止URLに当たる宛先は止まる                                                         | すべて |

## ガードレール

| 項目                            | 値                                     | 既定        |
| ----------------------------- | ------------------------------------- | --------- |
| プロンプト攻撃の検出                    | 有効・無効                                 | 有効        |
| 有害コンテンツの検出感度                  | 推奨・緩い・最も緩い・無効                         | 推奨        |
| 個人情報のマスキング                    | 有効・無効                                 | 有効        |
| 実行時間の上限                       | 5・15・30・60・90・120 分か「制限しない」           | 制限しない     |
| 機微語・除外語                       | それぞれ 200 件まで                          | —         |
| 機微語の長さ                        | 語は 100 文字まで、正規表現（RE2）は 500 文字まで       | —         |
| 機微語の表示の名前                     | 50 文字まで。`[` `]` と制御文字は使えない            | —         |
| 除外語の長さ                        | 100 文字まで                              | —         |
| 正規表現を試す                       | 試す文は 2,000 文字まで。当たった所は 50 か所まで出る      | —         |
| AIエージェントへの共通の指示の連結順序          | 1・2・3                                 | —         |
| AIエージェントへの共通の指示の組織            | 全体（全部の組織）・各組織                         | 全体（全部の組織） |
| 禁止URL の理由                     | セキュリティ・コンプライアンス・内部ポリシー・その他            | —         |
| ウィジェットの通信先の制限で登録できるもの         | 拒否（ホスト名。サブドメインも止まる）だけ。変えてから 60 秒ほどで効く | —         |
| ガードレール設定が効くまで                 | 数分のうちに、次の依頼から                         | —         |
| 禁止事項の指示（AIエージェントへの共通の指示）が効くまで | 最大 30 分                               | —         |

## 記録

| 項目                              | 値                                                                                    | 既定                                |
| ------------------------------- | ------------------------------------------------------------------------------------ | --------------------------------- |
| 記録の保持                           | 24 か月（監査ログ・操作監査ログ・AIエージェントの LLM 利用・外部への通信の記録・LLM Gateway の記録）                        | —                                 |
| CSV の書き出し                       | 監査ログは上限なし。外部への通信の記録・利用者の操作の監査は 5,000 件まで。AIエージェントの LLM 利用・LLM Gateway の記録は 1,000 件まで | —                                 |
| 会話の書き出し                         | JSON で 1 回 1,000 件まで                                                                 | 期間を指定しないときは直近 30 日                |
| 利用者の操作の監査の画面                    | —                                                                                    | 期間を指定しないときは直近 30 日                |
| SIEM の送り先                       | HTTP push（汎用）・Microsoft Sentinel・Splunk・AWS CloudWatch Logs                          | —                                 |
| SIEM の外部の送り先                    | `https` だけ                                                                           | —                                 |
| SIEM へ送る間隔                      | 1 分ごと（届くまでおおむね 1〜2 分）                                                                | —                                 |
| SIEM に送れる記録                     | 9 種類                                                                                 | 「利用者の操作の監査」「外部への通信の記録」は送らない。ほかは送る |
| SIEM の HTTP push のトークンのヘッダ名     | —                                                                                    | `Authorization`                   |
| SIEM の CloudWatch Logs のログストリーム | —                                                                                    | 記録の種類の識別子（`audit_logs` など）        |

## 会話の保管と共有

| 項目                 | 値                                                                                         | 既定          |
| ------------------ | ----------------------------------------------------------------------------------------- | ----------- |
| 共有リンクを停止する（機能の許可）  | オン・オフ。オンにすると、作ったリンクも開けない（一覧の表示と削除はできる）。保存してから 60 秒以内に効く。構築の設定で無効にしているときは、この画面から使えるようにできない | オフ          |
| アーカイブまでの日数         | 30〜3650 日。次のアーカイブの実行から効く                                                                  | 空（構築の設定の日数） |
| アーカイブ後の保持日数        | 30〜3650 日。過ぎた会話は添付ごと消え、戻せない。保全（legal hold）中のものは消えない                                       | 空（無期限）      |
| 保全（legal hold）の ID | プロジェクトは UUID、会話は 128 文字まで                                                                 | —           |

## エラーのコード

管理コンソールの設定によって、外部 API が返すエラーです。

| HTTP ステータス | `error.code`     | いつ                                                    | 決める設定                                                                                                                                                                        |
| ---------- | ---------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `403`      | `ip_not_allowed` | 外部連携 API 許可IP が有効で、許可していない接続元から呼んだとき                  | [外部連携 API 許可IP](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/admin/guide/network-guide.md#%E5%A4%96%E9%83%A8%E9%80%A3%E6%90%BA-api-%E8%A8%B1%E5%8F%AFip)       |
| `403`      | `sso_required`   | プロジェクトの外部 API で、SSO でログインしていない利用者が、SSO の利用者だけの操作をしたとき | [SSO だけで入らせる](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/admin/guide/login-sso-guide.md#sso-%E3%81%A0%E3%81%91%E3%81%A7%E5%85%A5%E3%82%89%E3%81%9B%E3%82%8B) |

## 管理者の種類と使える画面

| 画面                                                                                                            | システム管理者       | 組織管理者                                       | 監査役     |
| ------------------------------------------------------------------------------------------------------------- | ------------- | ------------------------------------------- | ------- |
| ダッシュボード                                                                                                       | ○             | ○                                           | —       |
| プロジェクト管理の横断 KPI・実行履歴                                                                                          | ○             | ○（担当する組織の範囲）                                | ○（閲覧だけ） |
| プロジェクト管理の実行ルール                                                                                                | ○             | 見るだけ                                        | —       |
| プロジェクト管理の確認依頼・組織のプロジェクト                                                                                       | 組織管理者を兼ねるときだけ | ○（担当する組織の範囲）                                | —       |
| AIエージェントの AIエージェント一覧（横断）                                                                                      | ○             | ○（担当する組織の範囲）                                | ○（閲覧だけ） |
| AIエージェントの公開の申請                                                                                                | ○             | ○（担当する組織の範囲。公開を承認制にするかのテナント全体の設定はシステム管理者だけ） | —       |
| 接続先と使える範囲の MCPの接続（システム管理者には「MCPサーバー」＞「MCPの接続」のタブ）                                                             | ○             | ○（自組織の利用者・プロジェクトの接続だけ）                      | —       |
| 記録と監査の監査ログ・操作監査ログ・利用者の操作の監査・AIエージェントの LLM 利用・外部への通信の記録（外部への通信の記録は、監査役ではテナントの監査役だけ。ガードレールアラートと利用者の評価は監査役には出ない） | ○             | —                                           | ○（閲覧だけ） |
| ユーザーメニューの「パスワード変更」                                                                                            | ○             | ○                                           | ○       |
| そのほかの画面（この区分のガイドで扱う設定を含む）                                                                                     | ○             | —                                           | —       |

組織管理者は、利用者と組織の「管理の役割」で決めます（[ロールリファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/roles-ref.md)）。
