> ## 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의 다른 모든
것은 디렉터리를 기반으로 합니다. 애플리케이션은 디렉터리의 사용자와 그룹에 액세스를
부여하고, 인증 정책은 해당 사용자가 로그인하는 방식을 결정합니다.

대시보드에서 Directory는 다음 섹션을 함께 제공합니다.

<CardGroup cols={2}>
  <Card title="사용자" icon="user" href="/ko/identity/directory/users">
    조직의 각 사용자로, 프로필, 상태 및 추가된 방식에 대한 기록을 포함합니다.
  </Card>

  <Card title="스키마" icon="table-list" href="/ko/identity/directory/schema">
    모든 사용자 프로필이 보유할 수 있는 기본 제공 필드 및 사용자 지정 필드의 스키마입니다.
  </Card>

  <Card title="그룹" icon="users" href="/ko/identity/directory/groups">
    하나의 단위로 액세스를 할당하는 사용자 모음(수동, 기본 제공 또는 자동)입니다.
  </Card>

  <Card title="자동 그룹" icon="wand-magic-sparkles" href="/ko/identity/directory/auto-groups">
    속성에서 멤버십이 계산되고 자동으로 최신 상태로 유지되는 그룹입니다.
  </Card>

  <Card title="사용자 가져오기" icon="file-arrow-up" href="/ko/identity/directory/importing-users">
    파일에서 사용자를 일괄로 가져오고 결과를 검토합니다.
  </Card>

  <Card title="디렉터리 동기화" icon="building-user" href="/ko/identity/directory/directory-sync">
    HRIS 또는 디렉터리 솔루션에서 사용자를 동기화하여 디렉터리를 자동으로 최신 상태로
    유지합니다.
  </Card>

  <Card title="역할" icon="user-shield" href="/ko/identity/administration/administrators-and-roles">
    각 사용자가 보유한 역할로, Iru에서 수행할 수 있는 작업을 결정합니다.
  </Card>
</CardGroup>

## 디렉터리에 포함된 항목

```mermaid theme={null}
flowchart TD
  subgraph dir["Directory"]
    users["사용자<br/>조직의 모든 구성원"]
    attrs["프로필 속성<br/>기본 제공 및 사용자 지정 필드"]
    groups["그룹<br/>수동, 기본 제공, 자동"]
  end
  attrs --- users
  users --- groups
  attrs -. "구동 가능" .-> groups
  groups -->|"할당 대상"| apps["애플리케이션"]
```

* **사용자**는 디렉터리에 표시되는 조직의 모든 구성원입니다. 각 사용자에게는 프로필,
  로그인 ID, 그리고 수명 주기에서의 위치를 반영하는 상태가 있습니다.
* **프로필 속성**은 프로필이 보유할 수 있는 필드입니다. 이름, 이메일, 전화번호와 같은
  기본 제공 항목과 [스키마](/ko/identity/directory/schema)에서 정의하는 사용자 지정
  속성이 포함됩니다.
* **그룹**은 사용자 모음입니다. 그룹에 액세스를 한 번 할당하면 그룹의 모든 사용자가
  해당 액세스를 상속합니다. [그룹](/ko/identity/directory/groups)을 참조하세요.

## 사용자가 디렉터리에 추가되는 방식

사용자를 추가하는 방법은 세 가지이며, 필요에 따라 혼합하여 사용할 수 있습니다.

<CardGroup cols={3}>
  <Card title="수동 추가" icon="user-plus">
    **Directory → Users**에서 사용자를 직접 생성합니다. 소수의 사용자나 빠른 테스트에
    적합합니다.
  </Card>

  <Card title="파일에서 가져오기" icon="file-csv">
    CSV를 업로드하여 많은 사용자를 한 번에 생성합니다.
    [사용자 가져오기](/ko/identity/directory/importing-users)를 참조하세요.
  </Card>

  <Card title="HR 시스템에서 동기화" icon="building-user">
    HR 시스템을 연결하여 일정에 따라 사용자가 자동으로 생성, 업데이트 및 제거되도록
    합니다. [Directory Sync](/ko/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** | 사용자의 액세스가 차단되지만 기록과 이력은 유지됩니다. 휴직 중이거나 오프보딩 중인 경우에 사용합니다. |

일시 중지는 되돌릴 수 있습니다. 일시 중지된 사용자를 복원하면 이전 상태로 돌아갑니다.
사용자 제거는 영구적이며 완전히 떠난 사용자를 위한 것입니다. 일시 중지와 제거의
차이점, 그리고 사용자가 계정 설정을 완료하도록 초대하는 방법은
[사용자](/ko/identity/directory/users)에서 다룹니다.

## 디렉터리가 사용되는 곳

디렉터리는 Iru Identity의 나머지 부분이 기반으로 하는 토대입니다.

* **애플리케이션**은 할당된 그룹을 통해 액세스를 부여하고, 프로필 속성을 각 앱이
  수신하는 ID 정보에 매핑합니다.
  [액세스 할당](/ko/identity/applications/assigning-access)을 참조하세요.
* **인증 정책**은 로그인하는 사용자를 평가하고 사용자가 증명해야 하는 항목을
  결정합니다. [인증 정책](/ko/identity/authentication/authentication-policies)을
  참조하세요.
* **Auto Groups**는 프로필 속성을 읽어 멤버십을 자동으로 계산합니다.
  [Auto Groups](/ko/identity/directory/auto-groups)를 참조하세요.

<Note>
  Iru Identity를 처음 사용하십니까? 전체 객체 집합은 [주요 개념](/ko/identity/getting-started/key-concepts)에서
  시작한 다음 [빠른 시작](/ko/identity/getting-started/quickstart)을 따라 첫 번째
  로그인을 설정하세요.
</Note>