Tengja Gmail við Odoo með Google OAuth

Odoo er samhæft við Google OAuth fyrir Gmail. Til að senda örugg tölvupóst frá sérsniðnu léni þarf aðeins að stilla nokkrar stillingar á Workspace-vettvangi Google, sem og í bakenda Odoo gagnagrunnsins. Þessi uppsetning virkar hvort sem notað er persónulegt netfang eða netfang búið til undir sérsniðnu léni.

Uppsetning í Google

Búa til nýtt verkefni

Til að byrja skaltu fara á Google API Console. Skráðu þig inn með Google Workspace-reikningnum þínum ef þú ert með slíkan, annars skaltu skrá þig inn með persónulega Gmail-reikningnum þínum (þetta ætti að vera sama netfangið og þú vilt stilla í Odoo).

Smelltu síðan á Create Project, sem er staðsett lengst til hægri á OAuth consent screen. Ef verkefni hefur þegar verið búið til á þessum reikningi, þá er New Project valkosturinn staðsettur efst til hægri undir fellivalmyndinni Select a project.

Á skjánum New Project skaltu endurnefna Project name í Odoo og velja Location. Stilltu Location sem Google Workspace organization. Ef þú ert að nota persónulegan Gmail-reikning skaltu skilja Location eftir sem No Organization.

Smelltu á Create til að ljúka þessum skref.

OAuth samþykktarskjár

Ef síðan vísar þér ekki sjálfkrafa á valkosti User Type, smelltu þá á OAuth consent screen í vinstri valmyndinni.

Undir valkostum User Type skaltu velja viðeigandi User Type og smella síðan á Create aftur, sem mun loks vísa þér á síðuna Edit app registration.

Breyta skráningu forrits

Næst munum við stilla skráningu forritsins fyrir verkefnið.

Á skrefinu OAuth consent screen, undir hlutanum App information, skaltu slá inn Odoo í reitinn App name. Veldu netfang fyrirtækisins undir reitnum User support email.

Næst, undir App Domain → Authorized domains, smelltu á Add Domain og sláðu inn odoo.com.

Eftir það, undir hlutanum Developer contact information, sláðu inn netfang fyrirtækisins. Google notar þetta netfang til að tilkynna fyrirtækinu um breytingar á verkefninu þínu.

Smelltu síðan á hnappinn Save and Continue. Slepptu síðan síðunni Scopes með því að skruna niður og smella á Save and Continue.

Ef haldið er áfram í prófunarham (External), bættu þá við netföngunum sem verið er að stilla undir skrefinu Test users með því að smella á Add Users og síðan á hnappinn Save and Continue. Samantekt á skráningu forritsins birtist.

Að lokum skaltu skruna niður og smella á Back to Dashboard til að ljúka uppsetningu verkefnisins.

Búa til skilríki

Nú þegar verkefnið er sett upp þarf að búa til skilríki, sem innihalda Client ID og Client Secret. Smelltu fyrst á Credentials í vinstri hliðarstikunni.

Smelltu síðan á Create Credentials í efstu valmyndinni og veldu OAuth client ID úr fellivalmyndinni.

• Undir Application Type skaltu velja Web Application úr fellivalmyndinni.
• Í reitinn Name skaltu slá inn Odoo.
• Undir merkimiðanum Authorized redirect URIs skaltu smella á hnappinn ADD URI og slá síðan inn https://yourdbname.odoo.com/google_gmail/confirm í reitinn URIs 1. Gakktu úr skugga um að skipta út hlutanum yourdbname í slóðinni fyrir raunverulegt heiti Odoo gagnagrunnsins.
• Smelltu næst á Create til að búa til OAuth Client ID og Client Secret. Afritaðu að lokum hvort gildi fyrir sig til notkunar síðar við stillingu í Odoo og farðu síðan í Odoo gagnagrunninn.

Uppsetning í Odoo

Slá inn Google skilríki

Opnaðu fyrst Odoo og farðu í eininguna Apps. Fjarlægðu síðan síuna Apps úr leitarstikunni og sláðu inn Google. Settu upp eininguna sem heitir Google Gmail.

Farðu næst í Stillingar → Almennar stillingar og undir hlutanum Discuss skaltu ganga úr skugga um að gátreiturinn fyrir Custom Email Servers eða External Email Servers sé merktur. Þetta birtir nýjan valkost fyrir Gmail Credentials eða Use a Gmail Server. Afritaðu og límdu viðeigandi gildi í reitina Client ID og Client Secret og vistaðu stillingarnar.

Stilla sendandi tölvupóstþjón

Til að stilla ytri Gmail-reikninginn skaltu fara aftur efst á stillinguna Custom Email Servers og smella síðan á tengilinn Outgoing Email Servers.

Smelltu síðan á New eða Create til að búa til nýjan tölvupóstþjón og fylltu inn Name, Description og netfang Username (ef þörf krefur).

Smelltu næst á Gmail OAuth Authentication eða Gmail (undir hlutanum Authenticate with eða Connection). Smelltu að lokum á Connect your Gmail Account.

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

Ef netfangið er persónulegur reikningur birtist aukaskref, svo smelltu á Continue til að leyfa staðfestinguna og tengja Gmail-reikninginn við Odoo.

Leyfðu síðan Odoo að fá aðgang að Google-reikningnum með því að smella á Continue eða Allow. Eftir það vísar síðan aftur á nýstillta sendandi tölvupóstþjóninn í Odoo. Stillingin hleður tókenið sjálfkrafa inn í Odoo og merki sem segir Gmail Token Valid birtist með grænum lit.

Að lokum skaltu smella á Test the Connection. Staðfestingarskilaboð ættu að birtast. Odoo gagnagrunnurinn getur nú sent örugg tölvupóst í gegnum Google með OAuth-auðkenningu.

Google OAuth algengar spurningar

Birting í framleiðslu á móti prófun

Ef valið er Production sem Publishing Status (í stað Testing) birtast eftirfarandi viðvörunarskilaboð:

Til að leiðrétta þessa viðvörun skaltu fara á Google API Platform. Ef Publishing status er In Production skaltu smella á Back to Testing til að leiðrétta vandamálið.

Engir prófunarnotendur bætt við

Ef engir prófunarnotendur eru bætt við OAuth samþykktarskjáinn birtist 403 aðgangssynjunarvilla.

Til að leiðrétta þessa villu skaltu fara aftur á OAuth consent screen undir APIs & Services og bæta prófunarnotanda/notendum við forritið. Bættu við netfanginu sem þú ert að stilla í Odoo.

Gmail-eining ekki uppfærð

Ef Google Gmail-einingin í Odoo hefur ekki verið uppfærð í nýjustu útgáfuna birtast Forbidden villuskilaboð.

Til að leiðrétta þennan villu skaltu fara í eininguna Forrit og hreinsa leitarskilyrðin. Leitaðu síðan að Gmail eða Google og uppfærðu eininguna Google Gmail. Smelltu að lokum á þrjá punktana efst til hægri á einingunni og veldu Uppfæra.

Tegund forrits

Þegar skilríki eru búin til (OAuth Client ID og Client Secret), ef Desktop App er valið sem Tegund forrits, birtist Heimildarvilla.

Til að leiðrétta þennan villu skaltu eyða skilríkjunum sem þegar hafa verið búin til og búa til ný skilríki þar sem þú velur Web Application sem Tegund forrits. Síðan, undir Authorized redirect URIs, smelltu á ADD URI og sláðu inn: https://yourdbname.odoo.com/google_gmail/confirm í reitinn. Gakktu úr skugga um að skipta út yourdbname í slóðinni fyrir nafn Odoo gagnagrunnsins þíns.