> ## 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. # Okta를 사용한 SCIM 디렉터리 통합 > Okta와 Iru Endpoint 간의 SCIM 디렉터리 통합을 구성합니다. SCIM 프로토콜을 통해 사용자 및 그룹을 자동으로 프로비저닝 및 프로비저닝 해제합니다. ### Okta를 사용한 SCIM 디렉터리 통합 정보 Iru Endpoint의 Okta를 사용한 SCIM 디렉터리 통합을 사용하면 Okta와 Iru Endpoint 간에 SCIM 기반 사용자 디렉터리 동기화를 설정하여 사용자 및 그룹을 자동으로 프로비저닝 및 프로비저닝 해제할 수 있습니다. ### 작동 방식 SCIM 통합은 Okta와 Iru Endpoint 간에 보안 연결을 생성하여 사용자 및 그룹 데이터를 자동으로 동기화합니다. Okta에서 사용자 또는 그룹이 추가, 수정 또는 제거되면 이러한 변경 사항이 SCIM 프로토콜을 통해 Iru Endpoint에 자동으로 반영됩니다. ### 사전 요구 사항 * SCIM용 표준 기반 기본 제공 프로비저닝을 지원하는 Okta의 **Advanced Lifecycle Management** 플랜을 사용하고 있는지 확인하세요. * [SCIM 디렉터리 통합](/ko/endpoint/integrations/scim/scim-directory-integration#scim-schema-and-supported-attributes) 문서에 나열된 지원되는 사용자 및 그룹 속성을 검토하세요. ### SCIM 토큰 및 API URL 가져오기 먼저 Iru Endpoint에서 다음 단계를 완료하세요. Okta를 구성할 때 SCIM 액세스 토큰과 API URL이 필요합니다. 자세한 내용은 [SCIM 디렉터리 통합](/ko/endpoint/integrations/scim/scim-directory-integration) 문서를 참조하세요. Iru Endpoint의 사이드바에서 [**계정 메뉴 버튼**](/ko/iru/platform-overview/account-menu)을 선택한 다음 **통합**을 선택합니다. Integrations 옵션이 강조 표시된 계정 메뉴 스크린샷 Integrations 페이지 오른쪽 상단에서 **모든 통합 찾아보기**를 선택합니다. **Directory integrations** 필터를 선택합니다. **SCIM protocol** 타일을 선택합니다. SCIM protocol 타일이 있는 새 통합 추가 페이지 **시작하기**를 선택합니다. SCIM 통합의 고유한 이름을 입력합니다. **토큰 생성**을 선택합니다. SCIM 통합은 Bearer Token이 포함된 HTTP 권한 부여 헤더를 사용합니다. 이름 필드와 토큰 생성 버튼이 있는 SCIM 사용자 통합 구성 화면 **Copy token**을 선택합니다. Done을 선택한 후에는 토큰을 다시 볼 수 없습니다. **Okta** 탭에서 필요하므로 안전하게 보관하세요. 확인란을 선택하여 토큰을 복사했음을 확인한 다음 **완료**를 선택합니다. **통합** 페이지로 돌아갑니다. Copy token 버튼이 있는 토큰 복사 및 ID 공급자 구성 대화 상자 생성한 SCIM 디렉터리 통합의 **줄임표**를 선택합니다. **View Details**를 선택합니다. View details, Rename, Rotate token, Delete가 표시된 줄임표 메뉴와 SCIM 통합이 있는 디렉터리 통합 목록 SCIM API URL(예: `https://subdomain.api.iru.com/api/v1/scim`)을 복사합니다. ID 공급자에서 이 URL이 필요합니다. 테넌트에 표시되는 URL에는 여전히 `api.kandji.io` 도메인이 표시될 수 있습니다. `api.kandji.io` 버전의 SCIM API URL도 이 용도로 사용할 수 있습니다. **닫기**를 선택합니다. SCIM API URL과 복사 버튼이 있는 사용자 통합 세부 정보 보기 모달 토큰과 API URL을 준비해 둔 다음 **Okta** 탭으로 전환하여 SCIM 앱 통합을 생성하고 구성합니다. 먼저 **Iru Endpoint** 탭을 완료하여 SCIM 토큰과 API URL을 받으세요. 아래 단계에서 이 값을 입력합니다. ## Okta에서 SCIM 통합 생성 Okta Integration Network(OIN)에서 제공되는 Iru Endpoint 애플리케이션은 SCIM용으로 프로비저닝할 수 없습니다. SCIM용으로 새 Application Integration을 생성해야 합니다. 이 새 앱 통합은 OIN Iru Endpoint 애플리케이션을 사용하는 기존 Okta SSO 통합을 방해하지 않습니다. login.okta.com에서 Okta 관리 콘솔에 로그인합니다. 로그인한 후 왼쪽 탐색 메뉴에서 **애플리케이션** 섹션을 확장하고 **애플리케이션**을 선택합니다. **Create App Integration**을 선택합니다. Create App Integration 버튼이 있는 Okta Applications 페이지 애플리케이션 유형으로 **SAML 2.0**을 선택하고 **다음**을 선택합니다. SAML 2.0이 선택된 새 앱 통합 생성 대화 상자 **General Settings**에서 앱의 **이름**을 지정하고 **App visibility** 섹션의 확인란을 선택합니다. 그런 다음 **다음**을 선택합니다. 앱 이름과 App visibility가 있는 SAML 통합 생성 General Settings **SAML Settings**에서 **Single sign-on URL** 및 **Audience URI (SP Entity ID)** 필드에 자리 표시자 URL을 입력합니다. 다른 설정은 변경하지 마세요. Single sign-on URL과 Audience URI가 있는 SAML 통합 생성 Configure SAML 단계 **다음**을 선택합니다. **Help Okta Support understand how you configured this application**에서 **This is an internal app that we have created** 확인란을 선택하고 **Finish**를 선택합니다. This is an internal app that we have created 및 Finish가 있는 SAML 통합 생성 Feedback 단계 이 애플리케이션 통합은 SSO에 사용하지 않으므로 URL이 유효할 필요는 없지만, 계속하려면 이 필드에 URL을 입력해야 합니다. Iru Endpoint에서 SAML SSO를 활성화하기로 결정한 경우 이 앱을 그대로 사용할 수 있습니다. ## SCIM 설정 구성 방금 생성한 Okta SCIM 앱에서 **일반** 탭으로 이동합니다. **설정** 섹션에서 **편집**을 선택합니다. Provisioning 설정에서 **SCIM**을 선택합니다. 다른 설정은 수정하지 말고 **저장**을 선택합니다. Provisioning 설정에서 SCIM이 선택된 Okta General 탭 **Provisioning** 탭의 Integration 섹션에서 **편집**을 선택합니다. SCIM Connection과 Edit 버튼이 있는 Okta Provisioning 탭 **SCIM connector base URL**에 **Iru Endpoint** 탭에서 복사한 SCIM API URL(예: `https://subdomain.api.iru.com/api/v1/scim`)을 입력합니다. `api.kandji.io` 버전의 SCIM API URL도 이 용도로 사용할 수 있습니다. **Unique identifier field for users**에 **userName**을 입력합니다. **Supported provisioning actions**로 **Push New Users**, **Push Profile Updates** 및 **Push Groups**를 선택합니다. **Authentication Mode**로 **HTTP Header**를 선택합니다. **Authorization**에 **Iru Endpoint** 탭에서 받은 Bearer Token을 입력합니다. **Test Connector Configuration**을 선택하여 통합을 테스트합니다. base URL, userName, 프로비저닝 작업, HTTP Header 및 Bearer token이 있는 Okta SCIM Connection 감지된 기능 목록에서 다음 항목에만 성공을 나타내는 체크 표시가 있는지 확인합니다. * Create Users * Update User Attributes * Push Groups Connector configured successfully 및 감지된 기능이 표시된 Okta Test Connector Configuration 대화 상자 **저장**을 선택합니다. **Provisioning** 탭에서 **To App** 섹션으로 이동하여 **편집**을 선택합니다. Provisioning to App과 Edit가 있는 Okta Provisioning To App 섹션 **Provisioning to App** 섹션에서 **Create Users**, **Update User Attributes** 및 **Deactivate Users**를 활성화합니다. Create Users, Update User Attributes 및 Deactivate Users가 있는 Okta Provisioning to App 설정 **저장**을 선택합니다. (선택 사항) **Attribute Mappings**에서 Iru Endpoint로 보낼 사용자 속성을 편집합니다. Iru Endpoint는 [SCIM 디렉터리 통합](/ko/endpoint/integrations/scim/scim-directory-integration#scim-schema-and-supported-attributes) 문서에 언급된 속성만 저장하고 사용합니다. ## Iru Endpoint에 사용자 할당 Okta에서는 동일한 그룹을 Assignments 탭과 Push Groups 탭 모두에서 사용할 수 없습니다. 이러한 충돌을 피하려면 SCIM 앱 접근용 할당 그룹(예: `iru_endpoint_users`)을 하나 생성하고 푸시된 그룹의 사용자와 동기화된 상태로 유지하세요. 그런 다음 해당 할당 그룹을 SCIM 앱에 할당합니다. 이는 Okta SCIM을 통해 Iru Endpoint에 사용자를 할당하는 한 가지 예입니다. ### 할당 그룹 생성 새 브라우저 탭에서 **Directory > Groups**로 이동하여 **Add Group**을 선택합니다. 그룹에 **iru\_endpoint\_users**와 같은 의미 있는 이름을 지정하고 **저장**을 선택합니다. ### 그룹 규칙으로 구성원 추가 푸시 그룹(예: Sales 및 Engineering)에 속한 사람이 자동으로 `iru_endpoint_users`의 구성원이 되어야 할 때 사용하세요. 이 단계를 따르면 해당 사용자를 수동으로 일괄 추가할 필요가 없습니다. Directory > Groups > Rules로 이동하여 **Add Rule**을 선택합니다. Add Rule이 있는 Okta Directory Groups Rules 페이지 규칙 이름을 입력합니다(예: `Update iru_endpoint_users group membership`). IF에서 **Use basic condition** 및 **Group membership**을 선택한 다음 **includes any of the following**을 설정하고 푸시할 그룹(예: Sales 및 Engineering)을 선택합니다. **Then Assign to**에서 `iru_endpoint_users`를 선택한 다음 **저장**을 선택합니다. Use basic condition 및 Group membership이 있는 Okta 그룹 규칙 IF 조건 Rules 페이지로 돌아와 새 규칙의 **작업**을 열고 **Activate**를 선택합니다. Actions 메뉴와 Activate가 있는 Okta Group Rules 목록 ### 수동으로 구성원 추가 그룹 규칙을 사용하지 **않는** 경우에 사용하세요. 예를 들어 푸시 그룹과 규칙이 준비되기 전에 테스트 사용자를 추가하거나, `iru_endpoint_users`에 있어야 하지만 아직 푸시된 그룹에 속하지 않은 사람을 추가할 때 사용합니다. `iru_endpoint_users`를 검색하고 SCIM 앱을 사용해야 하는 사용자를 추가합니다. ### SCIM 앱에 그룹 할당 Okta SCIM 앱이 열려 있는 브라우저 탭으로 돌아갑니다. **할당** 탭으로 이동하여 **Assign > Assign to Groups**를 선택합니다. 새로 생성한 그룹을 검색하고 **할당** > **Save and Go Back**을 선택합니다. 그룹이 할당되었는지 확인하고 **완료**를 선택합니다. 이제 그룹이 Assignments 탭의 **그룹** 섹션에 표시되어야 합니다. 그룹이 표시되지 않으면 브라우저 탭을 새로 고쳐 보세요. `iru_endpoint_users`의 모든 사용자가 Iru Endpoint에 프로비저닝되어 Users 모듈에 표시됩니다. [Blueprints의 조건부 로직](/ko/endpoint/blueprints/assignment-maps/using-conditional-logic-in-blueprints)을 위해 그룹을 동기화하려면 다음 섹션을 계속 진행하세요. #### Iru Endpoint에 그룹 푸시 이 섹션에서는 Iru Endpoint에 사용자 그룹을 푸시하는 방법을 알아봅니다. [Blueprints의 조건부 로직](/ko/endpoint/blueprints/assignment-maps/using-conditional-logic-in-blueprints)에 사용하기 위해 Okta 그룹을 Iru Endpoint에 푸시하려는 경우, 푸시하려는 각 그룹을 SCIM 앱의 **Push Groups** 탭에 추가하세요. 이 [Okta 문서](https://help.okta.com/oie/en-us/Content/Topics/users-groups-profiles/usgp-about-group-push.htm)에 따르면 Assignment 탭에서 사용자를 할당하는 데 사용된 그룹은 Push Groups 탭에서 사용할 수 없습니다. Okta는 일관된 그룹 구성원을 위해 동일한 사용자를 포함하는 추가 그룹을 생성하고 새 그룹을 Push Groups 탭에 추가할 것을 권장합니다. 동일한 그룹을 두 곳에 모두 추가하면 Assignment 탭이 우선하며 그룹이 푸시되지 않을 수 있습니다. 이를 처리하는 한 가지 방법은 모든 Iru Endpoint 사용자를 포함하는 단일 "사용자 할당" 그룹을 생성하고 해당 그룹을 Assignment 탭에 추가하는 것입니다. 그런 다음 기존 Okta 그룹을 Push Groups로 사용할 수 있습니다. 사용자-그룹 연결이 작동하려면 푸시된 그룹의 구성원이 SCIM 앱에 할당된 Iru Endpoint 사용자 그룹의 구성원이기도 해야 한다는 점을 기억하세요. ### Push Groups 탭에서 그룹 추가 SCIM 앱에서 Iru Endpoint에 표시되어야 하는 모든 Okta 그룹을 추가합니다. Push Groups 탭을 열고 **Push Groups**를 선택한 다음 **Find groups by name**(또는 **Find groups by rule**)을 선택합니다. 그룹을 검색하여 선택합니다. **Create Group**을 선택합니다. **Save & Add Another**를 선택합니다. Iru Endpoint에 푸시할 다른 그룹을 추가합니다. ### 그룹 업데이트 푸시 사용자 및 그룹 동기화는 단방향입니다. 즉, SCIM 앱은 새 데이터나 업데이트된 데이터가 있을 때만 Iru Endpoint에 사용자 및 그룹 데이터를 보냅니다. 이러한 이유로 Iru Endpoint 웹 앱에는 "Sync Now" 옵션이 필요하지 않습니다. * Okta에서 SCIM 앱에 할당된 그룹에 사용자를 추가하는 경우 Push Groups로 추가한 그룹도 함께 업데이트하세요. * 업데이트는 Iru Endpoint에 비교적 빠르게 반영됩니다. 그룹 업데이트를 즉시 푸시하려면 Okta의 Push Groups 탭에서 **Push Now**를 사용하세요. [Okta 문서](https://help.okta.com/oie/en-us/content/topics/users-groups-profiles/usgp-enable-group-push.htm)를 참조하세요. ### 푸시된 그룹 삭제 다음 단계를 사용하여 그룹 업데이트 푸시를 중지하거나 선택적으로 Iru Endpoint에서 푸시된 그룹을 삭제할 수 있습니다. Okta에서 앱의 Push Groups 탭으로 이동합니다. Push Status 열에서 **Unlink push group**을 선택합니다. \*\*Delete the group in the target app (recommended)\*\*를 선택합니다. 이렇게 하면 Iru Endpoint에서 그룹이 제거되지만 사용자 계정은 삭제되지 않습니다. 사용자 계정은 Provisioning 탭의 할당 그룹에 연결된 상태로 유지됩니다. **Unlink**를 선택합니다. 더 이상 Push Groups 탭에 그룹이 표시되지 않아야 합니다.