Google Workspace 연결하기

Google Workspace 디렉터리를 연결하면 Google 그룹에 따라 Klang 워크스페이스에 접근할 수 있는 사람이 정해집니다. 새 동료는 그룹에 추가되면 접근 권한을 얻고, 그룹에서 빠지면 권한을 잃습니다. 직접 초대할 필요가 없습니다.

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

시작하기 전에

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

• Klang: Pro 또는 Enterprise 워크스페이스의 관리자
• Google: Google Workspace 최고 관리자 계정. Klang은 이 관리자의 승인을 받아 디렉터리를 읽으므로, 이 계정에서 모든 사용자와 그룹을 볼 수 있어야 합니다.

디렉터리는 Workspace 도메인에만 있으므로 개인 Gmail 계정은 사용할 수 없습니다.

연결

1. Klang에서 설정 → 워크스페이스 → 멤버 → 멤버 동기화를 여세요.
2. Google Workspace 카드에서 연결을 선택하세요.
3. Google Workspace 관리자 계정으로 로그인하고 Klang이 요청하는 접근 권한을 승인하세요.

Klang은 사용자 읽기, 그룹 읽기, 그룹 멤버 읽기의 세 가지 읽기 전용 권한을 요청합니다. 디렉터리에 어떤 내용도 다시 쓰지 않습니다.

승인하면 바로 Klang으로 돌아오며, 몇 초 안에 그룹 목록이 표시됩니다.

접근 대상 선택

같은 카드에서 두 가지 방법 중 하나를 고를 수 있습니다.

모든 활성 사용자. 활성 Google Workspace 계정이 있는 모든 사람이 이 워크스페이스의 멤버가 됩니다. 정지되거나 보관된 계정은 제외됩니다. 관리자는 계속 Klang에서 지정합니다. 회사 전체 옵션은 항상 멤버 권한만 부여합니다.

특정 그룹 선택. 이 워크스페이스에 관리자 권한을 줄 Google 그룹과 멤버 권한을 줄 그룹을 고릅니다. 중첩 그룹도 반영되므로, 다른 그룹을 포함한 그룹을 고르면 하위 그룹의 모든 사람이 포함됩니다.

확정하기 전에 포함된 사람 보기를 선택해 선택 범위에 들어가는 사람을 확인하세요. 그런 다음 필요한 라이선스 수를 확인하고 저장을 선택하세요.

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

이후 동작

Google은 변경 사항을 알려 주는 기능이 없으므로 Klang이 15분마다 디렉터리를 다시 읽습니다. 연결 카드에서 옵션 더 보기(⋮) → 지금 동기화를 선택해 바로 동기화할 수도 있습니다.

• Google에서 그룹에 추가된 사람은 다음 동기화 때 해당 워크스페이스에 접근할 수 있습니다.
• 연결된 모든 그룹에서 제거된 사람은 Klang에서 비활성화됩니다. 콘텐츠는 그대로 남으며, 다시 그룹에 들어오면 접근 권한을 되찾습니다.
• Google에서 정지되거나 보관된 사람도 같은 방식으로 접근 권한을 잃습니다.
• 관리자 그룹은 멤버를 관리자로 승격할 수 있습니다. 기존 관리자는 멤버 그룹으로 옮겨도 역할이 유지됩니다.
• Klang에 한 번도 로그인한 적 없는 사람에게는 초대 이메일이 발송됩니다.

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

동기화가 멈춘 경우

카드에 다음 두 상황 중 어느 쪽인지 표시됩니다.

동기화 실패. 요청 한도 초과나 일시적인 네트워크 오류 같은 일시적인 문제입니다. 멤버는 접근 권한을 유지합니다. 다시 시도를 선택하고, 계속 실패하면 다시 연결하세요.

다시 연결 필요. Klang이 더 이상 디렉터리에 접근할 수 없는 상태입니다. 대부분 Klang을 승인한 관리자가 퇴사했거나 그 관리자의 권한이 철회된 경우입니다. 승인은 도메인이 아니라 해당 관리자 개인에게 속합니다. 다시 연결하기 전까지 멤버는 접근 권한을 유지합니다. 다시 연결을 선택하고 현재 최고 관리자 계정으로 다시 승인하세요.

연결 해제

이 워크스페이스의 동기화를 중지하려면 옵션 더 보기(⋮) → 연결 해제를 선택하세요. 기존 멤버는 접근 권한을 유지하며 이후 수동으로 관리됩니다. 대기 중인 동기화 초대는 취소됩니다. 같은 연결을 공유하는 다른 워크스페이스는 계속 동기화됩니다. Klang은 마지막 워크스페이스의 연결이 해제될 때만 Google 디렉터리의 접근 권한을 취소합니다. 그 뒤에 다시 연결하려면 관리자가 Klang을 다시 승인해야 합니다.