Action de se connecter pour les packages Google

Utilisez l'action Se connecter pour établir une connexion avec le serveur Google afin d'utiliser d'autres actions de ce même package pour automatiser les tâches. Tous les champs de cette action acceptent une information d'identification du Credential Vault, une variable ou une valeur d'entrée utilisateur.

Prérequis

Configurez les paramètres OAuth dans Google Cloud Platform et récupérez les informations d'identification nécessaires pour connecter Automation Anywhere à vos applications Suite Google G.
  1. Si ce n'est pas déjà fait, créez un projet.
  2. Activez les API pour les applications Suite Google G que vous souhaitez automatiser, telles que l'API Google Drive, l'API Google Agenda et l'API Google Sheets.
  3. Suivez les étapes de la section Configuration d'OAuth 2.0 pour générer l'identifiant client et le secret.
    Remarque :
    • Sélectionnez l'option Application Web et saisissez un nom.
    • En fonction du mode d'authentification, saisissez l'URI de redirection approprié comme indiqué ci-dessous :
      • Code d'autorisation (mode d'authentification par défaut) : Ajoutez cette URI de redirection autorisée http://localhost:8888/Callback.
      • Géré par la Control Room : Ajoutez l'URL de rappel à partir de la page Control Room > Gestion > Connexions OAuth > Paramètres de connexion. Reportez-vous à la rubrique Créer une connexion OAuth.

Procédure

  1. Dans la palette Actions, double-cliquez sur l'action Se connecter ou faites-la glisser depuis le package que vous souhaitez utiliser.
  2. Dans le champ Nom d'utilisateur, vous pouvez fournir un nom d'utilisateur valide ou sélectionner l'information d'identification ou la variable d'information d'identification qui contient votre nom d'utilisateur Google. Pour saisir une valeur, cliquez sur Chaîne non sécurisée.
  3. Si vous configurez l'action Se connecter pour le package Google Agenda ou Google Sheets, saisissez un nom de session.
  4. Cliquez sur la liste déroulante Mode d'authentification OAuth2 et sélectionnez l'un des modes d'authentification suivants :

    Pour un mode d'authentification assisté, sélectionnez Code d'autorisation, qui est un flux ancien et non sécurisé. Pour le mode d'authentification non assisté, sélectionnez Géré par la Control Room l'authentification OAuth2, un modèle plus sûr et plus standard pour les automatisations.

    • Code d'autorisation
      • Dans le champ Identifiant client, sélectionnez l'information d'identification ou la variable d'information d'identification qui contient l'identifiant client. Pour saisir une valeur, cliquez sur Chaîne non sécurisée.
      • Dans le champ URI de redirection, saisissez http://localhost:8888/Callback
        Remarque : Pour le package Google Sheets, l'attribut Rediriger l'URI n'est pas pris en charge. Saisissez l'URL de redirection fixe directement dans Google Cloud Platform : http://localhost:8888/Callback
      • Dans le champ Secret du client, sélectionnez l'information d'identification ou la variable d'information d'identification qui contient le jeton d'accès. Pour saisir une valeur, cliquez sur Chaîne non sécurisée.
    • Géré par la Control Room

      Pour utiliser Oauth2 géré par la Control Room dans Google packages, vous devez configurer la connexion OAuth dans la Control Room. Reportez-vous à la rubrique Créer une connexion OAuth.

      Mettez à jour des informations dans les champs suivants :

      • Connexion : Cliquez sur le bouton Choisir pour sélectionner un type de connexion.
      • Sélectionnez Personnalisé dans le champ Type de fournisseur.

      • Sélectionnez le nom de la connexion que vous avez défini dans la Control Room pour les applications Google Workspace.

      • Dans le champ Type de jeton, sélectionnez l'une des options suivantes :

        Pour plus d'informations sur les jetons d'accès et de rafraîchissement de l'application Google Workspace, voir Configuration d'applications d'entreprise

        • Partagée : Sélectionnez cette option lorsque le jeton d'accès OAuth2 est partagé par tous les utilisateurs qui exécutent l'automatisation. Notez que cela nécessite que l'administrateur de la Control Room ou n'importe quel utilisateur (avec les options Gestion des connexions et Afficher les connexions activées pour les CONNEXIONS OAUTH) configure une connexion OAuth dans la Control Room. Enregistrez une fois les informations d'identification de connexion pour générer un jeton d'accès partagé qui peut être utilisé par tous les utilisateurs exécutant l'automatisation.
        • Spécifique à l'utilisateur : Sélectionnez cette option lorsque le jeton d'accès OAuth2 est spécifique à chaque utilisateur exécutant l'automatisation. Notez que cela nécessite que l'administrateur de la Control Room ou n'importe quel utilisateur (avec les options Gestion des connexions et Afficher les connexions activées pour les CONNEXIONS OAUTH) configure une connexion OAuth dans la Control Room. Veillez à ne pas enregistrer les informations d'identification de connexion afin que chaque utilisateur exécutant l'automatisation puisse fournir ses informations d'identification de connexion et générer un jeton d'accès qui ne peut être utilisé que par cet utilisateur spécifique.
        • Cliquez sur Confirmer.

          Utilisation de l'option OAuth2 gérée par la Control Room

      Remarque : Lorsque vous utilisez l'option Spécifique à l'utilisateur, vous devez vous connecter à votre compte Google pour vous authentifier et générer un jeton spécifique à l'utilisateur. Pour utiliser cette option, procédez comme suit :
      1. Dans la Control Room, accédez à votre profil et sélectionnez Mes paramètres > Connexions OAuth.
      2. Cliquez sur Se connecter pour vous authentifier.
      3. Connectez-vous à votre compte Google et sélectionnez Continuer.
      4. Vérifiez les services auxquels vous avez accès et cliquez sur Continuer.

        Si la connexion est réussie, le statut Actif s'affiche.

        Statut de réussite de l'authentification OAuth

  5. Pour Google Sheets, vous pouvez spécifier le temps d'attente (en minutes) dans le champ Attendre la fin de l'action (en minutes) lorsque vous effectuez actions par exemple Obtenir, Définir ou Supprimer. Par défaut, le temps d'attente est de 10 minutes.
    Si Google Sheets ne s'ouvre pas ou ne se ferme pas dans le délai que vous spécifiez, la série d'actions suivante de la tâche est exécutée.
    Remarque : Lorsque vous utilisez l'action Se connecter pour vous connecter au serveur Google, l'option Attendre la fin de l'action (en minutes) n'est prise en charge que dans le package Google Sheets.
  6. Cliquez sur Enregistrer.
  7. Après avoir ajouté les actions d'un package Google spécifique, utilisez l'action Déconnecter de ce même package Google pour mettre fin à la connexion.

Étapes suivantes

La première fois que le robot s'exécute, la fenêtre de connexion Google s'affiche. Vous devez sélectionner le compte Google et approuver les autorisations d'accès demandées.

Le fichier de jetons est généré pour la première fois une fois que vous avez fourni les autorisations d'accès lors du déploiement du robot. Il est créé en fonction des valeurs que vous fournissez dans les champs Nom d'utilisateur, ID client et Secret du client et ne demande les informations d'identification que la première fois pour fournir l'autorisation d'accès. La prochaine fois, il utilise le même fichier de jetons pour se connecter à l'Google Sheets.

Le fichier de jetons est situé dans C:\Users\<username>\AppData\Local\AutomationAnywhere\G-SuitAuth, où C:\Users\<username> est le répertoire principal de l'utilisateur du système concerné.

Si vous saisissez les bonnes informations d'identification lorsque vous fournissez les autorisations d'accès pour la première fois et que vous pouvez vous connecter à l'Google Sheets, si vous ne modifiez que le mot de passe la prochaine fois, vous n'aurez pas besoin de supprimer le fichier de jetons, qui fonctionnera comme prévu.

Utilisez d'autres actions du même package Google pour automatiser les tâches. Pour utiliser les actions d'autres packages Google, établissez une connexion à l'aide de l'action Se connecter depuis ce package.