SMTP via OAuth configureren in DocuFlow

Per 1 oktober 2022 is Microsoft gestopt met de ondersteuning van Basic Authenticatie voor SMTP-verkeer. Dit betekent dat als er gebruik gemaakt wordt van de Microsoft SMTP-server voor het verzenden van e-mails, dit zal moeten gebeuren door middel van OAuth. Deze pagina beschrijft hoe je in DocuFlow kunt overstappen van Basic Authentication naar OAuth.

Instellen in Microsoft 365 beheercentrum

Voorafgaand aan de overstap zal er op het Microsoft Office 365 portaal ingesteld moeten worden dat er gebruik mag worden gemaakt van ‘geverifieerde SMTP'. Hoe dit werkt volgens Microsoft vind je hier:

https://learn.microsoft.com/nl-nl/exchange/clients-and-mobile-in-exchange-online/authenticated-client-smtp-submission

Voor het gemak hebben we hieronder een paar print-screens toegevoegd van onze eigen Office 365 omgeving. Let op dat als er verbinding wordt gemaakt met een speciale Documizers gebruiker, onderstaande instellingen dus voor die Documizers gebruiker gemaakt moeten worden.

Stap voor stap

  1. Ga naar het Microsoft 365 beheercentrum and go to Gebruikers > Actieve gebruikers.

  2. Klik op de gebruiker en kies aan de rechterkant voor E-mail > E-mailapps beheren:

     

  3. Zet het vinkje aan bij Geverifieerde SMTP en kies voor Wijzigingen opslaan:

     

Instellingen in DocuFlow

Vooraf

DocuFlow versie 6.1.33

Om onderstaande wijzigingen door te voeren, moet je minimaal gebruik maken van DocuFlow versie 6.1.33. Heb je een oudere versie? Download dan eerst de nieuwste versie van de Documizers downloadportal. De link naar deze portal is in bezit bij je DocuFlow beheerder(s). Heb je de link niet (meer), of staat er op de downloadportal toch een oudere versie? Neem dan contact op met support@documizers.com.

Ingelogd als Office 365 beheerder

Om onderstaande stappen uit te voeren, zal je rechten moeten hebben om een DocuFlow App te mogen installeren in het Office 365 beheercentrum van jouw Microsoft omgeving. Zorg er dus voor dat je bent ingelogd als een Office 365 beheerder op de pc waar je onderstaande stappen uitvoert.

Stap voor stap

  1. Start DocuFlow via je Windows Startmenu:

     

  2. Kies voor Configuratie - Plugins en zoek de plugin op voor emails:

     

  3. Dubbelklik er op om de verbindingsinstellingen aan te passen.

  4. Klik op Verbindingen > en dubbelklik op de Microsoft SMTP-server om de instellingen aan te passen:

     

  5. Wijzig het veld Authentication Type naar OAuth en klik op Authenticate. Er zal nu een Microsoft inlogscherm verschijnen.

  6. Log in met de Documizers gebruiker waarvoor geverifieerde SMTP is ingeschakeld.

  7. Er verschijnt nu een scherm waarin gevraagd wordt de DocuFlow SMTP App machtigingen te geven. Zet eventueel een vinkje bij ‘Toestemming namens uw organisatie’ (alleen zichtbaar bij uitgebreide Office 365 rechten):

     

  8. Als alles goed is gegaan, verschijnt in beeld dat het token ‘Present’ is:

     

  9. Via ‘Test connection’ kun je vervolgens testen of het sturen van een mailtje lukt. Let op dat je bij het Van-veld wel een email adres invult dat voor de overstap naar OAuth ook al werkte. Er moeten namelijk Verzenden als / Verzenden namens rechten aanwezig zijn.

  10. Sla alle wijzigingen op door te bevestigen met OK.