Workiva-ondersteuningscentrum

Met de e-mailconnector kunt u een E-mail verzenden commando toevoegen om e-mails te verzenden als onderdeel van een keten. Deze opdracht gebruikt het Simple Mail Transfer Protocol (SMTP) om de e-mail te verzenden. Authenticatie kan plaatsvinden via Basic-authenticatie of OAuth2-authenticatie. De e-mail kan extra context bevatten uit eerdere opdrachten in de reeks om verbeterde automatisering mogelijk te maken.

SMTP-vereisten

Om de e-mailconnector te gebruiken, heeft uw organisatie gegevens nodig over de SMTP-server van de e-mailprovider, zoals Gmail® of Microsoft® Office 365®.

Om de connector in te stellen, hebt u het volgende nodig:

• De hostnaam van de SMTP-server
• De poort die de SMTP-server gebruikt om e-mail te verzenden.
• Het HELO-domein, indien vereist door de SMTP-server.
• Als de SMTP-server authenticatie vereist, moeten de gebruikersnaam en het wachtwoord van de integratiegebruiker die de connector gebruikt voor authenticatie, worden gebruikt.

OAuth2-vereisten

Voordat u OAuth2-beveiliging voor deze connector kunt gebruiken, moeten de volgende items aanwezig en geïmplementeerd zijn.

Azure-elementen

Je moet beschikken over:

• Zowel een Microsoft Azure account als een Azure accountsleutel.
• Stel een autorisatiecodestroom in Azure in.
• De Exchange Online - service is geconfigureerd in Azure.

• Stel de juiste redirect URI in Azure in bij het configureren van de autorisatiecodeflow.

  Omgeving	Omleidings-URI
  APAC-productie	https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  EU-productie	https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  Amerikaanse productie	https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback

Raadpleeg de Microsoft Azure-documentatie voor instructies over het verkrijgen en implementeren van deze vereisten .

Workiva-elementen

• U moet de Workiva e-mailconnector hebben ingeschakeld (hiervoor is een organisatiebeveiligingsbeheerdervereist).

Een e-mailconnector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een organisatiebeveiligingsbeheerder deze inschakelen via Configuratie.

1. Klik in Chain Builderop Connectionscompare_arrowsen vervolgens op Create rechtsboven.
2. Onder Connector Connectionselecteer je Email en de standaard CloudRunner.
   
3. Voer een unieke Naam en Beschrijving in om de verbinding te helpen identificeren.

4. Voer onder Eigenschappende verbindingsgegevens in:

   

   Eigendom	Details
   Hostnaam	Voer de hostnaam van de SMTP-server in: Voor Gmailis dit doorgaans smtp.gmail.com Voor Microsoft 365is dit doorgaans smtp.office365.com Voor Mailgunis dit doorgaans smtp.mailgun.org
   Haven	Voer de poort in waarop de server draait.De standaard SMTP-poort is doorgaans587, maar het kan ook25 zijn.
   TLS ingeschakeld	Als u een beveiligde SMTP-server gebruikt die versleutelde communicatie via de transportlaag vereist, stelt u de beveiligings-/beveiligde socketslaag (TLS/SSL) in op Ingeschakeld.
   HELO-domein	Voer, indien vereist door de SMTP-server, het HELO-domein in dat wordt gebruikt om een ​​succesvolle handshake te garanderen.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met behulp van Advanced Encryption Standard (AES)-256-codering.

5. Onder Authenticatieselecteer je het authenticatietype dat je wilt gebruiken en voer je de informatie in die nodig is om de API-aanroepen te authenticeren. De benodigde informatie is afhankelijk van het type authenticatie dat u selecteert.

   Voor basisverificatie

   

   Eigendom	Details
   Gebruikersnaam	Als de SMTP-server gebruikmaakt van basisverificatie, voer dan de gebruikersnaam in van de integratiegebruiker van de connector.
   Wachtwoord	Als de SMTP-server basisverificatie vereist, voer dan het wachtwoord in dat bij de gebruikersnaam hoort.

    

   Voor Microsoft Office 365 E-mail OAuth2

   

   Eigendom	Details
   Gebruikersnaam	Dit is de gebruikersnaam voor toegang tot de SMTP-server.
   Huurders-ID	Dit is de ID-string voor uw Microsoft-tenant.
   Klant-ID	Dit is de client-ID voor de sleutel die de API moet gebruiken.
   Klantgeheim	Dit is het clientgeheim voor de sleutel die de API moet gebruiken.

6. Klik op Verbinden.
7. Selecteer de omgevingen die u voor de verbinding wilt gebruiken en klik op Opslaan.
8. Om de verbinding te testen, maak en voer een keten uit met de opdracht 'E-mail verzenden' van de connector om een ​​e-mail naar je eigen e-mailadres te sturen en controleer of er een geldige uitvoer wordt geretourneerd.

Probleemoplossing

Als de connector er niet in slaagt de e-mail te verzenden:

• Controleer of de hostnaam en poort van de SMTP-server van uw e-mailprovider correct zijn.
• Controleer of het domeintype van de SMTP-server correct is (TLS of HELO).
• Als u gebruikmaakt van basisverificatie, controleer dan of de gebruikersnaam en het wachtwoord correct zijn.
• Als u OAuth2-authenticatie gebruikt, controleer dan of:
  • De waarden voor ClientID en Client Secret zijn correct.
  • De Omleidings-URI is correct in Azure bij het genereren van die Client ID- en Client Secret-waarden.
• Controleer of de e-mailadressen van de ontvangers die zijn ingevoerd voor de velden Aan, CCen BCC [] van de opdracht [ E-mail verzenden correct zijn.