Okta SCIM 디렉터리 동기화
Okta SCIM 2.0의 사용자와 그룹을 디렉터리 기록으로 받고, 멤버십 영향과 동기화 상태를 확인합니다.
주요 기능
- 버전이 명시된 /api/scim/v2 사용자·그룹 엔드포인트
- 생성할 때 한 번 표시되는 공급자 전용 bearer 토큰
- Okta 푸시에서 받은 디렉터리 사용자·그룹·멤버십 기록
- 사용자 비활성화·삭제 시 디렉터리 관리 멤버십 중지와 세션 회수 시도
사전 요구사항
- 1SCIM 2.0 서비스에 요청할 수 있는 프로비저닝 설정이 있는 Okta 앱
- 2Cremit 디렉터리 공급자와 토큰을 만들 권한
- 3선택한 프로비저닝 동작을 검증할 시험 사용자와 그룹
단계별 설정 가이드
연동에 필요한 설정 단계를 순서대로 확인하세요.
Okta가 Cremit에 무엇을 보내나요?
Okta 앱에서 프로비저닝을 설정하고 활성화하면 SCIM 2.0 사용자·그룹 요청을 Cremit의 /api/scim/v2 엔드포인트로 보낼 수 있습니다. Cremit은 활성 상태와 지원하는 멤버십 변경을 포함해 디렉터리 사용자·그룹 기록을 저장합니다. SCIM 사용자 기록만으로 Cremit 로그인 계정이나 조직 멤버십이 자동 생성되지는 않습니다. 앱 할당, SSO와 멤버십 정책은 별도로 확인해야 합니다.
비활성화·삭제된 사용자 이벤트를 받으면 Cremit은 해당 조직에서 일치하는 디렉터리 관리 멤버십을 비활성화하고 활성 세션 회수를 시도합니다. 이 조치는 최선 노력 방식이므로 완료하지 못해도 SCIM 응답이 실패하지 않을 수 있습니다. 모든 계정, 다른 조직의 멤버십 또는 모든 API 토큰의 즉시 회수를 약속하는 기능은 아닙니다. 퇴사자 처리 시 실제 멤버 상태와 세션 접근을 확인하세요.
SCIM 연결 설정하기
Cremit Platform의 디렉터리 연동에서 Okta 공급자를 추가하고 Tokens 탭을 여세요. 디렉터리 토큰을 만들고 생성 창이 열려 있을 때 값을 복사합니다. 평문은 한 번만 보이지만 토큰은 만료되거나 폐기할 때까지 사용할 수 있습니다. 화면에 표시되는 SCIM 기본 URL도 복사하세요. 로그인에 별도 SAML 공급자를 사용할 수 있으나 SCIM 공급자와 토큰은 따로 설정합니다.
SCIM 프로비저닝을 지원하는 Okta 앱의 Provisioning 설정에 Cremit SCIM 기본 URL과 bearer 토큰을 입력하세요. 자격증명을 시험한 뒤 조직이 보내려는 사용자 수명 주기 동작을 명시적으로 활성화합니다. 그룹 정보가 필요하면 그룹 푸시도 별도로 설정하세요. Okta 앱과 프로비저닝 메뉴의 사용 가능 범위는 Okta 구성에 따르며, 이 안내는 Cremit 카탈로그 앱 등록이나 특정 애드온을 전제로 하지 않습니다.
실제 상태 변화 시험하기
무해한 시험 사용자를 Okta 앱에 할당하고 Cremit의 디렉터리 기록과 마지막 동기화 시각을 확인하세요. 그룹 정보가 필요하면 시험 그룹도 푸시합니다. 이후 Okta에서 시험 사용자를 비활성화하고 SCIM 이벤트, 디렉터리 활성 상태, 디렉터리 관리 조직 멤버십과 세션 접근을 확인하세요. 사용자가 그룹에서만 빠진 경우는 별도 변화로 확인해야 하며 사용자 비활성화와 같다고 가정하면 안 됩니다.
SCIM bearer 토큰을 보호하고 마지막 사용 시각을 검토하세요. 연결을 교체할 때는 Cremit에서 기존 토큰을 폐기합니다. 퇴사자와 관련된 노출 자격증명은 현재 사용하는 작업의 담당자를 확인하고 발급처에서 교체하거나 폐기하세요. 디렉터리의 비활성 표시만으로 그 자격증명이 무효가 되지는 않습니다.