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.

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: 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 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 tu 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.

Añadir la conexión de Gmail

1. Selecciona Integration Service en Sector público de Automation Cloud^TM .

2. En la lista Conectores , selecciona Gmail. También puedes utilizar la barra de búsqueda para encontrar el conector.
3. Selecciona el botón Añadir conexión .

4. Ahora se te redirigirá a la página de conexión. Selecciona tu tipo de autenticación preferido.

   Si seleccionas Trae tu propia aplicación OAuth 2.0, debes proporcionar un ID de cliente y un Secreto de cliente, y los ámbitos que puedas necesitar para interactuar con diferentes actividades. Consulta la documentación de las actividades para ver qué ámbitos requieren.

5. Se ha agregado su conexión.

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: que se conecta a la aplicación pública de UiPath.

• Traiga su propia aplicación OAuth 2.0, que se conecta a una aplicación privada que cree.

Para aprender a crear una aplicación, ve a la documentación oficial de Google y sigue los pasos descritos: Autenticación: iniciar sesión con Google para Web.

• Al configurar tu aplicación, establece el campo URI de redireccionamiento autorizado en: https://govcloud.uipath.us/provisioning_/callback

Configurar ámbitos

Cuando creas 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á establecido actualmente 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 garantizar 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.

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