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

# Microsoft Entra ID를 사용한 SCIM 디렉터리 통합

> Microsoft Entra ID와 Iru Endpoint 간의 SCIM 디렉터리 통합을 구성합니다. SCIM을 통해 사용자 및 그룹을 자동으로 프로비저닝 및 프로비저닝 해제합니다.

### Microsoft Entra ID를 사용한 SCIM 디렉터리 통합 정보

Iru Endpoint의 Microsoft Entra ID를 사용한 SCIM 디렉터리 통합을 사용하면 Microsoft Entra ID와 Iru Endpoint 간에 SCIM 기반 사용자 디렉터리 동기화를 설정하여 사용자 및 그룹을 자동으로 프로비저닝 및 프로비저닝 해제할 수 있습니다.

### 작동 방식

SCIM 통합은 Microsoft Entra ID와 Iru Endpoint 간에 보안 연결을 생성하여 사용자 및 그룹 데이터를 자동으로 동기화합니다. Microsoft Entra ID에서 사용자 또는 그룹이 추가, 수정 또는 제거되면 이러한 변경 사항이 SCIM 프로토콜을 통해 Iru Endpoint에 자동으로 반영됩니다.

### 사전 요구 사항

* [SCIM 디렉터리 통합](/ko/endpoint/integrations/scim/scim-directory-integration#scim-schema-and-supported-attributes) 문서에 나열된 지원되는 사용자 및 그룹 속성을 검토하세요.
* Microsoft는 중첩 그룹 기능을 지원하지 않으므로 SCIM에 중첩 그룹이 포함되지 않도록 하세요.

<Tabs>
  <Tab title="Iru Endpoint">
    ### SCIM 토큰 및 API URL 가져오기

    먼저 Iru Endpoint에서 다음 단계를 완료하세요. Microsoft Entra ID를 구성할 때 SCIM 액세스 토큰과 API URL이 필요합니다. 자세한 내용은 [SCIM 디렉터리 통합](/ko/endpoint/integrations/scim/scim-directory-integration) 문서를 참조하세요.

    <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**을 선택합니다. Done을 선택한 후에는 토큰을 다시 볼 수 없습니다. **Microsoft Entra ID** 탭에서 필요하므로 안전하게 보관하세요.
      </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>

      <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이 필요합니다. 테넌트에 표시되는 URL에는 여전히 `api.kandji.io` 도메인이 표시될 수 있습니다. `api.kandji.io` 버전의 SCIM API URL도 이 용도로 사용할 수 있습니다.
      </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>

      <Step title="Microsoft Entra ID 탭으로 전환">
        토큰과 API URL을 준비해 둔 다음 **Microsoft Entra ID** 탭으로 전환하여 SCIM 앱 통합을 생성하고 구성합니다.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Microsoft Entra ID">
    <Note>
      먼저 **Iru Endpoint** 탭을 완료하여 SCIM 토큰과 API URL을 받으세요. 아래 단계에서 이 값을 입력합니다.
    </Note>

    ### Microsoft Entra ID에서 SCIM 통합 생성

    <Steps>
      <Step title="Microsoft Entra 관리 센터 열기">
        [Microsoft Entra 관리 센터](https://entra.microsoft.com)에 로그인합니다.
      </Step>

      <Step title="Entra ID로 이동">
        포털 메뉴를 열고 **Entra ID**를 선택합니다.
      </Step>

      <Step title="Enterprise apps에 접근">
        **Entra ID** 메뉴에서 **Enterprise apps**를 선택합니다.
      </Step>

      <Step title="새 애플리케이션 생성">
        **New application**을 선택합니다.

        <Note>
          이미 SAML Single Sign-On 애플리케이션을 생성한 경우 해당 애플리케이션을 선택하고 SCIM을 추가할 수 있습니다.
        </Note>

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-id-new-app.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=c2cf9fdd7e1bb1642bde470e6b2cb9e1" alt="New application 버튼이 있는 Microsoft Entra ID Enterprise applications All applications" width="3584" height="2006" data-path="assets/media/images/iru-scim-entra-id-new-app.png" />
        </Frame>
      </Step>

      <Step title="애플리케이션 유형 선택">
        **Create your own application**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-create-own-app.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=e8ee8a2bc2755af20b6e3899cb060fbc" alt="Create your own application이 있는 Microsoft Entra ID 갤러리 찾아보기" width="3584" height="1538" data-path="assets/media/images/iru-scim-entra-create-own-app.png" />
        </Frame>
      </Step>

      <Step title="애플리케이션 이름 지정">
        애플리케이션의 이름을 지정합니다.
      </Step>

      <Step title="통합 유형 선택">
        \*\*Integrate any other application you don't find in the gallery (Non-gallery)\*\*를 선택합니다.
      </Step>

      <Step title="애플리케이션 생성">
        **만들기**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-create-own-app-name-settings.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=cba41a5ec1b20278e90e2a50596f575e" alt="앱 이름과 Non-gallery 옵션이 있는 Microsoft Entra ID Create your own application 대화 상자" width="1150" height="1202" data-path="assets/media/images/iru-scim-entra-create-own-app-name-settings.png" />
        </Frame>
      </Step>

      <Step title="프로비저닝에 접근">
        새로 생성한 앱의 Overview 페이지로 이동합니다.
        **관리**에서 **Provisioning**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=254b497e5495f90c98dd2aa3f8043f96" alt="Manage에 Provisioning이 있는 Microsoft Entra ID Iru SCIM Overview" width="3274" height="1976" data-path="assets/media/images/iru-scim-entra-provisioning.png" />
        </Frame>
      </Step>

      <Step title="새 구성 생성">
        **New Configuration**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-new-config.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=f467f0725c3ed827be07becb33457fba" alt="New configuration 버튼이 있는 Microsoft Entra ID Provisioning 시작하기" width="1884" height="1318" data-path="assets/media/images/iru-scim-entra-new-config.png" />
        </Frame>
      </Step>

      <Step title="인증 방법 선택">
        **Select authentication method** 드롭다운에서 **Bearer authentication**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning-configuration.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8e4dd75bab8d15c0867bda9f6737d821" alt="Bearer authentication, Tenant URL 및 Secret token이 있는 Microsoft Entra ID 새 프로비저닝 구성" width="1886" height="1470" data-path="assets/media/images/iru-scim-entra-provisioning-configuration.png" />
        </Frame>
      </Step>

      <Step title="SCIM 연결 구성">
        **Iru Endpoint** 탭에서 복사한 SCIM API URL을 **Tenant URL** 필드에 붙여넣습니다.
      </Step>

      <Step title="Secret Token 추가">
        **Iru Endpoint** 탭에서 받은 토큰을 **Secret token** 필드에 붙여넣습니다.
      </Step>

      <Step title="연결 테스트">
        **Test connection**을 선택합니다. 테스트 성공 알림이 표시되어야 합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning-test-success.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=20452fe2fa50403d81da1e52d8188c51" alt="Microsoft Entra ID Provisioning 연결 테스트 성공 메시지" width="684" height="128" data-path="assets/media/images/iru-scim-entra-provisioning-test-success.png" />
        </Frame>
      </Step>

      <Step title="구성 생성">
        **만들기**를 선택합니다.
      </Step>

      <Step title="프로비저닝 설정에 접근">
        Manage 섹션에서 **Provisioning**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning-mapping.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=7c8a14a6cc74dbcfc10cf82ce6af826e" alt="Microsoft Entra ID Provisioning 구성 Overview" width="1864" height="1532" data-path="assets/media/images/iru-scim-entra-provisioning-mapping.png" />
        </Frame>
      </Step>

      <Step title="매핑 구성">
        **Mappings** 펼침 삼각형을 확장하고 Groups와 Users가 모두 활성화되어 있는지 확인합니다.
      </Step>

      <Step title="설정 구성">
        **설정** 펼침 삼각형을 확장합니다.
      </Step>

      <Step title="범위 설정">
        **Scope**로 **Sync only assigned users and groups**를 선택합니다.
      </Step>

      <Step title="프로비저닝 활성화">
        **Provisioning Status**를 On으로 설정합니다.
      </Step>

      <Step title="구성 저장">
        **저장**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-mapping-settings.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=0970d7108a416da6b5087fbf537785a2" alt="Scope 및 Provisioning Status가 있는 Microsoft Entra ID Provisioning Mappings 및 Settings" width="2034" height="1962" data-path="assets/media/images/iru-scim-mapping-settings.png" />
        </Frame>
      </Step>

      <Step title="설정 닫기">
        오른쪽 상단의 **X**를 선택하여 설정을 닫습니다.
      </Step>
    </Steps>

    ### 사용자 및 그룹 할당

    <Steps>
      <Step title="Users and groups에 접근">
        **관리**에서 **Users and groups**를 선택합니다.
      </Step>

      <Step title="사용자 및 그룹 추가">
        메뉴에서 **Add user/group**을 선택합니다.
      </Step>

      <Step title="사용자 및 그룹 선택">
        **Add Assignment** 대화 상자에서 **Users and groups** 아래의 링크를 선택합니다.
      </Step>

      <Step title="목록에서 선택">
        사용자 및 보안 그룹 목록이 표시됩니다. 특정 사용자 또는 그룹을 검색하거나 목록에 나타나는 여러 사용자 및 그룹을 선택할 수 있습니다.
      </Step>

      <Step title="할당 선택">
        할당하려는 사용자 및 그룹을 선택합니다.
      </Step>

      <Step title="선택 확인">
        **선택**을 선택합니다.
      </Step>

      <Step title="할당 완료">
        **할당**을 선택하여 앱에 사용자 및 그룹 할당을 완료합니다.
      </Step>

      <Step title="할당 확인">
        추가한 사용자 및 그룹이 **Users and groups** 목록에 표시되는지 확인합니다.
      </Step>
    </Steps>

    <Note>
      무료 등급을 사용 중이라는 메시지가 표시되면 SCIM Enterprise App에 사용자만 추가할 수 있으며 그룹은 추가할 수 없습니다.
    </Note>

    ### 고려 사항

    <CardGroup cols={2}>
      <Card title="동기화" icon="arrows-rotate">
        사용자 동기화는 단방향입니다. Microsoft Entra ID SCIM 앱은 새 정보가 필요할 때만 Iru Endpoint에 사용자 정보를 보냅니다. 앱이 생성된 후 Microsoft Entra ID의 SCIM 앱에 사용자 또는 그룹이 추가되면 40분마다(Microsoft Entra ID에서 설정) 동기화가 이루어집니다. 더 빨리 동기화하려면 Microsoft Entra ID의 SCIM 앱에서 프로비저닝을 중지했다가 다시 시작하세요. 이는 Iru Endpoint의 기존 사용자 또는 그룹에 영향을 주지 않습니다.
      </Card>

      <Card title="사용자 제거" icon="user-minus">
        Entra ID에서 사용자를 비활성으로 설정하면 Iru Endpoint 테넌트에서도 해당 사용자가 비활성으로 설정됩니다. Entra ID에서 사용자를 삭제하면 Iru Endpoint 테넌트에서도 해당 사용자가 삭제됩니다.
      </Card>

      <Card title="Blueprint 조건부 로직" icon="code-branch">
        그룹과 함께 [Assignment Map](/ko/endpoint/blueprints/assignment-maps/using-conditional-logic-in-blueprints) 조건부 로직을 사용하는 경우 Iru Endpoint에 프로비저닝하려는 각 그룹을 SCIM 앱에 명시적으로 추가해야 합니다. 그룹 구성원인 사용자를 추가하는 것만으로는 그룹이 자동으로 동기화되지 않습니다.
      </Card>

      <Card title="AD CS 강력한 인증서 매핑" icon="certificate">
        인증서 기반 인증에 Microsoft Active Directory Certificate Services를 사용하는 경우 SCIM 속성 매핑이 강력한 인증서 매핑 요구 사항을 지원하는지 확인하세요. 필요한 매핑 및 인증서 업데이트는 [Active Directory 강력한 인증서 매핑 구성](/ko/endpoint/integrations/certificate-services/active-directory-certificate-services/active-directory-certificate-services-ad-cs-strong-mapping-configuration)을 참조하세요.
      </Card>
    </CardGroup>

    #### Microsoft Device Compliance

    Entra ID SCIM 사용자 디렉터리 통합과 Microsoft Device Compliance 통합을 함께 사용하는 경우 SCIM 애플리케이션에서 **externalId** 속성의 사용자 및 그룹 속성 매핑이 아래와 같이 objectId에 매핑되어 있는지 확인하세요. Iru Endpoint는 **objectId**를 사용하여 Intune의 사용자 및 그룹 리소스를 매핑합니다.

    <table>
      <thead>
        <tr>
          <th><strong>사용자 속성</strong></th>
          <th><strong>사용자 값</strong></th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td>externalId</td>
          <td>objectId</td>
        </tr>
      </tbody>
    </table>

    <table>
      <thead>
        <tr>
          <th><strong>그룹 속성</strong></th>
          <th><strong>그룹 값</strong></th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td>externalId</td>
          <td>objectId</td>
        </tr>
      </tbody>
    </table>

    **사용자 매핑 및 그룹 매핑 업데이트**

    <Steps>
      <Step title="SCIM 애플리케이션에 접근">
        [Microsoft Entra 관리 센터](https://entra.microsoft.com)에서 SCIM 엔터프라이즈 애플리케이션으로 이동합니다.
      </Step>

      <Step title="Provisioning 열기">
        **Provisioning**을 선택합니다.
      </Step>

      <Step title="속성 매핑에 접근">
        **Attribute mapping (Preview)** 섹션을 선택합니다.
      </Step>

      <Step title="사용자 또는 그룹 매핑 선택">
        사용자 속성을 업데이트하는 경우 \*\*Provision Microsoft Entra ID Users.\*\*를 선택합니다.
        그룹 속성을 업데이트하는 경우 **Provision Microsoft Entra ID Groups**를 선택합니다.
      </Step>

      <Step title="External ID 매핑 확인">
        externalId가 objectId에 매핑되어 있는지 확인합니다.
      </Step>

      <Step title="필요한 경우 매핑 업데이트">
        매핑되어 있지 않으면 속성 오른쪽의 **편집** 버튼을 선택하고 목록에서 objectId를 선택합니다.
      </Step>

      <Step title="변경 사항 저장">
        **저장**을 선택합니다.
      </Step>

      <Step title="Overview로 돌아가기">
        **X**를 선택하여 돌아갑니다.
      </Step>

      <Step title="프로비저닝 다시 시작">
        Provisioning 개요 페이지로 돌아온 후 값이 변경된 경우 프로비저닝 서비스를 중지했다가 다시 시작하여 업데이트된 값을 Iru Endpoint에 즉시 푸시해야 합니다.
      </Step>

      <Step title="프로비저닝 일시 중지">
        **Pause provisioning** 버튼을 선택합니다.
      </Step>

      <Step title="프로비저닝 시작">
        **Start provisioning** 버튼을 선택합니다.
      </Step>
    </Steps>
  </Tab>
</Tabs>