Microsoft Outlook 365 csatlakoztatása Odoo-hoz Azure OAuth használatával¶
Az Odoo kompatibilis a Microsoft Azure OAuth rendszerével a Microsoft 365-höz. Ahhoz, hogy biztonságos e-maileket küldjön és fogadjon egy egyéni domainről, csak néhány beállítást kell konfigurálni az Azure platformon és az Odoo adatbázis háttérrendszerén. Ez a konfiguráció működik akár személyes e-mail címmel, akár egy egyéni domain által létrehozott címmel.
Beállítás a Microsoft Azure Portálon¶
Új alkalmazás létrehozása¶
A kezdéshez látogasson el a Microsoft Azure Portál-ra. Jelentkezzen be a Microsoft Outlook Office 365 fiókkal, ha van ilyen, ellenkező esetben jelentkezzen be a személyes Microsoft fiókkal. Az Azure Beállításokhoz adminisztratív hozzáféréssel rendelkező felhasználónak kell csatlakoznia és elvégeznie a következő konfigurációt. Ezután navigáljon a Manage Microsoft Entra ID (korábban Azure Active Directory) címkével ellátott szakaszhoz.
Most kattintson a felső menüben található Add (+) gombra, majd válassza a App registration lehetőséget. A Register an application képernyőn nevezze át a Name mezőt Odoo-ra vagy valami felismerhetőre. A Supported account types szakasz alatt válassza a Accounts in any organizational directory (Any Microsoft Entra ID directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox) lehetőséget.
A Redirect URL szakasz alatt válassza a Web platformot, majd írja be a https://<web base url>/microsoft_outlook/confirm címet a URL mezőbe. A web.base.url változhat attól függően, hogy milyen URL-t használnak az adatbázisba való bejelentkezéshez.
Megjegyzés
A web.base.url dokumentációja elmagyarázza, hogyan lehet egy egyedi URL-t rögzíteni. Lehetőség van különböző átirányítási URL-ek hozzáadására is a Microsoft alkalmazásban.
Miután az URL-t hozzáadtuk a mezőhöz, Regisztrálja az alkalmazást, hogy létrejöjjön.
API jogosultságok¶
A következő lépés az API jogosultságok beállítása. Az Odoo-nak specifikus API jogosultságokra lesz szüksége, hogy képes legyen olvasni (IMAP) és küldeni (SMTP) e-maileket a Microsoft 365 beállításban. Először kattintson a bal oldali menüsávban található API jogosultságok linkre. Ezután kattintson a (+) Jogosultság hozzáadása gombra, és válassza a Microsoft Graph lehetőséget a Gyakran használt Microsoft API-k alatt. Ezután válassza a Delegált jogosultságok opciót.
A keresősávban keresse meg a következő Delegált jogosultságokat, és kattintson a Jogosultságok hozzáadása gombra mindegyiknél:
SMTP.Küldés
IMAP.HozzáférésFelhasználóként.Mind
Megjegyzés
A User.Read jogosultság alapértelmezés szerint hozzá lesz adva.
Felhasználók és csoportok hozzárendelése¶
Az API jogosultságok hozzáadása után navigáljon vissza az Áttekintés részhez az Alkalmazás bal oldali menüsávjának tetején.
Most adjon hozzá felhasználókat ehhez az alkalmazáshoz. Az Essentials áttekintő táblázat alatt kattintson a Managed Application in Local Directory feliratú linkre, vagy a táblázat jobb alsó sarkában található utolsó lehetőségre.
A bal oldali menüben válassza a Users and Groups lehetőséget. Ezután kattintson a (+) Add User/Group gombra. A fióktól függően vagy Group és User adható hozzá, vagy csak Users. Személyes fiókok esetén csak Users adható hozzá.
A Users vagy Groups alatt kattintson a None Selected lehetőségre, és adja hozzá azokat a felhasználókat vagy felhasználói csoportokat, akik az Odoo-ban a Microsoft account-ról fognak e-maileket küldeni. Add a felhasználókat/csoportokat, kattintson a Select gombra, majd Assign az alkalmazáshoz.
Hozzon létre hitelesítő adatokat¶
Most, hogy a Microsoft Azure alkalmazás be van állítva, hitelesítő adatokat kell létrehozni az Odoo beállításához. Ezek közé tartozik a Client ID és a Client Secret. Kezdésként a Client ID másolható az alkalmazás Overview oldaláról. A Client ID vagy Application ID az alkalmazás Essentials áttekintésében található a Display Name alatt.
Ezután a Client Secret Value-t kell megszerezni. Ehhez kattintson a bal oldali menüben a Certificates & Secrets lehetőségre. Ezután létre kell hozni egy Client Secret-et. Ehhez kattintson a (+) New Client Secret gombra.
A jobb oldalon megjelenik egy ablak, amelyen egy Add a client secret feliratú gomb található. A Description alatt írja be, hogy Odoo Fetchmail vagy valami felismerhető, majd állítsa be a expiration date-et.
Fontos
Új Client Secret-et kell létrehozni és konfigurálni, ha az első lejár. Ebben az esetben szolgáltatáskimaradás léphet fel, ezért a lejárati dátumot fel kell jegyezni, és a lehető legkésőbbi dátumra kell állítani.
Ezután kattintson a Hozzáadás gombra, amikor ez a két érték meg van adva. Létrejön egy Ügyfél titkos érték és egy Titkos azonosító. Fontos, hogy a Érték vagy Ügyfél titkos érték másolva legyen egy jegyzettömbbe, mivel ez az oldal elhagyása után titkosítva lesz. A Titkos azonosító nem szükséges.
Ezek után a következő elemeknek készen kell állniuk az Odoo-ban történő beállításra:
Egy ügyfél azonosító (Ügyfél azonosító vagy Alkalmazás azonosító)
Egy ügyfél titok (Érték vagy Ügyfél titkos érték)
Ezzel befejeződik a beállítás a Microsoft Azure Portal oldalon.
Beállítás az Odoo-ban¶
Adja meg a Microsoft Outlook hitelesítő adatait¶
Először nyissa meg az Odoo adatbázist, és navigáljon a Alkalmazások modulhoz. Ezután távolítsa el a Alkalmazások szűrőt a keresősávból, és írja be, hogy Outlook. Ezután telepítse a Microsoft Outlook nevű modult.
Ezután navigáljon a menüpontra, és a Beszélgetés szakasz alatt győződjön meg arról, hogy a Egyéni e-mail szerverek jelölőnégyzet be van jelölve. Ez egy új opciót jelenít meg a Outlook hitelesítő adatok számára.
Mentés a folyamatot.
Ezután másolja és illessze be a Ügyfélazonosító (Alkalmazásazonosító) és Ügyféltitok (Ügyféltitok érték) mezőkbe, majd Mentés a beállításokat.
Kimenő e-mail szerver konfigurálása¶
A Általános beállítások oldalon, a Egyéni e-mail szerverek beállítás alatt kattintson a Kimenő e-mail szerverek linkre a Microsoft fiók konfigurálásához.
Ezután hozzon létre egy új e-mail szervert, és jelölje be a Outlook négyzetet. Ezután töltse ki a Név mezőt (bármi lehet) és a Microsoft Outlook e-mail Felhasználónév mezőt.
Ha a Feladó szűrő mező üres, adjon meg egy domaint vagy e-mail címet.
Ezután kattintson a Csatlakoztassa az Outlook fiókját gombra.
Egy új ablak nyílik meg a Microsofttól a engedélyezési folyamat befejezéséhez. Válassza ki a megfelelő e-mail címet, amelyet az Odoo-ban konfigurálnak.
Ezután engedélyezze az Odoo számára a Microsoft fiók elérését a Igen gombra kattintva. Ezt követően az oldal visszatér az újonnan konfigurált Kimenő levelezőszerver-hez az Odoo-ban. A konfiguráció automatikusan betölti a token-t az Odoo-ba, és megjelenik egy zöld színű címke, amelyen a következő áll: Outlook Token Érvényes.
Végül kattintson a Kapcsolat tesztelése gombra. Meg kell jelennie egy megerősítő üzenetnek. Az Odoo adatbázis mostantól biztonságos, védett e-maileket küldhet a Microsoft Outlookon keresztül OAuth hitelesítéssel.
Konfiguráció egyetlen kimenő levelezőszerverrel¶
Egyetlen kimenő szerver konfigurálása a legegyszerűbb elérhető konfiguráció a Microsoft Azure számára, és nem igényel kiterjedt hozzáférési jogokat az adatbázis felhasználói számára.
Egy általános e-mail cím kerülne felhasználásra az adatbázis összes felhasználójának e-mailjeinek küldésére. Például egy notifications alias-szal ([email protected]) vagy contact alias-szal ([email protected]) lehetne strukturálva. Ezt a címet kell beállítani a FROM Szűrés-ként a szerveren. Ennek a címnek meg kell egyeznie a {mail.default.from}@{mail.catchall.domain} kulcskombinációval a rendszerparaméterekben.
Lásd még
Látogassa meg a From Filtering dokumentációt további információkért.
Megjegyzés
A Rendszerparaméterek elérhetők a fejlesztői mód aktiválásával a menüben.
Ezen konfiguráció használatakor minden adatbázisból küldött e-mail a konfigurált notification postafiók címét fogja használni. Azonban meg kell jegyezni, hogy a feladó neve meg fog jelenni, de az e-mail címe megváltozik:
Example
Kimenő levelezőszerver konfigurációja:
Kimenő levelezőszerver felhasználónév (bejelentkezés) =
[email protected]Kimenő levelezőszerver FROM Filtering =
[email protected]mail.catchall.domaina rendszerparaméterekben =example.commail.default.froma rendszerparaméterekben =notifications
Felhasználóspecifikus (több felhasználós) konfiguráció¶
Az általános levelezőszerver mellett egyedi levelezőszerverek is beállíthatók a felhasználók számára egy adatbázisban. Ezeket az email címeket az egyes szervereken FROM Filtering-ként kell beállítani, hogy a konfiguráció működjön.
Ez a konfiguráció a két Microsoft Azure konfiguráció közül a nehezebb, mivel megköveteli, hogy minden felhasználó, aki levelezőszerverrel van konfigurálva, hozzáférési jogokkal rendelkezzen a beállításokhoz, hogy kapcsolatot létesíthessen a levelezőszerverrel.
Beállítás¶
Minden felhasználónak külön levelezőszervert kell beállítani. A FROM Filtering-t úgy kell beállítani, hogy csak a felhasználó emailjei legyenek küldve arról a szerverről. Más szóval, csak az a felhasználó tudja használni ezt a szervert, akinek az email címe megegyezik a beállított FROM Filtering-gel.
Lásd még
Látogassa meg a From Filtering dokumentációt további információkért.
A tartalék szerver beállítása szükséges a értesítések küldésének engedélyezéséhez. Ennek a szervernek a FROM Szűrése értéke a {mail.default.from}@{mail.catchall.domain} legyen.
Megjegyzés
A Rendszerparaméterek elérhetők a fejlesztői mód aktiválásával a menüben.
Fontos
Ennek a tranzakciós e-mail szervernek a konfigurációja együttműködhet egy kimenő tömeges e-mail szerverrel. A tömeges e-mail szerver FROM Szűrése üresen maradhat, de szükséges hozzáadni az Email Marketing alkalmazás beállításaiban.
Lásd még
További információk a tömeges e-mail szerver beállításáról: E-mailek küldése külső SMTP szerverrel.
Example
Több felhasználós kimenő levelezőszerver konfiguráció:
- Felhasználó #1 postafiók
Kimenő levelezőszerver #1 felhasználónév (bejelentkezés) =
[email protected]Kimenő levelezőszerver #1 FROM Szűrése =
[email protected]
- Felhasználó #2 postafiók
Kimenő levelezőszerver #2 felhasználónév (bejelentkezés) =
[email protected]Kimenő levelezőszerver #2 FROM Szűrése =
[email protected]
- Értesítések postafiók
Kimenő levelezőszerver #3 felhasználónév (bejelentkezés) =
[email protected]Kimenő levelezőszerver #3 FROM Szűrés =
[email protected]
- Rendszerparaméterek
mail.catchall.domaina rendszerparaméterekben =example.commail.default.froma rendszerparaméterekben =notifications
Bejövő levelezőszerver konfigurálása¶
A bejövő fiókot hasonló módon kell konfigurálni, mint a kimenő e-mail fiókot. Navigáljon a Bejövő levelezőszerverek részhez a Technikai menüben, és Hozzon létre egy új konfigurációt. Ellenőrizze vagy válassza ki a gombot a Outlook Oauth Hitelesítés mellett, és adja meg a Microsoft Outlook felhasználónevet. Kattintson a Csatlakoztassa az Outlook fiókját gombra. Az Odoo kijelenti: Outlook Token Érvényes. Most Tesztelje és erősítse meg a fiókot. A fiók készen áll az e-mailek fogadására az Odoo adatbázisba.