Workiva Support Center

Mit dem E-Mail-Connector können Sie den Befehl Send Email einbinden, um E-Mails als Teil einer Kette zu versenden. Dieser Befehl verwendet das Simple Mail Transfer Protocol (SMTP), um die E-Mail zu versenden. Die Authentifizierung kann entweder über die Basisauthentifizierung oder die OAuth2-Authentifizierung erfolgen. Die E-Mail kann zusätzlichen Kontext von früheren Befehlen in der Kette enthalten, um eine bessere Automatisierung zu ermöglichen.

SMTP-Voraussetzungen

Um den E-Mail-Connector verwenden zu können, benötigt Ihr Unternehmen Angaben zum SMTP-Server seines E-Mail-Anbieters, z. B. Gmail® oder Microsoft® Office 365®.

Zur Einrichtung des Konnektors benötigen Sie Folgendes:

• Der Hostname des SMTP-Servers
• Der Port, den der SMTP-Server zum Senden von E-Mails verwendet
• Die HELO-Domäne, falls vom SMTP-Server benötigt
• Wenn der SMTP-Server eine Authentifizierung erfordert, geben Sie den Benutzernamen und das Kennwort des Integrationsbenutzers an, als den sich der Connector authentifizieren soll

OAuth2-Voraussetzungen

Bevor Sie die OAuth2-Sicherheit für diesen Connector verwenden können, müssen die folgenden Elemente vorhanden und implementiert sein.

Azurblaue Elemente

Das müssen Sie haben:

• Sowohl ein Microsoft Azure Konto als auch ein Azure-Kontoschlüssel.
• Richten Sie einen Autorisierungscodefluss in Azure ein.
• Konfigurieren Sie den Exchange Online-Dienst in Azure.

• Richten Sie die richtige redirect URI in Azure ein, wenn Sie den Autorisierungscodefluss einrichten.

  Umgebung	URI umleiten
  APAC prod	https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  EU-Produkt	https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  US-Produkt	https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback

Anweisungen zur Erlangung und Implementierung dieser Voraussetzungen finden Sie in der Microsoft Azure-Dokumentation.

Workiva-Elemente

• Sie müssen den Workiva E-Mail-Connector aktiviert haben (dies erfordert einen Organization Security Administrator).

Einrichten eines E-Mail-Connectors

Hinweis: Um den Connector für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator der Organisation ihn aktivieren von Konfiguration.

1. Von Chain Builder, klicken Sie auf Connections compare_arrows, und dann Create oben rechts.
2. Wählen Sie unter Connector Connection, Email und den Standard CloudRunner.
   
3. Geben Sie einen eindeutigen Namen und Beschreibung ein, um die Verbindung zu identifizieren.

4. Geben Sie unter Eigenschaften die Details der Verbindung ein:

   

   Eigenschaft	Details
   Host-Name	Geben Sie den Hostnamen des SMTP-Servers ein: Für Gmail ist dies normalerweise smtp.gmail.com Für Microsoft 365 ist dies normalerweise smtp.office365.com Für Mailgun, ist dies normalerweise smtp.mailgun.org
   Port	Geben Sie den Port ein, an dem der Server läuft. Der Standard-SMTP-Port ist in der Regel 587, er kann aber auch 25 sein.
   TLS aktiviert	Wenn Sie einen sicheren SMTP-Server verwenden, der eine verschlüsselte Kommunikation über Transport Layer erfordert, setzen Sie die Option Sicherheit/Secure Sockets Layer (TLS/SSL) auf Aktiviert.
   HELO-Domäne	Falls vom SMTP-Server gefordert, geben Sie die HELO-Domäne ein, die für einen erfolgreichen Handshake verwendet wird.

   Hinweis: Alle sensiblen Zugangsdaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert.

5. Wählen Sie unter Authentifizierung die gewünschte Authentifizierungsart aus und geben Sie die für die Authentifizierung der API-Aufrufe erforderlichen Informationen ein. Welche Informationen erforderlich sind, hängt von der von Ihnen gewählten Authentifizierungsart ab.

   Für die Basisauthentifizierung

   

   Eigenschaft	Details
   Name des Benutzers	Wenn der SMTP-Server eine einfache Authentifizierung verwendet, geben Sie den Benutzernamen des Integrationsbenutzers des Connectors ein.
   Kennwort	Wenn der SMTP-Server eine Basisauthentifizierung erfordert, geben Sie das mit dem Benutzernamen verbundene Kennwort ein.

    

   Für Microsoft Office 365 E-Mail OAuth2

   

   Eigenschaft	Details
   Benutzername	Dies ist der Benutzername für den Zugriff auf den SMTP-Server.
   Mieter-ID	Dies ist die ID-Zeichenfolge für Ihren Microsoft-Mandanten.
   Kunden-ID	Dies ist die Client-ID für den Schlüssel, den die API verwenden soll.
   Client Secret	Dies ist das Client Secret für den Schlüssel, den die API verwenden soll.

6. Klicken Sie auf Verbinden Sie.
7. Wählen Sie die Umgebungen aus, die die Verbindung verwenden sollen, und klicken Sie auf Speichern.
8. Um die Verbindung zu testen, erstellen Sie und führen Sie eine Kette mit dem Befehl Send Email des Connectors aus, um eine E-Mail an Ihre eigene E-Mail-Adresse zu senden, und überprüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.

Fehlersuche

Wenn der Connector keine E-Mail senden kann:

• Überprüfen Sie, ob der Hostname und der Port des SMTP-Servers Ihres E-Mail-Anbieters korrekt sind.
• Überprüfen Sie, ob der Domänentyp des SMTP-Servers korrekt ist (TLS oder HELO).
• Wenn Sie die Basisauthentifizierung verwenden, überprüfen Sie, ob die Werte für den Benutzernamen und das Kennwort korrekt sind.
• Wenn Sie OAuth2-Authentifizierung verwenden, überprüfen Sie dies:
  • die Werte ClientID und Client Secret korrekt sind.
  • die Redirect URI in Azure korrekt ist, wenn diese Client ID und Client Secret Werte generiert werden.
• Überprüfen Sie, ob die Empfänger-E-Mail-Adressen, die für die Eingaben To, CC und BCC des Befehls Send Email eingegeben wurden, korrekt sind.