Los proveedores de autenticación de identidad del agente te permiten almacenar y administrar las claves de API y las credenciales de OAuth que usan tus agentes para autenticarse en herramientas y servicios externos. En el administrador de autenticación de Agent Identity, puedes editar los detalles de los proveedores, habilitarlos o inhabilitarlos, o borrarlos y restablecerlos a medida que cambien tus requisitos de acceso.
Antes de comenzar
- Verifica que hayas elegido el método de autenticación correcto.
- 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 de
editor de conectores de IAM (roles/iamconnectors.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 requeridos:
Permisos necesarios
Se requieren los siguientes permisos para administrar los proveedores de autenticación de Agent Identity:
-
iamconnectors.connectors.update -
iamconnectors.connectors.delete
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Cómo editar un proveedor de autenticación
Para actualizar la descripción o los detalles de autenticación de un proveedor de autenticación, usa la consola deGoogle Cloud o Google Cloud CLI.
Console
-
En la consola de Google Cloud , ve a la página Registro de agentes.
- Haz clic en el nombre del agente cuyo proveedor de autenticación quieres administrar.
- Haz clic en Identidad.
- En la sección Proveedores de autenticación, busca el proveedor de autenticación que deseas administrar.
- En el caso de tu proveedor de autenticación, haz clic en el menú Acciones y selecciona Editar.
- Actualiza la descripción o los detalles de autenticación según sea necesario.
- Haz clic en Guardar.
Google Cloud CLI
-
Para actualizar un proveedor de autenticación, ejecuta el siguiente comando:
gcloud alpha agent-identity connectors 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: Es el nombre del proveedor de autenticación.LOCATION: Es la ubicación del proveedor de autenticación.NEW_DESCRIPTION: Es una descripción nueva para el proveedor de autenticación.NEW_CLIENT_ID: Es un ID de cliente nuevo de tu aplicación de terceros.NEW_CLIENT_SECRET: Es un secreto del cliente nuevo de tu aplicación de terceros.NEW_ENDPOINT: Es una URL nueva del servidor de autorización de terceros.
Habilita o inhabilita un proveedor de autenticación
Si quieres impedir temporalmente que un agente use un proveedor de autenticación sin borrarlo, puedes inhabilitarlo. Puedes volver a habilitarla en cualquier momento.
Console
-
En la consola de Google Cloud , ve a la página Registro de agentes.
- Haz clic en el nombre del agente cuyo proveedor de autenticación quieres administrar.
- Haz clic en Identidad.
- En la sección Proveedores de autenticación, busca el proveedor de autenticación que deseas administrar.
- Para tu proveedor de autenticación, haz clic en Acciones y selecciona Habilitar o Inhabilitar.
- En el diálogo de confirmación, haz clic en Habilitar o Inhabilitar.
Google Cloud CLI
-
Para habilitar un proveedor de autenticación, ejecuta el siguiente comando:
gcloud alpha agent-identity connectors update
AUTH_PROVIDER_NAME\ --location="LOCATION" \ --state=enabled -
Para inhabilitar un proveedor de autenticación, ejecuta el siguiente comando:
gcloud alpha agent-identity connectors update
AUTH_PROVIDER_NAME\ --location="LOCATION" \ --state=disabled
Reemplaza lo siguiente:
AUTH_PROVIDER_NAME: Es el nombre del proveedor de autenticación.LOCATION: Es 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 inhabilitará y se colocará en un estado de borrado no definitivo 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 que se borre su política, momento en el que puedes crear un proveedor de autenticación con el mismo nombre.
Console
-
En la consola de Google Cloud , ve a la página Registro de agentes.
- Haz clic en el nombre del agente cuyo proveedor de autenticación quieres administrar.
- Haz clic en Identidad.
- En la sección Proveedores de autenticación, busca el proveedor de autenticación que deseas administrar.
- En el caso de tu proveedor de autenticación, haz clic en Acciones y selecciona Borrar.
- En el diálogo de confirmación, haz clic en Borrar.
gcloud
-
Para borrar un proveedor de autenticación, ejecuta el siguiente comando:
gcloud alpha agent-identity connectors delete
AUTH_PROVIDER_NAME\ --location="LOCATION"
Reemplaza lo siguiente:
AUTH_PROVIDER_NAME: Es el nombre del proveedor de autenticación.LOCATION: Es 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 borrado no definitivo en un plazo de 30 días a partir 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 que se borre su política. En ese momento, puedes crear un proveedor de autenticación con el mismo nombre.
Console
-
En la consola de Google Cloud , ve a la página Registro de agentes.
- Haz clic en el nombre del agente cuyo proveedor de autenticación quieres administrar.
- Haz clic en Identidad.
- En la sección Proveedores de autenticación, busca el proveedor de autenticación que deseas administrar.
- En el proveedor de autenticación, haz clic en Acciones y selecciona Restablecer.
- En el cuadro de diálogo de confirmación, haz clic en Restablecer.
gcloud
-
Para restablecer un proveedor de autenticación, ejecuta el siguiente comando:
gcloud alpha agent-identity connectors undelete
AUTH_PROVIDER_NAME\ --location="LOCATION"
Reemplaza lo siguiente:
AUTH_PROVIDER_NAME: Es el nombre del proveedor de autenticación.LOCATION: Es la ubicación del proveedor de autenticación.
¿Qué sigue?
- Autentica con OAuth de 2 segmentos con el administrador de autenticación
- Autentica con OAuth de 3 segmentos con el administrador de autenticación
- Autentica con la clave de API con el administrador de autenticación
- Descripción general de la identidad del agente
- Soluciona problemas del administrador de autenticación de Agent Identity