Okta를 사용한 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 디렉터리 통합 문서에 나열된 지원되는 사용자 및 그룹 속성을 검토하세요.

Iru Endpoint
Okta

SCIM 토큰 및 API URL 가져오기

먼저 Iru Endpoint에서 다음 단계를 완료하세요. Okta를 구성할 때 SCIM 액세스 토큰과 API URL이 필요합니다. 자세한 내용은 SCIM 디렉터리 통합 문서를 참조하세요.

통합 열기

Iru Endpoint의 사이드바에서 계정 메뉴 버튼을 선택한 다음 통합을 선택합니다.

모든 통합 찾아보기

Integrations 페이지 오른쪽 상단에서 모든 통합 찾아보기를 선택합니다.

Directory integrations 필터링

Directory integrations 필터를 선택합니다.

SCIM protocol 선택

SCIM protocol 타일을 선택합니다.

구성 시작

시작하기를 선택합니다.

통합 이름 지정

SCIM 통합의 고유한 이름을 입력합니다.

인증 토큰 생성

토큰 생성을 선택합니다. SCIM 통합은 Bearer Token이 포함된 HTTP 권한 부여 헤더를 사용합니다.

토큰 복사

Copy token을 선택합니다. Done을 선택한 후에는 토큰을 다시 볼 수 없습니다. Okta 탭에서 필요하므로 안전하게 보관하세요.

확인 및 설정 완료

확인란을 선택하여 토큰을 복사했음을 확인한 다음 완료를 선택합니다. 통합 페이지로 돌아갑니다.

Copy token 버튼이 있는 토큰 복사 및 ID 공급자 구성 대화 상자

통합 세부 정보에 접근

생성한 SCIM 디렉터리 통합의 줄임표를 선택합니다.

세부 정보 보기

View Details를 선택합니다.

View details, Rename, Rotate token, Delete가 표시된 줄임표 메뉴와 SCIM 통합이 있는 디렉터리 통합 목록

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도 이 용도로 사용할 수 있습니다.

세부 정보 닫기

닫기를 선택합니다.

SCIM API URL과 복사 버튼이 있는 사용자 통합 세부 정보 보기 모달

Okta 탭으로 전환

토큰과 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 통합을 방해하지 않습니다.

Okta 테넌트에 접근

애플리케이션으로 이동

로그인한 후 왼쪽 탐색 메뉴에서 애플리케이션 섹션을 확장하고 애플리케이션을 선택합니다.

앱 통합 생성

Create App Integration을 선택합니다.

Create App Integration 버튼이 있는 Okta Applications 페이지

애플리케이션 유형 선택

애플리케이션 유형으로 SAML 2.0을 선택하고 다음을 선택합니다.

일반 설정 구성

General Settings에서 앱의 이름을 지정하고 App visibility 섹션의 확인란을 선택합니다. 그런 다음 다음을 선택합니다.

앱 이름과 App visibility가 있는 SAML 통합 생성 General Settings

SAML 설정 구성

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 설정 구성

General 탭에 접근

방금 생성한 Okta SCIM 앱에서 일반 탭으로 이동합니다.

설정 편집

설정 섹션에서 편집을 선택합니다.

SCIM 프로비저닝 선택

Provisioning 설정에서 SCIM을 선택합니다.

일반 설정 저장

다른 설정은 수정하지 말고 저장을 선택합니다.

Provisioning 설정에서 SCIM이 선택된 Okta General 탭

Provisioning 탭에 접근

Provisioning 탭의 Integration 섹션에서 편집을 선택합니다.

SCIM Connection과 Edit 버튼이 있는 Okta Provisioning 탭

SCIM API URL 구성

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 디렉터리 통합 문서에 언급된 속성만 저장하고 사용합니다.

Iru Endpoint에 사용자 할당

Okta에서는 동일한 그룹을 Assignments 탭과 Push Groups 탭 모두에서 사용할 수 없습니다. 이러한 충돌을 피하려면 SCIM 앱 접근용 할당 그룹(예: iru_endpoint_users)을 하나 생성하고 푸시된 그룹의 사용자와 동기화된 상태로 유지하세요. 그런 다음 해당 할당 그룹을 SCIM 앱에 할당합니다.

이는 Okta SCIM을 통해 Iru Endpoint에 사용자를 할당하는 한 가지 예입니다.

할당 그룹 생성

Groups로 이동

새 브라우저 탭에서 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 앱에 그룹 할당

SCIM 앱으로 돌아가기

Okta SCIM 앱이 열려 있는 브라우저 탭으로 돌아갑니다.

Assignments에 접근

할당 탭으로 이동하여 Assign > Assign to Groups를 선택합니다.

그룹 할당

새로 생성한 그룹을 검색하고 할당 > Save and Go Back을 선택합니다.

할당 확인

그룹이 할당되었는지 확인하고 완료를 선택합니다. 이제 그룹이 Assignments 탭의 그룹 섹션에 표시되어야 합니다.

필요한 경우 새로 고침

그룹이 표시되지 않으면 브라우저 탭을 새로 고쳐 보세요.

iru_endpoint_users의 모든 사용자가 Iru Endpoint에 프로비저닝되어 Users 모듈에 표시됩니다. Blueprints의 조건부 로직을 위해 그룹을 동기화하려면 다음 섹션을 계속 진행하세요.

Iru Endpoint에 그룹 푸시

이 섹션에서는 Iru Endpoint에 사용자 그룹을 푸시하는 방법을 알아봅니다.Blueprints의 조건부 로직에 사용하기 위해 Okta 그룹을 Iru Endpoint에 푸시하려는 경우, 푸시하려는 각 그룹을 SCIM 앱의 Push Groups 탭에 추가하세요.

이 Okta 문서에 따르면 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 탭을 열고 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 문서를 참조하세요.

푸시된 그룹 삭제

다음 단계를 사용하여 그룹 업데이트 푸시를 중지하거나 선택적으로 Iru Endpoint에서 푸시된 그룹을 삭제할 수 있습니다.

Push Groups 탭에 접근

Okta에서 앱의 Push Groups 탭으로 이동합니다.

푸시 그룹 연결 해제

Push Status 열에서 Unlink push group을 선택합니다.

삭제 구성

**Delete the group in the target app (recommended)**를 선택합니다. 이렇게 하면 Iru Endpoint에서 그룹이 제거되지만 사용자 계정은 삭제되지 않습니다. 사용자 계정은 Provisioning 탭의 할당 그룹에 연결된 상태로 유지됩니다.

연결 해제 확인

Unlink를 선택합니다.

더 이상 Push Groups 탭에 그룹이 표시되지 않아야 합니다.

시작하기

기기

에이전트

Blueprints

등록

Library

배포 가이드

설정

통합

Endpoint Detection & Response

취약점 관리

Okta를 사용한 SCIM 디렉터리 통합