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

# OneLogin을 사용한 SCIM 디렉터리 통합

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

### OneLogin을 사용한 SCIM 디렉터리 통합 정보

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

### 작동 방식

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

### 사전 요구 사항

* [SCIM 디렉터리 통합](/ko/endpoint/integrations/scim/scim-directory-integration#scim-schema-and-supported-attributes) 문서에 나열된 지원되는 사용자 및 그룹 속성을 검토하세요.

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

    먼저 Iru Endpoint에서 다음 단계를 완료하세요. OneLogin을 구성할 때 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을 선택한 후에는 토큰을 다시 볼 수 없습니다. **OneLogin** 탭에서 필요하므로 안전하게 보관하세요.
      </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="OneLogin 탭으로 전환">
        토큰과 API URL을 준비해 둔 다음 **OneLogin** 탭으로 전환하여 SCIM 앱 통합을 생성하고 구성합니다.
      </Step>
    </Steps>
  </Tab>

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

    ### OneLogin에서 SCIM 통합 생성

    <Steps>
      <Step title="OneLogin 관리 콘솔에 접근">
        OneLogin 관리 콘솔에 로그인합니다. (예: [https://accuhive.onelogin.com/admin2](https://accuhive.onelogin.com/admin2))
      </Step>

      <Step title="애플리케이션으로 이동">
        상단 탐색 메뉴에서 **애플리케이션**에 마우스를 올립니다.
      </Step>

      <Step title="애플리케이션 메뉴 열기">
        드롭다운 메뉴에서 **애플리케이션**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-onelogin-applications.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8ca857de3466adc9e5d40c800ec67cdc" alt="Applications 메뉴가 있는 OneLogin 상단 탐색 메뉴" width="2566" height="1074" data-path="assets/media/images/iru-scim-onelogin-applications.png" />
        </Frame>
      </Step>

      <Step title="새 애플리케이션 추가">
        오른쪽 상단 근처에서 **Add App**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-onelogin-add-app.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=99963ed4a1d5a859119fadeae9454bfb" alt="Add App 버튼이 있는 OneLogin Applications 페이지" width="3426" height="1222" data-path="assets/media/images/iru-scim-onelogin-add-app.png" />
        </Frame>
      </Step>

      <Step title="SCIM Provisioner 검색">
        텍스트 필드에 \*\*SCIM Provisioner with SAML (SCIM v2 Enterprise)\*\*를 입력합니다.
      </Step>

      <Step title="SCIM Provisioner 선택">
        \*\*SCIM Provisioner with SAML (SCIM v2 Enterprise)\*\*를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-onelogin-scim-provisioner.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=5d3cf623664271105a1f1c79def9c5ff" alt="SCIM Provisioner with SAML 옵션이 있는 OneLogin Add App 검색" width="2912" height="754" data-path="assets/media/images/iru-scim-onelogin-scim-provisioner.png" />
        </Frame>
      </Step>
    </Steps>

    ### SCIM 설정 구성

    **SCIM Provisioner with SAML (SCIM v2 Enterprise)** 애플리케이션에서 다음 단계를 사용하여 SCIM 설정을 구성합니다. 다음 단계에는 사용자 및 그룹(역할) 프로비저닝이 포함됩니다.

    #### 애플리케이션 정보

    <Steps>
      <Step title="표시 이름 업데이트">
        (선택 사항) 앱 **Display Name**을 **Iru Endpoint SCIM Provisioner**와 같은 이름으로 업데이트합니다.
      </Step>

      <Step title="포털 표시 여부 구성">
        (선택 사항) OneLogin 포털에 앱을 표시할지 여부를 선택합니다.
      </Step>

      <Step title="애플리케이션 아이콘 추가">
        (선택 사항) 아이콘을 추가합니다.
      </Step>

      <Step title="설명 추가">
        (선택 사항) 설명을 추가합니다.
      </Step>

      <Step title="구성 저장">
        기본 구성을 완료한 후 **저장**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-onelogin-basic-configuration.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=2637e3d6e3153924c13592ac97eed774" alt="Display Name과 Save가 있는 OneLogin SCIM 앱 기본 구성" width="2102" height="1878" data-path="assets/media/images/iru-scim-onelogin-basic-configuration.png" />
        </Frame>
      </Step>
    </Steps>

    #### Parameters

    <Steps>
      <Step title="Parameters로 이동">
        **Parameters** 페이지로 이동합니다.
      </Step>

      <Step title="새 매개변수 추가">
        오른쪽의 추가 **(+)** 버튼을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-onelogin-new-parameter.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=be5c76e0a2874562499050834102bef3" alt="매개변수 추가 버튼이 있는 OneLogin Parameters 페이지" width="2500" height="1348" data-path="assets/media/images/iru-scim-onelogin-new-parameter.png" />
        </Frame>
      </Step>

      <Step title="필드 이름 입력">
        **Field name**에 **email.value**를 입력합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-onelogin-parameter-email-value.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=9f395bf5c38ccdba8d74e7b8462985ee" alt="email.value 필드 이름이 있는 OneLogin 새 매개변수" width="1102" height="882" data-path="assets/media/images/iru-scim-onelogin-parameter-email-value.png" />
        </Frame>
      </Step>

      <Step title="매개변수 저장">
        **저장**을 선택합니다.
      </Step>

      <Step title="매개변수 값 구성">
        Value 드롭다운에서 **이메일**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-onelogin-parameter-set-email-value.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=e8df6e1ce066a4017fc033d132b331da" alt="Email 값이 선택된 OneLogin email.value 매개변수" width="1106" height="920" data-path="assets/media/images/iru-scim-onelogin-parameter-set-email-value.png" />
        </Frame>
      </Step>

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

    #### Configuration

    <Steps>
      <Step title="구성으로 이동">
        **구성** 페이지로 이동합니다.
      </Step>

      <Step title="SCIM API URL 입력">
        **SCIM Base URL** 필드에 **Iru Endpoint** 탭에서 복사한 SCIM API URL(예: `https://subdomain.api.iru.com/api/v1/scim`)을 붙여넣습니다. `api.kandji.io` 버전의 SCIM API URL도 이 용도로 사용할 수 있습니다.
      </Step>

      <Step title="Bearer Token 입력">
        **SCIM Bearer Token** 필드에 **Iru Endpoint** 탭에서 받은 토큰을 붙여넣습니다.
      </Step>

      <Step title="API 연결 활성화">
        **사용**을 선택하여 API Connection을 켭니다.
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-onelogin-main-config.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=188f3092a2bca393041768e5f7fa68c7" alt="SCIM Base URL 및 Bearer Token 필드가 있는 OneLogin Configuration 페이지" width="2068" height="3060" data-path="assets/media/images/iru-scim-onelogin-main-config.png" />
        </Frame>
      </Step>
    </Steps>

    #### Provisioning

    <Steps>
      <Step title="Provisioning 페이지에 접근">
        **Provisioning** 페이지로 이동합니다.
      </Step>

      <Step title="프로비저닝 활성화">
        **Enable provisioning** 확인란을 선택합니다.
      </Step>

      <Step title="사용자 작업 구성">
        **Create user**, **Delete user** 및 **Update user** 옆의 확인란을 선택 해제합니다.
      </Step>

      <Step title="삭제 정책 설정">
        **When users are deleted in OneLogin, or the user's app access is removed...** 옵션에서 **삭제**를 선택합니다.
      </Step>

      <Step title="일시 중단 정책 설정">
        **When user accounts are suspended in OneLogin...** 옵션에서 **Suspend**를 선택합니다.
      </Step>

      <Step title="구성 저장">
        이제 오른쪽 상단에서 **저장**을 선택하여 초기 구성을 저장합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-onelogin-provisioning-settings.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=c96129db03a9d56823ccda43a0156509" alt="Enable provisioning 및 사용자 작업이 있는 OneLogin Provisioning 페이지" width="2078" height="1530" data-path="assets/media/images/iru-scim-onelogin-provisioning-settings.png" />
        </Frame>
      </Step>
    </Steps>

    ### Iru Endpoint에 사용자 및 역할 프로비저닝

    다음 단계를 사용하여 SCIM 통합을 통해 사용자와 OneLogin 역할을 Iru Endpoint로 보냅니다.

    <Note>
      OneLogin 역할은 Iru Endpoint의 그룹과 같은 의미이며 SCIM 구성에 할당됩니다. OneLogin에서 사용자가 역할에 할당되면 Iru Endpoint로 푸시됩니다. 또한 SCIM 앱에 할당된 모든 역할은 그룹으로 Iru Endpoint에 푸시됩니다.
    </Note>

    #### 역할 생성

    <Steps>
      <Step title="사용자로 이동">
        상단 탐색 메뉴에서 **사용자**에 마우스를 올립니다.
      </Step>

      <Step title="Roles에 접근">
        드롭다운 메뉴에서 **Roles**를 선택합니다.
      </Step>

      <Step title="새 역할 생성">
        **New Role**을 선택합니다.
      </Step>

      <Step title="역할 이름 지정">
        역할의 이름을 지정합니다.
      </Step>

      <Step title="역할에 앱 할당">
        역할에 할당할 앱을 선택합니다. 이 예에서는 SCIM 앱을 선택했습니다.
      </Step>

      <Step title="역할 저장">
        **저장**을 선택합니다.
      </Step>
    </Steps>

    #### 역할에 사용자 할당

    <Steps>
      <Step title="생성된 역할에 접근">
        방금 생성한 역할을 다시 선택합니다.
      </Step>

      <Step title="사용자로 이동">
        **사용자**를 선택합니다.
      </Step>

      <Step title="새 매핑 생성">
        **Users Added Automatically**에서 **New Mapping**을 선택합니다.
      </Step>

      <Step title="매핑 이름 지정">
        매핑의 이름을 지정합니다.
      </Step>

      <Step title="조건 구성">
        요구 사항에 맞는 조건을 생성합니다. 이 예에서는 기준으로 **Group membership**을 선택하지만 부서와 같은 다른 기준을 사용할 수도 있습니다.
      </Step>

      <Step title="역할 작업 선택">
        **작업**에서 적용할 역할을 선택합니다.
      </Step>

      <Step title="매핑 저장">
        **저장**을 선택합니다.
      </Step>
    </Steps>

    <Note>
      OneLogin에서는 사용자가 하나의 그룹에만 속할 수 있으므로 OneLogin 그룹은 부서나 위치처럼 사용자를 설명하는 속성으로 생각할 수 있습니다. 사용자가 둘 이상의 "그룹"에 속해야 하는 경우 OneLogin 역할을 사용하세요.
    </Note>

    그룹 프로비저닝에 대한 자세한 내용은 OneLogin 문서 [여기](https://developers.onelogin.com/scim/create-app)를 참조하세요.

    <Warning>
      원하는 경우 각 사용자 레코드에서 SCIM 앱에 사용자를 수동으로 추가할 수도 있습니다.
    </Warning>

    #### SCIM 앱에 규칙 추가

    아래 단계를 사용하여 OneLogin SCIM 앱에서 하나 이상의 역할(Iru Endpoint 그룹)을 Iru Endpoint로 푸시합니다.

    <Steps>
      <Step title="Rules에 접근">
        SCIM 앱에서 **Rules**를 선택합니다.
      </Step>

      <Step title="새 규칙 추가">
        **Add Rule**을 선택합니다.
      </Step>

      <Step title="규칙 이름 지정">
        규칙의 이름을 지정합니다.
      </Step>

      <Step title="작업 구성">
        **작업**의 첫 번째 드롭다운에서 **Set Groups in**을 선택합니다.
      </Step>

      <Step title="매핑 소스 선택">
        **Map from OneLogin**을 선택합니다.
      </Step>

      <Step title="역할 매핑 구성">
        **For each** 필드의 드롭다운에서 **role**을 선택합니다.
      </Step>

      <Step title="역할 값 설정">
        **with value that matches** 필드에 그룹으로 Iru Endpoint에 푸시할 SCIM 역할을 입력합니다.
      </Step>

      <Step title="규칙 저장">
        **저장**을 선택합니다.
      </Step>
    </Steps>

    ### 업데이트 푸시

    <Note>
      **동기화**: 사용자 및 그룹 동기화는 단방향입니다. 즉, SCIM 앱은 보낼 새 정보나 업데이트된 정보가 있을 때만 Iru Endpoint에 사용자 정보를 보냅니다. 이러한 이유로 Iru Endpoint 웹 앱에는 "Sync Now" 옵션이 필요하지 않습니다.
    </Note>

    OneLogin에서 SCIM 앱이 업데이트되면 변경 사항을 저장한 다음 **Reapply entitlement mappings**를 사용해야 합니다.

    <Steps>
      <Step title="More Actions에 접근">
        **More Actions** 메뉴에 마우스를 올립니다.
      </Step>

      <Step title="Entitlement Mappings 다시 적용">
        **Reapply entitlement mappings** 옵션을 선택합니다.
      </Step>
    </Steps>
  </Tab>
</Tabs>