Administra grupos y proveedores de Workload Identity

La federación de identidades para cargas de trabajo te permite otorgar acceso a las cargas de trabajo externas a los recursos deGoogle Cloud a través de grupos de identidades para cargas de trabajo y proveedores de identidades (IdP) conectados. A medida que cambien tus requisitos, puedes crear, ver, actualizar, borrar o recuperar grupos y proveedores con la consola deGoogle Cloud , Google Cloud CLI o la API de REST.

Antes de comenzar

Crea un grupo de identidades para cargas de trabajo. Para obtener instrucciones, consulta las guías de configuración de la federación de identidades para cargas de trabajo.

Roles obligatorios

Para obtener los permisos que necesitas para administrar proveedores y grupos de identidades para cargas de trabajo, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para administrar grupos de identidades para cargas de trabajo y proveedores. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Los siguientes permisos son necesarios para administrar grupos de identidades para cargas de trabajo y proveedores:

  • Para ver grupos y proveedores de identidades para cargas de trabajo:
    • iam.googleapis.com/workloadIdentityPoolProviders.get
    • iam.googleapis.com/workloadIdentityPoolProviders.list
    • iam.googleapis.com/workloadIdentityPools.get
    • iam.googleapis.com/workloadIdentityPools.list
  • Para crear, actualizar y borrar grupos y proveedores:
    • iam.googleapis.com/workloadIdentityPoolProviders.create
    • iam.googleapis.com/workloadIdentityPoolProviders.delete
    • iam.googleapis.com/workloadIdentityPoolProviders.undelete
    • iam.googleapis.com/workloadIdentityPoolProviders.update
    • iam.googleapis.com/workloadIdentityPools.create
    • iam.googleapis.com/workloadIdentityPools.delete
    • iam.googleapis.com/workloadIdentityPools.undelete
    • iam.googleapis.com/workloadIdentityPools.update

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Administra grupos de identidades para cargas de trabajo

En esta sección, se muestra cómo administrar grupos de identidades para cargas de trabajo.

Crea grupos

Para crear grupos de identidades para cargas de trabajo en un proyecto, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Nuevo proveedor y grupo de cargas de trabajo.

    Ir a Nuevo proveedor y grupo de cargas de trabajo

  2. En la sección Crear un grupo de identidades, ingresa un nombre para el grupo.

    La consola de Google Cloud usa el nombre para crear un ID del grupo. Para cambiar el ID del grupo, haz clic en Editar. No puedes cambiar el ID del grupo más adelante.

  3. Opcional: En el campo Descripción, ingresa una descripción para el grupo.
  4. Opcional: Para crear el grupo en un estado inhabilitado, haz clic en el botón de activación Grupo habilitado.
  5. Haz clic en Continuar.
  6. En las secciones Agregar un proveedor al grupo y Configurar atributos del proveedor, configura un proveedor de identidad para el grupo. Para obtener instrucciones, consulta Crea un proveedor.
  7. Haz clic en Guardar.

gcloud

El comando gcloud iam workload-identity-pools create crea un grupo de identidades para cargas de trabajo en un proyecto.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • POOL_ID: Es un ID único para el grupo de identidades para cargas de trabajo, por ejemplo, my-pool. Debe tener entre 4 y 32 caracteres alfanuméricos en minúscula o guiones, y no puede comenzar con gcp-.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • DISPLAY_NAME: Opcional Un nombre visible para el grupo de identidades para cargas de trabajo, de hasta 32 caracteres, por ejemplo, My workload pool.
  • DESCRIPTION: Opcional Una descripción del grupo de identidades para cargas de trabajo, de hasta 256 caracteres.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools create POOL_ID \
    --project=PROJECT_ID \
    --location="global" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

Windows (PowerShell)

gcloud iam workload-identity-pools create POOL_ID `
    --project=PROJECT_ID `
    --location="global" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION"

Windows (cmd.exe)

gcloud iam workload-identity-pools create POOL_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION"

Deberías recibir una respuesta similar a la que figura a continuación:

Create request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef] to complete...done.
Created workloadIdentityPool [my-pool].

REST

El método projects.locations.workloadIdentityPools.create crea un grupo de identidades para cargas de trabajo en un proyecto.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es un ID único para el grupo de identidades para cargas de trabajo, por ejemplo, my-pool. Debe tener entre 4 y 32 caracteres alfanuméricos en minúscula o guiones, y no puede comenzar con gcp-.
  • DISPLAY_NAME: Opcional Un nombre visible para el grupo de identidades para cargas de trabajo, de hasta 32 caracteres, por ejemplo, My workload pool.
  • DESCRIPTION: Opcional Una descripción del grupo de identidades para cargas de trabajo, de hasta 256 caracteres.

Método HTTP y URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools?workloadIdentityPoolId=POOL_ID

Cuerpo JSON de la solicitud:

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION"
}

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una operación de larga duración que representa tu solicitud. Para verificar si se completó la creación del grupo, consulta Verifica el estado de una operación de larga duración en esta página.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Enumera grupos

Para enumerar todos los grupos de identidades para cargas de trabajo de un proyecto, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Grupos de identidades para cargas de trabajo.

    Ir a Grupos de identidades para cargas de trabajo

  2. En la tabla, consulta la lista de grupos de identidades para cargas de trabajo.
  3. Opcional: Para incluir grupos y proveedores borrados en la lista, haz clic en el botón de activación Mostrar grupos y proveedores borrados.

gcloud

El comando gcloud iam workload-identity-pools list enumera los grupos de identidades para cargas de trabajo de un proyecto.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project. Para incluir grupos borrados de forma no definitiva en el resultado, agrega la marca --show-deleted.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools list \
    --project=PROJECT_ID \
    --location="global" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools list `
    --project=PROJECT_ID `
    --location="global" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools list ^
    --project=PROJECT_ID ^
    --location="global" ^
    --format="json"

Deberías recibir una respuesta similar a la que figura a continuación:

[
  {
    "description": "Workload identity pool for external workloads.",
    "displayName": "My workload pool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "state": "ACTIVE"
  }
]

REST

El método projects.locations.workloadIdentityPools.list enumera los grupos de identidades para cargas de trabajo de un proyecto.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project. Para incluir grupos borrados de forma no definitiva en la respuesta, agrega ?showDeleted=true a la URL de la solicitud.

Método HTTP y URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "workloadIdentityPools": [
    {
      "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
      "displayName": "My workload pool",
      "description": "Workload identity pool for external workloads.",
      "state": "ACTIVE"
    }
  ]
}

Obtener una reducción

Para obtener detalles sobre un grupo de identidades para cargas de trabajo específico, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Grupos de identidades para cargas de trabajo.

    Ir a Grupos de identidades para cargas de trabajo

  2. Busca el grupo de identidades para cargas de trabajo que deseas ver y, luego, haz clic en su nombre visible. La consola de Google Cloud muestra detalles sobre el grupo de identidades para cargas de trabajo.

gcloud

El comando gcloud iam workload-identity-pools describe obtiene detalles sobre un grupo de identidades para cargas de trabajo.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo, por ejemplo, my-pool.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools describe POOL_ID \
    --project=PROJECT_ID \
    --location="global" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools describe POOL_ID `
    --project=PROJECT_ID `
    --location="global" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools describe POOL_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --format="json"

Deberías recibir una respuesta similar a la que figura a continuación:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
  "displayName": "My workload pool",
  "description": "Workload identity pool for external workloads.",
  "state": "ACTIVE"
}

REST

El método projects.locations.workloadIdentityPools.get obtiene detalles sobre un grupo de identidades para cargas de trabajo.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo, por ejemplo, my-pool.

Método HTTP y URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
  "displayName": "My workload pool",
  "description": "Workload identity pool for external workloads.",
  "state": "ACTIVE"
}

Actualiza un grupo

Puedes habilitar o inhabilitar un grupo de identidades para cargas de trabajo. También puedes cambiar su nombre visible o descripción.

Para actualizar un grupo de identidades para cargas de trabajo existente, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Grupos de identidades para cargas de trabajo.

    Ir a Grupos de identidades para cargas de trabajo

  2. Busca el grupo de identidades para cargas de trabajo que deseas editar.
  3. Haz clic en el nombre visible del grupo de identidades para cargas de trabajo.
  4. Para editar el nombre visible del grupo de identidades para cargas de trabajo, haz lo siguiente:

    1. En la página Detalles del grupo, junto al nombre visible, haz clic en el ícono Editar.
    2. En el cuadro de diálogo Editar el nombre visible del grupo que aparece, actualiza el nombre visible.
    3. Haz clic en Guardar.
  5. Para inhabilitar o habilitar el grupo de identidades para cargas de trabajo, haz clic en el botón de activación Estado y, luego, en Inhabilitar o Habilitar.
  6. Para editar la descripción, haz lo siguiente:

    1. En Descripción, junto al texto de la descripción, haz clic en Editar.
    2. Actualiza la descripción.
    3. Haz clic en Guardar.

gcloud

El comando gcloud iam workload-identity-pools update actualiza un grupo de identidades para cargas de trabajo existente.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo, por ejemplo, my-pool.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • DISPLAY_NAME: Es un nombre visible para el grupo de identidades para cargas de trabajo, de hasta 32 caracteres, por ejemplo, My updated pool.
  • DESCRIPTION: Es una descripción del grupo de identidades para cargas de trabajo, de hasta 256 caracteres. Para inhabilitar o habilitar el grupo, también pasa la marca --disabled o --no-disabled.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools update POOL_ID \
    --project=PROJECT_ID \
    --location="global" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

Windows (PowerShell)

gcloud iam workload-identity-pools update POOL_ID `
    --project=PROJECT_ID `
    --location="global" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION"

Windows (cmd.exe)

gcloud iam workload-identity-pools update POOL_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION"

Deberías recibir una respuesta similar a la que figura a continuación:

Update request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef] to complete...done.
Updated workloadIdentityPool [my-pool].

REST

El método projects.locations.workloadIdentityPools.patch actualiza un grupo de identidades para cargas de trabajo existente.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo, por ejemplo, my-pool.
  • UPDATE_MASK: Es una lista separada por comas de los campos que se actualizarán, por ejemplo, displayName,description,disabled.
  • DISPLAY_NAME: Es un nombre visible para el grupo de identidades para cargas de trabajo, de hasta 32 caracteres, por ejemplo, My updated pool.
  • DESCRIPTION: Es una descripción del grupo de identidades para cargas de trabajo, de hasta 256 caracteres.
  • DISABLED: Indica si el grupo está inhabilitado. Establece en true para inhabilitar el grupo o en false para habilitarlo.

Método HTTP y URL:

PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID?updateMask=UPDATE_MASK

Cuerpo JSON de la solicitud:

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "disabled": DISABLED
}

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una operación de larga duración que representa tu solicitud. Para verificar si se completó la actualización del grupo, consulta Verifica el estado de una operación de larga duración en esta página.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Borra un grupo

Cuando borras un grupo de identidades para cargas de trabajo, también borras sus proveedores de grupos de identidades para cargas de trabajo. Como resultado, las identidades del grupo pierden el acceso a los recursos de Google Cloud .

Puedes recuperar un grupo hasta 30 días después de borrarlo. Después de 30 días, la eliminación es permanente. Hasta que se borre de forma permanente, no podrás volver a usar su nombre cuando crees un grupo de identidades para cargas de trabajo nuevo.

Para borrar un grupo de identidades para cargas de trabajo y sus IdP, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Grupos de identidades para cargas de trabajo.

    Ir a Grupos de identidades para cargas de trabajo

  2. Busca el grupo de identidades para cargas de trabajo que deseas borrar y, luego, haz clic en su nombre visible.
  3. Haz clic en Borrar grupo y, luego, en Borrar. Se borran el grupo de identidades para cargas de trabajo y sus IdP.

gcloud

El comando gcloud iam workload-identity-pools delete borra un grupo de identidades para cargas de trabajo.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo que deseas borrar, por ejemplo, my-pool.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools delete POOL_ID \
    --project=PROJECT_ID \
    --location="global"

Windows (PowerShell)

gcloud iam workload-identity-pools delete POOL_ID `
    --project=PROJECT_ID `
    --location="global"

Windows (cmd.exe)

gcloud iam workload-identity-pools delete POOL_ID ^
    --project=PROJECT_ID ^
    --location="global"

Deberías recibir una respuesta similar a la que figura a continuación:

Delete request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef] to complete...done.
Deleted workloadIdentityPool [my-pool].

REST

El método projects.locations.workloadIdentityPools.delete borra un grupo de identidades para cargas de trabajo.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo que deseas borrar, por ejemplo, my-pool.

Método HTTP y URL:

DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una operación de larga duración que representa tu solicitud. Para verificar si se completó la eliminación del grupo, consulta Verifica el estado de una operación de larga duración en esta página.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Recupera un grupo

Puedes recuperar un grupo de identidades para cargas de trabajo borrado hasta 30 días después de la eliminación.

Para recuperar un grupo, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Grupos de identidades para cargas de trabajo.

    Ir a Grupos de identidades para cargas de trabajo

  2. Haz clic en el botón de activación Mostrar grupos y proveedores borrados.
  3. Busca el grupo de identidades para cargas de trabajo que deseas recuperar y, luego, haz clic en su ícono Restablecer .
  4. Haz clic en Restablecer. Se restablecen el grupo y sus proveedores.

gcloud

El comando gcloud iam workload-identity-pools undelete restablece un grupo de identidades para cargas de trabajo borrado de forma no definitiva.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo borrado que se restablecerá, por ejemplo, my-pool.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools undelete POOL_ID \
    --project=PROJECT_ID \
    --location="global"

Windows (PowerShell)

gcloud iam workload-identity-pools undelete POOL_ID `
    --project=PROJECT_ID `
    --location="global"

Windows (cmd.exe)

gcloud iam workload-identity-pools undelete POOL_ID ^
    --project=PROJECT_ID ^
    --location="global"

Deberías recibir una respuesta similar a la que figura a continuación:

Undelete request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef] to complete...done.
Undeleted workloadIdentityPool [my-pool].

REST

El método projects.locations.workloadIdentityPools.undelete restablece un grupo de identidades para cargas de trabajo borrado de forma no definitiva.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo borrado que se restablecerá, por ejemplo, my-pool.

Método HTTP y URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID:undelete

Cuerpo JSON de la solicitud:

{}

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una operación de larga duración que representa tu solicitud. Para verificar si se completó el restablecimiento del grupo, consulta Verifica el estado de una operación de larga duración en esta página.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Administra proveedores de grupos de identidades para cargas de trabajo

En esta sección, se muestra cómo administrar los proveedores de grupos de identidades para cargas de trabajo.

Crea un proveedor

Para crear un proveedor de grupos de identidades para cargas de trabajo en un grupo de identidades para cargas de trabajo existente, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Grupos de identidades para cargas de trabajo.

    Ir a Grupos de identidades para cargas de trabajo

  2. Busca el grupo de identidades para cargas de trabajo al que deseas agregar un proveedor y, luego, haz clic en su Nombre visible.
  3. Haz clic en Agregar proveedor.
  4. Selecciona el tipo de proveedor que deseas crear:

    • AWS: Un IdP de Amazon Web Services (AWS).
    • OpenID Connect (OIDC): Es un IdP compatible con OIDC. Esto incluye Microsoft Azure.
  5. Ingresa un nombre para el proveedor.

    La consola de Google Cloud usa el nombre para crear un ID del proveedor. Para cambiar el ID del proveedor, haz clic en Editar. No puedes cambiar el ID del proveedor más adelante.

  6. Completa los campos restantes para tu proveedor:

    • AWS: Ingresa tu ID de cuenta de AWS.
    • OIDC: ingresa la URL de la entidad emisora. Para Azure, la URL de la entidad emisora usa el formato https://sts.windows.net/AZURE_TENANT_ID. Para otros proveedores, consulta la documentación del proveedor.

    Cuando finalices, haz clic en Continuar.

  7. Para configurar la asignación de atributos, haz clic en Editar asignación. La asignación de atributos te permite usar información sobre identidades externas para otorgar acceso a un subconjunto de esas identidades.

  8. Opcional: Para proporcionar una condición de atributo, que especifica las identidades que se pueden autenticar, haz clic en Agregar condición y, luego, ingresa una expresión válida de Common Expression Language (CEL). Para obtener más información, consulta Condiciones de atributos.
  9. Haz clic en Guardar. Se crea el proveedor del grupo de identidades para cargas de trabajo.

gcloud

Crea un proveedor de AWS

El comando gcloud iam workload-identity-pools providers create-aws crea un proveedor de grupos de identidades para cargas de trabajo de AWS.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PROVIDER_ID: Es un ID único para el proveedor, por ejemplo, my-aws-provider. Debe tener entre 4 y 32 caracteres alfanuméricos en minúscula o guiones, y no puede comenzar con gcp-.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo al que se agregará el proveedor, por ejemplo, my-pool.
  • DISPLAY_NAME: Opcional Un nombre visible para el proveedor, de hasta 32 caracteres, por ejemplo, My AWS provider.
  • AWS_ACCOUNT_ID: Es el ID de 12 dígitos de tu cuenta de AWS, por ejemplo, 123456789012.
  • ATTRIBUTE_CONDITION: Opcional Es una expresión de Common Expression Language (CEL) que restringe qué identidades se pueden autenticar, por ejemplo, attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role'.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --account-id="AWS_ACCOUNT_ID" \
    --attribute-condition="ATTRIBUTE_CONDITION"

Windows (PowerShell)

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --account-id="AWS_ACCOUNT_ID" `
    --attribute-condition="ATTRIBUTE_CONDITION"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --account-id="AWS_ACCOUNT_ID" ^
    --attribute-condition="ATTRIBUTE_CONDITION"

Deberías recibir una respuesta similar a la que figura a continuación:

Create request issued for: [my-aws-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef] to complete...done.
Created workloadIdentityPoolProvider [my-aws-provider].

Crea un proveedor de OIDC

El comando gcloud iam workload-identity-pools providers create-oidc crea un proveedor de grupos de identidades para cargas de trabajo de OIDC.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PROVIDER_ID: Es un ID único para el proveedor, por ejemplo, my-oidc-provider. Debe tener entre 4 y 32 caracteres alfanuméricos en minúscula o guiones, y no puede comenzar con gcp-.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo al que se agregará el proveedor, por ejemplo, my-pool.
  • DISPLAY_NAME: Opcional Un nombre visible para el proveedor, de hasta 32 caracteres, por ejemplo, My OIDC provider.
  • ISSUER_URI: Es la URL HTTPS de la entidad emisora de OIDC, por ejemplo, https://idp.example.com o https://sts.windows.net/AZURE_TENANT_ID.
  • DISCOVERY_URI: Opcional. Es la URL desde la que se recuperará el documento de descubrimiento de OIDC, que anula la URL predeterminada de ISSUER_URI/.well-known/openid-configuration, por ejemplo, https://idp.example.com/.well-known/custom-openid-configuration. El esquema, el host y el puerto deben coincidir con ISSUER_URI, y la ruta de acceso debe contener un segmento /.well-known/ seguido de un sufijo no vacío.
  • ATTRIBUTE_CONDITION: Opcional Es una expresión de Common Expression Language (CEL) que restringe qué identidades se pueden autenticar, por ejemplo, assertion.sub.startsWith('repo:my-org/').
  • ACTOR_PROVIDERS: Opcional. Los nombres de recursos completos de hasta tres proveedores de grupos de identidades para cargas de trabajo en el mismo grupo que están autorizados a emitir tokens de actor para este proveedor, por ejemplo, projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider. El identificador del proyecto en cada nombre de recurso debe coincidir con el formato del ID del proyecto o número del proyecto que usas para este proveedor. Para obtener más información, consulta Configura la delegación de identidad y los tokens de actor.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --issuer-uri="ISSUER_URI" \
    --discovery-uri="DISCOVERY_URI" \
    --attribute-mapping="google.subject=assertion.sub" \
    --attribute-condition="ATTRIBUTE_CONDITION" \
    --actor-providers="ACTOR_PROVIDERS"

Windows (PowerShell)

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --issuer-uri="ISSUER_URI" `
    --discovery-uri="DISCOVERY_URI" `
    --attribute-mapping="google.subject=assertion.sub" `
    --attribute-condition="ATTRIBUTE_CONDITION" `
    --actor-providers="ACTOR_PROVIDERS"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --issuer-uri="ISSUER_URI" ^
    --discovery-uri="DISCOVERY_URI" ^
    --attribute-mapping="google.subject=assertion.sub" ^
    --attribute-condition="ATTRIBUTE_CONDITION" ^
    --actor-providers="ACTOR_PROVIDERS"

Deberías recibir una respuesta similar a la que figura a continuación:

Create request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef] to complete...done.
Created workloadIdentityPoolProvider [my-oidc-provider].

REST

Crea un proveedor de AWS

El método projects.locations.workloadIdentityPools.providers.create crea un proveedor de grupos de identidades para cargas de trabajo de AWS.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo al que se agregará el proveedor, por ejemplo, my-pool.
  • PROVIDER_ID: Es un ID único para el proveedor, por ejemplo, my-aws-provider. Debe tener entre 4 y 32 caracteres alfanuméricos en minúscula o guiones, y no puede comenzar con gcp-.
  • DISPLAY_NAME: Opcional Un nombre visible para el proveedor, de hasta 32 caracteres, por ejemplo, My AWS provider.
  • AWS_ACCOUNT_ID: Es el ID de 12 dígitos de tu cuenta de AWS, por ejemplo, 123456789012.
  • ATTRIBUTE_CONDITION: Opcional Es una expresión de Common Expression Language (CEL) que restringe qué identidades se pueden autenticar, por ejemplo, attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role'.

Método HTTP y URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID

Cuerpo JSON de la solicitud:

{
  "displayName": "DISPLAY_NAME",
  "aws": {
    "accountId": "AWS_ACCOUNT_ID"
  },
  "attributeCondition": "ATTRIBUTE_CONDITION"
}

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una operación de larga duración que representa tu solicitud. Para verificar si se completó la creación del proveedor, consulta Verifica el estado de una operación de larga duración en esta página.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Crea un proveedor de OIDC

El método projects.locations.workloadIdentityPools.providers.create crea un proveedor de grupos de identidades para cargas de trabajo de OIDC.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo al que se agregará el proveedor, por ejemplo, my-pool.
  • PROVIDER_ID: Es un ID único para el proveedor, por ejemplo, my-oidc-provider. Debe tener entre 4 y 32 caracteres alfanuméricos en minúscula o guiones, y no puede comenzar con gcp-.
  • DISPLAY_NAME: Opcional Un nombre visible para el proveedor, de hasta 32 caracteres, por ejemplo, My OIDC provider.
  • ISSUER_URI: Es la URL HTTPS de la entidad emisora de OIDC, por ejemplo, https://idp.example.com o https://sts.windows.net/AZURE_TENANT_ID.
  • DISCOVERY_URI: Opcional. Es la URL desde la que se recuperará el documento de descubrimiento de OIDC, que anula la URL predeterminada de ISSUER_URI/.well-known/openid-configuration, por ejemplo, https://idp.example.com/.well-known/custom-openid-configuration. El esquema, el host y el puerto deben coincidir con ISSUER_URI, y la ruta de acceso debe contener un segmento /.well-known/ seguido de un sufijo no vacío.
  • ATTRIBUTE_CONDITION: Opcional Es una expresión de Common Expression Language (CEL) que restringe qué identidades se pueden autenticar, por ejemplo, assertion.sub.startsWith('repo:my-org/').
  • ACTOR_PROVIDERS: Opcional. Los nombres de recursos completos de hasta tres proveedores de grupos de identidades para cargas de trabajo en el mismo grupo que están autorizados a emitir tokens de actor para este proveedor, por ejemplo, projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider. El identificador del proyecto en cada nombre de recurso debe coincidir con el formato del ID del proyecto o número del proyecto que usas para este proveedor. Para obtener más información, consulta Configura la delegación de identidad y los tokens de actor.

Método HTTP y URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID

Cuerpo JSON de la solicitud:

{
  "displayName": "DISPLAY_NAME",
  "oidc": {
    "issuerUri": "ISSUER_URI",
    "discoveryUri": "DISCOVERY_URI"
  },
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "attributeCondition": "ATTRIBUTE_CONDITION",
  "actorProviders": [
    "ACTOR_PROVIDERS"
  ]
}

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una operación de larga duración que representa tu solicitud. Para verificar si se completó la creación del proveedor, consulta Verifica el estado de una operación de larga duración en esta página.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Enumerar proveedores

Para enumerar los proveedores de grupos de identidades para cargas de trabajo de un proyecto, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Grupos de identidades para cargas de trabajo.

    Ir a Grupos de identidades para cargas de trabajo

  2. Si quieres ver los proveedores de un grupo de identidades para cargas de trabajo, haz clic en el ícono Expandir nodo para el grupo.

gcloud

El comando gcloud iam workload-identity-pools providers list enumera los proveedores de un grupo de identidades para cargas de trabajo.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo cuyos proveedores deseas enumerar, por ejemplo, my-pool. Para incluir proveedores borrados de forma no definitiva en el resultado, agrega la marca --show-deleted.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers list \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools providers list `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers list ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --format="json"

Deberías recibir una respuesta similar a la que figura a continuación:

[
  {
    "attributeMapping": {
      "google.subject": "assertion.sub"
    },
    "displayName": "My OIDC provider",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
    "oidc": {
      "issuerUri": "https://idp.example.com"
    },
    "state": "ACTIVE"
  }
]

REST

El método projects.locations.workloadIdentityPools.providers.list enumera los proveedores de un grupo de identidades para cargas de trabajo.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo cuyos proveedores deseas enumerar, por ejemplo, my-pool. Para incluir proveedores borrados de forma no definitiva en la respuesta, agrega ?showDeleted=true a la URL de la solicitud.

Método HTTP y URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "workloadIdentityPoolProviders": [
    {
      "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
      "displayName": "My OIDC provider",
      "state": "ACTIVE",
      "attributeMapping": {
        "google.subject": "assertion.sub"
      },
      "oidc": {
        "issuerUri": "https://idp.example.com"
      }
    }
  ]
}

Obtén un proveedor

Para obtener detalles sobre un proveedor de grupos de identidades para cargas de trabajo específico, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Grupos de identidades para cargas de trabajo.

    Ir a Grupos de identidades para cargas de trabajo

  2. Busca el grupo de identidades para cargas de trabajo que contiene el proveedor y, luego, haz clic en el ícono Expandir nodo para el grupo.
  3. Busca el proveedor de grupos de identidades para cargas de trabajo que deseas visualizar y, luego, haz clic en el ícono Editar . En la consola de Google Cloud , se muestra información detallada sobre el proveedor.

gcloud

El comando gcloud iam workload-identity-pools providers describe obtiene detalles sobre un proveedor de grupos de identidades para cargas de trabajo.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PROVIDER_ID: Es el ID del proveedor del grupo de identidades para cargas de trabajo, por ejemplo, my-oidc-provider.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo que contiene el proveedor, por ejemplo, my-pool.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers describe PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools providers describe PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers describe PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --format="json"

Deberías recibir una respuesta similar a la que figura a continuación:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
  "displayName": "My OIDC provider",
  "state": "ACTIVE",
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "oidc": {
    "issuerUri": "https://idp.example.com"
  }
}

REST

El método projects.locations.workloadIdentityPools.providers.get obtiene detalles sobre un proveedor de grupos de identidades para cargas de trabajo.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo que contiene el proveedor, por ejemplo, my-pool.
  • PROVIDER_ID: Es el ID del proveedor del grupo de identidades para cargas de trabajo, por ejemplo, my-oidc-provider.

Método HTTP y URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
  "displayName": "My OIDC provider",
  "state": "ACTIVE",
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "oidc": {
    "issuerUri": "https://idp.example.com"
  }
}

Actualiza un proveedor

Puedes habilitar o inhabilitar un proveedor de grupos de identidades para cargas de trabajo. También puedes actualizar la información de la cuenta y su asignación de atributos, además del nombre visible y la descripción.

Para actualizar un proveedor de grupos de identidades para cargas de trabajo existente, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Grupos de identidades para cargas de trabajo.

    Ir a Grupos de identidades para cargas de trabajo

  2. Busca el grupo de identidades para cargas de trabajo que contiene el proveedor y, luego, haz clic en el ícono Expandir nodo para el grupo.

  3. Busca el proveedor de grupos de identidades para cargas de trabajo que deseas editar y, luego, haz clic en su ícono Editar.

  4. Edita la información del proveedor y, luego, haz clic en Guardar.

gcloud

Actualiza un proveedor de AWS

El comando gcloud iam workload-identity-pools providers update-aws actualiza un proveedor de grupos de identidades para cargas de trabajo de AWS existente.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PROVIDER_ID: Es el ID del proveedor que se actualizará, por ejemplo, my-aws-provider.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo que contiene el proveedor, por ejemplo, my-pool.
  • DISPLAY_NAME: Es un nombre visible para el proveedor, de hasta 32 caracteres, por ejemplo, Updated AWS provider.
  • DESCRIPTION: Es una descripción del proveedor, de hasta 256 caracteres. Para inhabilitar o habilitar el proveedor, también pasa la marca --disabled o --no-disabled.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

Windows (PowerShell)

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION"

Deberías recibir una respuesta similar a la que figura a continuación:

Update request issued for: [my-aws-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef] to complete...done.
Updated workloadIdentityPoolProvider [my-aws-provider].

Actualiza un proveedor de OIDC

El comando gcloud iam workload-identity-pools providers update-oidc actualiza un proveedor de grupos de identidades para cargas de trabajo de AWS existente.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PROVIDER_ID: Es el ID del proveedor de OIDC que se actualizará, por ejemplo, my-oidc-provider.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo que contiene el proveedor, por ejemplo, my-pool.
  • DISPLAY_NAME: Es un nombre visible para el proveedor, de hasta 32 caracteres, por ejemplo, Updated OIDC provider.
  • DESCRIPTION: Es una descripción del proveedor, de hasta 256 caracteres.
  • ISSUER_URI: Es la URL HTTPS de la entidad emisora de OIDC, por ejemplo, https://idp.example.com. Para inhabilitar o habilitar el proveedor, también pasa la marca --disabled o --no-disabled.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION" \
    --issuer-uri="ISSUER_URI"

Windows (PowerShell)

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION" `
    --issuer-uri="ISSUER_URI"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION" ^
    --issuer-uri="ISSUER_URI"

Deberías recibir una respuesta similar a la que figura a continuación:

Update request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000013-0123456789abcdef] to complete...done.
Updated workloadIdentityPoolProvider [my-oidc-provider].

REST

El método projects.locations.workloadIdentityPools.providers.patch actualiza un proveedor de grupos de identidades para cargas de trabajo existente.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo que contiene el proveedor, por ejemplo, my-pool.
  • PROVIDER_ID: Es el ID del proveedor que se actualizará, por ejemplo, my-aws-provider.
  • UPDATE_MASK: Es una lista separada por comas de los campos que se actualizarán, por ejemplo, displayName,description,disabled.
  • DISPLAY_NAME: Es un nombre visible para el proveedor, de hasta 32 caracteres, por ejemplo, Updated AWS provider.
  • DESCRIPTION: Es una descripción del proveedor, de hasta 256 caracteres.
  • DISABLED: Indica si el proveedor está inhabilitado. Establece true para inhabilitar el proveedor o false para habilitarlo.

Método HTTP y URL:

PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID?updateMask=UPDATE_MASK

Cuerpo JSON de la solicitud:

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "disabled": DISABLED
}

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una operación de larga duración que representa tu solicitud. Para verificar si se completó la actualización del proveedor, consulta Verifica el estado de una operación de larga duración en esta página.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Borra un proveedor

Cuando borras un proveedor de grupos de identidades para cargas de trabajo, las identidades del proveedor pierden el acceso a los recursos de Google Cloud .

Puedes recuperar un proveedor hasta 30 días después de borrarlo. Después de 30 días, la eliminación es permanente. Hasta que se borre de forma permanente un proveedor, no podrás volver a usar su nombre cuando crees uno nuevo.

Para borrar un proveedor de grupos de identidades para cargas de trabajo, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Grupos de identidades para cargas de trabajo.

    Ir a Grupos de identidades para cargas de trabajo

  2. Busca el grupo de identidades para cargas de trabajo que contiene el proveedor y, luego, haz clic en su nombre visible.

  3. En el panel Proveedores, busca el proveedor que deseas borrar y haz clic en el ícono Borrar .

  4. Haz clic en Delete para borrar el proveedor.

gcloud

El comando gcloud iam workload-identity-pools providers delete borra un proveedor de grupos de identidades para cargas de trabajo.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PROVIDER_ID: Es el ID del proveedor de grupos de identidades para cargas de trabajo que se borrará, por ejemplo, my-oidc-provider.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo que contiene el proveedor, por ejemplo, my-pool.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers delete PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID"

Windows (PowerShell)

gcloud iam workload-identity-pools providers delete PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers delete PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID"

Deberías recibir una respuesta similar a la que figura a continuación:

Delete request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef] to complete...done.
Deleted workloadIdentityPoolProvider [my-oidc-provider].

REST

El método projects.locations.workloadIdentityPools.providers.delete borra un proveedor de grupos de identidades para cargas de trabajo.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo que contiene el proveedor, por ejemplo, my-pool.
  • PROVIDER_ID: Es el ID del proveedor de grupos de identidades para cargas de trabajo que se borrará, por ejemplo, my-oidc-provider.

Método HTTP y URL:

DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una operación de larga duración que representa tu solicitud. Para verificar si se completó la eliminación del proveedor, consulta Verifica el estado de una operación de larga duración en esta página.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Recupera un proveedor

Puedes recuperar un proveedor de grupos de identidades para cargas de trabajo borrado hasta 30 días después de la eliminación. Para recuperar un proveedor, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página Grupos de identidades para cargas de trabajo.

    Ir a Grupos de identidades para cargas de trabajo

  2. Haz clic en el botón de activación Mostrar grupos y proveedores borrados.

  3. Busca el grupo de identidades para cargas de trabajo que contiene el proveedor y, luego, haz clic en el ícono Expandir nodo para el grupo.

  4. Busca el proveedor que quieras recuperar y, luego, haz clic en su ícono Restablecer .

  5. Haz clic en Restore. Se restablecerá el proveedor.

gcloud

El comando gcloud iam workload-identity-pools providers undelete restablece un proveedor de grupos de identidades para cargas de trabajo borrado de forma no definitiva.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PROVIDER_ID: Es el ID del proveedor de grupos de identidades para cargas de trabajo borrado que se restablecerá, por ejemplo, my-oidc-provider.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo que contiene el proveedor, por ejemplo, my-pool.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers undelete PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID"

Windows (PowerShell)

gcloud iam workload-identity-pools providers undelete PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers undelete PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID"

Deberías recibir una respuesta similar a la que figura a continuación:

Undelete request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef] to complete...done.
Undeleted workloadIdentityPoolProvider [my-oidc-provider].

REST

El método projects.locations.workloadIdentityPools.providers.undelete restablece un proveedor de grupos de identidades para cargas de trabajo borrado de forma no definitiva.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud . Los IDs de proyecto son cadenas alfanuméricas, como my-project.
  • POOL_ID: Es el ID del grupo de identidades para cargas de trabajo que contiene el proveedor, por ejemplo, my-pool.
  • PROVIDER_ID: Es el ID del proveedor de grupos de identidades para cargas de trabajo borrado que se restablecerá, por ejemplo, my-oidc-provider.

Método HTTP y URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID:undelete

Cuerpo JSON de la solicitud:

{}

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una operación de larga duración que representa tu solicitud. Para verificar si se completó el restablecimiento del proveedor, consulta Verifica el estado de una operación de larga duración en esta página.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Revisa el estado de una operación de larga duración

Cuando usas la API de REST, cualquier método que cree, actualice, borre o restablezca un grupo o proveedor de identidades para cargas de trabajo devuelve una operación de larga duración (LRO). La operación de larga duración realiza un seguimiento del estado de la solicitud y también indica si se completó el cambio.

gcloud

El comando gcloud iam workload-identity-pools operations describe devuelve el estado de una operación de larga duración.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • OPERATION_NAME: Es el nombre completo del recurso de la operación del campo name de la respuesta original:

    • Operaciones de grupos: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID
    • Operaciones del proveedor: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID

    Para las operaciones del proveedor, ejecuta el comando gcloud iam workload-identity-pools providers operations describe en su lugar.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Windows (PowerShell)

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Windows (cmd.exe)

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Deberías recibir una respuesta similar a la que figura a continuación:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "displayName": "My workload pool",
    "description": "Workload identity pool for external workloads.",
    "state": "ACTIVE"
  }
}

REST

El método projects.locations.workloadIdentityPools.operations.get muestra el estado de una operación de larga duración.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • OPERATION_NAME: Es el nombre completo del recurso de la operación del campo name de la respuesta original:

    • Operaciones de grupos: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID
    • Operaciones del proveedor: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID

Método HTTP y URL:

GET https://iam.googleapis.com/v1/OPERATION_NAME

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "displayName": "My workload pool",
    "description": "Workload identity pool for external workloads.",
    "state": "ACTIVE"
  }
}

Si el campo done de la operación es false o se omite, sigue supervisando su estado obteniendo la operación de forma repetida. Usa la retirada exponencial truncada para introducir un retraso entre las solicitudes. Cuando el campo done se establece como true, la operación está completa.

Administra las restricciones de la federación de identidades para cargas de trabajo

Puedes usar las restricciones de la política de la organización para restringir cómo se pueden usar los recursos en tu organización de Google Cloud .

En esta sección, se describen las restricciones que se recomiendan cuando usas la federación de identidades para cargas de trabajo.

Administra los IdP permitidos

Como administrador de la organización, puedes decidir con qué IdP se puede federar tu organización.

Para administrar qué IdP están permitidos, habilita la restricción de lista constraints/iam.workloadIdentityPoolProviders en la política de la organización. Esta restricción especifica los URI de la entidad emisora de los proveedores permitidos. Puedes usar la consola deGoogle Cloud o Google Cloud CLI para habilitar esta restricción.

Para permitir solo la federación desde AWS, crea una sola restricción con el URI https://sts.amazonaws.com. En el siguiente ejemplo, se muestra cómo crear esta restricción con gcloud CLI:

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     https://sts.amazonaws.com --organization=ORGANIZATION_NUMBER

También puedes especificar qué IDs de cuentas de AWS tienen acceso a tus recursos deGoogle Cloud . Para especificar los IDs de cuenta, usa la restricción de lista constraints/iam.workloadIdentityPoolAwsAccounts:

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolAwsAccounts \
    ACCOUNT_ID --organization=ORGANIZATION_NUMBER

Para permitir solo la federación de un proveedor de OIDC, crea una sola restricción con el issuer_uri del proveedor permitido. Por ejemplo, lo siguiente solo permite la federación de un usuario específico de Azure:

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     https://sts.windows.net/AZURE_TENANT_ID --organization=ORGANIZATION_NUMBER

La federación desde un IdP de SAML es especial porque las claves públicas que se usan para validar la aserción se proporcionan cuando se configura el IdP de SAML. Como resultado, es posible que un usuario malicioso intente subir un documento de metadatos de SAML con el ID de la entidad del IdP de tu organización con una clave pública. La restricción de la federación con un ID de la entidad en esta situación solo da como resultado una ilusión de seguridad.

Para mitigar este riesgo, te recomendamos que solo permitas que se cree un grupo de identidades para cargas de trabajo con la federación de SAML en un proyecto de Google Cloud que tu organización administre de forma centralizada. Luego, según sea necesario, otorga a las identidades externas en ese grupo de identidades para cargas de trabajo acceso a los recursos de toda tu organización.

Para permitir la federación desde los IdP de SAML, crea una restricción que permita la palabra clave especial KEY_UPLOAD.

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     KEY_UPLOAD --organization=ORGANIZATION_NUMBER

Puedes repetir estos comandos para permitir la federación de proveedores adicionales.

Para bloquear la federación de todos los proveedores, sigue estos pasos:

  1. Crea un archivo YAML que contenga lo siguiente:

    constraint: constraints/iam.workloadIdentityPoolProviders
    listPolicy:
      allValues: DENY
  2. Pasa el archivo al comando gcloud resource-manager org-policies set-policy:

    gcloud resource-manager org-policies set-policy FILE_NAME.yaml \
        --organization=ORGANIZATION_NUMBER

Restringe la creación de claves de cuentas de servicio

La federación de identidades para cargas de trabajo te permite acceder a los recursos de Google Cloud desde fuera de Google Cloud sin usar una clave de cuenta de servicio. Si nunca usas las claves de la cuenta de servicio para la autenticación, puedes ayudar a reducir el riesgo mediante la inhabilitación de la creación de claves.

Para inhabilitar la creación de claves de cuentas de servicio, aplica la restricción booleana iam.disableServiceAccountKeyCreation en la política de la organización. También puedes aplicar la restricción booleana iam.disableServiceAccountKeyUpload, que inhabilita la carga de claves públicas para las cuentas de servicio.

Puedes usar la consola deGoogle Cloud o la gcloud CLI para habilitar estas restricciones. Por ejemplo, los siguientes comandos de la gcloud CLI habilitan ambas restricciones:

gcloud resource-manager org-policies enable-enforce \
    constraints/iam.disableServiceAccountKeyCreation \
    --organization=ORGANIZATION_NUMBER
gcloud resource-manager org-policies enable-enforce \
    constraints/iam.disableServiceAccountKeyUpload \
    --organization=ORGANIZATION_NUMBER

Supervisa la federación de identidades para cargas de trabajo

Puedes usar las métricas de Cloud Monitoring para supervisar los eventos de autenticación de tus proveedores y grupo de identidades para cargas de trabajo. Para obtener una lista de las métricas disponibles, consulta Métricas de IAM.

¿Qué sigue?

Obtén más información sobre la federación de identidades para cargas de trabajo.