Authentification Gmail

Prérequis

Selon le type d'authentification que vous sélectionnez, vous avez besoin de l'une des informations d'identification suivantes :

• Code d'autorisation OAuth 2.0 : votre adresse e-mail Google et le mot de passe associé à votre compte Google.
• Fournissez votre propre application OAuth 2.0 : l' ID client et la clé secrète du client, ainsi que les étendues.
• Compte de service : clé de compte de service, e-mail de compte.

Si votre compte n'est pas activé par Google :

• Contactez votre administrateur pour obtenir l'approbation de la création de connexions.
• Activez l'autorisation en cochant les options disponibles pour autoriser la création d'une connexion.

Remarque :

Pour plus de détails concernant les différents types d’authentification, reportez-vous au guide Comment se connecter aux activités Google Workspace 365 .

Pour en savoir plus sur Gmail, consultez le site Web de la documentation Gmail .

Étendues

Le connecteur demande les autorisations/étendues suivantes :

• Étendues par défaut de l’application publique 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.
• Étendues par défaut du compte de service 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.
• Apportez votre propre application OAuth 2.0 :
  • Étendues obligatoires : openid, https://www.googleapis.com/auth/userinfo.email, https://mail.google.com/
  • Étendues minimales pour créer une connexion : openid, https://www.googleapis.com/auth/gmail.readonly.
  • Liste minimale des étendues requises pour les déclencheurs Gmail :
    • openid, https://www.googleapis.com/auth/gmail.readonly – pour l'événement sur les boîtes aux lettres.
    • openid, https://www.googleapis.com/auth/calendar.readonly – pour les événements sur les calendriers.

Remarque :

Si vous vous authentifiez à l'aide de l'application Apporter votre propre OAuth 2.0, vous bénéficiez par défaut des étendues configurées lors de la création de l'application. Si vous souhaitez utiliser les autorisations d'application par défaut, vous pouvez déclarer une étendue common . Cela signifie que vous n'utilisez que les autorisations configurées pour cette application. Vous pouvez également déclarer des étendues supplémentaires lors de la création de la connexion, à l'aide du champ Étendues . Il vous sera alors demandé d’accorder le consentement supplémentaire lors de la connexion.

La connexion permet aux produits UiPath d'interagir avec les données Gmail à votre place. Cela peut inclure la lecture, l'écriture, la modification et la suppression de données, en fonctions de vos autorisations Gmail. Vous pouvez toujours supprimer tout accès à votre compte Google.

Setting up a Google Cloud project

Remarque :

This section applies only if you are using the Bring your own OAuth 2.0 app authentication type. If you use OAuth 2.0 Authorization code, skip to Add the Gmail connection.

Before creating a connection using Bring your own OAuth 2.0 app, configure a Google Cloud project to authorize OAuth communication with Gmail.

1. Go to the Google Cloud Console and create a project or select an existing one. Fill in the basic project details and select Save and Continue.
2. In the navigation menu, select APIs & Services, then Library.
3. Search for Gmail API, then select Enable.
4. Select Credentials, then + Create Credentials, and then OAuth client ID.
5. Under Application type, select Web application and enter a name.
6. Under Authorized redirect URIs, add https://{baseURL}/provisioning_/callback, then select Create.
7. Save the Client ID and Client secret in a secure location.
8. Select OAuth consent screen and configure the app settings. Whether the app is Internal or External depends on your organization's security policy.
9. Select Edit App, go to the Scopes section, then select Add or Remove Scopes.
10. Search for mail and select the appropriate Gmail API scopes. Refer to the Scopes section for the minimum required set. If you add scopes for additional APIs, such as Google Drive, ensure they comply with your company's policies.
11. Save your changes. If your app is External, you can optionally add test users in the Test users step before returning to the project dashboard.

Your Client ID and Client secret are now ready to use when creating the Gmail connection in Integration Service.

Remarque :

To manage API access restrictions or app permissions at the organizational level, refer to Google's Third Party and Custom Apps documentation.

Ajouter la connexion Gmail

1. Sélectionnez Orchestrator dans le lanceur du produit.

2. Sélectionnez un dossier, puis accédez à l'onglet Connexions .

3. Sélectionnez Ajouter une connexion (Add connecion).

4. Pour ouvrir la page de création de connexion, sélectionnez le connecteur dans la liste. Vous pouvez utiliser la barre de recherche pour trouver le connecteur.

5. Sélectionnez le type d’authentification que vous souhaitez.

   If you select Bring your own OAuth 2.0 app, select the gear icon, then select Bring your own OAuth 2.0 app and supply the Client ID and Client secret from your Google Cloud project setup. You must also provide the scopes required for the activities you plan to use. Check the documentation of each activity to learn what scopes it requires.

6. Saisissez les informations d’identification requises et sélectionnez Connect.

   Pour tout champ de type Clé secrète, vous pouvez sélectionner le menu à côté du champ et choisir Utiliser la ressource d'informations d’identification pour référencer une ressource d'informations d'identification Orchestrator liée à un coffre externe au lieu d'entrer la valeur directement. Pour plus d'informations, consultez Utiliser des ressources d'informations d'identification pour les connexions.

Using the connection in Studio Desktop

After creating a Gmail connection in Integration Service, configure your Studio or StudioX automation to use it.

1. In Studio, open Manage Packages and install the Google Workspace package.

2. In your automation, you can add Gmail activities by selecting Installed, then Integrations, Google, Workspace, and then select Gmail.

   Remarque :

   Use the Gmail activities from the Integrations section rather than the legacy Use Gmail activity. The legacy activity does not support Integration Service connections and is limited to a single hardcoded user account.

3. In each activity's properties, select the Gmail connection you created in Integration Service.

If not all Gmail scopes were enabled in your Google Cloud project, some activities may fail. Check each activity's documentation for its required scopes.

Apportez votre propre application OAuth 2.0

Dans Integration Service, lors de la création d'une connexion à l'un de nos connecteurs basés sur l'API Google, vous pouvez choisir entre deux options d'authentification :

• Code d'autorisation OAuth 2.0 : se connecte à l'application publique UiPath.
• Bring your own OAuth 2.0 app – connects to a private Google Cloud application you create.

Étendues de configuration

When you create a connection using Bring your own OAuth 2.0 app, you have the option to customize application scopes.

Actualiser les jetons pour les applications OAuth

Google a défini des limitations de jeton d’actualisation pour les ID client OAuth 2.0 individuels. Si la limite est atteinte, la création d'un nouveau jeton de réactualisation invalide automatiquement le plus ancien jeton de réactualisation sans avertissement. Cette limite ne s'applique pas aux comptes de service. Pour de plus amples informations, consultez la documentation officielle de Google .

Une liste des raisons qui peuvent entraîner l'expiration du jeton :

• Vous avez révoqué l'accès de votre application.
• Le jeton de réactualisation n'a pas été utilisé depuis six mois.
• Vous devez modifier les mots de passe et le jeton d'actualisation contient des étendues Gmail.
• Votre compte a dépassé le nombre maximum de jetons de réactualisation (en direct) accordés.
  • Si vous demandez un nouveau jeton après que la limite est dépassée, votre ancienne connexion, basée sur un jeton précédemment accordé, expirera. Seule la nouvelle connexion ou la dernière connexion modifiée/réauthentifiée (avec le dernier jeton) fonctionnera.
• Un administrateur a défini l'un des services demandés dans les étendues de votre application sur Refusé (l'erreur est admin_policy_enforced).
• Pour les API Google Cloud Platform: la durée de la session définie par l’administrateur aurait pu être dépassée.

Remarque :

La limite est actuellement fixée à 100 jetons d’actualisation par compte Google et par ID client OAuth 2.0. Ce numéro peut être soumis à des modifications. Pour obtenir les dernières informations, vérifiez toujours la documentation Google.

Il existe une limite plus importante sur le nombre total de jetons de réactualisation qu'un compte d'utilisateur ou un compte de service peut avoir pour tous les clients. Les utilisateurs réguliers ne dépasseront pas cette limite, contrairement à un compte développeur utilisé pour tester une implémentation.

Pour s'assurer que cette limite ne soit pas dépassée, UiPath propose aux utilisateurs de créer leurs propres applications OAuth et de se connecter à l'aide du type d'authentification Apporter votre propre application. Assurez-vous de suivre les meilleures pratiques de Google lors de la création de votre application OAuth. Pour en savoir plus sur la création d'une application OAuth, consultez la documentation officielle de Google .

Remarque :

L'invalidation du jeton entraîne des connexions échouées et les automatisations ne peuvent pas s'exécuter sans que les connexions soient réparées.