Broker de conexiune pentru Google și Meta¶
Un broker de conexiune (connection broker) este o bază de date Odoo centrală care deține un singur client OAuth Google verificat și o singură aplicație Meta și permite mai multor baze de date Odoo (instanțele) să se conecteze prin el la conturi Google și Meta. Instanțele nu creează nicio aplicație la Google sau Meta: administratorii lor doar fac clic pe Conectează.
Această pagină este destinată administratorilor unei companii care oferă conexiunea ca serviciu mai multor baze de date, de exemplu un integrator care administrează bazele de date ale clienților săi. Dacă folosiți aplicația Google sau Meta doar în propria bază de date, citiți în schimb Conexiuni.
Important
Brokerul este o bază de date separată, instalată o singură dată. Nu îl instalați pe bazele de date care folosesc aplicațiile Google și Meta. Instalați Website Tracking Connection Broker din în baza de date centrală.
Cum funcționează¶
Administratorul unei instanțe face clic pe Conectează la o conexiune în modul Serviciu broker.
Instanța trimite administratorul la broker cu o cerere semnată. Brokerul verifică instanța, semnătura, adresa de întoarcere și permisiunile solicitate, apoi redirecționează administratorul către ecranul de consimțământ Google sau Meta.
După consimțământ, brokerul păstrează criptat secretul pe termen lung al contului (tokenul de reîmprospătare Google sau tokenul Meta de lungă durată) și trimite administratorul înapoi la instanță cu un cod de unică folosință valabil zece minute.
Instanța valorifică codul. De atunci, cere brokerului tokenuri de acces de scurtă durată când trebuie să apeleze Google sau Meta. Secretele de lungă durată nu părăsesc niciodată brokerul.
Brokerul nu citește niciodată datele instanțelor: păstrează doar autorizările.
Configurarea brokerului¶
Mergeți la . Toate setările de mai jos sunt disponibile doar administratorilor.
Cheie de criptare¶
Tokenurile sunt stocate criptate cu o cheie. Generați o cheie și adăugați-o în fișierul de configurare al serverului:
website_tracking_broker_key = <key>
Puteți enumera mai multe chei separate prin virgule: prima criptează, toate decriptează. Aceasta vă permite să rotiți cheia. Setarea Criptarea tokenurilor afișează Starea cheii de criptare.
Atenționare
Fără opțiunea din fișierul de configurare, Odoo generează o cheie și o păstrează în baza de date. În setări este afișat un avertisment. O cheie stocată în baza de date se pierde odată cu aceasta: folosiți fișierul de configurare în producție și păstrați o copie a cheii într-un loc sigur. Dacă cheia se pierde, toate conexiunile trebuie refăcute.
URL public¶
În setarea URL public, introduceți adresa HTTPS publică a brokerului (de exemplu https://connect.example.com). Aceasta este dată instanțelor. URI-urile de redirecționare de înregistrat la Google și Meta sunt afișate în setări: adresa urmată de /broker/google/callback și /broker/meta/callback.
- 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¶
În consola Google Cloud, creați un proiect și activați API-urile folosite de clienții dumneavoastră (Content API for Shopping și Merchant API, Google Ads API, Data Manager API, Search Console API, Business Profile APIs, Analytics Admin API).
Configurați ecranul de consimțământ OAuth cu domeniile pe care le permiteți și creați un ID de client OAuth de tip Web application cu URI-ul de redirecționare Google afișat în setări.
Introduceți ID client Google al brokerului și Secret client Google al brokerului în setarea Client OAuth.
Verificați Domenii Google permise: domeniile pe care instanțele le pot solicita, separate prin spații. Orice altă cerere este refuzată.
Important
Google trebuie să verifice aplicația dumneavoastră înainte ca persoanele din afara organizației să îi poată acorda domenii sensibile (Google Ads, Search Console, Business Profile, Merchant Center). Până la verificare, aplicația rămâne în modul testing, iar autorizările expiră după câteva zile.
Meta¶
În Meta for Developers, creați o aplicație de tip Business și adăugați produsul Facebook Login for Business.
Adăugați URI-ul de redirecționare Meta afișat în setări la URI-urile de redirecționare OAuth valide.
Solicitați accesul avansat pentru permisiunile pe care le permiteți (revizuirea aplicației).
Introduceți ID aplicație Meta a brokerului, Secretul aplicației Meta a brokerului și Versiunea Graph API a brokerului în setarea Aplicație Meta și verificați Permisiuni Meta permise.
Înregistrarea instanțelor¶
Mergeți la și creați câte o înregistrare pentru fiecare bază de date a clientului:
Câmp |
Descriere |
|---|---|
Nume și Client |
Pentru a recunoaște instanța. |
ID instanță |
Identificatorul instanței, generat de Odoo. Copiați-l. |
URL broker |
Adresa brokerului de dat instanței. |
Google și Meta |
Furnizorii pe care instanța îi poate folosi. |
Gazde permise |
Numele de gazdă ale site-urilor web ale instanței, câte unul pe linie ( |
Faceți clic pe Afișează secretul. O fereastră afișează URL broker, ID instanță și secretul. Secretul este afișat o singură dată: copiați cele trei valori și trimiteți-le în siguranță administratorului instanței. Dacă secretul se pierde, faceți clic pe Generează un secret nou; instanța trebuie apoi actualizată.
Administratorul instanței introduce cele trei valori în . Vezi Setarea Connection Broker.
- 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.
Urmărirea și revocarea conexiunilor¶
listează conexiunile făcute prin broker: instanța, furnizorul, contul conectat, ultima utilizare și starea.
Stare |
Semnificație |
|---|---|
În așteptare |
Administratorul s-a întors de la ecranul de consimțământ, dar instanța nu a valorificat încă codul. Autorizările nevalorificate în zece minute sunt șterse. |
Activ |
Instanța folosește autorizarea. |
Eroare |
Brokerul nu mai poate obține un token (acces revocat de utilizator, token Meta expirat). Administratorul instanței trebuie să se reconecteze. Motivul este afișat în Ultima eroare. |
Revocată |
Deconectat de instanță sau de dumneavoastră. |
Faceți clic pe Revocă la o autorizare pentru a o deconecta. Autorizarea este revocată și la Google sau Meta, cu excepția cazului în care o altă autorizare folosește același cont.
Sfat
Un token Meta durează aproximativ 60 de zile. Brokerul îl prelungește automat când este folosit în ultimele șapte zile și Meta permite acest lucru. Dacă tokenul a expirat mai devreme sau dacă Meta refuză, starea devine Eroare, iar administratorul instanței trebuie să facă clic pe Reconectează.
Securitate¶
Fiecare cerere a unei instanțe este semnată cu secretul acesteia. O cerere cu semnătură greșită, o instanță necunoscută sau un furnizor nepermis este refuzată, iar numărul de cereri este limitat.
Brokerul redirecționează doar către gazdele permise ale instanței și sunt solicitate doar domeniile permise.
Instanțele primesc tokenuri de acces care durează câteva minute (Google) sau tokenul de lungă durată necesar apelului (Meta); tokenurile de reîmprospătare rămân criptate în broker.
Tratați brokerul ca pe un sistem sensibil: restricționați accesul la baza sa de date, folosiți doar HTTPS și faceți o copie de rezervă a cheii de criptare.