> ## 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 Endpoint에서 SCIM 기반 사용자 디렉터리 동기화를 설정합니다. ID 공급자의 사용자 및 그룹을 자동으로 프로비저닝 및 프로비저닝 해제합니다.

### SCIM 디렉터리 통합 정보

SCIM, 즉 [System for Cross-domain Identity Management](https://scim.cloud/)는 여러 시스템 간의 사용자 ID 관리를 더 간단하고 효율적으로 만들기 위해 설계된 프로토콜입니다. 사용자 추가 및 제거 과정을 자동화하는 데 도움이 되므로 여러 클라우드 기반 애플리케이션을 사용할 때 특히 유용합니다.

### 작동 방식

SCIM에는 두 가지 주요 역할이 있습니다.

* **Client** - 일반적으로 Microsoft Entra ID 또는 Okta와 같이 핵심 ID 데이터를 관리하는 ID 공급자 또는 ID 접근 관리 시스템입니다.
* **Service Provider** - Iru Endpoint와 같이 ID 데이터를 사용하여 사용자 접근 및 권한을 관리하는 SaaS(Software-as-a-Service) 애플리케이션입니다.

SCIM은 프로비저닝, 동기화 및 프로비저닝 해제를 포함한 여러 작업을 지원합니다. 이 단방향 동기화를 통해 Iru Endpoint에서 사용자 계정을 자동으로 생성하고, MDM과 IdP 간에 사용자 속성을 최신 상태로 유지하며, 더 이상 필요하지 않은 사용자 계정을 자동으로 제거하거나 비활성화할 수 있습니다.

### Iru Endpoint에서 SCIM 구성

ID 공급자(IdP)와 Iru Endpoint 간에 SCIM 통합을 구성하려면 다음을 수행해야 합니다.

* Iru Endpoint에서 새 SCIM 디렉터리 통합 생성
* IdP에서 사용할 SCIM API URL과 API 토큰을 Iru Endpoint에서 가져오기
* IdP에 접근하여 앱 통합을 생성하고, SCIM 속성을 매핑하고, 원하는 사용자 그룹 푸시

#### 새 SCIM 디렉터리 통합 생성

<Steps>
  <Step title="통합 열기">
    Iru Endpoint의 사이드바에서 [**계정 메뉴 버튼**](/ko/iru/platform-overview/account-menu)을 선택한 다음 **통합**을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-integrations.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=e89fa7e9b81ac504a6f519608e10b8a3" alt="Integrations 옵션이 강조 표시된 계정 메뉴 스크린샷" width="562" height="1040" data-path="assets/media/images/iru-nav-integrations.png" />
    </Frame>
  </Step>

  <Step title="모든 통합 찾아보기">
    Integrations 페이지 오른쪽 상단에서 **모든 통합 찾아보기**를 선택합니다.
  </Step>

  <Step title="Directory integrations 필터링">
    **Directory integrations** 필터를 선택합니다.
  </Step>

  <Step title="SCIM protocol 선택">
    **SCIM protocol** 타일을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/iru/mFx4MUIljla7jvxs/assets/media/images/iru-integrations-add-scim.png?fit=max&auto=format&n=mFx4MUIljla7jvxs&q=85&s=336ae459ab0810c8d899d6abecb96ad9" alt="SCIM protocol 타일이 있는 새 통합 추가 페이지" width="2126" height="1354" data-path="assets/media/images/iru-integrations-add-scim.png" />
    </Frame>
  </Step>

  <Step title="구성 시작">
    **시작하기**를 선택합니다.
  </Step>

  <Step title="통합 이름 지정">
    SCIM 통합의 고유한 이름을 입력합니다.
  </Step>

  <Step title="인증 토큰 생성">
    **토큰 생성**을 선택합니다. SCIM 사용자 디렉터리 통합은 인증 방법으로 Bearer Token이 포함된 HTTP 권한 부여 헤더를 사용합니다.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-name.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=cf4df5d3d63147de7739024f71f94bf8" alt="이름 필드와 토큰 생성 버튼이 있는 SCIM 사용자 통합 구성 화면" width="1898" height="1258" data-path="assets/media/images/iru-scim-name.png" />
    </Frame>
  </Step>

  <Step title="토큰 복사">
    **Copy token**을 선택합니다.
  </Step>

  <Step title="토큰 복사 확인">
    Done을 선택한 후에는 토큰을 다시 볼 수 없습니다. 계속하기 전에 안전하게 보관하세요.
  </Step>

  <Step title="설정 완료">
    확인란을 선택하여 토큰을 복사했음을 확인한 다음 **완료**를 선택합니다. **통합** 페이지로 돌아갑니다.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=c31e71ca70b13bd8db22047685ff47ae" alt="Copy token 버튼이 있는 토큰 복사 및 ID 공급자 구성 대화 상자" width="1912" height="1262" data-path="assets/media/images/iru-scim-copy-token.png" />
    </Frame>
  </Step>
</Steps>

#### SCIM API URL 가져오기

SCIM API URL은 Iru Endpoint의 통합 세부 정보에서 확인할 수 있습니다. SCIM 연결을 구성할 때 이 URL을 ID 공급자에 제공해야 합니다.

<Steps>
  <Step title="통합 세부 정보에 접근">
    방금 생성한 SCIM 디렉터리 통합의 **줄임표**를 선택합니다.
  </Step>

  <Step title="세부 정보 보기">
    **View Details**를 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-view-details.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=72a2ce0cf83d041f18caa066996ffd4f" alt="View details, Rename, Rotate token, Delete가 표시된 줄임표 메뉴와 SCIM 통합이 있는 디렉터리 통합 목록" width="876" height="492" data-path="assets/media/images/iru-scim-view-details.png" />
    </Frame>
  </Step>

  <Step title="API URL 복사">
    SCIM API URL(예: `https://subdomain.api.iru.com/api/v1/scim`)을 **복사**합니다. ID 공급자에서 이 URL이 필요합니다.

    <Note>테넌트에 표시되는 URL에는 여전히 `api.kandji.io` 도메인이 표시될 수 있습니다. `api.kandji.io` 버전의 SCIM API URL도 이 용도로 사용할 수 있습니다.</Note>
  </Step>

  <Step title="세부 정보 닫기">
    **닫기**를 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-api-url.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=f826bc146ef440fff34093ffeb0202d6" alt="SCIM API URL과 복사 버튼이 있는 사용자 통합 세부 정보 보기 모달" width="1258" height="804" data-path="assets/media/images/iru-scim-copy-api-url.png" />
    </Frame>
  </Step>
</Steps>

### SCIM 통합 이름 변경

기존 SCIM 디렉터리 통합의 이름을 변경하려면:

<Steps>
  <Step title="통합 메뉴 열기">
    이름을 변경하려는 SCIM 디렉터리 통합의 **줄임표**를 선택합니다.
  </Step>

  <Step title="Rename 선택">
    **Rename**을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-rename.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=23ec71b5a32fe4f4c79dbc3b0fb3d573" alt="Rename 옵션이 있는 SCIM 통합 줄임표 메뉴" width="876" height="502" data-path="assets/media/images/iru-scim-rename.png" />
    </Frame>
  </Step>

  <Step title="새 이름 입력">
    통합의 새 이름을 입력하고 저장합니다.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rename-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8bce3f3a702cc1044918b75de8937961" alt="이름 필드가 있는 SCIM 통합 이름 변경 메시지 또는 대화 상자" width="1270" height="674" data-path="assets/media/images/iru-scim-rename-prompt.png" />
    </Frame>
  </Step>
</Steps>

### SCIM 토큰 교체

현재 토큰을 무효화해야 하는 경우(예: 보안 문제가 발생했거나 IdP에서 재구성한 경우) SCIM API 토큰을 교체하세요. 교체한 후 ID 공급자에서 새 토큰으로 업데이트하세요.

<Steps>
  <Step title="통합 메뉴 열기">
    SCIM 디렉터리 통합의 **줄임표**를 선택합니다.
  </Step>

  <Step title="Rotate token 선택">
    **Rotate token**을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rotate-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=f8f63aedfd798b4a2c0d08f6d96f5cbc" alt="Rotate token 옵션이 있는 SCIM 통합 줄임표 메뉴" width="1160" height="534" data-path="assets/media/images/iru-scim-rotate-token.png" />
    </Frame>
  </Step>

  <Step title="교체 확인">
    메시지에서 교체를 확인합니다. 이전 토큰은 더 이상 작동하지 않습니다.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rotate-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8a4ba4bc590415c8380c2a21848455ac" alt="SCIM 통합의 토큰 교체 확인 메시지" width="1106" height="674" data-path="assets/media/images/iru-scim-rotate-prompt.png" />
    </Frame>
  </Step>

  <Step title="새 토큰 복사">
    새 토큰을 복사하고 IdP에서 업데이트합니다.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-new-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=12bfb79182832a84389e2f1d57f67013" alt="교체 후 새 SCIM 토큰 복사" width="1098" height="1282" data-path="assets/media/images/iru-scim-copy-new-token.png" />
    </Frame>
  </Step>
</Steps>

### SCIM 통합 삭제

SCIM 디렉터리 통합을 제거하면 IdP로부터의 동기화가 중지되고 Iru Endpoint에서 통합이 제거됩니다. 오류를 방지하려면 IdP에서 SCIM 앱을 업데이트하거나 제거하세요.

<Steps>
  <Step title="통합 메뉴 열기">
    제거하려는 SCIM 디렉터리 통합의 **줄임표**를 선택합니다.
  </Step>

  <Step title="Delete integration 선택">
    **Delete integration**을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-delete-integration.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=f540e04a54a5ab4db9060b2aa9b6d599" alt="Delete integration 옵션이 있는 SCIM 통합 줄임표 메뉴" width="868" height="496" data-path="assets/media/images/iru-scim-delete-integration.png" />
    </Frame>
  </Step>

  <Step title="삭제 확인">
    메시지에서 통합을 삭제할 것인지 확인합니다.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-delete-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=fd94a0d15d035bb5c9b6468ef97b0662" alt="SCIM 통합 삭제 확인 메시지" width="1108" height="728" data-path="assets/media/images/iru-scim-delete-prompt.png" />
    </Frame>
  </Step>
</Steps>

### SCIM 스키마 및 지원되는 속성

Iru Endpoint는 다음 SCIM 속성을 지원합니다. IdP에서 SCIM 애플리케이션을 매핑할 때 이 속성을 참조하세요.

<Note>
  Iru Endpoint는 아래 목록에 없는 속성은 사용하지 않습니다. 전송되는 속성을 제한하려면 IdP의 SCIM 앱에 구성된 속성을 수정하세요.
</Note>

**사용자 속성**

| **속성** | **설명** | **필수** |
| - | - | - |
| userName | 서비스 공급자에 인증하는 데 사용되는 사용자의 고유 식별자 | 예 |
| name.formatted | 사용자의 전체 이름(예: "John Doe"). 이 속성 또는 displayName 속성이 필요합니다 | 아니요 |
| displayName | 사용자의 전체 이름(예: "John Doe"). 이 속성 또는 name.formatted 속성이 필요합니다 | 예 |
| title | "Vice President"와 같은 사용자의 직함입니다. | 아니요 |
| active | ID 공급자 내 사용자의 상태입니다. 이 속성은 ID 공급자가 자동으로 추가합니다. | 예 |
| emails.value | emails의 하위 속성인 사용자의 이메일 주소입니다. Iru Endpoint는 목록의 첫 번째 이메일만 저장합니다. | 예 |
| department | 부서 이름을 식별합니다. | 아니요 |

사용자에 대한 첫 번째 푸시에서 `active`가 `false`로 설정되면 Iru Endpoint는 해당 사용자를 일시 중단된 상태로 생성합니다.

**그룹 속성**

| **속성** | **설명** | **필수** |
| - | - | - |
| displayName | 사람이 읽을 수 있는 그룹 이름입니다. | 예 |
| members | 그룹의 구성원 목록입니다. | 예 |

SCIM을 사용하여 디렉터리에서 사용자를 동기화하는 경우 SCIM 앱이 새 정보를 Iru Endpoint로 자동 전송하므로, 기본 Entra ID 또는 Google Workspace 디렉터리 통합을 사용할 때 표시되는 Sync Now 버튼이 필요하지 않습니다. 각 클라우드 IdP에는 SCIM 데이터 동기화에 대한 자체 표준이 있습니다.

SCIM 동기화가 구성되는 방식은 ID 공급자의 문서를 확인하세요.

### 관련 문서

IdP에 해당하는 문서를 사용하여 ID 공급자에서 SCIM을 구성하세요. Iru Endpoint의 SCIM 구현은 SCIMv2 사양을 따릅니다.

<CardGroup cols={3}>
  <Card title="Okta를 사용한 SCIM 디렉터리 통합" icon="key" href="/ko/endpoint/integrations/scim/scim-directory-integration-with-okta">
    SCIM을 통한 자동 사용자 및 그룹 프로비저닝을 위해 Okta를 Iru Endpoint에 연결합니다
  </Card>

  <Card title="Microsoft Entra ID를 사용한 SCIM 디렉터리 통합" icon="microsoft" iconType="brands" href="/ko/endpoint/integrations/scim/scim-directory-integration-with-microsoft-entra-id">
    SCIM 기반 사용자 및 그룹 프로비저닝을 위해 Microsoft Entra ID(이전 Azure AD)를 Iru Endpoint에 연결합니다
  </Card>

  <Card title="OneLogin을 사용한 SCIM 디렉터리 통합" icon="key" href="/ko/endpoint/integrations/scim/scim-directory-integration-with-onelogin">
    SCIM을 통한 자동 사용자 및 그룹 프로비저닝을 위해 OneLogin을 Iru Endpoint에 연결합니다
  </Card>
</CardGroup>