Autenticación de Gmail

Requisitos previos

Dependiendo del tipo de autenticación que selecciones, necesitarás una de las siguientes credenciales:

• Código de autorización OAuth 2.0: tu dirección de correo electrónico de Google y la contraseña asociada a tu cuenta de Google.
• Trae tu propia aplicación OAuth 2.0: el ID de cliente y el secreto de cliente de tu aplicación, y los ámbitos.
• Cuenta de servicio: clave de cuenta de servicio, correo electrónico de la cuenta.

Si Google no ha habilitado su cuenta:

• Comuníquese con su administrador para obtener aprobaciones sobre la creación de conexiones.
• Habilite el permiso marcando las opciones disponibles para permitir la creación de una conexión.

Nota:

Para obtener más información sobre los diferentes tipos de autenticación, consulta la guía Cómo conectarse a las actividades de Google Workspace 365 .

Para obtener más información sobre Gmail, visita el sitio web de documentación de Gmail .

Ámbitos

El conector solicita los siguientes permisos/ámbitos:

• Ámbitos predeterminados de la aplicación pública de UiPath: openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, https://mail.google.com/, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/gmail.settings.basic.
• Ámbitos predeterminados de la cuenta de servicio de Google: openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, https://mail.google.com/, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/gmail.settings.basic.
• Traiga su propia aplicación OAuth 2.0:
  • Ámbitos obligatorios: openid, https://www.googleapis.com/auth/userinfo.email, https://mail.google.com/
  • Ámbitos mínimos para crear una conexión: openid, https://www.googleapis.com/auth/gmail.readonly.
  • Lista mínima de ámbitos necesarios para los desencadenadores de Gmail:
    • openid, https://www.googleapis.com/auth/gmail.readonly : para eventos en buzones.
    • openid, https://www.googleapis.com/auth/calendar.readonly : para eventos en calendarios.

Nota:

Si te autenticas utilizando Trae tu propia aplicación OAuth 2.0, te beneficiarás de forma predeterminada de los ámbitos configurados en la creación de la aplicación. Si quieres utilizar los permisos de aplicación predeterminados, puedes declarar un ámbito common . Esto significa que solo utilizas los permisos configurados para esa aplicación. También puedes declarar ámbitos adicionales en la creación de la conexión, utilizando el campo Ámbitos . A continuación, se te pedirá que concedas el consentimiento adicional durante el inicio de sesión.

La conexión permite que los productos de UiPath interactúen con los datos de Gmail en su nombre. Esto puede incluir leer, escribir, modificar y eliminar datos, dependiendo de tus permisos de Gmail. Siempre puedes eliminar cualquier acceso en tu cuenta de Google.

Configurar un proyecto de Google Cloud

Nota:

Esta sección solo se aplica si utilizas el tipo de autenticación Trae tu propia aplicación OAuth 2.0 . Si utilizas el código de autorización OAuth 2.0, pasa a Añadir la conexión de Gmail.

Antes de crear una conexión utilizando Trae tu propia aplicación OAuth 2.0, configura un proyecto de Google Cloud para autorizar la comunicación OAuth con Gmail.

1. Ve a Google Cloud Console y crea un proyecto o selecciona uno existente. Rellena los detalles básicos del proyecto y selecciona Guardar y continuar.
2. En el menú de navegación, selecciona API y servicios y luego Biblioteca.
3. Busca API de Gmail y selecciona Habilitar.
4. Selecciona Credenciales, luego +Crear credenciales y luego ID de cliente OAuth.
5. En Tipo de aplicación, selecciona Aplicación web e introduce un nombre.
6. En URI de redireccionamiento autorizados, https://{baseURL}/provisioning_/callback y luego selecciona Crear.
7. Guarda el ID de cliente y el Secreto de cliente en una ubicación segura.
8. Selecciona la pantalla de consentimiento de OAuth y configura los ajustes de la aplicación. Que la aplicación sea interna o externa depende de la política de seguridad de tu organización.
9. Selecciona Editar aplicación, ve a la sección Ámbitos y luego selecciona Añadir o eliminar ámbitos.
10. Busca correo y selecciona los ámbitos de la API de Gmail adecuados. Consulta la sección Ámbitos para conocer el conjunto mínimo necesario. Si añades ámbitos para API adicionales, como Google Drive, asegúrate de que cumplen con las políticas de tu empresa.
11. Guarda tus cambios. Si tu aplicación es Externa, puedes añadir usuarios de prueba en el paso Usuarios de prueba antes de volver al panel del proyecto.

Tu ID de cliente y Secreto de cliente ya están listos para utilizarse al crear la conexión de Gmail en Integration Service.

Nota:

Para gestionar las restricciones de acceso a la API o los permisos de la aplicación a nivel de organización, consulta la documentación de Apps personalizadas y de terceros de Google.

Añadir la conexión de Gmail

1. Selecciona Orchestrator en el lanzador de productos.

2. Selecciona una carpeta y luego navega a la pestaña Conexiones .

3. Selecciona Añadir conexión.

4. Para abrir la página de creación de conexiones, selecciona el conector de la lista. Puedes utilizar la barra de búsqueda para encontrar el conector.

5. Selecciona tu tipo de autenticación preferido.

   Si seleccionas Trae tu propia aplicación OAuth 2.0, selecciona el icono del engranaje y luego selecciona Trae tu propia aplicación OAuth 2.0 y proporciona el ID de cliente y el Secreto de cliente de la configuración de tu proyecto de Google Cloud. También debes proporcionar los ámbitos necesarios para las actividades que planeas utilizar. Consulta la documentación de cada actividad para saber qué ámbitos requiere.

6. Introduce las credenciales necesarias y selecciona Conectar.

   Para cualquier campo de tipo secreto, puedes seleccionar el menú junto al campo y elegir Usar activo de credenciales para hacer referencia a un activo de credenciales de Orchestrator vinculado a un almacén externo en lugar de introducir el valor directamente. Para obtener más información, consulta Usar activos de credenciales para las conexiones.

Utilizar la conexión en Studio Desktop

Después de crear una conexión de Gmail en Integration Service, configura tu automatización de Studio o StudioX para utilizarla.

1. En Studio, abre Gestionar paquetes e instala el paquete de Google Workspace .

2. En tu automatización, puedes añadir actividades de Gmail seleccionando Instalado, luego Integraciones, Google, Workspace y luego seleccionando Gmail.

   Nota:

   Utiliza las actividades de Gmail de la sección Integraciones en lugar de la actividad heredada Usar Gmail . La actividad heredada no admite conexiones de Integration Service y está limitada a una sola cuenta de usuario codificada.

3. En las propiedades de cada actividad, selecciona la conexión de Gmail que creaste en Integration Service.

Si no se habilitaron todos los ámbitos de Gmail en tu proyecto de Google Cloud, algunas actividades pueden fallar. Consulta la documentación de cada actividad para conocer sus ámbitos necesarios.

Traiga su propia aplicación OAuth 2.0

En Integration Service, al crear una conexión a uno de nuestros conectores basados en la API de Google, puedes elegir entre dos opciones de autenticación:

• Código de autorización OAuth 2.0 : se conecta a la aplicación pública de UiPath.
• Trae tu propia aplicación OAuth 2.0 : se conecta a una aplicación privada de Google Cloud que crees.

Configurar ámbitos

Al crear una conexión utilizando Trae tu propia aplicación OAuth 2.0, tienes la opción de personalizar los ámbitos de la aplicación.

Actualizar tokens para aplicaciones OAuth

Google tiene limitaciones de token de actualización para los ID de cliente OAuth 2.0 individuales. Si se alcanza el límite, la creación de un nuevo token de actualización invalida automáticamente el token de actualización más antiguo sin previo aviso. Este límite no se aplica a las cuentas de servicio (consulta Uso de OAuth 2.0 para aplicaciones de servidor a servidor). Para obtener más información, consulta la documentación oficial de Google.

Una lista de razones que pueden causar la caducidad del token:

• Ha revocado el acceso de su aplicación.
• El token de actualización no se ha utilizado durante seis meses.
• Debes cambiar las contraseñas y el token de actualización contiene ámbitos de Gmail.
• Su cuenta ha superado el número máximo de tokens de actualización (activos) concedidos.
  • Si solicitas un nuevo token después de haber superado el límite, tu antigua conexión, basada en un token previamente concedido, caducará. Solo funcionará la nueva conexión o la última conexión editada/reautenticada (con el token más reciente).
• Un administrador ha establecido cualquiera de los servicios solicitados en los ámbitos de su aplicación como Restringido (el error es admin_policy_enforced).
• Para las API de Google Cloud Platform: la duración de la sesión establecida por el administrador podría haberse superado.

Nota:

El límite está actualmente establecido en 100 tokens de actualización por cuenta de Google por ID de cliente OAuth 2.0. Este número puede estar sujeto a cambios. Para obtener la información más reciente, consulta siempre la documentación de Google.

Hay un límite mayor en el número total de tokens de actualización que una cuenta de usuario o de servicio puede tener en todos los clientes. Los usuarios habituales no superarán este límite, pero una cuenta de desarrollador utilizada para probar una implementación podría hacerlo.

Para asegurarse de que no se supere este límite, UiPath ofrece a los usuarios la posibilidad de crear sus propias aplicaciones OAuth y conectarse utilizando el tipo de autenticación Trae tu propia aplicación. Asegúrate de seguir las mejores prácticas de Google al crear tu aplicación OAuth. Para obtener más información sobre cómo crear una aplicación OAuth, consulta la documentación oficial de Google.

Nota:

La invalidación del token da como resultado conexiones fallidas y las automatizaciones no pueden ejecutarse sin reparar las conexiones.