> For the complete documentation index, see [llms.txt](https://docs.digitalhumans.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalhumans.jp/itp-guide/initial-setup/sso.md).

# シングルサインオン（SSO）

シングルサインオン（SSO）を設定すると、受講者や管理者は、社内で使っている ID とパスワードでイマーシブトレーニングプラットフォームにサインインできます。SSO は組織ごとに設定します。

{% hint style="info" %}
SSO の設定・変更は、弊社を通じて行います。ご希望の場合は[弊社](https://www.digitalhumans.com/jp/contact)にご連絡ください。\
本製品のサインインには、認証基盤として Auth0 が使われています。SSO の接続も、この認証基盤上に設定されます。
{% endhint %}

## 対応する方式

| 方式                             | 内容                                   |
| ------------------------------ | ------------------------------------ |
| SAML 2.0                       | SAML 2.0 に準拠した ID プロバイダー（IdP）と接続できます |
| Microsoft Entra ID（旧 Azure AD） | Microsoft Entra ID と直接接続できます         |
| Google Workspace               | Google Workspace のアカウントで認証できます       |
| Microsoft アカウント                | Microsoft アカウントで認証できます               |

HENNGE One や Okta など、SAML 2.0 に対応した IdP をお使いの場合は、SAML 2.0 の方式での接続をご検討ください。お使いの IdP で接続できるかどうかは、弊社にご相談ください。

## SSO を設定しない場合のサインイン方法

SSO を設定していない組織では、次の方法でサインインします。

* メールアドレスとパスワード
* Google アカウント（Google OAuth）
* Microsoft アカウント（Microsoft OAuth）

## 設定に必要な情報

SSO の設定には、お客様の IdP の次の情報が必要です。

1. IdP のメタデータ（SAML メタデータの URL または XML ファイル）
2. エンティティ ID（IdP の識別子）
3. SSO URL（IdP のシングルサインオンのエンドポイント）
4. 証明書（IdP の X.509 署名証明書）

## 設定の流れ

### SAML 2.0

1. 弊社に SSO の設定をご依頼ください。
2. SAML の IdP メタデータ（URL または XML ファイル）をご提供ください。
3. 本製品側で SAML の接続を設定します。
4. 弊社からお伝えするサービスプロバイダー（SP）の情報を、お客様の IdP に設定してください。
   * ACS URL（Assertion Consumer Service）
   * エンティティ ID
   * サインイン URL
5. SSO でのサインインをテストします。
6. 組織の SSO を有効にします。

### Microsoft Entra ID（旧 Azure AD）

1. お客様の Microsoft Entra ID のテナントに、アプリケーションを登録してください。
2. 弊社からお伝えするリダイレクト URI を設定してください。
3. アプリケーション（クライアント）ID と、ディレクトリ（テナント）ID を弊社にご提供ください。
4. 本製品側で Microsoft Entra ID との接続を設定します。
5. テストを行い、有効にします。

### Google Workspace

1. Google Workspace を ID プロバイダーとして設定してください。
2. Google 管理コンソールで必要な設定情報を弊社にご提供ください。必要な情報は、設定時に弊社からご案内します。
3. 本製品側で接続を設定します。
4. テストを行い、有効にします。

## SSO を有効にしたあとのユーザー登録

SSO を有効にすると、ユーザーの登録は次のように行われます。

* **初回サインイン時に自動で登録**: SSO で初めてサインインしたユーザーは、自動で本製品に登録されます。
* **ユーザー情報の同期**: 氏名とメールアドレスは、IdP から同期されます。
* **ロール**: 新しく登録された SSO ユーザーには、既定の User（受講者）ロールが割り当てられます。ほかのロールが必要な場合は、登録後に管理者が変更してください（[ユーザーとロール](https://docs.digitalhumans.jp/itp-guide/initial-setup/users-and-roles.md)）。
* **招待は不要**: 有効な SSO の認証情報を持つユーザーは、招待を受けなくても直接サインインできます（組織で許可している場合）。

{% hint style="success" %}
SSO と API によるユーザー登録は併用できます。[API の「ユーザー」](https://docs.digitalhumans.jp/itp-guide/api/users.md)を使うと、ユーザーが初めて SSO でサインインする前に、ロールとチームの所属を割り当てておけます。
{% endhint %}

{% hint style="warning" %}
SSO でサインインするユーザーのメールアドレスを API で変更する場合は、IdP が次回のサインイン時に送るメールアドレスと一致させてください。一致しないと、そのユーザーはサインインできなくなります。
{% endhint %}

## 複数のサインイン方法を併用する

1つの組織で、複数のサインイン方法を同時に有効にできます。たとえば次のような使い分けができます。

* 社員は、SAML による SSO でサインインする
* 社外の協力会社の方は、メールアドレスとパスワードでサインインする
* 取引先の方は、Google アカウントでサインインする

ユーザーには、ログイン画面に有効なサインイン方法がすべて表示され、使う方法を選んでサインインします。

## うまくいかないときは

| 症状                        | 確認すること                                       |
| ------------------------- | -------------------------------------------- |
| ログイン画面に SSO のサインインが表示されない | 組織で SSO の接続が有効になっているか確認してください                |
| 別の IdP に転送されてしまう          | ログイン URL に含まれる組織のエイリアス（識別名）が正しいか確認してください     |
| ユーザー情報（氏名・メールアドレス）が同期されない | IdP 側の SAML の属性マッピングを確認してください                |
| サインインの画面が繰り返し表示される（認証ループ） | ACS URL とエンティティ ID が、IdP の設定と一致しているか確認してください |

解決しない場合や、SSO の接続を追加・変更したい場合は、[弊社](https://www.digitalhumans.com/jp/contact)にご連絡ください。サインインに関わるその他の問題は[トラブルシューティング](https://docs.digitalhumans.jp/itp-guide/network-requirements/troubleshooting.md)を、セキュリティの考え方は[セキュリティとデータの取り扱い](https://docs.digitalhumans.jp/itp-guide/network-requirements/security-and-data.md)をご覧ください。
