Tengja Microsoft Outlook 365 við Odoo með Azure OAuth

Odoo er samhæft við Azure OAuth frá Microsoft fyrir Microsoft 365. Til að senda og taka á móti öruggum tölvupóstum frá sérsniðnu léni þarf aðeins að stilla nokkrar stillingar á Azure-vettvangi og í bakenda Odoo-gagnagrunnsins. Þessi uppsetning virkar bæði með persónulegar netfang og netfang búið til undir sérsniðnu léni.

Uppsetning í Microsoft Azure Portal

Búa til nýtt forrit

Til að byrja skaltu fara á Microsoft Azure Portal. Skráðu þig inn með Microsoft Outlook Office 365-reikninginn ef þú átt einn, annars skaltu skrá þig inn með persónulegan Microsoft-reikning. Notandi með stjórnunarréttindi á Azure-stillingum þarf að tengjast og framkvæma eftirfarandi stillingar. Farðu síðan í hlutann sem heitir Manage Microsoft Entra ID (áður þekkt sem Azure Active Directory).

Smelltu nú á Add (+) efst í valmyndinni og veldu síðan App registration. Á skjánum Register an application skaltu endurnefna Name í Odoo eða eitthvað þekkjanlegt. Undir hlutanum Supported account types skaltu velja Accounts in any organizational directory (Any Microsoft Entra ID directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox).

Undir hlutanum Redirect URL skaltu velja Web sem vettvang og slá síðan inn https:///microsoft_outlook/confirm í reitinn URL. web.base.url getur breyst eftir því hvaða slóð er notuð til að skrá sig inn í gagnagrunninn.

Þegar slóðinni hefur verið bætt við reitinn skaltu smella á Register til að skrá forritið og búa það til.

API-heimildir

Næst þarf að stilla API permissions. Odoo þarf sérstakar API-heimildir til að geta lesið (IMAP) og sent (SMTP) tölvupósta í Microsoft 365-uppsetningunni. Smelltu fyrst á API permissions-tengilinn í vinstri valmyndinni. Smelltu síðan á hnappinn (+) Add a Permission og veldu Microsoft Graph undir Commonly Used Microsoft APIs. Veldu síðan valkostinn Delegated Permissions.

Leitaðu að eftirfarandi Delegated permissions í leitarreitnum og smelltu á Add permissions fyrir hverja:

• SMTP.Send
• IMAP.AccessAsUser.All

Úthluta notendum og hópum

Eftir að API-heimildum hefur verið bætt við skaltu fara aftur í Overview forritsins efst í vinstri hliðarstikunni.

Nú skaltu bæta notendum við þetta forrit. Undir yfirlitsskjánum Essentials skaltu smella á tengilinn sem heitir Managed Application in Local Directory, eða síðasta valkostinn neðst til hægri í töflunni.

Í vinstri hliðarstikunni skaltu velja Users and Groups. Smelltu síðan á (+) Add User/Group. Eftir því hvaða reikningur er í notkun er hægt að bæta við annaðhvort Group og User, eða aðeins Users. Persónulegir reikningar leyfa aðeins að bæta við Users.

Undir Users eða Groups skaltu smella á None Selected og bæta við þeim notendum eða hópi notenda sem munu senda tölvupósta frá Microsoft-reikningnum í Odoo. Smelltu á Add til að bæta við notendum/hópum, smelltu á Select og síðan Assign til að úthluta þeim á forritið.

Búa til skilríki

Nú þegar Microsoft Azure-forritið er sett upp þarf að búa til skilríki fyrir Odoo-uppsetninguna. Þetta felur í sér Client ID og Client Secret. Til að byrja er hægt að afrita Client ID af Overview-síðu forritsins. Client ID eða Application ID er staðsett undir Display Name í Essentials-yfirlitinu.

Næst þarf að sækja Client Secret Value. Til að fá þetta gildi skaltu smella á Certificates & Secrets í vinstri hliðarstikunni. Þá þarf að búa til Client Secret. Til að gera það skaltu smella á hnappinn (+) New Client Secret.

Gluggi opnast til hægri með hnappi sem heitir Add a client secret. Undir Description skaltu slá inn Odoo Fetchmail eða eitthvað þekkjanlegt og stilla síðan expiration date.

Smelltu síðan á Add þegar þessi tvö gildi hafa verið slegin inn. Client Secret Value og Secret ID verða búin til. Mikilvægt er að afrita Value eða Client Secret Value yfir í minnisblokk þar sem það verður dulkóðað þegar farið er af þessari síðu. Secret ID er ekki þörf.

Að þessum skrefum loknum ættu eftirfarandi atriði að vera tilbúin til að setja upp í Odoo:

• Client ID (Client ID eða Application ID)
• Client secret (Value eða Client Secret Value)

Þetta lýkur uppsetningunni á Microsoft Azure Portal-hlið.

Uppsetning í Odoo

Slá inn Microsoft Outlook-skilríki

Opnaðu fyrst Odoo-gagnagrunninn og farðu í eininguna Apps. Fjarlægðu síðan Apps-síuna úr leitarreitnum og sláðu inn Outlook. Settu síðan upp eininguna sem heitir Microsoft Outlook.

Farðu næst í Stillingar → Almennar stillingar og undir hlutanum Discuss skaltu ganga úr skugga um að gátreiturinn fyrir Custom Email Servers sé merktur. Þetta birtir nýjan valkost fyrir Outlook Credentials.

Vistaðu framvinduna með Save.

Afritaðu og límdu síðan Client ID (Application ID) og Client Secret (Client Secret Value) í viðeigandi reiti og vistaðu stillingarnar með Save.

Stilla sendingar-tölvupóstþjón

Á síðunni General Settings, undir stillingunni Custom Email Servers, skaltu smella á tengilinn Outgoing Email Servers til að stilla Microsoft-reikninginn.

Búðu síðan til nýjan tölvupóstþjón og merktu við reitinn fyrir Outlook. Fylltu næst inn Name (getur verið hvað sem er) og Microsoft Outlook-tölvupóstfangið í Username.

Ef reiturinn From Filter er tómur skaltu slá inn annaðhvort lén eða netfang.

Smelltu síðan á Connect your Outlook account.

Nýr gluggi frá Microsoft opnast til að ljúka heimildaferlinu. Veldu viðeigandi netfang sem er verið að stilla í Odoo.

Smelltu síðan á Yes til að gefa Odoo aðgang að Microsoft reikningnum. Eftir það mun síðan fara aftur á nýstillta Outgoing Mail Server í Odoo. Uppsetningin hleður sjálfkrafa token inn í Odoo og grænn merki sem segir Outlook Token Valid birtist.

Smelltu að lokum á Test Connection. Staðfestingarskilaboð ættu að birtast. Odoo gagnagrunnurinn getur nú sent örugg tölvupóst í gegnum Microsoft Outlook með OAuth auðkenningu.

Uppsetning með einum sendipóstþjóni

Að setja upp einn sendipóstþjón er einfaldasta uppsetningin sem völ er á fyrir Microsoft Azure og krefst ekki víðtækra aðgangsréttinda fyrir notendur í gagnagrunninum.

Almenn netfang er notuð til að senda tölvupóst fyrir alla notendur í gagnagrunninum. Til dæmis gæti það verið með notifications samnefni (notifications@example.com) eða contact samnefni (contact@example.com). Þetta netfang verður að vera stillt sem FROM Filtering á þjóninum. Þetta netfang verður einnig að passa við lyklasamsetningu {mail.default.from}@{mail.catchall.domain} í kerfisfæribreytum.

Þegar þessi uppsetning er notuð munu öll tölvupóst sem send eru úr gagnagrunninum nota netfang stilltrar notification pósthólfs. Hins vegar skal tekið fram að nafn sendanda mun birtast en netfang hans mun breytast:

Uppsetning fyrir einstaka notendur (margir notendur)

Auk almennrar tölvupóstþjóns er hægt að setja upp einstakar tölvupóstþjónar fyrir notendur í gagnagrunni. Þessi netföng verða að vera stillt sem FROM Filtering á hverjum einstaklingsbundnum þjóni til að þessi uppsetning virki.

Þessi uppsetning er erfiðari af tveimur Microsoft Azure uppsetningum, þar sem hún krefst þess að allir notendur sem eru stilltir með tölvupóstþjónum hafi aðgangsréttindi að stillingum til að geta tengt sig við tölvupóstþjóninn.

Uppsetning

Hver notandi ætti að hafa sérstakan tölvupóstþjón stilltan. FROM Filtering ætti að vera stillt þannig að aðeins tölvupóstur notandans sé sendur frá þeim þjóni. Með öðrum orðum, aðeins notandi með netfang sem passar við stillt FROM Filtering getur notað þennan þjón.

Setja verður upp varaþjón til að gera kleift að senda tilkynningar. FROM Filtering fyrir þennan þjón ætti að hafa gildið {mail.default.from}@{mail.catchall.domain}.

Stilling á móttökupóstþjóni

Móttökureikninginn ætti að stilla á svipaðan hátt og sendipóstreikninginn. Farðu í Incoming Mail Servers í Technical Menu og búðu til nýja stillingu. Hakaðu við eða veldu hnappinn við hliðina á Outlook Oauth Authentication og sláðu inn Microsoft Outlook notandanafnið. Smelltu á Connect your Outlook account. Odoo mun gefa til kynna: Outlook Token Valid. Smelltu síðan á Test and Confirm reikninginn. Reikningurinn ætti nú að vera tilbúinn til að taka við tölvupósti í Odoo gagnagrunninn.