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.

Zie ook

  • /applicaties/algemeen/gebruikers/azure

  • /applicaties/productiviteit/kalender/outlook

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.

Notitie

In de documentatie over de web.base.url wordt uitgelegd hoe je een unieke URL kunt bevriezen. Het is ook mogelijk om verschillende redirect URL’s toe te voegen aan de Microsoft app.

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

Notitie

De User.Read toestemming wordt standaard toegevoegd.

API rechten die nodig zijn voor Odoo integratie staan vermeld onder Microsoft Graph.

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.

Voeg gebruikers/groepen toe door te klikken op de koppeling Beheertoepassing in lokale map voor de aangemaakte applicatie.

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.

Application/Client ID in het 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.

Belangrijk

Een nieuw Client Secret moet worden aangemaakt en geconfigureerd als het eerste verloopt. In dit geval kan er een onderbreking van de service optreden, dus de vervaldatum moet worden genoteerd en op de verst mogelijke datum worden ingesteld.

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.

Client Secret Value of Waarde in de referenties van de app.

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.

Outlook Credentials in Odoo Algemene 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.

If the From Filter field is empty, enter either a domain or email address.

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.

Toestemmingpagina om toegang te verlenen tussen de nieuw aangemaakte app en 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.

Geldige Outlook Token indicator.

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.

Zie ook

For more information on the from filter visit: Gebruik een standaard “Van” e-mailadres.

Notitie

De Systeemparameters is toegankelijk door Ontwikkelaarsmodus (debugmodus) te activeren in het :menuselectie:`Instellingen --> Technisch --> Parameters --> Systeemparameters` menu.

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:

Naam van echte afzender met statische e-mail.

Example

Enkele uitgaande mailserver configuratie:

  • Uitgaande mailserver gebruikersnaam (login) = notifications@example.com

  • Uitgaande mailserver FROM Filtering = notifications@example.com

  • mail.catchall.domain in systeemparameters = voorbeeld.com

  • mail.default.from in systeemparameters = meldingen

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.

Zie ook

For more information on the from filter visit: Gebruik een standaard “Van” e-mailadres.

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.

Notitie

De Systeemparameters is toegankelijk door Ontwikkelaarsmodus (debugmodus) te activeren in het :menuselectie:`Instellingen --> Technisch --> Parameters --> Systeemparameters` menu.

Belangrijk

De configuratie voor deze transactionele e-mailserver kan naast een uitgaande mass-mailing e-mailserver werken. Het FROM Filtering voor de mass-mailing e-mailserver kan leeg blijven, maar moet worden toegevoegd in de instellingen van de Email Marketing toepassing.

Zie ook

For more information on setting the mass-mailing email server visit Verschillende dedicated servers configureren voor transactionele en massamails..

Example

Configuratie uitgaande mailserver voor meerdere gebruikers:

  • Gebruiker #1 mailbox
    • Uitgaande mailserver #1 gebruikersnaam (login) = john@example.com

    • Uitgaande mailserver #1 FROM Filtering = john@example.com

  • Gebruiker #2 mailbox
    • Uitgaande mailserver #2 gebruikersnaam (login) = jane@example.com

    • Uitgaande mailserver #2 FROM Filtering = jane@example.com

  • Meldingen mailbox
    • Uitgaande mailserver #3 username (login) = notifications@example.com

    • Uitgaande mailserver #3 FROM Filtering = notifications@example.com

  • Systeemparameters
    • mail.catchall.domain in systeemparameters = voorbeeld.com

    • mail.default.from in systeemparameters = meldingen

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.