Authentification Gmail

Prérequis

Pour créer une connexion, vous avez besoin des informations d'identification suivantes :

• Fournissez votre propre application OAuth 2.0 : l' ID client et la clé secrète du client, ainsi que les étendues.

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.

Pour plus d'informations sur Gmail, consultez le site Web de documentation de Gmail .

Étendues

Le connecteur demande les autorisations/étendues suivantes :

• Apportez votre propre application OAuth 2.0 :
  • É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 application OAuth 2.0 (Bring your Own 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 utilisez uniquement 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 ( Scopes ). 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 fonction de vos autorisations Gmail. Vous pouvez toujours supprimer les accès à votre compte Google.

Ajouter la connexion Gmail

1. Sélectionnez Integration Service dans Automation Suite.

2. Dans la liste Connecteurs , sélectionnez Gmail. Vous pouvez également utiliser la barre de recherche pour trouver le connecteur.
3. Sélectionnez le bouton Ajouter une connexion (Add connection).

4. Vous êtes maintenant redirigé vers la page de connexion. Sélectionnez le type d'authentification préféré

   Si vous sélectionnez Apporter votre propre application OAuth 2.0, vous devez fournir un ID de client et une clé secrète de client, ainsi que les étendues dont vous devrez peut-être interagir avec différentes activités. Consultez la documentation relative aux activités pour connaître les étendues requises.

5. Votre connexion a été ajoutée.

Apportez votre propre application OAuth 2.0

Pour savoir comment créer une application, accédez à la documentation officielle de Google et suivez les étapes décrites : Authentification – Connexion avec Google pour le Web.

• Lors de la configuration de votre application, définissez le champ URI de redirection autorisées ( Authorized redirect URIs ) sur : https://{yourDomain}/provisioning_/callback

Étendues de configuration

Lorsque vous créez une connexion à l’aide de l’application Apporter votre propre application OAuth 2.0 (Bring your Own OAuth 2.0 app), vous avez la possibilité de personnaliser les étendues d’application.

Actualiser les jetons pour les applications OAuth

Google a mis à jour les limitations de jeton pour les ID de 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 (voir Utilisation d'OAuth 2.0 pour les applications de serveur à serveur). Pour plus d'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 Restreint (L'erreur est admin_policy_enforced).
• Pour les API Google Cloud Platform: la longueur de session définie par l'administrateur aurait pu être dépassée.

Remarque : La limite est actuellement fixée à 100 jetons de réactualisation par compte Google par ID de 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 n'est pas dépassée, UiPath offre aux utilisateurs la possibilité de créer leurs propres applications OAuth et de se connecter à l'aide du type d'authentification Fournissez votre propre application (Bring your Own App). Assurez-vous de suivre les bonnes pratiques de Google lors de la création de votre application OAuth. Pour plus de détails sur la création d'une application OAuth, consultez la documentation officielle de Google .

Avertissement : l'invalidation du jeton entraîne des connexions échouées et les automatisations ne peuvent pas s'exécuter sans que les connexions soient corrigées.