직원 ID 풀 공급업체 관리

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 가이드에서는 직원 ID 제휴를 통해 일반적인 작업을 수행하는 방법을 설명합니다.

직원 풀 및 제공업체 관리

허용되는 프로젝트를 직원 풀 API에 액세스하기 위한 결제/할당량 프로젝트로 설정할 수 있습니다.

시작하기 전에

  1. 결제/할당량 프로젝트를 식별합니다.

    gcloud CLI에서 수행되는 작업을 위한 할당량에 대해 요금이 청구되는 Google Cloud 프로젝트를 설정하려면 다음 명령어를 실행합니다.

    gcloud config set billing/quota_project PROJECT_ID
    

    PROJECT_ID를 프로젝트 ID로 바꿉니다.

  2. 또는, 직원 ID 제휴를 설정하는 방법을 알아보려면 직원 ID 제휴 구성을 참조하세요. IdP별 안내는 다음을 참조하세요.

  3. Google Cloud CLI를 설치한 후 다음 명령어를 실행하여 초기화합니다.

    gcloud init

풀 관리

이 섹션에서는 직원 ID 제휴 풀을 관리하는 방법을 보여줍니다.

풀 만들기

직원 풀을 만들려면 다음 명령어를 실행하세요.

gcloud iam workforce-pools create WORKFORCE_POOL_ID \
    --organization=ORGANIZATION_ID \
    --description=DESCRIPTION \
    --location=global

다음을 바꿉니다.

  • WORKFORCE_POOL_ID: 선택한 직원 풀 ID
  • ORGANIZATION_ID: 조직 ID
  • DESCRIPTION: 이 풀에 대한 설명

풀 설명

특정 직원 풀을 설명하려면 다음 명령어를 실행하세요.

gcloud iam workforce-pools describe WORKFORCE_POOL_ID \
    --location=global

WORKFORCE_POOL_ID를 풀을 만들 때 선택한 직원 풀 ID로 바꿉니다.

풀 나열

조직의 직원 풀을 나열하려면 다음 명령어를 실행합니다.

gcloud iam workforce-pools list \
    --organization=ORGANIZATION_ID \
    --location=global

ORGANIZATION_ID를 조직 ID로 바꿉니다.

풀 업데이트

특정 직원 풀을 업데이트하려면 다음 명령어를 실행합니다.

gcloud iam workforce-pools update WORKFORCE_POOL_ID \
    --description=DESCRIPTION \
    --location=global

다음을 바꿉니다.

  • WORKFORCE_POOL_ID: 직원 풀 ID
  • DESCRIPTION: 풀에 대한 설명

풀 삭제

직원 ID 풀을 삭제하려면 다음 명령어를 실행합니다.

gcloud iam workforce-pools delete WORKFORCE_POOL_ID \
    --location=global

WORKFORCE_POOL_ID를 직원 풀 ID로 바꿉니다.

풀 삭제 취소

지난 30일 동안 삭제된 직원 ID 풀의 삭제를 취소할 수 있습니다.

풀을 삭제 취소하려면 다음 명령어를 실행합니다.

gcloud iam workforce-pools undelete WORKFORCE_POOL_ID \
    --location=global

WORKFORCE_POOL_ID를 직원 풀 ID로 바꿉니다.

직원 풀 내에 공급업체 구성

이 섹션에서는 gcloud 명령어를 사용하여 직원 풀 공급업체를 구성하는 방법을 설명합니다.

공급업체 만들기

공급업체를 만들려면 다음 명령어를 실행합니다.

gcloud iam workforce-pools providers create-oidc PROVIDER_ID \
    --workforce-pool=WORKFORCE_POOL_ID \
    --display-name=DISPLAY_NAME \
    --description=DESCRIPTION \
    --issuer-uri="OIDC_ISSUER_URL" \
    --client-id="OIDC_CLIENT_ID" \
    --attribute-mapping="ATTRIBUTE_MAPPING" \
    --attribute-condition="ATTRIBUTE_CONDITION"
    --location=global

다음을 바꿉니다.

  • PROVIDER_ID: 공급업체 ID
  • WORKFORCE_POOL_ID: 직원 풀 ID
  • DISPLAY_NAME: 표시 이름
  • DESCRIPTION: 설명
  • OIDC_ISSUER_URL: OIDC 발급기관 URL
  • OIDC_CLIENT_ID: OIDC 클라이언트 ID
  • ATTRIBUTE_MAPPING: 속성 매핑(예: google.subject=assertion.sub, google.groups=assertion.groupList, google.display_name=assertion.displayName,google.profile_photo=assertion.profilePhoto, attribute.costcenter=assertion.costcenter)
  • ATTRIBUTE_CONDITION: 속성 조건(예: assertion.group1=='gcp-users')

명령어 응답에서 POOL_RESOURCE_NAME은 풀의 이름입니다(예: locations/global/workforcePools/enterprise-example-organization-employees).

공급업체 설명

공급업체를 설명하려면 다음 명령어를 실행합니다.

  gcloud iam workforce-pools providers describe PROVIDER_ID \
      --workforce-pool=WORKFORCE_POOL_ID \
      --location=global

다음을 바꿉니다.

  • PROVIDER_ID: 공급업체 ID
  • WORKFORCE_POOL_ID: 직원 풀 ID

공급업체 나열

공급업체를 나열하려면 다음 명령어를 실행합니다.

gcloud iam workforce-pools providers list \
    --workforce-pool=WORKFORCE_POOL_ID \
    --location=global

WORKFORCE_POOL_ID를 직원 풀 ID로 바꿉니다.

공급업체 업데이트

생성 후 OIDC 제공업체를 업데이트하려면 다음 명령어를 실행합니다.

gcloud iam workforce-pools providers update-oidc PROVIDER_ID \
    --workforce-pool= WORKFORCE_POOL_ID \
    --description="DESCRIPTION" \
    --location=global

다음을 바꿉니다.

  • PROVIDER_ID: 공급업체 ID
  • WORKFORCE_POOL_ID: 직원 풀 ID
  • DESCRIPTION: 설명

공급업체 삭제

공급업체를 삭제하려면 다음 명령어를 실행하세요.

gcloud iam workforce-pools providers delete PROVIDER_ID \
    --workforce-pool=WORKFORCE_POOL_ID \
    --location=global

다음을 바꿉니다.

  • PROVIDER_ID: 공급업체 ID
  • WORKFORCE_POOL_ID: 직원 풀 ID

공급업체 삭제 취소

지난 30일 이내에 삭제된 제공자를 삭제 취소하려면 다음 명령어를 실행합니다.

gcloud iam workforce-pools providers undelete PROVIDER_ID \
    --workforce-pool=WORKFORCE_POOL_ID \
    --location=global

다음을 바꿉니다.

  • PROVIDER_ID: 공급업체 ID
  • WORKFORCE_POOL_ID: 직원 풀 ID

다음 단계