# ログインと外部認証（SSO）

**利用者と管理者が、どの方法で入るか**を決めるための選択肢と基準を扱います。SSO を使わないテナントにも効く、ログインの持続時間やロックの動きもここにあります。

## ログインの方法は 3 つ

| 方法        | 入り方                        | 決める場所                                                                                                       |
| --------- | -------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **パスワード** | メールアドレスとパスワード              | 「ログイン」の画面（自己登録・パスワードの再設定）                                                                                   |
| **パスキー**  | 端末の生体認証や PIN。パスワードを入れずに入れる | 利用者が自分で登録する。チャットの「設定」＞「パスキー」で、自分のパスキーの一覧（登録した時刻・最後に使用した時刻）を見て、使わないものを削除できる（管理者・監査役は、パスキーでログインしているときだけ削除できる） |
| **SSO**   | お客様の ID 基盤（IdP）で認証する       | 外部認証設定                                                                                                      |

**SSO で入るときの認証は、お客様の ID 基盤が行います。** 多要素認証や条件付きアクセスは、ID 基盤の側で決めてください。

## 管理コンソールのログイン

**管理コンソールにパスワードで入るときは、毎回、メールの認証コードを求めます。** チャットと違い、端末や接続元にかかわらず求めます。パスキーか SSO で入るときは、認証コードは求めません。パスキーを登録している管理者は、メールアドレスを入れて「続ける」を押すと、パスキーで入れます。

**管理コンソールのログインの持続時間も、「ログイン」の画面の設定に従います**（[「ログイン」の画面で決めること](#%E3%83%86%E3%83%8A%E3%83%B3%E3%83%88%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%81%A7%E6%B1%BA%E3%82%81%E3%82%8B%E3%81%93%E3%81%A8)）。

## SSO をつなぐ

**「ログインと接続元」＞「外部認証設定」で、ID 基盤ごとに設定を作ります。** この画面とお客様の ID 基盤の画面を、次の順で行き来します。

1. **表示名と IdP タイプを決める** — IdP タイプは OIDC / OAuth2 か SAML 2.0 です。**IdP タイプは、あとから変えられません**
2. **ID 基盤に URL を登録する** — IdP タイプを選ぶと、ID 基盤に登録する URL が、画面の「IdP側設定情報」に出ます（OIDC は Redirect URI、SAML は ACS URL・SP メタデータ URL など）。外部認証設定を保存する前でも出るので、先にコピーして ID 基盤に登録できます
3. **ID 基盤の情報を入れる** — OIDC は ID 基盤が発行した Client ID・Client Secret と各エンドポイント（Issuer URL から自動で取り込めます）、SAML は IdP Entity ID・SSO URL・署名証明書などです
4. **属性と利用者の対応を決める** — 紐付けキー、組織と職種の取り込み、自動承認

### 設定の項目

画面の節ごとの項目です。「必須」と書いていない項目は、空のままでも保存できます。

**基本設定**

| 項目               | 中身                                                                                              |
| ---------------- | ----------------------------------------------------------------------------------------------- |
| **外部認証を有効にする**   | 既定は無効です。有効にすると、ログイン画面にこの設定の SSO のボタンが出ます                                                        |
| **Entry ID**（必須） | 設定を見分ける ID です（例: `my-sso`）。英小文字で始まり、英小文字・数字・ハイフン・アンダースコアの 2〜64 文字です。**作るときにだけ入れられ、あとから変えられません** |
| **表示名**（必須）      | ログイン画面の SSO のボタンに出る名前です                                                                         |
| **アイコン**         | SSO のボタンに出る画像です。PNG か JPEG で、512KB までです                                                         |
| **説明**           | 用途などのメモです                                                                                       |
| **IdP タイプ**（必須）  | OIDC / OAuth2 か SAML 2.0 です。あとから変えられません                                                         |

**OIDC / OAuth2 の設定**

| 項目                                                              | 中身                                                                                   |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| **Issuer URL**                                                  | 入れて「自動取得」を押すと、ID 基盤の公開する設定（`.well-known/openid-configuration`）から、下の 3 つのエンドポイントを入れます |
| **Client ID**（必須）                                               | ID 基盤が発行したクライアント ID です                                                               |
| **Client Secret**（必須）                                           | ID 基盤が発行したクライアントシークレットです。**保存した後は表示されません。** 変えるときだけ入れます。空のまま保存すると今の値のままです            |
| **Authorization Endpoint・Token Endpoint・Userinfo Endpoint**（必須） | ID 基盤の認可・トークン・利用者の情報の URL です                                                         |
| **Scopes**                                                      | 既定は `openid profile email` です。空白かカンマで区切ります                                           |

**SAML IdP の設定**

| 項目                      | 中身                                                                                     |
| ----------------------- | -------------------------------------------------------------------------------------- |
| **IdP Entity ID**（必須）   | ID 基盤の Entity ID です                                                                    |
| **SSO URL**（必須）         | ID 基盤のシングルサインオンの URL です                                                                |
| **SLO URL**             | ID 基盤のシングルログアウトの URL です                                                                |
| **Signing Certificate** | ID 基盤の署名の X.509 証明書（PEM）です                                                             |
| **Metadata URL**        | ID 基盤のメタデータの URL です。**入れても、Entity ID・SSO URL・証明書は自動では入りません。** メタデータに書かれた値を、それぞれの欄に入れます |

**IdP 側設定情報**（この画面が出す値。コピーして ID 基盤に登録します）

| IdP タイプ       | 出る値                                                                       |
| ------------- | ------------------------------------------------------------------------- |
| OIDC / OAuth2 | Redirect URI                                                              |
| SAML 2.0      | ACS URL、SP メタデータ URL（ID 基盤がメタデータの読み込みに対応していれば、これを指定すると設定が取り込まれます）、SLO URL |

**ユーザー連携設定**

| 項目           | 中身                                                                                   |
| ------------ | ------------------------------------------------------------------------------------ |
| **紐付けキー**    | メールアドレス（既定）かサブジェクト (sub) です（[紐付けキー](#%E7%B4%90%E4%BB%98%E3%81%91%E3%82%AD%E3%83%BC)） |
| **ユーザー自動作成** | 既定は有効です。まだ登録されていない利用者を、このサービスに自動で作ります                                                |
| **自動承認**     | 承認しない／指定したドメインだけ／全員です（[自動承認](#%E8%87%AA%E5%8B%95%E6%89%BF%E8%AA%8D)）                 |

### ログイン画面での見え方

**有効な外部認証設定が 1 つ以上あると、ログイン画面のメールアドレスの欄の下に、設定ごとの SSO のボタン（表示名とアイコン）が並びます。** 利用者は、メールアドレスとパスワードで入るか、SSO のボタンで入るかを選べます。有効な設定が無いときは、ボタンは出ません。

すべての設定が無効になっていると、外部認証設定の一覧に「有効な外部認証設定がありません」と出ます。

### 紐付けキー

ID 基盤の利用者と、このサービスの利用者を何で結ぶかです。**メールアドレス** か **サブジェクト（sub）** を選びます。既定はメールアドレスです。

### 組織と職種の取り込み

**「IdP クレームの対応付け」で、ID 基盤から受け取るクレームの名前を、このサービスの「組織」「職種」に結びます**（例: クレーム `soshiki` → 組織）。空のままなら、Microsoft Entra ID の標準の属性（Department など）から探します。

**クレームの値をそのまま使えないときは、「IdP クレーム値の変換ルール」を置きます。** 1 つのルールは、次の 4 つで決めます。

| 項目               | 中身                                                                     |
| ---------------- | ---------------------------------------------------------------------- |
| **IdP 側の claim** | ID 基盤から送られてくるクレームの名前（例: `department`）。あとから変えられません。変えるときは、ルールを消して作り直します |
| **IdP 側の値**      | このルールを当てる値。完全に一致したときだけ当たります（例: 「営業部 第一課」）                              |
| **変換先の属性**       | 値を入れる属性の名前（例: `organization`（組織）・`job`（職種））                            |
| **変換後の値**        | 利用者に入れる値（例: 組織のコード）                                                    |

ルールごとに、有効・無効を切り替えられます。

### 自動承認

ID 基盤で初めてログインして作られる利用者を、承認待ちにするか、自動で承認するかです。

| 選択肢                | 動き                                                                |
| ------------------ | ----------------------------------------------------------------- |
| **承認しない（管理者が承認）**  | 「承認待ち」になり、管理者が「利用者と組織」＞「ユーザー」で承認するまでログインできません                     |
| **指定したドメインだけ自動承認** | メールアドレスの @ より後ろが完全に一致した利用者だけを自動で承認します。サブドメインは別に足します。それ以外は「承認待ち」です |
| **全員を自動承認**        | この ID 基盤から来た利用者を、ドメインに関係なくすべて自動で承認します                             |

**ID 基盤を社外の人も使うなら、「全員を自動承認」は選ばないでください。** 「指定したドメインだけ自動承認」で、自社のドメインに絞ります。

### SSO で初めて入るとき

**同じメールアドレスのアカウント（SSO でないもの）が既にあると、本人の確認を求めます。** 「本人確認」の画面で、そのアカウントのパスワードを入れると、2 つがつながります。

次のときは、つながらずに断られます。

- 同じメールアドレスのアカウントがあり、本人の確認ができないとき（乗っ取りを防ぐため）
- 契約のアカウントの上限に達していて、新しいアカウントを作れないとき

どちらも、利用者にはシステム管理者に問い合わせるよう表示されます。

## SSO だけで入らせる

**「外部認証設定」の「SSO専用ログイン」を有効にすると、SSO にリンクされた利用者は、ID とパスワードでのログイン・パスワードの再設定・パスキーが使えなくなります。** パスワードで入ろうとすると「このアカウントはSSO専用です」と出ます。

**SSO にリンクされていない利用者には効きません。** その人は、これまでどおりパスワードで入ります。

**プロジェクトの外部 API には、SSO でログインした利用者でなければ使えない操作があります**（`403` `sso_required`）。

## 「ログイン」の画面で決めること

**「ログインと接続元」＞「ログイン」の「ログインの方法」「ログインの持続時間」で決めます。** テナントのすべての利用者に効きます。

| 項目                       | 選択肢                                                                |
| ------------------------ | ------------------------------------------------------------------ |
| **自己登録**                 | 有効なら、利用者がログイン画面から自分でアカウントを作れます。無効にしても、SSO で初めてログインする利用者の登録は止まりません  |
| **パスワードの再設定**            | 有効なら、ログイン画面の「パスワードを忘れた方はこちら」から再設定できます。無効にすると、その前に送った確認コードも使えなくなります |
| **操作が無い時にログインが切れるまでの時間** | 15 分〜24 時間                                                         |
| **ログインを続けられる最長の時間**      | 1 日〜30 日                                                           |

- 自己登録とパスワードの再設定には「既定（今の動き）」も選べます。今は、どちらも有効と同じに動きます
- 操作が無い時の時間は、最長の時間以下にします
- 今の値が変えられる範囲の外のときは、その旨が出ます。変えなければ今の値のまま動きます。変えるときは範囲の中の値にします
- 会話の共有リンクは「接続先と使える範囲」＞「機能の許可」で、アーカイブは「記録の保持と送り先」＞「会話の書き出しと保全」＞「会話の保持と保全」のタブで決めます（[ログと監査](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/admin/guide/audit-log-guide.md#%E4%BC%9A%E8%A9%B1%E3%81%AE%E4%BF%9D%E7%AE%A1%E3%81%A8%E5%85%B1%E6%9C%89)）

**ログインの持続時間は、管理コンソール自身のログインにも効きます。** 短くしすぎると、管理の作業の途中で切れます。

メールアドレスでのログインを止めたいときは、自己登録ではなく「SSO専用ログイン」を使ってください。

## 続けて間違えたとき

**パスワードを続けて間違えると、そのアカウントは一時的にロックされます。** 時間がたつと、また入れるようになります。

**待たずに戻すときは、「利用者と組織」＞「ユーザー」で、その利用者の「ロックを解除」を押します。** すぐにログインできるようになります。解除したことは監査ログに残ります。

## 利用者を止める・戻す

**「利用者と組織」＞「ユーザー」で、利用者ごとに次の操作ができます。** どれも、押すと確認が出ます。

| 操作                      | 何が起きるか                                                                                                            | 戻せるか                                                         |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| **承認**                  | 承認待ちの利用者が、ログインできるようになります                                                                                          | —                                                            |
| **利用を停止**               | 停止している間は、ログインできません。会話やファイルなどのデータは残ります。止めると、実行中の会話と個人の定期実行が止まり、その人が持ち主のプロジェクトの巡回と開いている実行も止まり、その人の外部サービスへの接続が削除されます | 「利用を再開」で、ログインできるようになります。止まった会話・定期実行・巡回・実行と、削除した接続は、自動では戻りません |
| **承認を取り消す**             | ログインできなくなり、契約のアカウント数から外れます。データは残ります。「利用を停止」と同じく、実行中の会話などが止まり、接続が削除されます                                            | 再承認で、ログインできるようになります。止まった物と削除した接続は、自動では戻りません                  |
| **ユーザーを削除**             | **会話・ファイル・スケジュールなどが、画面と API から消えます**                                                                              | 戻せません                                                        |
| **ロックを解除**              | パスワードを続けて間違えたことによるロックが解け、すぐにログインできます                                                                              | —                                                            |
| **パスワードのリセット**          | 一時パスワードを作り、利用者にメールで送ります。メールを送れなかったときは、画面に一時パスワードが出るので、利用者に伝えます                                                    | —                                                            |
| **システム管理者の権限を付ける・解除する** | 付けると、その人は管理コンソールに入り、全体の設定と管理ができます                                                                                 | 解除できます                                                       |

**一時的に止めるだけなら、「利用を停止」を使ってください。** 画面と API から消えて戻せないのは「ユーザーを削除」だけです。停止・取り消し・削除の違い（アカウント数に数えるか・データ・戻し方）は上の表のとおりです。退職や異動で、データを残してから考えたいときも「利用を停止」です。

- 削除したユーザーの、アーカイブした会話・会話ごとの作業のメモ・利用者ごとの設定の記録の削除を希望する場合は、ソフトバンクにお問い合わせください。
- 保全（legal hold）を付けた会話とプロジェクトは、利用者を削除しても消えません（[ログと監査](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/admin/guide/audit-log-guide.md#%E4%BF%9D%E5%85%A8legal-hold)）
- 持ち主がいなくなったプロジェクトと Agent は、「利用者と組織」＞「持ち主の引き継ぎ」で、ほかの利用者に移譲できます。移譲したプロジェクトは一時停止になり、新しい持ち主が点検してから再開します
- これらの操作は、監査ログに残ります

### 違反による利用制限

**「利用者と組織」＞「違反による利用制限」に、利用を制限している利用者と IP アドレスの一覧が出ます。** 制限が終わる日時が出ており、待たずに「制限を解除」で解けます。

IP アドレスによる制限は、同じ IP アドレスを使う複数の利用者にかかることがあります。
