Okta 연결하기

Okta 디렉터리를 연결하면 멤버를 Klang으로 동기화할 수 있습니다. 동기화된 모든 사용자에게 접근 권한을 주거나 특정 그룹으로 제한할 수 있습니다.

Okta 대신 Microsoft Entra, Google Workspace 또는 다른 SCIM 서비스에서 동기화할 수도 있습니다. 워크스페이스마다 한 번에 하나의 서비스만 사용할 수 있습니다. Okta 연결 하나를 여러 워크스페이스에서 함께 사용할 수 있습니다.

시작하기 전에

다음 두 가지가 필요합니다.

• Klang: Pro 또는 Enterprise 워크스페이스의 관리자
• Okta: 애플리케이션을 추가하고 프로비저닝을 구성할 수 있는 권한

그룹은 선택 사항입니다. 사람마다 접근 범위나 역할을 다르게 하려면 그룹을 미리 계획하세요.

Klang에서 연결 정보 받기

1. Klang에서 설정 → 워크스페이스 → 멤버 → 멤버 동기화를 여세요.
2. SCIM 디렉터리 카드에서 연결을 선택하세요.
3. 열리는 대화 상자에서 Okta 탭을 선택하세요.
4. 저장을 선택해 연결을 만들고 URL과 토큰을 표시하세요.

Klang에 기본 URL과 토큰, 그리고 Okta에서 따라 할 단계가 표시됩니다.

토큰은 한 번만 표시됩니다. 대화 상자를 닫기 전에 복사하세요. 토큰을 잃어버렸다면 새 토큰 만들기를 선택해 새로 만들 수 있지만, 기존 토큰은 즉시 더 이상 작동하지 않습니다.

연결 설정이 표시되면 새로 설정하는 경우 새 연결 만들기를 선택한 상태로 두세요. 기존 연결을 다시 사용하려면 대신 내가 관리하는 워크스페이스를 선택하고 저장을 선택하세요. 새 토큰이나 서비스 설정은 필요하지 않습니다.

나중에 설정 내용을 다시 보려면 연결 카드에서 옵션 더 보기(⋮)를 열고 설정 보기를 선택하세요. URL과 서비스별 안내는 계속 볼 수 있지만, 저장된 토큰은 다시 표시되지 않습니다. 닫기를 선택하면 연결을 바꾸지 않고 안내를 닫습니다.

Okta에서 애플리케이션 추가하기

1. Okta 관리 콘솔(Admin Console)에서 Applications로 이동하세요.
2. Browse App Catalog를 선택하세요.
3. SCIM 2.0 Test App (OAuth Bearer Token)을 검색하고 Add integration을 선택하세요.
4. 이름을 Klang으로 입력하고 Next와 Done을 차례로 선택하세요.

이름에 Test가 들어 있지만, 이 앱은 Okta의 범용 SCIM 커넥터입니다. Okta Integration Network에 없는 애플리케이션을 연결할 때 쓰는 방법이며, 많은 서비스 업체가 안내하는 것과 같은 커넥터입니다.

Okta에 연결 정보 붙여 넣기

1. Klang 애플리케이션에서 Provisioning을 여세요.
2. 왼쪽 열에서 Integration을 선택한 다음 Edit를 선택하세요.
3. Enable API integration을 체크하세요.
4. Klang의 기본 URL을 SCIM 2.0 Base Url에 붙여 넣으세요.
5. Klang의 토큰을 OAuth Bearer Token에 붙여 넣으세요.
6. Test API Credentials를 선택하세요. Okta에 앱이 “was verified successfully”(인증 성공)라고 표시되어야 합니다.
7. Save를 선택하세요.

테스트에 실패하면 토큰 전체를 복사했는지, 기본 URL 끝에 슬래시(/)가 없는지 확인하세요.

Klang에 필요한 작업 켜기

많은 분이 놓치는 단계입니다. 이 단계를 건너뛰면 이후 작업이 아무 알림 없이 모두 실패합니다.

1. Provisioning에서 왼쪽 열의 To App을 선택한 다음 Edit를 선택하세요.
2. Create Users, Update User Attributes, Deactivate Users를 켜세요.
3. Sync Password는 꺼 둔 상태로 두세요. Klang은 Okta의 비밀번호로 로그인하지 않습니다.
4. Save를 선택하세요.

변경은 반드시 Edit 양식 안에서 하세요. 양식 위에도 같은 옵션이 읽기 전용으로 표시되는데, 여기를 체크해도 아무 효과가 없습니다.

Create Users가 꺼져 있으면 Okta는 Klang에 이미 있는 사람만 찾고 새로 만들지 않습니다. 이 경우 모든 할당이 Automatic provisioning of user ... failed: Matching user not found 오류로 실패합니다.

사용자 할당

1. Assignments 탭을 여세요.
2. Assign을 선택한 다음 Assign to People 또는 Assign to Groups를 선택하세요.
3. 프로비저닝할 대상을 고르고 Save and Go Back, Done을 차례로 선택하세요.

사용자를 할당하면 Klang에 해당 사용자가 만들어집니다. 다만 아직 워크스페이스 접근 권한은 생기지 않으며, 이는 아래의 마지막 단계에서 설정합니다.

선택 사항: 그룹 푸시

동기화된 모든 사용자를 사용하는 경우 그룹 프로비저닝은 건너뛰어도 됩니다. Klang에서 특정 그룹을 선택하려면 해당 그룹과 그룹 멤버십을 보내야 합니다.

Okta는 그룹 이름을 사용자와 따로 보내므로, 이 단계를 거쳐야 Klang에 그룹이 표시됩니다.

그룹으로 애플리케이션을 할당했다면 Push Groups에는 별도의 그룹을 사용하세요.

1. Push Groups 탭을 여세요.
2. Push Groups → Find groups by name을 선택하세요.
3. 그룹 이름을 입력하고 목록에서 선택하세요.
4. Push group memberships immediately는 체크된 상태로 두세요.
5. Klang에 같은 이름의 그룹이 이미 있으면 Okta에 Match found가 표시됩니다. 이 경우 Link Group을 선택하세요. 그렇지 않으면 Create Group이 표시됩니다.
6. Save를 선택하세요.

이 워크스페이스의 멤버 선택

동기화된 모든 사용자를 선택하면 이 연결로 전달되는 모든 활성 사용자에게 멤버 권한이 부여됩니다. 관리자는 Klang에서 관리하세요. 어떤 사용자를 보낼지는 계속 Okta에서 정합니다.

1. 멤버 동기화로 돌아가 누구에게 접근 권한을 부여하시겠습니까?를 찾으세요.
2. 동기화된 모든 사용자 또는 특정 그룹 선택을 선택하세요. 특정 그룹을 선택하는 경우 관리자 권한과 멤버 권한을 줄 그룹을 각각 고르세요.
3. 포함된 사람 보기를 선택해 선택 범위에 들어가는 사람을 확인하세요.
4. 추가로 필요한 라이선스를 확인한 다음 저장을 선택하세요.

그룹은 서로 겹쳐도 됩니다. 한 사람은 워크스페이스마다 한 번만 계산됩니다. 새 연결은 선택 항목을 저장하기 전까지 누구에게도 접근 권한을 주지 않습니다.

다른 워크스페이스에서 연결 사용하기

1. 내가 관리하는 다른 워크스페이스로 전환하세요.
2. 설정 → 워크스페이스 → 멤버 → 멤버 동기화를 여세요.
3. SCIM 디렉터리 카드에서 연결을 선택하세요.
4. 연결을 다시 사용할 워크스페이스를 선택하세요.
5. 저장을 선택해 이 연결을 사용하세요.
6. 접근 대상을 고르고 선택 항목을 저장하세요.

워크스페이스를 연결하려면 두 워크스페이스 모두의 관리자여야 합니다. 연결을 공유하므로 Okta 쪽 설정은 한 번만 하면 됩니다. 같은 그룹이 워크스페이스마다 다른 역할을 부여할 수 있습니다.

이후 동작

• 저장한 선택 범위에 포함된 활성 사용자는 이 워크스페이스에 접근할 수 있습니다.
• 비활성화되었거나 선택 범위에서 빠진 사용자는 동기화로 받은 접근 권한을 잃습니다. 콘텐츠는 그대로 남습니다.
• 애플리케이션 할당이 해제되었거나 Okta에서 비활성화된 사람도 같은 방식으로 접근 권한을 잃습니다.
• 관리자 그룹은 멤버를 관리자로 승격할 수 있습니다. 기존 관리자는 멤버 그룹으로 옮겨도 역할이 유지됩니다.
• Klang에 한 번도 로그인한 적 없는 사람에게는 초대 이메일이 발송됩니다.

사람 관리는 계속 Okta에서 하면 되고, Klang은 그 내용을 따릅니다.

토큰 교체

연결 카드에서 옵션 더 보기(⋮)를 열고 새 토큰 만들기를 선택하세요. 연결된 워크스페이스의 관리자라면 누구나 할 수 있습니다. 확인 화면에 영향을 받는 모든 워크스페이스가 표시되며, 기존 토큰은 이 모든 워크스페이스에서 더 이상 작동하지 않습니다. 동기화를 다시 시작하려면 새 토큰을 Okta의 OAuth Bearer Token 입력란에 붙여 넣으세요.

동기화되지 않는 경우

• Provisioning → Integration의 Test API Credentials로 언제든지 연결을 다시 확인할 수 있습니다.
• Okta는 사용자별 오류를 Assignments 탭에 표시합니다. 사용자 옆의 빨간색 아이콘을 선택하면 원인을 볼 수 있습니다.
• Matching user not found는 Create Users가 꺼져 있다는 뜻입니다. 위의 단계를 참고하세요.
• Import 탭은 Klang에서 그룹은 다시 읽어 오지만 사용자는 읽어 오지 않습니다. Klang은 디렉터리의 원본 데이터가 아니므로, 전체 사용자 목록 요청에 의도적으로 빈 결과를 반환합니다. 동기화는 푸시 방향으로 사용하세요.

연결 해제

이 워크스페이스의 동기화를 중지하려면 옵션 더 보기(⋮) → 연결 해제를 선택하세요. 기존 멤버는 접근 권한을 유지하며 이후 수동으로 관리됩니다. 대기 중인 동기화 초대는 취소됩니다. 연결된 다른 워크스페이스는 계속 동기화됩니다. 마지막 워크스페이스의 연결을 해제하면 공유 연결과 토큰도 함께 삭제됩니다.