Workiva kundestøttesenter

Med e-postkoblingen kan du inkludere en Send e-post -kommando for å sende e-post som en del av en kjede. Denne kommandoen bruker Simple Mail Transfer Protocol (SMTP) til å sende e-posten. Autentisering kan gjøres ved hjelp av enten grunnleggende autentisering eller OAuth2-autentisering. E-posten kan inkludere ytterligere kontekst fra tidligere kommandoer i kjeden for å muliggjøre forbedret automatisering.

SMTP-forutsetninger

For å bruke e-postkoblingen trenger organisasjonen din informasjon om SMTP-serveren til e-postleverandøren, for eksempel Gmail® eller Microsoft® Office 365®.

For å sette opp koblingen trenger du:

• Vertsnavnet til SMTP-serveren
• Porten SMTP-serveren bruker til å sende e-post
• HELO-domenet, hvis det kreves av SMTP-serveren
• Hvis SMTP-serveren krever autentisering, må brukernavnet og passordet til integrasjonsbrukeren som koblingen skal autentisere som

OAuth2-forutsetninger

Før du kan bruke OAuth2-sikkerhet for denne koblingen, må følgende elementer være til stede og implementert.

Azure-elementer

Du må ha:

• Både en Microsoft Azure -konto og en Azure-kontonøkkel.
• Sett opp en autorisasjonskodeflyt i Azure.
• Konfigurerte Exchange Online-tjenesten i Azure.

• Konfigurer riktig omdirigerings-URI i Azure når du konfigurerer autorisasjonskodeflyten.

  Miljø	Omdirigerings-URI
  APAC-produkt	https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  EU-produkt	https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  Amerikansk produkt	https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback

Se Microsoft Azure-dokumentasjonen for instruksjoner om hvordan du får tak i og implementerer disse forutsetningene.

Workiva-elementer

• Du må ha aktivert Workiva e-postkoblingen (dette krever en sikkerhetsadministrator for organisasjonen).

Konfigurer en e-postkobling

Merk: For å gjøre koblingen tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator i organisasjonen aktivere den fra Konfigurasjon.

1. Fra Kjedebyggerklikker du på Tilkoblingercompare_arrowsog deretter på Opprett øverst til høyre.
2. Under Koblingstilkoblingvelger du E-post og standardinnstillingen CloudRunner.
   
3. Skriv inn et unikt Navn og en Beskrivelse for å identifisere forbindelsen.

4. Under Egenskaperskriver du inn tilkoblingsdetaljene:

   

   Egenskap	Detaljer
   Vertsnavn	Skriv inn vertsnavnet til SMTP-serveren: For Gmailer dette vanligvis smtp.gmail.com For Microsoft 365er dette vanligvis smtp.office365.com For Mailguner dette vanligvis smtp.mailgun.org
   Port	Skriv inn porten serveren kjører på. Standard SMTP-port er vanligvis587, men den kan også være25.
   TLS aktivert	Hvis du bruker en sikker SMTP-server som krever kryptert kommunikasjon via Transport Layer, sett Security/Secure Sockets Layer (TLS/SSL) til Aktivert.
   HELO-domene	Hvis SMTP-serveren krever det, angi HELO-domenet som brukes for å sikre et vellykket håndtrykk.

   Merk: All sensitiv påloggingsinformasjon krypteres og lagres automatisk ved hjelp av Advanced Encryption Standard (AES)-256-kryptering.

5. Under Autentiseringvelger du autentiseringstypen du vil bruke, og skriver inn informasjonen som trengs for å autentisere API-kallene. Informasjonen som kreves vil avhenge av hvilken autentiseringstype du velger.

   For grunnleggende autentisering

   

   Egenskap	Detaljer
   Brukernavn	Hvis SMTP-serveren bruker grunnleggende autentisering, skriver du inn brukernavnet til koblingens integrasjonsbruker.
   Passord	Hvis SMTP-serveren krever grunnleggende autentisering, skriver du inn passordet som er knyttet til brukernavnet.

    

   For Microsoft Office 365 Email OAuth2

   

   Egenskap	Detaljer
   Brukernavn	Dette er brukernavnet for å få tilgang til SMTP-serveren.
   Leietaker-ID	Dette er ID-strengen for Microsoft-leietakeren din.
   Klient-ID	Dette er klient-ID-en for nøkkelen du vil at API-et skal bruke.
   Klienthemmelighet	Dette er klienthemmeligheten for nøkkelen du vil at API-et skal bruke.

6. Klikk på Koble til.
7. Velg miljøene du vil bruke tilkoblingen i, og klikk på Lagre.
8. For å teste tilkoblingen, opprett og kjør en kjede med -koblingens Send e-post-kommandofor å sende en e-post til din egen e-postadresse, og bekreft at den returnerer gyldige utdata.

Feilsøking

Hvis koblingen ikke sender e-post:

• Bekreft at vertsnavnet og porten til e-postleverandørens SMTP-server er riktige.
• Kontroller at domenetypen for SMTP-serveren er riktig (TLS eller HELO).
• Hvis du bruker grunnleggende autentisering, må du kontrollere at brukernavn- og passordverdiene er riktige.
• Hvis du bruker OAuth2-autentisering, må du bekrefte at:
  • Verdiene for ClientID og Client Secret er riktige.
  • Omdirigerings-URI-en er riktig i Azure når disse verdiene for klient-ID og klienthemmelighet genereres.
• Bekreft at mottakerens e-postadresser som er angitt for kommandoene Send e-postog BCCer riktige.