Microsoft Outlook 365 verbinden met Odoo met Azure OAuth¶

Odoo is compatibel met Microsoft’s Azure OAuth voor Microsoft 365. Om beveiligde e-mails te versturen en ontvangen vanuit een aangepast domein, hoef je alleen maar een paar instellingen te configureren op het Azure platform en op de back-end van de Odoo database. Deze configuratie werkt met een persoonlijk e-mailadres of een adres dat is aangemaakt door een aangepast domein.

Instellen in Microsoft Azure Portaal¶

Een nieuwe applicatie maken¶

Om te beginnen ga je naar Microsoft’s Azure Portal. Log in met de Microsoft Outlook Office 365 account als die er is, anders log je in met de persoonlijke Microsoft account. Een gebruiker met administratieve toegang tot de Azure Settings moet verbinding maken en de volgende configuratie uitvoeren. Navigeer vervolgens naar het gedeelte met de naam Manage Microsoft Entra ID (voorheen Azure Active Directory).

Klik nu op Toevoegen (+) in het bovenste menu en selecteer vervolgens Appregistratie. Op het Een toepassing registreren scherm hernoem je de naam naar Odoo of iets herkenbaars. Selecteer in de Ondersteunde accounttypes sectie Accounts in elke organisatiemap (Elke Microsoft Entra ID map - Multitenant) en persoonlijke Microsoft accounts (bijv. Skype, Xbox).

Selecteer onder het Redirect URL gedeelte Web als platform en voer vervolgens https://<web base url>/microsoft_outlook/confirm in het URL veld in. De web.base.url kan veranderen afhankelijk van de URL die wordt gebruikt om in te loggen in de database.

Nadat de URL is toegevoegd aan het veld, Register de toepassing, zodat deze wordt gemaakt.

API-rechten¶

Vervolgens moeten de API rechten worden ingesteld. Odoo heeft specifieke API rechten nodig om e-mails te kunnen lezen (IMAP) en versturen (SMTP) in de Microsoft 365 setup. Klik eerst op de API permissions link in de linker menubalk. Klik vervolgens op de knop (+) Add a Permission en selecteer Microsoft Graph onder Commonly Used Microsoft APIs. Selecteer daarna de optie Gedelegeerde machtigingen.

Zoek in de zoekbalk naar de volgende Gedelegeerde rechten en klik op Toevoeg rechten voor elk van deze rechten:

• SMTP.Send

• IMAP.AccessAsUser.All

Gebruikers en groepen toewijzen¶

Nadat je de API-rechten hebt toegevoegd, navigeer je terug naar het Overzicht van de Toepassing bovenaan in het menu aan de linkerkant.

Voeg nu gebruikers toe aan deze toepassing. Klik in de overzichtstabel Essentials op de link Managed Application in Local Directory, of op de laatste optie rechtsonder in de tabel.

Selecteer in het menu aan de linkerkant Gebruikers en groepen. Klik vervolgens op (+) Gebruiker/Groep toevoegen. Afhankelijk van het account kun je een Groep en een Gebruiker toevoegen, of alleen Gebruikers. Bij persoonlijke accounts kan alleen Users worden toegevoegd.

Klik onder Users of Groups op None Selected en voeg de gebruikers of gebruikersgroepen toe die e-mails gaan verzenden vanaf de Microsoft account in Odoo. Add de gebruikers/groepen, klik op Selecteer en vervolgens op Assign ze aan de applicatie.

Creëer referenties¶

Nu de Microsoft Azure app is ingesteld, moeten er referenties worden aangemaakt voor de Odoo setup. Deze omvatten de Client ID en Client Secret. Om te beginnen kun je de Client ID kopiëren van de Overview pagina van de app. De Client ID of Application ID staat onder de Display Name in het Essentials overzicht van de app.

Vervolgens moet de Client Secret Value worden opgehaald. Om deze waarde op te halen, klik je op Certificates & Secrets in het menu aan de linkerkant. Vervolgens moet er een Client Secret worden aangemaakt. Klik hiervoor op de (+) New Client Secret knop.

Aan de rechterkant verschijnt een venster met een knop met de tekst Een clientgeheim toevoegen. Typ onder Description Odoo Fetchmail of iets herkenbaars en stel vervolgens de expiration date in.

Klik vervolgens op Add wanneer deze twee waarden zijn ingevoerd. Er wordt een Client Secret Value en Secret ID aangemaakt. Het is belangrijk om de Value of Client Secret Value te kopiëren naar een kladblok, omdat het versleuteld wordt na het verlaten van deze pagina. De geheim ID is niet nodig.

Na deze stappen zouden de volgende onderdelen klaar moeten zijn om ingesteld te worden in Odoo:

• Een client-ID (Client ID of Application ID)

• Een cliëntgeheim (Value of Client Secret Value)

Hiermee is de installatie aan de Microsoft Azure Portal kant voltooid.

Opzetten in Odoo¶

Microsoft Outlook-inloggegevens invoeren¶

Open eerst de Odoo database en navigeer naar de Apps module. Verwijder dan de Apps filter uit de zoekbalk en typ Outlook in. Installeer daarna de module Microsoft Outlook.

Navigeer vervolgens naar Instellingen ‣ Algemene instellingen en controleer onder het Discussie gedeelte of het selectievakje voor Aangepaste e-mailservers is aangevinkt. Hierdoor wordt een nieuwe optie voor Outlook Credentials ingevuld.

De voortgang opslaan.

Kopieer en plak vervolgens de Client ID (Toepassings-ID) en Client Secret (Clientgeheimwaarde) in de respectievelijke velden en Opslaan de instellingen.

Uitgaande e-mailserver configureren¶

Klik op de pagina Algemene instellingen onder de instelling Aangepaste e-mailservers op de koppeling Uitgaande e-mailservers om het Microsoft-account te configureren.

Maak vervolgens een nieuwe e-mailserver aan en vink Outlook aan. Vul vervolgens de Naam in (dit kan van alles zijn) en de Microsoft Outlook e-mail Gebruikersnaam.

Als het Van Filter veld leeg is, voer dan een domein of e-mailadres in.

Klik vervolgens op Maak verbinding met je Outlook-account.

Er wordt een nieuw venster van Microsoft geopend om het autorisatieproces te voltooien. Selecteer het juiste e-mailadres dat wordt geconfigureerd in Odoo.

Geef Odoo dan toegang tot het Microsoft account door te klikken op Ja. Hierna navigeert de pagina terug naar de nieuw geconfigureerde Uitgaande Mail Server in Odoo. De configuratie laadt automatisch de token in Odoo en een tag met de tekst Outlook Token Valid verschijnt in het groen.

Klik ten slotte op Test Connection. Er zou een bevestigingsbericht moeten verschijnen. De Odoo database kan nu veilige, beveiligde e-mails versturen via Microsoft Outlook met behulp van OAuth authenticatie.

Configuratie met één uitgaande mailserver¶

Het configureren van een enkele uitgaande server is de eenvoudigste configuratie die beschikbaar is voor Microsoft Azure en het vereist geen uitgebreide toegangsrechten voor de gebruikers in de database.

Een generiek e-mailadres wordt gebruikt om e-mails te versturen voor alle gebruikers in de database. Het zou bijvoorbeeld gestructureerd kunnen worden met een meldingen alias (notifications@example.com) of contact alias (contact@example.com). Dit adres moet zijn ingesteld als het FROM Filtering op de server. Dit adres moet ook overeenkomen met de {mail.default.from}@{mail.catchall.domain} toetsencombinatie in de systeemparameters.

Als je deze configuratie gebruikt, zal elke e-mail die vanuit de database wordt verzonden het adres van de geconfigureerde notificatie mailbox gebruiken. De naam van de afzender verschijnt wel, maar het e-mailadres verandert:

Gebruikersspecifieke (configuratie voor meerdere gebruikers)¶

Naast een algemene e-mailserver kunnen individuele e-mailservers worden ingesteld voor gebruikers in een database. Deze e-mailadressen moeten worden ingesteld als FROM Filtering op elke individuele server om deze configuratie te laten werken.

Deze configuratie is de moeilijkste van de twee Microsoft Azure configuraties, omdat het vereist dat alle gebruikers die zijn geconfigureerd met e-mailservers toegangsrechten hebben tot instellingen om een verbinding met de e-mailserver tot stand te brengen.

Instellingen¶

Elke gebruiker moet een aparte e-mailserver hebben. De FROM Filtering moet zo worden ingesteld dat alleen de e-mail van de gebruiker vanaf die server wordt verzonden. Met andere woorden, alleen een gebruiker met een e-mailadres dat overeenkomt met de ingestelde FROM Filtering kan deze server gebruiken.

Een fallback server moet worden ingesteld om het verzenden van notifications mogelijk te maken. De FROM Filtering voor deze server moet de waarde {mail.default.from}@{mail.catchall.domain} hebben.

Inkomende e-mailserver configureren¶

De inkomende account moet op dezelfde manier worden geconfigureerd als de uitgaande e-mailaccount. Navigeer naar de Incoming Mail Servers in het Technical Menu en Create een nieuwe configuratie. Vink of selecteer de knop naast Outlook Oauth Authentication en voer de Microsoft Outlook gebruikersnaam in. Klik op Sluit je Outlook account aan. Odoo zal aangeven: Outlook Token Valid Nu Test en Bevestig het account. Het account zou klaar moeten zijn om e-mail te ontvangen in de Odoo database.