SCIM 사용자 프로비저닝 설정: Okta

중요 정보:

• Okta는 애플리케이션에 그룹을 할당하는 방식과 사용자의 그룹 멤버십을 하위 애플리케이션에 프로비저닝하는 방식을 분리했습니다. 그룹 멤버십은 "Push groups"라는 개념을 통해 애플리케이션과 동기화됩니다. 자세한 정보는 Okta의 애플리케이션 및 그룹 할당 기술문서를 참조하십시오.
• Okta의 SCIM 작업은 즉시 수행됩니다. 프로비저닝이 활성화되면 사용자에게 DeepL에 대한 액세스 권한이 부여될 때 프로비저닝이 이루어지며, 이에 따라 사용자의 그룹 멤버십도 업데이트됩니다.
• Okta가 프로비저닝 라이프사이클 전반에 걸쳐 사용자를 관리하는 방식을 이해하려면 Okta의 공식 기술문서를 참조하십시오.

제한 사항:

• Okta를 통한 SCIM 프로비저닝은 SAML 통합에서만 사용할 수 있습니다. 이는 Okta가 개발자들이 공개 Okta 통합 네트워크의 일부가 되는 통합을 생성하도록 요구하기 때문이며, 이를 통해 누구나 OIDC를 사용하여 Okta에서 SCIM을 설정할 수 있습니다. 이 경우 Okta는 네트워크에 게시하기 전에 SCIM 통합이 정상적으로 작동하는지 확인하는 절차가 필요합니다.
• 관리자는 SCIM을 통해 관리할 수 없습니다. 사용자가 SCIM을 통해 프로비저닝된 후 관리자로 승격되면, 해당 사용자를 SCIM을 통해 계속 관리할 수 없습니다. 향후 릴리스에서 이 제한 사항을 제거하기 위해 노력 중입니다.
• SCIM 프로비저닝 과정에서 귀사의 조직과 연결되지 않은 기존 계정은 조직으로 가져올 수 없습니다.
• 이메일 NameID 정책 형식과 함께 사용하는 경우 이메일 업데이트 작업을 완료할 수 없습니다. 이는 SAML을 사용하는 SSO 구성에만 적용됩니다.

필수 조건

• DeepL에 대한 관리자 권한
• DeepL에 대한 SSO(싱글 사인 온)가 설정되어 있어야 합니다. SSO를 설정하지 않은 경우 지침을 따르십시오.
  • OpenID Connect
  • SAML
• 이전 설정에서 JIT 그룹 동기화 및 그룹이 활성화된 경우 이를 제거하십시오. 이 문서의 지침을 따르십시오.
• Okta를 통한 SCIM 프로비저닝은 현재 SAML 통합에서만 사용할 수 있습니다. 이는 Okta가 개발자들에게 공개 Okta 통합 네트워크의 일부가 되는 통합을 생성하도록 요구하기 때문이며, 이를 통해 누구나 OIDC를 사용하여 Okta에서 SCIM을 설정할 수 있습니다. 이 경우 Okta는 네트워크에 게시하기 전에 SCIM 통합이 정상적으로 작동하는지 확인하는 절차가 필요합니다.

DeepL 계정에서 SCIM 활성화

1. DeepL 계정의 설정 으로 이동
2. '팀 및 사용자 프로비저닝 구성 ' 섹션에서 '사용자 프로비저닝 관리'를 클릭하세요

3. 'SCIM 프로비저닝
   활성화'를 선택합니다. SCIM 관리자 API 키가 생성됩니다. 이 API 키는 Entra ID에서 구성할 때 필요합니다. 

   이전에 JIT 그룹 동기화를 설정한 적이 있다면, 사용자 프로비저닝 문제를 방지하기 위해 반드시 비활성화하십시오. JIT 그룹 동기화를 비활성화하기 전에 기존 그룹과 사용자를 내보내십시오. 

Okta에서 SCIM 구성 설정

연결 생성

1. Okta 관리자 콘솔로 이동하여 '애플리케이션(Applications)' 아래의 DeepL 애플리케이션으로 이동합니다.
2. '일반' 탭을 선택합니다.
3. '앱 설정' 섹션에서 '편집'을 클릭합니다.
4. SCIM 프로비저닝을 활성화하고 '저장'을 클릭합니다.
5. 이제 표시되는 '프로비저닝' 탭을 선택합니다.
6. 'SCIM 연결' 섹션에서 '편집'을 클릭합니다.
7. 다음 정보를 입력합니다:
   • SCIM 커넥터 기본 URL: https://scim.deepl.com
   • 사용자 고유 식별자 필드: userName
   • 지원되는 프로비저닝 작업: '새 사용자 푸시 ', '프로필 업데이트 푸시 ', '그룹 푸시 '를 선택합니다
   • 인증 모드: HTTP 헤더를 선택하십시오
   • 인증: SCIM API 키를 입력하세요(DeepL 관리자 계정의 '관리자 키'에서 확인할 수 있습니다. 자세한 정보는 이 문서를 참조하세요.)
8. '커넥터 구성 테스트'를 클릭하여 연결을 확인합니다.
9. 테스트가 성공하면 '저장'을 클릭하세요.

사용자 및 그룹 할당

SSO 설정 과정에서 이미 애플리케이션에 사용자와 그룹을 할당한 경우, 다음 섹션으로 넘어갈 수 있습니다.

1. DeepL 애플리케이션에서 '할당' 탭을 선택하세요.
2. '할당'을 클릭하고 '사용자에게 할당' 또는 '그룹에 할당'을 선택합니다.
3. DeepL에 프로비저닝할 사용자 또는 그룹을 선택합니다.
4. '할당'을 클릭한 다음 '완료'를 클릭합니다.

프로비저닝 범위 구성

1. DeepL 애플리케이션에서 '프로비저닝' 탭을 선택합니다.
2. '앱에 프로비저닝' 섹션에서 '편집'을 클릭합니다.
3. 다음 옵션을 활성화합니다:
   • 사용자 생성: 사용자가 애플리케이션을 할당받으면 DeepL에 자동으로 생성합니다
   • 사용자 속성 업데이트: Okta에서 사용자 속성이 변경되면 DeepL의 사용자 속성을 업데이트합니다
   • 사용자 비활성화: 사용자가 애플리케이션에서 할당 해제되거나 Okta에서 비활성화되면 DeepL에서 사용자를 비활성화합니다
4. '저장'을 클릭합니다.

속성 매핑 구성

Okta는 SCIM 프로비저닝을 위한 기본 속성 매핑을 제공합니다. 필요한 경우 이러한 매핑을 사용자 지정할 수 있습니다.

1. DeepL 애플리케이션에서 '프로비저닝' 탭을 선택합니다.
2. 프로필 편집자로 이동을 클릭합니다.
3. 필요에 따라 속성 매핑을 검토하고 수정합니다.
4. '매핑 저장'을 클릭합니다.

프로비저닝 로그 다운로드

프로비저닝 문제를 해결하거나 작업이 성공적으로 수행되었는지 확인하려면:

1. Okta 관리자 콘솔에서 [보고서] > [시스템 로그]로 이동합니다.
2. DeepL 애플리케이션과 프로비저닝 이벤트로 필터링합니다.
3. 개별 이벤트를 클릭하여 상세 정보를 확인하세요.
4. 로그를 내보내려면 'CSV 다운로드'를 클릭하거나 Okta API를 사용하여 JSON 형식의 로그를 가져오십시오.

Okta 프로비저닝 로그에 대한 자세한 정보는 Okta의 공식 기술문서를 참조하십시오.