Administra proveedores de autenticación de identidad del agente

En el administrador de autenticación de Agent Identity, puedes administrar los proveedores de autenticación editando sus detalles, habilitándolos o inhabilitándolos, o bien borrándolos y restableciéndolos según sea necesario.

Antes de comenzar

  1. Verifica que hayas elegido el método de autenticación correcto.
  2. Verifica que tengas los roles necesarios para completar esta tarea.

Roles obligatorios

Para obtener los permisos que necesitas para administrar los proveedores de autenticación de Agent Identity, pídele a tu administrador que te otorgue el rol de IAM Editor de Agent Identity (roles/agentidentity.editor) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para administrar los proveedores de autenticación de Agent Identity. Para ver los permisos exactos que son necesarios, expande la sección Permisos necesarios:

Permisos necesarios

Se requieren los siguientes permisos para administrar los proveedores de autenticación de Agent Identity:

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

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

Edita un proveedor de autenticación

Para actualizar la descripción o los detalles de autenticación de un proveedor de autenticación, usa la Google Cloud consola o Google Cloud CLI.

Para actualizar un proveedor de autenticación, ejecuta el siguiente comando:

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"

Reemplaza lo siguiente:

  • AUTH_PROVIDER_NAME: El nombre del proveedor de autenticación.
  • LOCATION: La ubicación del proveedor de autenticación.
  • NEW_DESCRIPTION: Una nueva descripción para el proveedor de autenticación.
  • NEW_CLIENT_ID: Un nuevo ID de cliente de tu aplicación de terceros.
  • NEW_CLIENT_SECRET: Un nuevo secreto del cliente de tu aplicación de terceros.
  • NEW_ENDPOINT: Una nueva URL del servidor de autorización de terceros.

Habilita o inhabilita un proveedor de autenticación

Si quieres evitar temporalmente que un agente use un proveedor de autenticación sin borrarlo, puedes inhabilitarlo. Puedes volver a habilitarlo en cualquier momento.

  1. Para habilitar un proveedor de autenticación, ejecuta el siguiente comando:

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

  2. Para inhabilitar un proveedor de autenticación, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • AUTH_PROVIDER_NAME: El nombre del proveedor de autenticación.
  • LOCATION: La ubicación del proveedor de autenticación.

Borra un proveedor de autenticación

Cuando ya no necesites un proveedor de autenticación, puedes borrarlo. Si borras un proveedor de autenticación, se inhabilita y se coloca en un estado de eliminación no definitiva durante 30 días. Durante este período, puedes restablecer el proveedor de autenticación si lo deseas. Después de 30 días, se necesita un día adicional para purgar su política, momento en el que puedes crear un proveedor de autenticación con el mismo nombre.

Para borrar un proveedor de autenticación, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • AUTH_PROVIDER_NAME: El nombre del proveedor de autenticación.
  • LOCATION: La ubicación del proveedor de autenticación.

Restablece un proveedor de autenticación borrado

Si borras un proveedor de autenticación por accidente, puedes restablecerlo desde su estado de eliminación no definitiva en un plazo de 30 días después de la eliminación. Durante este período, puedes restablecer el proveedor de autenticación si lo deseas. Después de 30 días, se necesita un día adicional para purgar su política, momento en el que puedes crear un proveedor de autenticación con el mismo nombre.

Para restablecer un proveedor de autenticación, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • AUTH_PROVIDER_NAME: El nombre del proveedor de autenticación.
  • LOCATION: La ubicación del proveedor de autenticación.

¿Qué sigue?