> ## 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.

# ディレクトリの概要

> 組織のユーザーの信頼できる記録: ユーザー、ユーザーを記述するプロファイル属性、およびユーザーを整理するグループ。

**ディレクトリ**は、組織のユーザーを管理する場所です。**ユーザー**、各ユーザーを記述する**プロファイル属性**、ユーザーを整理する**グループ**を保持します。Iru Identity の他のすべての機能はディレクトリを基盤としています。アプリケーションはそのユーザーとグループにアクセスを付与し、認証ポリシーはそれらのユーザーのサインイン方法を決定します。

ダッシュボードでは、ディレクトリに次のセクションがまとめられています。

<CardGroup cols={2}>
  <Card title="ユーザー" icon="user" href="/ja/identity/directory/users">
    組織内の各ユーザー。プロファイル、ステータス、追加方法の記録を持ちます。
  </Card>

  <Card title="スキーマ" icon="table-list" href="/ja/identity/directory/schema">
    すべてのユーザープロファイルが保持できる組み込みフィールドとカスタムフィールドのスキーマ。
  </Card>

  <Card title="グループ" icon="users" href="/ja/identity/directory/groups">
    1 つの単位としてアクセスを割り当てるユーザーのコレクション (手動、組み込み、または自動)。
  </Card>

  <Card title="自動グループ" icon="wand-magic-sparkles" href="/ja/identity/directory/auto-groups">
    属性からメンバーシップが計算され、自動的に最新の状態に保たれるグループ。
  </Card>

  <Card title="ユーザーのインポート" icon="file-arrow-up" href="/ja/identity/directory/importing-users">
    ファイルからユーザーを一括で取り込み、結果を確認します。
  </Card>

  <Card title="ディレクトリ同期" icon="building-user" href="/ja/identity/directory/directory-sync">
    HRIS またはディレクトリソリューションからユーザーを同期し、ディレクトリを自動的に最新の状態に保ちます。
  </Card>

  <Card title="ロール" icon="user-shield" href="/ja/identity/administration/administrators-and-roles">
    各ユーザーが持つロール。Iru でできることを決定します。
  </Card>
</CardGroup>

## ディレクトリに含まれるもの

```mermaid theme={null}
flowchart TD
  subgraph dir["ディレクトリ"]
    users["ユーザー<br/>組織内のすべてのユーザー"]
    attrs["プロファイル属性<br/>組み込みフィールドとカスタムフィールド"]
    groups["グループ<br/>手動、組み込み、自動"]
  end
  attrs --- users
  users --- groups
  attrs -. "駆動可能" .-> groups
  groups -->|"割り当て先"| apps["アプリケーション"]
```

* **ユーザー**は、ディレクトリに表される組織内のすべての人です。それぞれがプロファイル、サインイン ID、およびライフサイクル内の位置を反映するステータスを持ちます。
* **プロファイル属性**は、プロファイルが保持できるフィールドです。名前、メールアドレス、電話番号などの組み込みファセットに加え、[スキーマ](/ja/identity/directory/schema)で定義したカスタム属性が含まれます。
* **グループ**はユーザーのコレクションです。グループにアクセスを一度割り当てると、そのグループのすべてのユーザーがそのアクセスを継承します。[グループ](/ja/identity/directory/groups)を参照してください。

## ユーザーをディレクトリに追加する方法

ユーザーを追加するには 3 つの方法があり、ニーズの変化に応じて組み合わせることができます。

<CardGroup cols={3}>
  <Card title="手動で追加" icon="user-plus">
    **Directory → Users** からユーザーを手動で作成します。少数のユーザーや簡単なテストに最適です。
  </Card>

  <Card title="ファイルからインポート" icon="file-csv">
    CSV をアップロードして多数のユーザーを一度に作成します。[ユーザーのインポート](/ja/identity/directory/importing-users)を参照してください。
  </Card>

  <Card title="HR システムから同期" icon="building-user">
    HR システムを接続して、スケジュールに従ってユーザーを自動的に作成、更新、削除します。[Directory Sync](/ja/identity/directory/directory-sync) を参照してください。
  </Card>
</CardGroup>

すべてのユーザーは、手動での追加、ファイルからのインポート、接続された HR システムからの同期など、作成元を示す**ソース**を記録します。ソースはユーザーリストに表示されるため、ユーザーがどのようにディレクトリに追加されたかをいつでも確認できます。

<Tip>
  手動入力と CSV インポートは、使い始めに最適です。HR システムが社員の記録システムである場合は、それを接続して、ユーザーの入社、ロール変更、退職に応じてディレクトリが自動的に最新の状態に保たれるようにします。
</Tip>

## ユーザーライフサイクル

ユーザーは組織に入社、異動、退職し、ディレクトリの記録は少数のステータスを通じてそれに追従します。

```mermaid theme={null}
flowchart LR
  join["入社"] --> pending["Pending"]
  pending -->|"初回サインイン / アクティベーション"| active["Active"]
  active -->|"休職 / オフボーディング"| suspended["Suspended"]
  suspended -->|"復帰"| active
  active -->|"完全に退職"| removed["Removed"]
  suspended -->|"完全に退職"| removed
```

| ステータス | 意味 |
| - | - |
| **保留中** | ユーザーは作成されましたが、まだアクティブではありません。新しく追加またはインポートされたユーザーの開始点です。 |
| **有効** | ユーザーは完全に有効化されており、サインインして割り当てられたアプリにアクセスできます。 |
| **Suspended** | ユーザーのアクセスはブロックされていますが、記録と履歴は保持されます。休職中またはオフボーディング中のユーザーに使用します。 |

一時停止は元に戻すことができます。一時停止されたユーザーを復元すると、以前のステータスに戻ります。ユーザーの削除は永続的であり、完全に退職したユーザー向けです。一時停止と削除の違い、およびユーザーを招待してアカウントの設定を完了させる方法については、[ユーザー](/ja/identity/directory/users)で説明しています。

## ディレクトリが使用される場所

ディレクトリは、Iru Identity の他の部分の基盤です。

* **アプリケーション**は、割り当てられたグループを通じてアクセスを付与し、プロファイル属性を各アプリが受け取る ID 情報にマッピングします。[アクセスの割り当て](/ja/identity/applications/assigning-access)を参照してください。
* **認証ポリシー**は、サインインするユーザーを評価し、そのユーザーが証明する必要がある内容を決定します。[認証ポリシー](/ja/identity/authentication/authentication-policies)を参照してください。
* **Auto Groups** は、プロファイル属性を読み取ってメンバーシップを自動的に計算します。[Auto Groups](/ja/identity/directory/auto-groups) を参照してください。

<Note>
  Iru Identity を初めて使用する場合は、まず[主要な概念](/ja/identity/getting-started/key-concepts)でオブジェクトの全体像を確認し、[クイックスタート](/ja/identity/getting-started/quickstart)に従って最初のサインオンを設定してください。
</Note>