Portail de support Workiva

Le connecteur Email vous permet d'inclure une commande Send Email pour envoyer un email dans le cadre d'une chaîne. Cette commande utilise le protocole SMTP (Simple Mail Transfer Protocol) pour envoyer le courrier électronique. L'authentification peut être effectuée à l'aide de l'authentification de base ou de l'authentification OAuth2. Le courriel peut inclure un contexte supplémentaire provenant de commandes antérieures dans la chaîne afin de permettre une meilleure automatisation.

Conditions préalables SMTP

Pour utiliser le connecteur Email, votre organisation a besoin d'informations sur le serveur SMTP de son fournisseur de messagerie, tel que Gmail® ou Microsoft® Office 365®.

Pour configurer le connecteur, vous aurez besoin de :

• Le nom d'hôte du serveur SMTP
• Le port que le serveur SMTP utilise pour envoyer des courriels
• Le domaine HELO, s'il est requis par le serveur SMTP
• Si le serveur SMTP requiert une authentification, le nom d'utilisateur et le mot de passe de l'utilisateur d'intégration en tant que lequel le connecteur doit s'authentifier.

Conditions préalables pour OAuth2

Avant de pouvoir utiliser la sécurité OAuth2 pour ce connecteur, les éléments suivants doivent être présents et mis en œuvre.

Éléments d'azur

Vous devez avoir :

• Un compte Microsoft Azure et une clé de compte Azure.
• Configurez un flux de code d'autorisation dans Azure.
• Configuration du service Exchange Online dans Azure.

• Configurez correctement l'URI de redirection dans Azure lors de la configuration du flux du code d'autorisation.

  Environnement	Redirection de l'URI
  APAC prod	https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  Produits de l'UE	https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  US prod	https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback

Reportez-vous à la documentation de Microsoft Azure pour obtenir des instructions sur l'obtention et la mise en œuvre de ces conditions préalables.

Éléments de Workiva

• Vous devez avoir activé le connecteur Workiva Email (cela nécessite un administrateur de la sécurité de l'organisation).

Mise en place d'un connecteur de courrier électronique

Note : Pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un administrateur de la sécurité de l'organisation doit l'activer à partir de Configuration.

1. Depuis Chain Builder, cliquez sur Connections compare_arrows, puis Create en haut à droite.
2. Sous Connector Connection, sélectionnez Email et la valeur par défaut CloudRunner.
   
3. Entrez un nom unique Name et Description pour aider à identifier la connexion.

4. Sous Properties, entrez les détails de la connexion :

   

   Propriété	Détails
   Nom d'hôte	Entrez le nom d'hôte du serveur SMTP : Pour Gmail, il s'agit généralement de smtp.gmail.com Pour Microsoft 365, il s'agit généralement de smtp.office365.com Pour Mailgun, il s'agit généralement de smtp.mailgun.org
   Port	Entrez le port sur lequel le serveur s’exécute. Le port SMTP par défaut est généralement 587, mais il peut également être 25.
   TLS activé	Si vous utilisez un serveur SMTP sécurisé qui nécessite une communication cryptée via la couche de transport, réglez le paramètre Sécurité/Couche de sockets sécurisée (TLS/SSL) sur Activé.
   Domaine HELO	Si le serveur SMTP l'exige, entrez le domaine HELO utilisé pour garantir la réussite de la poignée de main.

   Note : Toutes les données d'identification sensibles sont automatiquement cryptées et stockées à l'aide du cryptage Advanced Encryption Standard (AES)-256.

5. Sous Authentication, sélectionnez le type d'authentification que vous souhaitez utiliser et saisissez les informations nécessaires pour authentifier les appels API. Les informations requises dépendent du type d'authentification sélectionné.

   Pour l'authentification de base

   

   Propriété	Détails
   Nom de l'utilisateur	Si le serveur SMTP utilise l'authentification de base, saisissez le nom d'utilisateur de l'utilisateur d'intégration du connecteur.
   Mot de passe	Si le serveur SMTP requiert une authentification de base, saisissez le mot de passe associé au nom d'utilisateur.

    

   Pour Microsoft Office 365 Email OAuth2

   

   Propriété	Détails
   Nom d’utilisateur	Il s'agit du nom d'utilisateur permettant d'accéder au serveur SMTP.
   ID du locataire	Il s'agit de la chaîne d'identification de votre locataire Microsoft.
   Identifiant du client	Il s'agit de l'identifiant du client pour la clé que vous souhaitez que l'API utilise.
   Clé secrète client	Il s'agit du secret du client pour la clé que vous voulez que l'API utilise.

6. Cliquez sur Connecter.
7. Sélectionnez les environnements qui utiliseront la connexion et cliquez sur Enregistrer.
8. Pour tester la connexion, créez et exécutez une chaîne avec la commande Send Email du connecteur pour envoyer un courriel à votre propre adresse électronique, et vérifiez qu'elle renvoie un résultat valide.

Dépannage

Si le connecteur ne parvient pas à envoyer le courrier électronique :

• Vérifiez que le nom d'hôte et le port du serveur SMTP de votre fournisseur d'accès sont corrects.
• Vérifiez que le type de domaine du serveur SMTP est correct (TLS ou HELO).
• Si vous utilisez l'authentification de base, vérifiez que les valeurs du nom d'utilisateur et du mot de passe sont correctes.
• Si vous utilisez l'authentification OAuth2, vérifiez que :
  • les valeurs ClientID et Client Secret sont correctes.
  • l'URI de redirection est correct dans Azure lors de la génération des valeurs de l'ID et du secret du client.
• Vérifiez que les adresses électroniques des destinataires saisies pour les entrées To, CC, et BCC de la commande Send Email sont correctes.