에이전트 ID 인증 제공업체 관리

에이전트 ID 인증 관리자에서 세부정보를 수정하거나, 사용 설정 또는 사용 중지하거나, 필요에 따라 삭제 및 복원하여 인증 제공업체를 관리합니다.

시작하기 전에

  1. 올바른 인증 방법을 선택했는지 확인합니다.
  2. 이 작업을 완료하는 데 필요한 역할이 있는지 확인합니다.

필요한 역할

에이전트 ID 인증 제공자를 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 에이전트 ID 편집자 (roles/agentidentity.editor) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 에이전트 ID 인증 제공업체를 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

에이전트 ID 인증 제공업체를 관리하려면 다음 권한이 필요합니다.

  • agentidentity.authProviders.update
  • agentidentity.authProviders.delete

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

인증 제공업체 수정

인증 제공업체의 설명 또는 인증 세부정보를 업데이트하려면Google Cloud 콘솔 또는 Google Cloud CLI를 사용하세요.

인증 제공업체를 업데이트하려면 다음 명령어를 실행합니다.

gcloud alpha agent-identity authProviders update AUTH_PROVIDER_NAME \
    --location="LOCATION" \
    --description="NEW_DESCRIPTION" \
    --three-legged-oauth-client-id="NEW_CLIENT_ID" \
    --three-legged-oauth-client-secret="NEW_CLIENT_SECRET" \
    --three-legged-oauth-authorization-url="NEW_ENDPOINT"

다음을 바꿉니다.

  • AUTH_PROVIDER_NAME: 인증 제공업체의 이름입니다.
  • LOCATION: 인증 제공자의 위치입니다.
  • NEW_DESCRIPTION: 인증 제공업체의 새로운 설명입니다.
  • NEW_CLIENT_ID: 서드 파티 애플리케이션의 새 클라이언트 ID입니다.
  • NEW_CLIENT_SECRET: 서드 파티 애플리케이션의 새 클라이언트 보안 비밀번호입니다.
  • NEW_ENDPOINT: 서드 파티 승인 서버의 새 URL입니다.

인증 제공업체 사용 설정 또는 사용 중지

인증 제공업체를 삭제하지 않고 에이전트가 인증 제공업체를 사용하지 못하도록 일시적으로 중지하려면 인증 제공업체를 사용 중지하면 됩니다. 언제든지 다시 사용 설정할 수 있습니다.

  1. 인증 제공업체를 사용 설정하려면 다음 명령어를 실행하세요.

    gcloud alpha agent-identity authProviders enable AUTH_PROVIDER_NAME \
    --location="LOCATION"

  2. 인증 제공업체를 사용 중지하려면 다음 명령어를 실행합니다.

    gcloud alpha agent-identity authProviders disable AUTH_PROVIDER_NAME \
    --location="LOCATION"

다음을 바꿉니다.

  • AUTH_PROVIDER_NAME: 인증 제공업체의 이름입니다.
  • LOCATION: 인증 제공자의 위치입니다.

인증 제공업체 삭제

인증 제공자가 더 이상 필요하지 않으면 삭제할 수 있습니다. 인증 제공업체를 삭제하면 인증 제공업체가 중지되고 30일 동안 소프트 삭제 상태로 전환됩니다. 이 기간 동안 원하는 경우 인증 제공업체를 복원할 수 있습니다. 30일이 지나면 정책이 삭제되는 데 하루가 더 걸리며, 이때 동일한 이름으로 인증 제공자를 만들 수 있습니다.

인증 제공업체를 삭제하려면 다음 명령어를 실행합니다.

gcloud alpha agent-identity authProviders delete AUTH_PROVIDER_NAME \
    --location="LOCATION"

다음을 바꿉니다.

  • AUTH_PROVIDER_NAME: 인증 제공업체의 이름입니다.
  • LOCATION: 인증 제공자의 위치입니다.

삭제된 인증 제공업체 복원

실수로 인증 제공업체를 삭제한 경우 삭제 후 30일 이내에 소프트 삭제 상태에서 복원할 수 있습니다. 이 기간 동안 원하는 경우 인증 제공업체를 복원할 수 있습니다. 30일이 지나면 정책이 삭제되는 데 하루가 더 걸리며, 이때 동일한 이름으로 인증 제공업체를 만들 수 있습니다.

인증 제공업체를 복원하려면 다음 명령어를 실행합니다.

gcloud alpha agent-identity authProviders undelete AUTH_PROVIDER_NAME \
    --location="LOCATION"

다음을 바꿉니다.

  • AUTH_PROVIDER_NAME: 인증 제공업체의 이름입니다.
  • LOCATION: 인증 제공자의 위치입니다.

다음 단계