그룹스 API 개요

Cloud ID 그룹스 API를 사용하면 각각 서로 다른 기능과 멤버십을 지원하는 다양한 유형의 그룹을 만들고 관리할 수 있습니다.

그룹 유형

그룹항목의 모음으로, 각 항목은 또 다른 그룹이거나 사용자일 수 있습니다. Cloud ID 그룹스 API는 다음 그룹 유형을 지원합니다.

Google 그룹스

Google 그룹스에는 이메일 주소가 있으며 메일링 리스트로도 자주 사용됩니다. Google 그룹스는 다양한 Google 제품에서도 사용할 수 있습니다. 예를 들어 Google 문서를 그룹과 공유하거나, Google 캘린더 일정에 그룹을 초대하거나, IAM에서 액세스 관리를 위해 그룹을 사용할 수 있습니다. Google 그룹스는 기본 그룹 유형입니다.

동적 그룹

동적 그룹은 멤버십 쿼리 또는 직원 속성(예: 직무와 건물 위치)에 대한 쿼리를 사용하여 멤버십을 자동으로 관리하는 Google 그룹스입니다. 예를 들어 멤버십 쿼리는 '조직에서 테크니컬 라이터의 직무를 수행하는 모든 사용자'일 수 있습니다.

보안 그룹

보안 그룹은 Google 그룹과 비슷하지만 조직 리소스에 대한 액세스를 제어하는 데 사용됩니다. 보안 그룹은 Google 그룹을 보안 그룹으로 업데이트하여 생성됩니다.

ID 매핑 그룹

ID 매핑 그룹은 Active Directory와 같은 Google 이외의 ID 소스에서 동기화된 사용자 및 그룹이 포함된 그룹입니다. ID 매핑 그룹을 사용하면 Google Cloud Search가 외부 ID 소스에 저장된 사용자 및 그룹, 검색 문서에 대한 권한을 인식할 수 있습니다. 예를 들어 문서에 대한 특정 권한이 있는 사용자 example_user_org@your_domain.com이 있을 수 있습니다. 이 사용자는 example_user@your_domain.com과 동기화하여 Google Cloud Search가 동일한 문서에 대해 동일한 권한을 인식하도록 할 수 있습니다.

Google Cloud Search에서 ID 매핑 그룹을 동기화하려면 ID 커넥터를 만들어야 합니다. 자바를 사용하는 경우 Google Cloud Search 자바 SDK를 사용하여 ID 커넥터를 만들 수 있습니다. REST API를 사용하려면 Cloud ID 그룹스 API를 사용하면 됩니다. ID 커넥터에 대한 자세한 내용은 Cloud Search 문서의 서로 다른 ID 시스템 동기화를 참조하세요.

그룹 속성

유형과 상관없이 각 그룹에는 다음과 같은 속성이 있습니다.

라벨
라벨이 그룹의 유형을 식별합니다.
  • Google 그룹스: cloudidentity.googleapis.com/groups.discussion_forum
  • 동적 그룹: cloudidentity.googleapis.com/groups.dynamic
  • 보안 그룹: cloudidentity.googleapis.com/groups.security(보안 그룹이 Google 그룹스를 기반으로 하므로 이 라벨은 cloudidentity.googleapis.com/groups.discussion_forum에 추가됩니다.)
  • ID 매핑된 그룹: system/groups/external
항목 키

항목 키는 사람이 읽을 수 있는 그룹의 고유 식별자입니다.

  • Google 그룹스, 동적 그룹, 보안 그룹: 그룹의 이메일 주소
  • ID 매핑 그룹: 네임스페이스로 정규화된 문자열. 네임스페이스는 Google Cloud Search에서 ID 소스를 만들 때 설정됩니다. ID 소스에 대한 자세한 내용은 Cloud Search 문서의 서로 다른 ID 시스템 동기화를 참조하세요.
상위 요소

상위 요소는 그룹이 속한 리소스입니다. Google 그룹스, 동적 그룹, 보안 그룹의 경우 상위 요소는 도메인을 소유한 고객입니다. ID 매핑 그룹의 경우 상위 요소는 그룹이 동기화되는 ID 소스입니다.

표시 이름

표시 이름은 Google 제품에 표시되는 그룹의 이름입니다.

멤버십 및 멤버십 속성

그룹에 속한 항목을 구성원이라 하며, 이 그룹과의 관계를 멤버십이라고 합니다. 항목은 사용자, 그룹, 서비스 계정일 수 있습니다. 멤버십에는 다음과 같은 속성이 있습니다.

선호 구성원 키
선호 구성원 키는 구성원이 읽을 수 있는 고유한 식별자입니다. Google 그룹 또는 개별 사용자의 경우 선호 구성원 키는 그룹 또는 사용자의 이메일 주소입니다. ID 매핑 그룹의 경우, 선호 구성원 키는 네임스페이스로 정규화된 문자열입니다.
멤버십 역할

멤버십 역할은 구성원이 그룹에서 갖고 있는 권한을 나타냅니다. 지원되는 역할은 다음과 같습니다.

  • MEMBER - 특수한 권한이 없음 모든 멤버십에는 최소 MEMBER 멤버십 역할이 있어야 합니다.

  • OWNER: 다른 OWNER를 관리하거나 그룹을 삭제하는 등의 광범위한 권한이 있습니다.

  • MANAGEROWNER보다 적지만 다른 MANAGER를 관리하는 등 MEMBER 이상의 권한이 있습니다.

그룹에서 특정 멤버십 역할이 갖는 권한은 Google 그룹스 웹 인터페이스 또는 Google 관리 콘솔에서 맞춤설정할 수 있습니다. 자세한 내용은 보기, 게시, 검토 가능한 사용자 설정하기를 참조하세요.

Cloud ID에 아직 없는 사용자 및 그룹을 외부 ID 소스로 가져올 수 있습니다. 먼저 조직의 ID 소스를 만든 다음 사용자 및 그룹 정보를 Cloud ID로 가져와야 합니다.

다음 단계

그 다음으로는 아래와 같은 옵션도 고려해 볼 수 있습니다.