> ## 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](/ko/identity/directory/directory-sync)를 참조하세요.)

## 프로비저닝과 할당의 관계

프로비저닝은 그룹 할당을 통해 액세스 권한을 가진 사용자인 앱의 **유효 사용자 및
그룹**에 대해 작동합니다. 할당은 *누구*인지를 결정하고, 프로비저닝은 이를 실제
계정으로 전환합니다.

```mermaid theme={null}
flowchart LR
  assign["할당된 그룹"] -->|"부여됨"| create["계정 생성 / 업데이트"]
  assign -->|"취소됨"| remove["계정 제거"]
  create --> app["앱의 계정"]
  remove --> app
```

유효 집합이 구성되는 방식은 [액세스 할당](/ko/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="게시 및 활성화">
    초안을 current로 설정하고 앱을 활성 상태로 유지합니다. 프로비저닝은 앱이 활성
    상태인 동안 실행되며 비활성화되면 일시 중지됩니다.
  </Step>
</Steps>

<Note>
  프로비저닝은 할당된 사용자에 대해서만 계정을 전송합니다. 아직 할당된 사람이 없다면
  먼저 액세스 권한을 부여하세요.
  [액세스 할당](/ko/identity/applications/assigning-access)을 참조하세요.
</Note>

## 액세스가 제거될 때 발생하는 일

제거에는 두 가지 트리거가 있으며, 각 트리거에 대해 Iru가 앱 계정에 수행할 작업을
**독립적으로** 선택합니다.

* **앱에서 할당 해제:** 사용자는 디렉터리에 남아 있지만 더 이상 앱에 할당된 그룹에
  속하지 않습니다.
* **디렉터리에서 제거:** 사용자의 디렉터리 레코드가 완전히 삭제됩니다.

각 트리거에 대해 세 가지 작업 중 하나를 선택합니다.

| 작업 | Iru가 앱 계정에 수행하는 작업 |
| - | - |
| **삭제** | 앱에 계정 삭제를 요청합니다. |
| **Deactivate** | 앱에서 계정을 비활성으로 표시하고(`active` 플래그를 `false`로 설정) 나중에 복원할 수 있도록 그대로 둡니다. |
| **Do nothing** | 앱의 계정을 그대로 둡니다. |

<Note>
  일반적인 설정은 할당 해제 시 **Deactivate**(액세스를 빠르게 복원할 수 있도록),
  디렉터리에서 제거 시 **삭제**입니다. 계정을 수동으로 정리하려는 앱에는
  **Do nothing**을 사용하세요.
</Note>

<Warning>
  계정을 비활성화하거나 삭제할 때 앱 내 해당 사용자의 **활성 세션**도 종료되는지
  여부는 앱이 Iru가 보내는 신호를 처리하는 방식에 따라 다릅니다.
  [자격 증명 및 세션](/ko/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="/ko/identity/applications/assigning-access">
    할당과 그룹 구성원 자격을 관리하여 프로비저닝 대상을 제어합니다.
  </Card>

  <Card title="그룹" icon="users" href="/ko/identity/directory/groups">
    앱에 푸시하고 앱의 그룹에 연결할 그룹을 구성합니다.
  </Card>

  <Card title="디렉터리 동기화" icon="building-user" href="/ko/identity/directory/directory-sync">
    HR 시스템에서 디렉터리로 사용자를 가져옵니다(인바운드 측).
  </Card>

  <Card title="애플리케이션 개요" icon="grip" href="/ko/identity/applications/applications-overview">
    앱, 프로토콜 및 버전 모델을 검토합니다.
  </Card>
</CardGroup>