다른 SCIM 서비스 연결하기

Klang의 멤버 동기화는 표준 SCIM 2.0을 따릅니다. Microsoft Entra와 Okta는 관리 콘솔이 서로 달라 별도 가이드가 있지만, Klang에는 두 서비스에만 해당하는 기능이 없습니다. Bearer 토큰으로 기본 URL에 SCIM 2.0 요청을 보낼 수 있는 서비스라면 OneLogin, JumpCloud, Ping, 사내 스크립트 등 무엇이든 사용할 수 있습니다.

이 문서는 그 밖의 모든 서비스를 위한 참고 자료입니다. Entra나 Okta를 사용한다면 해당 가이드를 따르세요.

시작하기 전에

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

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

Klang에서 연결 정보 받기

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

기본 URL과 Bearer 토큰, 두 가지 값을 받습니다. 토큰은 한 번만 표시됩니다. 대화 상자를 닫기 전에 복사하세요.

모든 요청의 Authorization 헤더에 Authorization: Bearer <token> 형식으로 토큰을 보내세요. 다른 인증 정보는 없으며, 따로 설정할 사용자 지정 헤더도 없습니다.

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

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

Klang이 지원하는 항목

엔드포인트	메서드
/ServiceProviderConfig, /ResourceTypes, /Schemas	GET
/Users	GET, POST
/Users/{id}	GET, PUT, PATCH, DELETE
/Groups	GET, POST
/Groups/{id}	GET, PUT, PATCH, DELETE

두 리소스 모두 PATCH를 지원하며, 일부 서비스가 보내는 경로 없는(pathless) 형식도 지원합니다. 그룹 멤버십은 PATCH 작업으로 받을 수도 있고, 전체를 교체하는 PUT으로 받을 수도 있습니다. GET /ServiceProviderConfig도 같은 정보를 알려 주므로, 설정 전에 이 엔드포인트를 읽는 서비스는 여기서 확인할 수 있습니다.

Klang이 사용자와 그룹을 대조하는 방법

• 사용자는 userName으로 대조하며, Klang은 이 값이 사용자의 이메일 주소라고 간주합니다.
• 그룹은 displayName으로 대조하며, 서비스가 externalId를 보내면 그 값으로 대조합니다.
• 서비스는 userName eq "..." 필터를 지원해야 합니다. 서비스는 이 필터로 사용자를 만들기 전에 이미 존재하는지 확인합니다.

Klang이 의도적으로 하지 않는 두 가지

콘텐츠는 보존됩니다. DELETE /Users/{id}를 보내거나 active를 false로 설정하면 해당 사용자가 동기화로 받은 접근 권한이 제거됩니다. 사용자의 콘텐츠는 삭제되지 않습니다.

사용자 목록은 조회할 수 없습니다. 필터 없이 GET /Users를 보내면 전체 사용자 명단 대신 빈 결과를 반환합니다. Klang은 디렉터리의 원본 데이터가 아니므로 목록을 돌려주지 않습니다. 필터를 사용한 조회는 정상적으로 작동하며, 서비스가 프로비저닝하는 데는 이것으로 충분합니다. GET /Groups는 목록을 반환합니다. 서비스가 푸시하려는 그룹을 이미 있는 그룹과 대조할 때 이 목록을 사용하기 때문입니다.

선택 사항: 푸시할 그룹 선택

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

Klang은 서비스가 실제로 보낸 그룹만 알 수 있습니다. 그룹을 고르는 방법은 서비스마다 다릅니다. Entra에서는 애플리케이션에 그룹을 할당한다고 하고, Okta에서는 Push Groups라고 합니다. 부르는 이름과 상관없이, 푸시한 그룹만 Klang에서 선택할 수 있습니다.

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

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

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

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

이후 동작

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

Klang의 연결 카드에는 서비스가 마지막으로 요청을 보낸 시각이 표시됩니다. 서비스 이름이 표시된다면 Klang이 요청에서 인식한 서비스입니다. 그렇지 않으면 SCIM으로만 표시되는데, Klang에 로고가 없는 서비스라면 정상입니다.

토큰 교체

연결 카드에서 옵션 더 보기(⋮)를 열고 새 토큰 만들기를 선택하세요. 기존 토큰은 연결을 공유하는 모든 워크스페이스에서 즉시 더 이상 작동하지 않습니다. 새 토큰을 사용하는 서비스에 붙여 넣으세요.

연결 해제

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