> 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/users-and-roles.md).

# ユーザーとロール

イマーシブトレーニングプラットフォームでは、ユーザーごとに「ロール」（権限）を割り当てて、できる操作と見られるデータの範囲を決めます。このページでは、ロールの種類と、ユーザーの招待・有効化・無効化・ロールの変更の手順を説明します。

## ロールの種類

ロールは次の5種類です。

| ロール                       | できること                                                     |
| ------------------------- | --------------------------------------------------------- |
| Organization Admin（組織管理者） | 組織全体を管理します。すべてのユーザー、チーム、設定、ブランディング、APIキー、トレーニングの内容を管理できます |
| Team Admin（チーム管理者）        | 担当するチームと、そのメンバーを管理します                                     |
| Author（シナリオ作成者）           | トレーニングシナリオと評価基準を作成・編集します                                  |
| Manager（マネージャー）           | 担当するチームのメンバーについて、アナリティクスと受講履歴を確認します                       |
| User（受講者）                 | トレーニングを受講し、自分の結果を確認します                                    |

1人のユーザーに複数のロールを割り当てられます。たとえば Author と Manager を持つユーザーは、シナリオを作成しながら、チームの受講状況を追うことができます。

### ロールごとに見られるデータ

受講履歴とアナリティクスで見られる範囲は、ロールによって次のように変わります。

| ロール                | 受講履歴                     | アナリティクス              |
| ------------------ | ------------------------ | -------------------- |
| User               | 自分のセッションのみ               | 自分のデータのみ             |
| Manager            | 自分のセッションと、担当するメンバーのセッション | 自分のデータと、担当するメンバーのデータ |
| Team Admin         | 担当するチーム内のすべてのセッション       | 担当するチーム内のすべてのユーザー    |
| Organization Admin | 組織内のすべてのセッション            | 組織全体のアナリティクス         |

詳しくは[受講履歴と結果の見方](https://docs.digitalhumans.jp/itp-guide/take-training/history.md)と[アナリティクス](https://docs.digitalhumans.jp/itp-guide/analytics.md)をご覧ください。

{% hint style="info" %}
組織のロールとは別に、チームの中にも「チームマネージャー」と「通常のメンバー」という役割があります。チームの中の役割は[チームとシナリオの割り当て](https://docs.digitalhumans.jp/itp-guide/initial-setup/teams.md)で説明しています。
{% endhint %}

## ユーザーを招待する

1. 組織設定の「メンバー」タブを開きます。
2. 「招待」をクリックします。
3. ユーザーのメールアドレスを入力します。
4. 割り当てるロールを1つ以上選びます。
5. 「招待を送信」をクリックします。

複数のユーザーをまとめて招待するときは、メールアドレスの一覧を用意し、割り当てるロールと一緒にまとめて送信します。

{% hint style="success" %}
受講者の表示名は、氏名でなくても構いません。社員番号や仮名で登録できます。
{% endhint %}

### 招待の状態

| 状態     | 意味                   |
| ------ | -------------------- |
| 「招待済み」 | 招待を送信し、受諾を待っている状態    |
| 「有効」   | ユーザーが招待を受諾し、ログインした状態 |
| 「無効」   | ユーザーのアクセスを停止した状態     |

API では、状態は `active`、`inactive`、`invited`（招待を受諾していない）、`expired`（招待の有効期限が切れた）の4つで返ります。詳しくは [API の「ユーザー」](https://docs.digitalhumans.jp/itp-guide/api/users.md)をご覧ください。

## ユーザーを有効化・無効化する

1. 対象ユーザーのプロフィールを開きます。
2. 状態を「有効」と「無効」の間で切り替えます。

無効（Inactive）にしたユーザーはログインできなくなります。そのユーザーのデータは削除されず、残ります。

## ロールを割り当てる

1. 対象ユーザーのプロフィールを開きます。
2. 「ロールを割り当て」をクリックします。
3. 割り当てるロールを選びます。
4. 変更を保存します。

## シングルサインオン（SSO）を使う場合

SSO を有効にしている組織では、初めて SSO でサインインしたユーザーは自動で登録され、既定の User ロールが割り当てられます。ほかのロールが必要なユーザーは、登録後に管理者がロールを変更してください。詳しくは[シングルサインオン（SSO）](https://docs.digitalhumans.jp/itp-guide/initial-setup/sso.md)をご覧ください。

## API でユーザーを管理する

ユーザーの追加、ロールの割り当て、状態の変更は API からも行えます。人事システムなどと連携してまとめて登録したい場合にお使いください。

{% hint style="warning" %}
API でロールを指定すると、ユーザーのロールは指定した内容で**丸ごと置き換わります**（追加ではありません）。\
たとえば User のユーザーに Manager を追加するときは、`["USER", "MANAGER"]` のように、残したいロールもすべて指定してください。`["MANAGER"]` だけを指定すると、User ロールは外れます。
{% endhint %}

手順は [API の「ユーザー」](https://docs.digitalhumans.jp/itp-guide/api/users.md)を、APIキーの発行は[APIキーの管理](https://docs.digitalhumans.jp/itp-guide/initial-setup/api-keys.md)をご覧ください。
