Csatlakoztassa a Gmailt az Odoo-hoz a Google OAuth használatával¶
Az Odoo kompatibilis a Google OAuth-tal a Gmailhez. Ahhoz, hogy biztonságos e-maileket küldhessen egyéni domainről, csak néhány beállítást kell konfigurálni a Google Workspace platformján, valamint az Odoo adatbázis háttérrendszerében. Ez a konfiguráció személyes e-mail cím vagy egy egyéni domain által létrehozott cím használatával működik.
Javaslat
További információért látogasson el a Google dokumentációjára az OAuth beállításáról.
Beállítás a Google-ben¶
Új projekt létrehozása¶
A kezdéshez látogasson el a Google API Console oldalra. Jelentkezzen be Google Workspace fiókjával, ha van ilyen, ellenkező esetben jelentkezzen be személyes Gmail fiókjával (ennek meg kell egyeznie azzal az email címmel, amelyet az Odoo-ban szeretne beállítani).
Ezt követően kattintson a Create Project gombra, amely a OAuth consent screen jobb oldalán található. Ha már létrehoztak egy projektet ebben a fiókban, akkor az New Project opció a jobb felső sarokban található a Select a project legördülő menü alatt.
A képernyőn nevezze át a Project name mezőt Odoo-ra, és keresse meg a Location mezőt. Állítsa be a Location mezőt a Google Workspace szervezet értékre. Ha személyes Gmail fiókot használ, akkor hagyja a Location mezőt No Organization értéken.
Kattintson a Create gombra a lépés befejezéséhez.
OAuth beleegyezési képernyő¶
Ha az oldal nem irányít át a opciókra, kattintson a OAuth consent screen elemre a bal oldali menüben.
A Felhasználói típus opciók alatt válassza ki a megfelelő Felhasználói típust, majd kattintson ismét a Létrehozás gombra, amely végül a oldalra navigál.
Figyelem
Személyes Gmail fiókok csak Külső felhasználói típusúak lehetnek, ami azt jelenti, hogy a Google jóváhagyást kérhet, vagy Hatáskörök hozzáadását. Azonban, ha Google WorkSpace fiókot használ, akkor Belső felhasználói típus is használható.
Vegye figyelembe, hogy amíg az API kapcsolat Külső tesztelési módban van, addig nincs szükség Google jóváhagyásra. A felhasználói korlát ebben a tesztelési módban 100 felhasználóra van beállítva.
Alkalmazás regisztráció szerkesztése¶
Ezután konfiguráljuk a projekt alkalmazás regisztrációját.
A OAuth beleegyezési képernyő lépésnél, a Alkalmazás információ szakasz alatt írja be az Odoo-t az Alkalmazás neve mezőbe. Válassza ki a szervezet e-mail címét a Felhasználói támogatás e-mail mező alatt.
Ezután, a alatt kattintson a Domain hozzáadása gombra, és írja be az odoo.com-ot.
Ezt követően, a Fejlesztői kapcsolattartási információk szakasz alatt írja be a szervezet e-mail címét. A Google ezt az e-mail címet használja, hogy értesítse a szervezetet a projekt bármilyen változásáról.
Ezután kattintson a Mentés és folytatás gombra. Ezután görgessen az oldal aljára, és kattintson a Mentés és folytatás gombra a oldal kihagyásához.
Ha a tesztelési módban (Külső) folytatja, adja hozzá a konfigurált e-mail címeket a Teszt felhasználók lépésnél, a Felhasználók hozzáadása gombra kattintva, majd a Mentés és folytatás gombra. Megjelenik az alkalmazás regisztráció összefoglalója.
Végül görgessen az oldal aljára, és kattintson a Vissza a vezérlőpulthoz gombra a projekt beállításának befejezéséhez.
Hozzon létre hitelesítő adatokat¶
Most, hogy a projekt be van állítva, hitelesítő adatokat kell létrehozni, amelyek tartalmazzák a Kliensazonosítót és a Kliens titkot. Először kattintson a bal oldali menüben a Hitelesítő adatok elemre.
Ezután kattintson a felső menüben a Hitelesítő adatok létrehozása gombra, és válassza ki a OAuth kliensazonosító lehetőséget a legördülő menüből.
A Alkalmazás típusa alatt válassza ki a Webalkalmazás lehetőséget a legördülő menüből.
A Név mezőbe írja be, hogy
Odoo.A Engedélyezett átirányítási URI-k címke alatt kattintson az URI HOZZÁADÁSA gombra, majd írja be a
https://yourdbname.odoo.com/google_gmail/confirmcímet az URI-k 1 mezőbe. Ügyeljen arra, hogy az URL yourdbname részét cserélje le az Odoo adatbázis tényleges nevére.Ezután kattintson a Létrehozás gombra az OAuth Kliensazonosító és Kliens titok generálásához. Végül másolja ki az egyes generált értékeket későbbi használatra az Odoo konfigurálásakor, majd navigáljon az Odoo adatbázisba.
Beállítás az Odoo-ban¶
Adja meg a Google hitelesítő adatokat¶
Először nyissa meg az Odoo-t, és navigáljon a Apps modulhoz. Ezután távolítsa el a Apps szűrőt a keresősávból, és írja be, hogy Google. Telepítse a Google Gmail nevű modult.
Ezután navigáljon a menüpontra, és a Discuss szekció alatt győződjön meg róla, hogy a Custom Email Servers vagy External Email Servers jelölőnégyzet be van jelölve. Ez új opciót ad hozzá a Gmail Credentials vagy Use a Gmail Sever számára. Ezután másolja és illessze be a megfelelő értékeket a Client ID és Client Secret mezőkbe, majd Save a beállításokat.
Kimenő e-mail szerver konfigurálása¶
Az külső Gmail fiók konfigurálásához térjen vissza a Custom Email Servers beállítás tetejére, majd kattintson a Outgoing Email Servers linkre.
Ezután kattintson a New vagy Create gombra egy új e-mail szerver létrehozásához, és töltse ki a Name, Description és az e-mail Username (ha szükséges) mezőket.
Ezután kattintson a Gmail OAuth Authentication vagy Gmail (a Authenticate with vagy Connection szekció alatt). Végül kattintson a Connect your Gmail Account gombra.
Egy új ablak nyílik meg Google címkével az engedélyezési folyamat befejezéséhez. Válassza ki a megfelelő e-mail címet, amelyet az Odoo-ban konfigurálnak.
Ha az e-mail cím személyes fiók, akkor egy extra lépés jelenik meg, így kattintson a Continue gombra a hitelesítés engedélyezéséhez és a Gmail fiók Odoo-hoz való csatlakoztatásához.
Ezután engedélyezze az Odoo számára a Google fiókhoz való hozzáférést a Continue vagy Allow gombra kattintva. Ezt követően az oldal visszatér az újonnan konfigurált kimenő e-mail szerverhez az Odoo-ban. A konfiguráció automatikusan betölti a tokent az Odoo-ba, és egy zöld Gmail Token Valid címke jelenik meg.
Végül Test the Connection. Meg kell jelennie egy megerősítő üzenetnek. Az Odoo adatbázis mostantól biztonságos, védett e-maileket küldhet a Google-on keresztül OAuth hitelesítéssel.
Google OAuth GYIK¶
Éles VS Tesztelési Kiadási Állapot¶
A Éles kiválasztása a Kiadási Állapot-ként (a Tesztelés helyett) a következő figyelmeztető üzenetet jeleníti meg:
A figyelmeztetés kijavításához navigáljon a Google API Platform oldalra. Ha a Kiadási állapot Éles, kattintson a Vissza a teszteléshez lehetőségre a probléma megoldásához.
Nincsenek hozzáadott tesztfelhasználók¶
Ha nincsenek tesztfelhasználók hozzáadva az OAuth beleegyezési képernyőhöz, akkor egy 403 hozzáférés megtagadva hiba jelenik meg.
A hiba kijavításához térjen vissza az OAuth beleegyezési képernyő-höz az API-k és Szolgáltatások alatt, és adjon hozzá tesztfelhasználó(ka)t az alkalmazáshoz. Adja hozzá az e-mail címet, amelyet az Odoo-ban konfigurál.
Gmail modul nincs frissítve¶
Ha az Odoo Google Gmail modulja nincs frissítve a legújabb verzióra, akkor egy Forbidden hibaüzenet jelenik meg.
A hiba kijavításához lépjen a modulba, és törölje a keresési kifejezéseket. Ezután keressen rá a Gmail vagy Google kifejezésre, és frissítse a Google Gmail modult. Végül kattintson a modul jobb felső sarkában található három pontra, és válassza a Upgrade lehetőséget.
Alkalmazás típusa¶
A hitelesítő adatok (OAuth Client ID és Client Secret) létrehozásakor, ha a Desktop App van kiválasztva az Application Type mezőben, egy Authorization Error jelenik meg.
A hiba kijavításához törölje a már létrehozott hitelesítő adatokat, és hozzon létre újakat, az Application Type mezőben a Web Application kiválasztásával. Ezután az Authorized redirect URIs alatt kattintson a ADD URI gombra, és írja be a következőt a mezőbe: https://yourdbname.odoo.com/google_gmail/confirm, ügyelve arra, hogy az URL-ben a yourdbname helyére az Odoo adatbázis nevét írja.