Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Cloud OAuth API로 엔터프라이즈 그룹 가져오기

이 가이드에서는 Cloud OAuth API(cloudoauth.googleapis.com)의 /groups 엔드포인트를 사용하여 인증된 직원 사용자의 엔터프라이즈 그룹 멤버십을 검색하는 방법을 설명합니다.

/groups 엔드포인트는 OpenID Connect(OIDC) 통합을 위한 분산 클레임 엔드포인트 역할을 하며, SCIM 지원 및 비SCIM 직원 ID 풀의 사용자에 대해 페이지로 나눈 엔터프라이즈 그룹 멤버십을 반환합니다.

시작하기 전에

직원 ID 풀 및 공급업체를 구성합니다. 자세한 내용은 직원 ID 제휴 구성을 참조하세요.
OAuth 클라이언트를 등록하고 승인 코드를 액세스 토큰으로 교환합니다. 자세한 내용은 Cloud OAuth API로 토큰 교환을 참조하세요.
Cloud OAuth API가 아직 사용 설정되지 않은 경우 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법 알아보기
API 사용 설정하기

엔터프라이즈 그룹 검색

인증된 사용자의 그룹 멤버십을 가져오려면 HTTP GET 요청을 /groups 엔드포인트로 보냅니다.

Cloud OAuth API의 common.groups 메서드는 인증된 사용자의 엔터프라이즈 그룹 멤버십을 가져옵니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

TOKEN: 토큰 교환 엔드포인트에서 가져온 수명이 짧은 OAuth 2.0 액세스 토큰입니다.
PAGE_SIZE: 선택사항. 페이지당 반환할 최대 그룹 수입니다(2,500~5,000개).
PAGE_TOKEN: 선택사항. next_page_token 필드의 이전 /groups 응답에서 수신된 페이지로 나누기 토큰입니다.

HTTP 메서드 및 URL:

GET https://cloudoauth.googleapis.com/v1/common/groups?page_size=PAGE_SIZE&page_token=PAGE_TOKEN

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer TOKEN" \
     "https://cloudoauth.googleapis.com/v1/common/groups?page_size=PAGE_SIZE&page_token=PAGE_TOKEN"

PowerShell(Windows)

다음 명령어를 실행합니다.

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudoauth.googleapis.com/v1/common/groups?page_size=PAGE_SIZE&page_token=PAGE_TOKEN" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "groups": [
    "security-admin@example.com",
    "data-analysts@example.com",
    "looker-developers@example.com"
  ],
  "next_page_token": "AE12aBcDeFgHiJkLmNoPqRsTuVwXyZ"
}

응답 필드

응답에는 다음 필드가 포함됩니다.

필드	유형	설명
`groups`	`array of strings`	인증된 사용자가 속한 엔터프라이즈 그룹 식별자 또는 이메일 주소 목록입니다.
`next_page_token`	`string`	후속 요청에서 `page_token`으로 전달하여 결과의 다음 페이지를 검색할 수 있는 토큰입니다. 이 필드가 비어 있거나 생략된 경우 다음 페이지가 표시되지 않습니다.

/groups 엔드포인트에서 반환하는 오류 응답에 대한 자세한 내용은 Cloud OAuth 사용자 정보 및 그룹 오류를 참조하세요.