Anslut Microsoft Outlook 365 till Odoo med Azure OAuth¶

Odoo är kompatibelt med Microsofts Azure OAuth för Microsoft 365. För att kunna skicka och ta emot säkra e-postmeddelanden från en anpassad domän behöver du bara konfigurera några inställningar på Azure-plattformen och på Odoo-databasens backend. Denna konfiguration fungerar med antingen en personlig e-postadress eller en adress som skapats av en anpassad domän.

Installation i Microsoft Azure Portal¶

Skapa en ny applikation¶

För att komma igång, gå till Microsofts Azure Portal. Logga in med Microsoft Outlook Office 365-kontot om det finns ett sådant, annars loggar du in med det personliga Microsoft-kontot. En användare med administrativ åtkomst till Azure-inställningarna måste ansluta och utföra följande konfiguration. Navigera sedan till avsnittet Manage Microsoft Entra ID (formellt Azure Active Directory).

Klicka nu på Add (+), som finns i toppmenyn, och välj sedan App registration. På skärmen Registrera en applikation byter du namn på Namn till Odoo eller något annat igenkännbart. I avsnittet Supported account types väljer du Accounts in any organizational directory (Any Microsoft Entra ID directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox).

Under the Redirect URL section, select Web as the platform, and then input https://<web base url>/microsoft_outlook/confirm in the URL field. The web.base.url is subject to change depending on the URL used to log in to the database.

After the URL has been added to the field, Register the application, so it is created.

API-behörigheter¶

Därefter ska API-behörigheter ställas in. Odoo behöver specifika API-behörigheter för att kunna läsa (IMAP) och skicka (SMTP) e-postmeddelanden i Microsoft 365-installationen. Klicka först på länken API-behörigheter, som finns i det vänstra menyfältet. Klicka sedan på knappen (+) Lägg till en behörighet och välj Microsoft Graph under Commonly Used Microsoft APIs. Välj sedan alternativet Delegerade behörigheter.

Sök efter följande Delegerade behörigheter i sökfältet och klicka på Lägg till behörigheter för var och en av dem:

• SMTP.Send

• IMAP.AccessAsUser.All

Tilldela användare och grupper¶

När du har lagt till API-behörigheterna navigerar du tillbaka till Overview för Application högst upp i den vänstra sidofältmenyn.

Lägg nu till användare i programmet. Under översiktstabellen Essentials klickar du på länken Managed Application in Local Directory, eller det sista alternativet längst ned till höger i tabellen.

I menyn till vänster väljer du Användare och grupper. Klicka sedan på (+) Lägg till användare/grupp. Beroende på kontot kan antingen en Grupp och en Användare läggas till, eller bara Användare. Personliga konton tillåter endast att Users läggs till.

Under Users eller Groups, klicka på None Selected och lägg till de användare eller grupper av användare som ska skicka e-post från Microsoft account i Odoo. Add användarna/grupperna, klicka på Select och sedan Assign dem till applikationen.

Skapa autentiseringsuppgifter¶

Nu när Microsoft Azure-appen är konfigurerad måste autentiseringsuppgifter skapas för Odoo-installationen. Dessa inkluderar Client ID och Client Secret. Till att börja med kan Client ID kopieras från Overview-sidan i appen. Klient-ID eller Applikations-ID finns under Displaynamn i Essentials -översikten för appen.

Därefter måste Client Secret Value hämtas. För att få detta värde, klicka på Certificates & Secrets i den vänstra sidomenyn. Sedan måste en Client Secret produceras. För att göra detta klickar du på knappen (+) New Client Secret.

Ett fönster till höger kommer att fyllas med en knapp märkt Add a client secret. Under Description skriver du in Odoo Fetchmail eller något igenkännbart och anger sedan expiration date.

Klicka sedan på Add när dessa två värden har angetts. En Client Secret Value och Secret ID kommer att skapas. Det är viktigt att kopiera Value eller Client Secret Value till ett anteckningsblock eftersom det kommer att krypteras när du lämnar den här sidan. Secret ID behövs inte.

Efter dessa steg bör följande objekt vara redo att konfigureras i Odoo:

• Ett klient-ID (Client ID eller Application ID)

• En klienthemlighet (Value eller Client Secret Value)

Detta slutför installationen på Microsoft Azure Portal-sidan.

Installation i Odoo¶

Ange autentiseringsuppgifter för Microsoft Outlook¶

Öppna först Odoo-databasen och navigera till modulen Apps. Ta sedan bort filtret Apps från sökfältet och skriv in Outlook. Därefter installerar du modulen som heter Microsoft Outlook.

Gå sedan till Inställningar ‣ Allmänna inställningar, och under avsnittet Diskutera, se till att kryssrutan för Egendefinierade e-postservrar är markerad. Detta fyller i ett nytt alternativ för Outlook Credentials.

Spara framstegen.

Kopiera och klistra sedan in Client ID (Application ID) och Client Secret (Client Secret Value) i respektive fält och Save inställningarna.

Konfigurera server för utgående e-post¶

På sidan General Settings, under inställningen Custom Email Servers, klickar du på länken Outgoing Email Servers för att konfigurera Microsoft-kontot.

Skapa sedan en ny e-postserver och markera rutan för Outlook. Fyll sedan i Name (det kan vara vad som helst) och Microsoft Outlook-e-post Username.

Om fältet Från filter är tomt, ange antingen en domän eller e-postadress.

Klicka sedan på Anslut ditt Outlook-konto.

Ett nytt fönster från Microsoft öppnas för att slutföra auktoriseringsprocessen. Välj lämplig e-postadress som konfigureras i Odoo.

Tillåt sedan Odoo att komma åt Microsoft-kontot genom att klicka på Ja. Efter detta kommer sidan att navigera tillbaka till den nyligen konfigurerade Outgoing Mail Server i Odoo. Konfigurationen laddar automatiskt token i Odoo, och en tagg som anger Outlook Token Valid visas i grönt.

Slutligen klickar du på Test Connection. Ett bekräftelsemeddelande bör visas. Odoo-databasen kan nu skicka säkra, säkra e-postmeddelanden via Microsoft Outlook med OAuth-autentisering.

Konfiguration med en enda utgående e-postserver¶

Att konfigurera en enda utgående server är den enklaste konfigurationen som finns för Microsoft Azure och den kräver inte omfattande åtkomsträttigheter för användarna i databasen.

En generisk e-postadress används för att skicka e-postmeddelanden till alla användare i databasen. Den kan till exempel vara strukturerad med ett notifications-alias (notifications@example.com) eller contact-alias (contact@example.com). Denna adress måste vara inställd som FROM Filtering på servern. Adressen måste också matcha nyckelkombinationen {mail.default.from}@{mail.catchall.domain} i systemparametrarna.

När du använder den här konfigurationen kommer varje e-postmeddelande som skickas från databasen att använda adressen till den konfigurerade notification-postlådan. Det bör dock noteras att avsändarens namn kommer att visas men att e-postadressen kommer att ändras:

Användarspecifik konfiguration (flera användare)¶

Förutom en generisk e-postserver kan individuella e-postservrar konfigureras för användare i en databas. Dessa e-postadresser måste anges som FROM Filtering på varje enskild server för att den här konfigurationen ska fungera.

Denna konfiguration är den svåraste av de två Microsoft Azure-konfigurationerna, eftersom den kräver att alla användare som är konfigurerade med e-postservrar har åtkomsträttigheter till inställningar för att kunna upprätta en anslutning till e-postservern.

Inställning¶

Varje användare bör ha en separat e-postserver. FROM Filtering bör ställas in så att endast användarens e-post skickas från den servern. Med andra ord, endast en användare med en e-postadress som matchar inställningen FROM Filtering kan använda den här servern.

En fallback server måste konfigureras för att tillåta sändning av notifications. FROM Filtering för denna server bör ha värdet {mail.default.from}@{mail.catchall.domain}.

Konfigurera server för inkommande e-post¶

Det inkommande kontot bör konfigureras på samma sätt som det utgående e-postkontot. Gå till Incoming Mail Servers i Technical Menu och Create en ny konfiguration. Markera eller kryssa i knappen bredvid Outlook Oauth Authentication och ange Microsoft Outlook-användarnamnet. Klicka på Anslut ditt Outlook-konto. Odoo kommer att säga: Outlook Token Valid Nu Test and Confirm kontot. Kontot ska nu vara redo att ta emot e-post till Odoo-databasen.