Accede a gcloud CLI con tu identidad federada

La federación de identidades de personal te permite acceder a Google Cloud CLI con credenciales de un proveedor de identidad (IdP) externo. Puedes usar un flujo de acceso basado en el navegador para acceder a los recursos de Google Cloud desde la línea de comandos sin administrar Cuentas de Google independientes.

Antes de comenzar

  1. Asegúrate de que el administrador haya configurado la federación de identidades de personal.

  2. Asegúrate de tener información que respalde una de las siguientes opciones. El administrador puede proporcionarte esta información. Si eres administrador, puedes enumerar los grupos y proveedores de personal para encontrar estos IDs.

Obtén un archivo de configuración de acceso

En esta sección, se describe cómo obtener un archivo de configuración de acceso que puedes usar para acceder a gcloud CLI.

Crea un archivo de configuración de acceso

Puedes usar el ID del grupo de identidades de personal y el ID del proveedor del grupo de identidades de personal para crear un archivo de configuración de acceso. Si eres administrador, puedes enumerar los grupos y proveedores de personal para encontrar estos IDs.

Ejecuta el siguiente comando para crear un archivo de configuración de acceso:

Linux y macOS

gcloud iam workforce-pools create-login-config \
    locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID \
    --output-file=LOGIN_CONFIG_PATH

Windows (PowerShell)

gcloud iam workforce-pools create-login-config `
    locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID `
    --output-file=LOGIN_CONFIG_PATH

Reemplaza lo siguiente:

  • WORKFORCE_POOL_ID: Es el ID del grupo de la federación de identidades de personal.
  • WORKFORCE_PROVIDER_ID: Es el ID del proveedor de la federación de identidades de personal.
  • LOGIN_CONFIG_PATH: Es la ruta de acceso en la que se escribirá el archivo de configuración de acceso. Por ejemplo, login-config.json

El archivo de configuración de acceso contiene los extremos que usa gcloud CLI para habilitar el flujo de autenticación basado en el navegador y establecer el público en el IdP que se configuró en el proveedor de grupos de identidades de personal. El archivo no contiene información confidencial.

El contenido del archivo de configuración de acceso es similar al siguiente:

{
  "universe_domain": "",
  "universe_cloud_web_domain": "",
  "type": "external_account_authorized_user_login_config",
  "audience": "//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID",
  "auth_url": "https://auth./authorize",
  "token_url": "https://sts./v1/oauthtoken",
  "token_info_url": "https://sts./v1/introspect"
}

Ahora puedes acceder a gcloud CLI.

Guarda un archivo de configuración de acceso

Puedes guardar el contenido del archivo de configuración de credenciales que se te proporcionó en un archivo. Toma nota de la ruta de acceso y, luego, accede a gcloud CLI.

Accede a gcloud CLI

Para acceder a gcloud CLI con un archivo de configuración de acceso, ejecuta el siguiente comando:

gcloud auth login --login-config="LOGIN_CONFIG_FILE_PATH"

Reemplaza LOGIN_CONFIG_FILE_PATH por la ruta de acceso al archivo de configuración de acceso, si no activaste este archivo antes. Sin embargo, si ya activaste este archivo con la marca --activate, no es necesario que vuelvas a especificarlo. En su lugar, ejecuta el siguiente comando:

gcloud auth login