Utilisation de l\' action Se connecter dans le E-mail package

Utilisez l\' Se connecter action dans le E-mail package pour établir une connexion avec un serveur de messagerie. Il s\'agit de la première action que vous utilisez pour automatiser une tâche liée aux e-mails.

Prérequis

Vous pouvez utiliser OAuth 2.0 pour vous authentifier auprès du serveur de messagerie pour l\'automatisation des e-mails. En fonction de votre fournisseur de services de messagerie, effectuez les étapes pertinentes :
  • Outlook/Office 365
    • Si vous utilisez le mode d\'authentification Flux d\'informations d\'identification, procédez comme suit :
      1. Connectez-vous au Microsoft Azure portal.
      2. Enregistrez une application avec la plateforme d\'identité Microsoft pour obtenir l\'identifiant client et l\'identifiant du locataire. Voir Register an application.
      3. Ajoutez un secret client.

        Voir Add a client secret

      4. En fonction du serveur de messagerie auquel vous vous connectez, effectuez les étapes pertinentes :
    • Si vous utilisez le mode d\'authentification Code d\'autorisation avec PKCE, procédez comme suit :
      1. Connectez-vous au Microsoft Azure portal.
      2. Enregistrez une application avec la plateforme d\'identité Microsoft pour obtenir l\'identifiant client et l\'identifiant du locataire. Reportez-vous à la rubrique Register an application.
      3. Lors de l\'enregistrement de l\'application, définissez l\'URI de redirection sur http://localhost:9999/callback.
      4. Ajoutez des autorisations de type délégué pour IMAP, POP3 et SMTP, et accordez à l\'application l\'autorisation requise pour Microsoft Graph.
    • Si vous utilisez le mode d\'authentification Géré par la Control Room, voir Configure Control Room managed OAuth for Outlook/Office365 (A-people login required).

    Les vidéos de la playlist suivante fournissent des informations sur la configuration et l\'utilisation de l\'authentification OAuth 2.0 dans l\'E-mail Se connecter action :

    Remarque : Si la boîte aux lettres est utilisée dans une action Boucle, veillez à inscrire l'utilisateur chargé d'effectuer l'automatisation. Pour en savoir plus, consultez la rubrique Manage users and groups assignment to an application.
  • Gmail
    • Si vous utilisez le mode d\'authentification Code d\'autorisation avec PKCE, procédez comme suit :
      1. Configurez les paramètres OAuth 2.0 dans Google Cloud Platform (GCP) et récupérez les informations d\'identification nécessaires pour vous connecter à Automation 360 à l\'aide de vos applications Google Workspace.
      2. Veillez à créer un projet.

        Voir créer un projet.

      3. Générez l\'identifiant et le secret du client.
        Voir Configuration d\'OAuth 2.0.
        Remarque :
        • Sélectionnez l\'option Application Web.
        • Ajoutez cet URI de redirection autorisé : http://localhost:8888/Callback.
      4. Procédez comme suit pour configurer le consentement de l\'utilisateur pour le nom d\'utilisateur que vous utiliserez pour vous connecter à Automation 360.
    • Si vous utilisez le mode d\'authentification Control Room managed, procédez comme suit :
      Important : E-mail package prend actuellement en charge l\'option Oauth gérée par Control Room pour les connexions OAuth basées uniquement sur le flux de code d\'autorisation.
      1. Configurez les paramètres OAuth 2.0 dans Google Cloud Platform (GCP) et récupérez les informations d\'identification nécessaires pour vous connecter Automation 360 à l\'aide de vos applications Google Workspace.
      2. Veillez à créer un projet.

        Voir créer un projet.

      3. Générez l\'identifiant et le secret du client.
        Voir Configuration d\'OAuth 2.0.
        Remarque :
        • Sélectionnez l\'option Application Web.
        • Pour ajouter l\'URI de redirection autorisée, procédez comme suit :
          1. Connectez-vous au Control Room en tant qu\'administrateur ou tout utilisateur ayant les permissions Gérer les connexions et Voir les connexions et naviguez vers Gérer > connexions OAuth.
          2. Cliquez sur l\'onglet Créer une connexion et sélectionnez l\'option Personnalisé dans le champ Type de fournisseur.
          3. Copiez l\'URL de rappel et retournez à la page de l\'application client dans Google Cloud Console.
          4. Cliquez sur le bouton + AJOUTER UN URI sous URI de redirection autorisés et collez l\'URI dans le champ URIs.
          5. Cliquez sur Créer.

          Pour apprendre à créer une connexion OAuth dans le Control Room, voir Créer OAuth une connexion.

      4. Procédez comme suit pour configurer le consentement de l\'utilisateur pour le nom d\'utilisateur que vous utiliserez pour vous connecter à Automation 360.
Remarque :
  • Le flux Infos d\'identification client ne prend pas en charge Gmail.
  • Les modes d\'authentification Informations d\'identification client et Code d\'autorisation avec PKCE ne prennent pas en charge les serveurs de messagerie Yahoo et MSN.
Recommandé : Si vous souhaitez utiliser les deux modes d\'authentification (Informations d\'identification client et Code d\'autorisation avec PKCE), vous devez vous inscrire sur deux applications distinctes.
Remarque : Lorsque vous vous connectez à un serveur Exchange Web Services, l\'authentification multi-facteurs (AMF) doit être désactivée, y compris dans toutes les stratégies de sécurité au niveau de l\'entreprise où l\'AMF pourrait être activée. Si MFA n\'est pas complètement désactivée, les utilisateurs peuvent rencontrer des erreurs de connexion ou d\'autorisation. Toutefois, si vous souhaitez toujours utiliser l\'AMF, consultez les informations contenues dans cet article (il n\'est pas garanti que la connexion soit correctement établie) :

Multi-factor authentication for Azure EWS (A-people login required)

Cette action vous permet de fournir les informations d\'identification et les détails du serveur de messagerie, et d\'associer ces informations à un nom de session. Utilisez ce même nom de session pour l\'autre E-mail actions, vous n\'avez donc qu\'à fournir les informations du serveur une seule fois.

Procédure

Pour établir une connexion avec un serveur de messagerie, procédez comme suit :

  1. Dans la palette Actions , double-cliquez sur l\'Se connecter action ou faites-la glisser depuis le E-mail package.
  2. Saisissez un nom de session.
  3. Dans l\'option Outlook, Serveur de messagerie ou EWS, spécifiez si vous souhaitez établir une connexion avec Microsoft Outlook ou un serveur de messagerie.
    Remarque :
    • Lorsque vous vous connectez au serveur EWS et que vous utilisez Loop action pour récupérer tous les e-mails du serveur de messagerie, le robot ne s\'exécute pas et affiche un message d\'erreur si l\'objet de l\'e-mail contient les caractères suivants.
      • Caractères de commande
        • Plage : 0x00 - 0x08 (except 0x09 - Horizontal Tab) and 0x0B - 0x0C (except 0x0A - Line Feed and 0x0D - Carriage Return)
        • Valeurs hexadécimales : 0x00-0x08, 0x0B-0x0C, 0x0E-0x1F
      • Paires de substitution élevées et paires de substitution faibles
        • Plage : 0xD800 - 0xDFFF
        • Valeurs hexadécimales : 0xD800 - 0xDFFF
      • Points de code sans caractère
        • Plage : 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
        • Valeurs hexadécimales : 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
      • Plages restreintes
        • Plage : 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF
        • Valeurs hexadécimales : 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF

          Solution de contournement: Vous pouvez utiliser Microsoft Outlook ou le serveur de messagerie pour effectuer cette opération. Cependant, nous vous recommandons d\'utiliser le Microsoft 365 Outlook package, car Microsoft a annoncé la fin de vie des API EWS utilisées pour se connecter à Exchange Online. Voir, Obsolescence des API EWS dans Exchange Online

    • Lorsque vous établissez une connexion avec Microsoft Outlook, les e-mails sont traités à partir de la boîte aux lettres partagée. Assurez-vous d\'avoir configuré la boîte aux lettres partagée dans votre application Outlook.
      • Cette fonctionnalité n\'est prise en charge que pour Outlook.
      • Vous ne pouvez sélectionner qu\'une seule boîte aux lettres dans la liste des boîtes aux lettres de la boîte aux lettres partagée.
      • L\'invitation à la réunion n\'est pas lue dans Outlook, car le robot ne sélectionne pas les invitations de calendrier en tant qu\'objets E-mail. Cette fonctionnalité n\'est pas prise en charge actuellement.
    • Si vous avez sélectionné l\'option Outlook, vous n\'avez pas besoin de fournir d\'informations supplémentaires.

      Vous pouvez utiliser l\'option variable pour spécifier l\'adresse e-mail à laquelle vous souhaitez vous connecter.

      Remarque : Vous ne pouvez pas établir de connexion avec le nouveau client Outlook. Cependant, vous pouvez passer au client Outlook classique pour automatiser une tâche liée aux e-mails.
    • Si vous avez sélectionné l\'option Serveur de messagerie, remplissez les champs suivants :
      Remarque : Pour plus d\'informations sur l\'hôte et le port à utiliser pour les différents serveurs de messagerie, voir Paramètres du serveur de messagerie.
      • Utiliser une connexion sécurisée (SSL/TLS) : sélectionnez cette option si vous souhaitez établir une connexion sécurisée avec le serveur de messagerie.
      • Hôte : saisissez le nom du serveur de messagerie.
        Remarque : Ce champ n\'est pas sensible à la casse.
      • Port: Saisissez le numéro de port du serveur.
      • Protocole: Sélectionnez le protocole IMAP ou POP3.
        Remarque : Les expressions régulières sont prises en charge pour le protocole IMAP et lisent les e-mails de tous les sous-dossiers sous Boîte de réception.
      • Mode d\'authentification : Sélectionnez l\'un des modes d\'authentification suivants :
        • Basique : Utilise le nom d\'utilisateur et le mot de passe.
        • OAuth2 – Code d\'autorisation avec PKCE : Voir Microsoft identity platform and OAuth 2.0 authorization code flow

          Pour plus d\'informations sur la manière de configurer une application dans Azure afin d\'utiliser le flux Code d\'autorisation OAuth avec PKCE pour le serveur de messagerie, consultez la rubrique How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required).

        • OAuth2 – Informations d\'identification client: Voir Microsoft identity platform and the OAuth 2.0 client credentials flow

          Pour plus d\'informations sur la manière de configurer une application dans Azure afin d\'utiliser le flux d\'informations d\'identification client OAuth 2.0 pour le serveur de messagerie IMAP/POP3, consultez la rubrique How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required).

        • Géré par la Control Room
          Pour utiliser le mode OAuth2 géré par la Control Room pour automatiser Gmail, vous devez configurer la connexion OAuth dans la Control Room. Reportez-vous à la rubrique Créer OAuth une connexion.
          Remarque : Control Room OAuth Managed prend en charge uniquement Gmail et non le client Outlook.

          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.
              Remarque : Cette option nécessite que l\'administrateur de la Control Room ou n\'importe quel utilisateur (avec les options Gérer les connexions et Voir 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.
              Remarque : Cette option nécessite que l\'administrateur de la Control Room ou n\'importe quel utilisateur (avec les options Gérer les connexions et Voir 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.
          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 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.

        Selon le mode d\'authentification que vous avez sélectionné, vous devez spécifier les détails dans les champs suivants, le cas échéant.
        • Nom d\'utilisateur : Saisissez le nom d\'utilisateur que vous souhaitez utiliser pour accéder au serveur de messagerie.

          Par exemple, john.smith@myCompanyName.com

        • Mot de passe: Saisissez le mot de passe correspondant au nom d\'utilisateur que vous avez spécifié.
        • Pour les champs Identifiant client, Identifiant du locataire, Rediriger l\'URI et Secret du client, saisissez les informations qui sont fournies pour votre compte sur votre Azure portal.
        • Fournisseur de messagerie: Sélectionnez votre fournisseur de messagerie dans la liste déroulante.
          • Outlook/Office365

            Si vous sélectionnez cette option, fournissez alors l\'Identifiant du locataire.

          • Gmail
        Pour Nom d\'utilisateur, Mot de passe, Identifiant du locataire, Identifiant du client et Secret du client, faites votre sélection dans l\'onglet Informations d\'identification, Variable ou Chaîne non sécurisée :
        • Informations d\'identification : Utilisez une valeur disponible dans le coffre d\'accréditation.
        • Variable : Utilisez une variable définie par l\'utilisateur qui stocke les valeurs.
        • Chaîne non sécurisée : Saisissez manuellement une valeur.
    • Si vous avez sélectionné l\'option EWS, renseignez les champs suivants :
      • Version Exchange : Sélectionnez la version utilisée par votre organisation :
        • Exchange Server 2013
        • Exchange2010_SP2
        • Exchange2010_SP1
        • Exchange2010
        • Exchange2007_SP1
      • Cloud Azure: Sélectionnez le produit utilisé par votre organisation :
        • Azure Global: pour les clients de la version commerciale de Microsoft 365 (login.microsoftonline.com)
        • Azure US GCC High: Pour les clients de la version gouvernementale de Microsoft 365 (login.microsoftonline.us)
      • Facultatif: Nom du domaine :
        • Si vous êtes un client Microsoft 365 et que vous laissez ce champ vide, l\'Espace de travail d\'automatisation utilise smtp.office365.com pour se connecter au serveur.
        • Si vous êtes un client Microsoft 365 et que vous avez saisi un nom de domaine dans le champ Nom d\'utilisateur, vous devez saisir smtp.office365.com dans ce champ.
        • Si vous n\'êtes pas un client Microsoft 365, saisissez le nom de domaine de votre organisation. Sinon, Espace de travail d\'automatisation utilise le nom de domaine que vous avez fourni dans le champ Nom d\'utilisateur.
      • Mode d\'authentification : Sélectionnez l\'un des modes d\'authentification suivants :
        Remarque : À partir d\'Automation 360 v27 ou d\'une version ultérieure, le type d\'autorisation Mode d\'authentification OAuth2-Silent est renommé OAuth2-ROPC et le Mode d\'authentification OAuth2-Interactive est renommé OAuth2-Implicit.

        Si vous rencontrez des difficultés de connexion à la boîte aux lettres partagée à l\'aide d\'EWS, consultez Unable to connect to shared mailbox using EWS error (A-People login required).

        Selon le mode d\'authentification que vous avez sélectionné, vous devez spécifier les détails dans les champs suivants, le cas échéant.
        • Nom d\'utilisateur : Saisissez le nom d\'utilisateur que vous souhaitez utiliser pour accéder au serveur de messagerie.

          Par exemple, john.smith@myCompanyName.com

        • Mot de passe: Saisissez le mot de passe correspondant au nom d\'utilisateur que vous avez spécifié.
        • Pour les champs Identifiant client, Identifiant du locataire, Rediriger l\'URI et Secret du client, saisissez les informations qui sont fournies pour votre compte sur votre Azure portal.
        • Tester la connexion : Cliquez sur Tester la connexion pour vous connecter à votre compte, accepter les autorisations requises pour vous authentifier et établir une connexion avec le serveur.
          Remarque :
          • Lorsque vous effectuez une opération de bureau et que vous cliquez sur Tester la connexion, les variables telles que Informations d\'identification, la variable d\'informations d\'identification ou les variables de chaîne ne sont actuellement pas prises en charge.
          • Lorsque vous effectuez une opération de bureau et que vous cliquez sur Tester la connexion pour vous connecter à votre compte, ajoutez cet URI de redirection : https://outlook.office365.com
        Pour Nom d\'utilisateur, Mot de passe, Identifiant du locataire, Identifiant du client et Secret du client, faites votre sélection dans l\'onglet Informations d\'identification, Variable ou Chaîne non sécurisée :
        • Informations d\'identification : Utilisez une valeur disponible dans le coffre d\'accréditation.
        • Variable : Utilisez une variable définie par l\'utilisateur qui stocke les valeurs.
        • Chaîne non sécurisée : Saisissez manuellement une valeur.
      • Durée du délai d\'attente de la connexion (secondes) (facultatif) : Dans ce champ, spécifiez le temps nécessaire pour établir une connexion au serveur EWS. Vous pouvez définir la valeur du délai d\'attente entre 10 secondes et 60 secondes. Par défaut, le champ Durée du délai d\'attente de connexion (secondes) (Facultatif) est réglé sur 10 secondes.
  4. Cliquez sur Enregistrer.