ログインと外部認証(SSO)
利用者と管理者が、どの方法で入るかを決めるための選択肢と基準を扱います。SSO を使わないテナントにも効く、ログインの持続時間やロックの動きもここにあります。
ログインの方法は 3 つ
| 方法 | 入り方 | 決める場所 |
|---|---|---|
| パスワード | メールアドレスとパスワード | 「ログイン」の画面(自己登録・パスワードの再設定) |
| パスキー | 端末の生体認証や PIN。パスワードを入れずに入れる | 利用者が自分で登録する。チャットの「設定」>「パスキー」で、自分のパスキーの一覧(登録した時刻・最後に使用した時刻)を見て、使わないものを削除できる(管理者・監査役は、パスキーでログインしているときだけ削除できる) |
| SSO | お客様の ID 基盤(IdP)で認証する | 外部認証設定 |
SSO で入るときの認証は、お客様の ID 基盤が行います。 多要素認証や条件付きアクセスは、ID 基盤の側で決めてください。
管理コンソールのログイン
管理コンソールにパスワードで入るときは、毎回、メールの認証コードを求めます。 チャットと違い、端末や接続元にかかわらず求めます。パスキーか SSO で入るときは、認証コードは求めません。パスキーを登録している管理者は、メールアドレスを入れて「続ける」を押すと、パスキーで入れます。
管理コンソールのログインの持続時間も、「ログイン」の画面の設定に従います(「ログイン」の画面で決めること)。
SSO をつなぐ
「ログインと接続元」>「外部認証設定」で、ID 基盤ごとに設定を作ります。 この画面とお客様の ID 基盤の画面を、次の順で行き来します。
- 表示名と IdP タイプを決める — IdP タイプは OIDC / OAuth2 か SAML 2.0 です。IdP タイプは、あとから変えられません
- ID 基盤に URL を登録する — IdP タイプを選ぶと、ID 基盤に登録する URL が、画面の「IdP側設定情報」に出ます(OIDC は Redirect URI、SAML は ACS URL・SP メタデータ URL など)。外部認証設定を保存する前でも出るので、先にコピーして ID 基盤に登録できます
- ID 基盤の情報を入れる — OIDC は ID 基盤が発行した Client ID・Client Secret と各エンドポイント(Issuer URL から自動で取り込めます)、SAML は IdP Entity ID・SSO URL・署名証明書などです
- 属性と利用者の対応を決める — 紐付けキー、組織と職種の取り込み、自動承認
設定の項目
画面の節ごとの項目です。「必須」と書いていない項目は、空のままでも保存できます。
基本設定
| 項目 | 中身 |
|---|---|
| 外部認証を有効にする | 既定は無効です。有効にすると、ログイン画面にこの設定の 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) です(紐付けキー) |
| ユーザー自動作成 | 既定は有効です。まだ登録されていない利用者を、このサービスに自動で作ります |
| 自動承認 | 承認しない/指定したドメインだけ/全員です(自動承認) |
ログイン画面での見え方
有効な外部認証設定が 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 日 |
- 自己登録とパスワードの再設定には「既定(今の動き)」も選べます。今は、どちらも有効と同じに動きます
- 操作が無い時の時間は、最長の時間以下にします
- 今の値が変えられる範囲の外のときは、その旨が出ます。変えなければ今の値のまま動きます。変えるときは範囲の中の値にします
- 会話の共有リンクは「接続先と使える範囲」>「機能の許可」で、アーカイブは「記録の保持と送り先」>「会話の書き出しと保全」>「会話の保持と保全」のタブで決めます(ログと監査)
ログインの持続時間は、管理コンソール自身のログインにも効きます。 短くしすぎると、管理の作業の途中で切れます。
メールアドレスでのログインを止めたいときは、自己登録ではなく「SSO専用ログイン」を使ってください。
続けて間違えたとき
パスワードを続けて間違えると、そのアカウントは一時的にロックされます。 時間がたつと、また入れるようになります。
待たずに戻すときは、「利用者と組織」>「ユーザー」で、その利用者の「ロックを解除」を押します。 すぐにログインできるようになります。解除したことは監査ログに残ります。
利用者を止める・戻す
「利用者と組織」>「ユーザー」で、利用者ごとに次の操作ができます。 どれも、押すと確認が出ます。
| 操作 | 何が起きるか | 戻せるか |
|---|---|---|
| 承認 | 承認待ちの利用者が、ログインできるようになります | — |
| 利用を停止 | 停止している間は、ログインできません。会話やファイルなどのデータは残ります。止めると、実行中の会話と個人の定期実行が止まり、その人が持ち主のプロジェクトの巡回と開いている実行も止まり、その人の外部サービスへの接続が削除されます | 「利用を再開」で、ログインできるようになります。止まった会話・定期実行・巡回・実行と、削除した接続は、自動では戻りません |
| 承認を取り消す | ログインできなくなり、契約のアカウント数から外れます。データは残ります。「利用を停止」と同じく、実行中の会話などが止まり、接続が削除されます | 再承認で、ログインできるようになります。止まった物と削除した接続は、自動では戻りません |
| ユーザーを削除 | 会話・ファイル・スケジュールなどが、画面と API から消えます | 戻せません |
| ロックを解除 | パスワードを続けて間違えたことによるロックが解け、すぐにログインできます | — |
| パスワードのリセット | 一時パスワードを作り、利用者にメールで送ります。メールを送れなかったときは、画面に一時パスワードが出るので、利用者に伝えます | — |
| システム管理者の権限を付ける・解除する | 付けると、その人は管理コンソールに入り、全体の設定と管理ができます | 解除できます |
一時的に止めるだけなら、「利用を停止」を使ってください。 画面と API から消えて戻せないのは「ユーザーを削除」だけです。停止・取り消し・削除の違い(アカウント数に数えるか・データ・戻し方)は上の表のとおりです。退職や異動で、データを残してから考えたいときも「利用を停止」です。
- 削除したユーザーの、アーカイブした会話・会話ごとの作業のメモ・利用者ごとの設定の記録の削除を希望する場合は、ソフトバンクにお問い合わせください。
- 保全(legal hold)を付けた会話とプロジェクトは、利用者を削除しても消えません(ログと監査)
- 持ち主がいなくなったプロジェクトと Agent は、「利用者と組織」>「持ち主の引き継ぎ」で、ほかの利用者に移譲できます。移譲したプロジェクトは一時停止になり、新しい持ち主が点検してから再開します
- これらの操作は、監査ログに残ります
違反による利用制限
「利用者と組織」>「違反による利用制限」に、利用を制限している利用者と IP アドレスの一覧が出ます。 制限が終わる日時が出ており、待たずに「制限を解除」で解けます。
IP アドレスによる制限は、同じ IP アドレスを使う複数の利用者にかかることがあります。