Kapcsolatközvetítő a Google-höz és a Metához¶

A kapcsolatközvetítő (connection broker) egy központi Odoo-adatbázis, amely egy ellenőrzött Google OAuth-klienst és egy Meta-alkalmazást birtokol, és lehetővé teszi, hogy sok más Odoo-adatbázis (a példányok) rajta keresztül csatlakozzon Google- és Meta-fiókokhoz. A példányok nem hoznak létre alkalmazást a Google-nél vagy a Metánál: az adminisztrátoraik csak a Csatlakozás gombra kattintanak.

Ez az oldal azon vállalatok adminisztrátorainak szól, amelyek a kapcsolatot szolgáltatásként kínálják több adatbázisnak, például egy integrátornak, aki az ügyfelei adatbázisait kezeli. Ha a Google vagy a Meta alkalmazást csak a saját adatbázisában használja, inkább olvassa el a Kapcsolatok oldalt.

Fontos

A közvetítő egy különálló adatbázis, amelyet csak egyszer kell telepíteni. Ne telepítse a Google és Meta alkalmazásokat használó adatbázisokra. Telepítse a Website Tracking Connection Broker modult az Alkalmazások menüből a központi adatbázisban.

Hogyan működik¶

Egy példány adminisztrátora a Bróker szolgáltatás módú kapcsolaton a Csatlakozás gombra kattint.
A példány egy aláírt kéréssel a közvetítőhöz irányítja az adminisztrátort. A közvetítő ellenőrzi a példányt, az aláírást, a visszatérési címet és a kért engedélyeket, majd átirányítja az adminisztrátort a Google vagy a Meta hozzájárulási képernyőjére.
A hozzájárulás után a közvetítő titkosítva őrzi a fiók hosszú élettartamú titkát (a Google frissítő tokenjét vagy a Meta hosszú élettartamú tokenjét), és az adminisztrátort tíz percig érvényes, egyszer használható kóddal küldi vissza a példányhoz.
A példány beváltja a kódot. Ettől kezdve a közvetítőtől kér rövid élettartamú hozzáférési tokeneket, amikor a Google-t vagy a Metát kell hívnia. A hosszú élettartamú titkok soha nem hagyják el a közvetítőt.

A közvetítő soha nem olvassa a példányok adatait: csak az engedélyeket tárolja.

A közvetítő beállítása¶

Lépjen a Beállítások ‣ Követési bróker ‣ Beállítások menüpontra. Az alábbi beállítások mind csak adminisztrátorok számára érhetők el.

Titkosítási kulcs¶

A tokenek egy kulccsal titkosítva tárolódnak. Generáljon egy kulcsot, és adja hozzá a szerver konfigurációs fájljához:

website_tracking_broker_key = <key>

Több kulcsot is megadhat vesszővel elválasztva: az első titkosít, mindegyik visszafejt. Ez lehetővé teszi a kulcs cseréjét. A Tokenek titkosítása beállítás mutatja az Titkosítási kulcs állapota állapotot.

Figyelem

Ha az opció hiányzik a konfigurációs fájlból, az Odoo generál egy kulcsot, és az adatbázisban tárolja. A beállításokban figyelmeztetés jelenik meg. Az adatbázisban tárolt kulcs az adatbázissal együtt elvész: éles környezetben használja a konfigurációs fájlt, és őrizzen egy másolatot a kulcsról biztos helyen. Ha a kulcs elvész, az összes kapcsolatot újra létre kell hozni.

Nyilvános URL¶

A Nyilvános URL beállításban adja meg a közvetítő nyilvános HTTPS-címét (például https://connect.example.com). Ezt kapják meg a példányok. A Google-nél és a Metánál regisztrálandó átirányítási URI-k megjelennek a beállításokban: a cím, amelyet a /broker/google/callback és a /broker/meta/callback követ.

screenshot: general-tracking-broker-settings

menu: Settings ‣ Tracking Broker ‣ Settings
shows: The Tracking Broker settings: the Public URL, the Token Encryption status, the Google OAuth Client with the redirect URI, the Allowed Scopes, the Meta App with the app ID, the secret (hidden), the Graph API version and the redirect URI, and the Allowed Permissions.
highlight: The Public URL and the redirect URIs (red frame).
data: Public URL "https://connect.example.com", secrets hidden.
notes: English UI, light theme, 1440px width. Use a test database.

Google¶

A Google Cloud konzolban hozzon létre egy projektet, és engedélyezze azokat az API-kat, amelyeket az ügyfelei használnak (Content API for Shopping és Merchant API, Google Ads API, Data Manager API, Search Console API, Business Profile APIs, Analytics Admin API).
Állítsa be az OAuth hozzájárulási képernyőt az Ön által engedélyezett hatókörökkel, és hozzon létre egy Web application típusú OAuth-ügyfélazonosítót a beállításokban megjelenő Google átirányítási URI-val.
Adja meg a Bróker Google-ügyfélazonosító és a Bróker Google-ügyfélkulcs értékét az OAuth-ügyfél beállításban.
Ellenőrizze az Engedélyezett Google-hatókörök értékét: azok a hatókörök, amelyeket a példányok kérhetnek, szóközzel elválasztva. Bármilyen más kérés elutasításra kerül.

Fontos

A Google-nek ellenőriznie kell az alkalmazását, mielőtt a szervezetén kívüli személyek érzékeny hatóköröket (Google Ads, Search Console, Business Profile, Merchant Center) adhatnának neki. Az ellenőrzésig az alkalmazás tesztelési módban marad, és az engedélyek néhány nap után lejárnak.

Meta¶

A Meta for Developers oldalon hozzon létre egy Business típusú alkalmazást, és adja hozzá a Facebook Login for Business terméket.
Adja hozzá a beállításokban megjelenő Meta átirányítási URI-t az érvényes OAuth-átirányítási URI-khoz.
Kérje az Ön által engedélyezett engedélyek speciális hozzáférését (alkalmazás-felülvizsgálat).
Adja meg a Bróker Meta-alkalmazásazonosító, a Bróker Meta-alkalmazás titkos kulcsa és a Bróker Graph API verzió értékét a Meta-alkalmazás beállításban, és ellenőrizze az Engedélyezett Meta-jogosultságok értékét.

A példányok regisztrálása¶

Lépjen a Beállítások ‣ Követési bróker ‣ Bróker példányok menüpontra, és hozzon létre ügyféladatbázisonként egy rekordot:

Mező	Leírás
Név és Ügyfél	A példány azonosításához.
Példányazonosító	A példány Odoo által generált azonosítója. Másolja ki.
Bróker URL	A közvetítő címe, amelyet a példánynak meg kell adni.
Google és Meta	A szolgáltatók, amelyeket a példány használhat.
Engedélyezett hosztok	A példány weboldalainak hosztnevei, soronként egy (`www.example.com` vagy `host:port`). A közvetítő csak ezekre a hosztokra irányítja vissza az adminisztrátorokat, amelyeknek HTTPS-t kell használniuk (a sima HTTP a `localhost` esetén elfogadott).

Kattintson a Titkos kulcs megjelenítése gombra. Egy ablak megjeleníti a Bróker URL, az Példányazonosító és a titok értékét. A titok csak egyszer jelenik meg: másolja ki a három értéket, és biztonságosan küldje el a példány adminisztrátorának. Ha a titok elveszik, kattintson a Új titkos kulcs generálása gombra; a példányt ekkor frissíteni kell.

A példány adminisztrátora a három értéket a Weboldal ‣ Konfiguráció ‣ Beállítások ‣ Követés ‣ Kapcsolódási bróker helyen adja meg. Lásd: Connection Broker beállítás.

screenshot: general-tracking-broker-instance

menu: Settings ‣ Tracking Broker ‣ Instances ‣ (an instance)
shows: An instance form with the Show Secret and Generate New Secret buttons, the Instance group (customer, instance ID, broker URL), the Providers group, the Allowed Hosts, and the Grants tab.
highlight: The Show Secret button and the Allowed Hosts (red frame).
data: Instance "Customer website" with host "www.example.com".
notes: English UI, light theme, 1440px width.

A kapcsolatok követése és visszavonása¶

A Beállítások ‣ Követési bróker ‣ Bróker engedélyek felsorolja a közvetítőn keresztül létesített kapcsolatokat: a példányt, a szolgáltatót, a csatlakoztatott fiókot, az utolsó használatot és az állapotot.

Állapot	Jelentés
Függőben	Az adminisztrátor visszatért a hozzájárulási képernyőről, de a példány még nem váltotta be a kódot. A tíz percen belül be nem váltott engedélyek törlődnek.
Aktív	A példány használja az engedélyt.
Hiba	A közvetítő már nem tud tokent szerezni (a felhasználó visszavonta a hozzáférést, lejárt Meta-token). A példány adminisztrátorának újra kell csatlakoznia. Az ok a Utolsó hiba mezőben látható.
Visszavonva	A példány vagy Ön szétkapcsolta.

Kattintson egy engedélyen a Visszavonás gombra a szétkapcsolásához. Az engedély a Google-nél vagy a Metánál is visszavonásra kerül, kivéve, ha egy másik engedély ugyanazt a fiókot használja.

Javaslat

Egy Meta-token körülbelül 60 napig érvényes. A közvetítő automatikusan meghosszabbítja, ha az utolsó hét napban használják, és a Meta engedi. Ha a token korábban lejárt, vagy ha a Meta elutasítja, az állapot Hiba értékre vált, és a példány adminisztrátorának a Újracsatlakozás gombra kell kattintania.

Biztonság¶

A példány minden kérése a titkával alá van írva. A hibás aláírású kérés, az ismeretlen példány vagy a nem engedélyezett szolgáltató elutasításra kerül, és a kérések száma korlátozott.
A közvetítő csak a példány engedélyezett hosztjaira irányít át, és csak az engedélyezett hatóköröket kéri.
A példányok néhány percig érvényes hozzáférési tokeneket (Google) vagy a híváshoz szükséges hosszú élettartamú tokent (Meta) kapnak; a frissítő tokenek titkosítva maradnak a közvetítőben.
Kezelje a közvetítőt érzékeny rendszerként: korlátozza az adatbázisához való hozzáférést, kizárólag HTTPS-t használjon, és készítsen biztonsági másolatot a titkosítási kulcsról.

Lásd még