> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# プロビジョニング

> アクセスの変更に応じて SCIM でアプリのアカウントを自動的に作成、更新、削除します。グループ連携プロビジョニング、手動同期、履歴も含みます。

**プロビジョニング**は、アプリケーション内のアカウントをディレクトリと同期させます。
対応するアプリの場合、Iru は **SCIM** を使用して、アクセスが付与されたときにアカウントを作成および更新し、
アクセスが取り消されたときに削除します。そのため、アプリのアカウントはユーザーが割り当てられている間だけ存在します。

これは Iru からアプリへの**アウトバウンド**プロビジョニングです。（HR システムやファイルからユーザーを
ディレクトリ*に*取り込むのはインバウンドプロビジョニングです。
[Directory Sync](/ja/identity/directory/directory-sync) を参照してください。）

## プロビジョニングと割り当ての関係

プロビジョニングは、アプリの**有効なユーザーとグループ**、つまりグループ割り当てを通じてアクセス権を
持つユーザーに対して動作します。割り当ては*誰が*アクセスできるかを決定し、プロビジョニングはそれを
実際のアカウントに変換します。

```mermaid theme={null}
flowchart LR
  assign["割り当てられたグループ"] -->|"付与"| create["アカウントを作成 / 更新"]
  assign -->|"取り消し"| remove["アカウントを削除"]
  create --> app["アプリ内のアカウント"]
  remove --> app
```

有効なセットの構築方法については、[アクセスの割り当て](/ja/identity/applications/assigning-access)を参照してください。

## プロビジョニングを有効にする

プロビジョニングは、アプリケーションごとにアプリの**ドラフト**で設定します。有効にしたら、
Iru にアプリの SCIM エンドポイントを指定し、送信するイベントを選択します。

<Steps>
  <Step title="プロビジョニングをオンにする">
    アプリケーションの SCIM プロビジョニングを有効にします。
  </Step>

  <Step title="アプリに接続する">
    アプリの SCIM **ベース URL** と、Iru が認証に使用する**ベアラートークン**を指定します。
    どちらもプロビジョニング先のアプリケーションから取得します。
  </Step>

  <Step title="既存のアカウントの照合方法を選択する">
    アプリにすでにアカウントがある場合は、Iru がユーザーを**ユーザー名**と**メールアドレス**の
    どちらで照合するかを選択し、既存のアカウントが重複せずに再利用されるようにします。
  </Step>

  <Step title="送信するイベントを選択する">
    Iru に実行させる操作を有効にします：**ユーザーの作成**、**ユーザーの更新**、**ユーザーの削除**。
    削除については、アプリから**割り当て解除**された場合と**ディレクトリから削除**された場合の
    動作を個別に選択します（以下を参照）。
  </Step>

  <Step title="送信する属性をマッピングする">
    アプリの**マッピング**にはプロビジョニングビューが含まれているため、アカウントを作成または
    更新する際に Iru がアプリに送信するプロファイル属性を制御できます。
  </Step>

  <Step title="公開して有効化する">
    ドラフトを現在のバージョンとして設定し、アプリをアクティブに保ちます。プロビジョニングは
    アプリがアクティブな間に実行され、無効化されると一時停止します。
  </Step>
</Steps>

<Note>
  プロビジョニングは、割り当てられたユーザーのアカウントのみを送信します。まだ誰も割り当てられていない
  場合は、先にアクセスを付与してください。[アクセスの割り当て](/ja/identity/applications/assigning-access)を
  参照してください。
</Note>

## アクセスが削除された場合の動作

削除には 2 つのトリガーがあり、それぞれについて Iru がアプリのアカウントに対して行う操作を
**個別に**選択します。

* **アプリからの割り当て解除：** ユーザーはディレクトリに残りますが、アプリに割り当てられた
  グループには含まれなくなります。
* **ディレクトリからの削除：** ユーザーのディレクトリレコードが完全に削除されます。

各トリガーについて、3 つのアクションのいずれかを選択します。

| アクション | Iru がアプリのアカウントに対して行う操作 |
| - | - |
| **削除** | アプリにアカウントの削除を要求します。 |
| **Deactivate** | アプリでアカウントを非アクティブとしてマークし（`active` フラグを `false` に設定）、後で復元できるようにそのまま残します。 |
| **Do nothing** | アプリのアカウントをそのままの状態で残します。 |

<Note>
  一般的な設定は、割り当て解除時に **Deactivate**（アクセスをすばやく復元できるように）、
  ディレクトリから削除時に **削除** です。アカウントを手動でクリーンアップしたいアプリには
  **Do nothing** を使用してください。
</Note>

<Warning>
  アカウントを無効化または削除したときに、アプリ内のそのユーザーの**アクティブなセッション**も
  終了するかどうかは、Iru が送信するシグナルをアプリがどのように処理するかによって異なります。
  [資格情報とセッション](/ja/identity/security/credentials-and-sessions)を参照してください。
</Warning>

## グループ連携プロビジョニング

アカウントに加えて、Iru は SCIM グループをサポートするアプリに**グループをプッシュ**でき、
グループ構造をアプリに反映させることができます。プッシュするグループを選択します。

* **アプリケーションロールグループ：** アプリのロールに関連付けられたグループ、または
* **選択したグループ：** 選択した特定のグループのセット。

アプリにすでに独自のグループがある場合、アプリケーションの**ダウンストリームグループ**ビューで、
重複を作成する代わりに Iru グループをアプリ内の既存のグループに**リンク**（**採用**と呼びます）できます。
各リンクには同期ステータスが表示されるため、どのグループが同期しているかを確認できます。

## 手動で同期を実行する

Iru はアクセスの変更に応じて自動的に同期しますが、変更をすぐに反映する必要がある場合
（設定の問題を修正した後など）は、同期を強制できます。

<CardGroup cols={2}>
  <Card title="ユーザー同期を強制する" icon="user-gear">
    アプリの**有効なユーザー**から特定のユーザーの同期をトリガーし、そのアカウントの状態を
    アプリに再送信します。
  </Card>

  <Card title="グループ同期を強制する" icon="users-gear">
    アプリの**有効なグループ**から特定のグループの同期をトリガーし、そのメンバーシップを
    アプリに再送信します。
  </Card>
</CardGroup>

## プロビジョニング履歴を確認する

アプリケーションの**プロビジョニング履歴**には、各同期の実行とその結果が表示されるため、
Iru が送信した内容を確認し、失敗したものをトラブルシューティングできます。各実行では、
**成功**、**保留中**または**待機中**、**失敗**したレコードの数が、アプリケーション、ユーザー、
グループ別に要約されます。最近の実行は、進行中の間は自動的に更新されます。

処理が完了しなかった場合、**処理エラー**ビューに、影響を受けたユーザーまたはグループ、
試行された操作、アプリから返されたエラーが一覧表示されます。これは原因を修正して再同期するために
必要な詳細です。

<Warning>
  アプリケーションを無効化すると以降のプロビジョニングは停止しますが、ユーザーのアプリ内の
  アカウントの状態は現在のまま維持されます。アカウントを完全に削除するには、まず割り当てを削除し
  （取り消しによって削除がプロビジョニングされるように）、その後無効化してください。
</Warning>

## 次のステップ

<CardGroup cols={2}>
  <Card title="アクセスの割り当て" icon="user-check" href="/ja/identity/applications/assigning-access">
    割り当てとグループメンバーシップを管理して、プロビジョニングされるユーザーを制御します。
  </Card>

  <Card title="グループ" icon="users" href="/ja/identity/directory/groups">
    アプリにプッシュし、アプリのグループにリンクするグループを作成します。
  </Card>

  <Card title="ディレクトリ同期" icon="building-user" href="/ja/identity/directory/directory-sync">
    HR システムからディレクトリにユーザーを取り込みます（インバウンド側）。
  </Card>

  <Card title="アプリケーションの概要" icon="grip" href="/ja/identity/applications/applications-overview">
    アプリ、プロトコル、バージョンモデルを確認します。
  </Card>
</CardGroup>
