Ugrás a fő tartalomhoz
Egyes szolgáltatások, például energia-, banki vagy iparági adatszolgáltatók, csak akkor osztanak meg adatokat, ha a fiók tulajdonosa a szolgáltatás saját oldalán bejelentkezik, és jóváhagyja a hozzáférést. Ezt OAuth2-nek nevezzük. Ha a szolgáltatás nem szerepel az összekötők katalógusában, akkor is csatlakoztathatja: kérje meg az MI-csevegést, hogy backend-függvényekkel építse fel a bejelentkezési folyamatot.

A megfelelő lehetőség kiválasztása

A Base44 többféle módon is elérhet egy másik szolgáltatást. A saját bejelentkezési folyamat építése a legtöbb munkával jár, ezért előbb nézze meg, hogy egy egyszerűbb lehetőség lefedi-e a szolgáltatást. Válassza a szolgáltatásnak megfelelő lehetőséget:
  • A szolgáltatás szerepel az összekötők katalógusában: Használjon összekötőt. A Base44 kezeli a bejelentkezést, tárolja a tokeneket, és frissen tartja őket. Az alkalmazásfelhasználói összekötővel mindenki a saját fiókját csatlakoztathatja. Ha egy katalógusbeli összekötő saját OAuth-klienst kér, az is összekötő, így nincs szüksége erre az oldalra.
  • A szolgáltatás API-kulcsot ad: Mentse a kulcsot titkos adatként, és kérje meg az MI-csevegést, hogy backend-függvényből hívja a szolgáltatást. Ha egy API-t a teljes munkaterületen meg szeretne osztani, használjon egyéni OpenAPI-integrációt.
  • A szolgáltatás OAuth2-bejelentkezést igényel, és nem összekötő: Építse fel a folyamatot backend-függvényekkel, ahogy ez az oldal leírja.
Az egyéni OpenAPI-integrációk és az MCP-kapcsolatok nem tudják az egyes felhasználók saját fiókját csatlakoztatni. Egy egyéni OpenAPI-integráció minden hívással ugyanazokat a bejelentkezési adatokat küldi, bárki használja is az alkalmazást. Az Ön által hozzáadott MCP-kapcsolatok csak az MI-csevegésnek szólnak az építés közben, a közzétett alkalmazásnak nem.

Hogyan működik

A Base44 nem tárolja és nem frissíti a katalóguson kívüli szolgáltatások tokenjeit, ezért ezt az alkalmazás saját backend-függvényei végzik. Ezeket az MI-csevegés írja meg Ön helyett. Egy egyéni bejelentkezési folyamat 4 részből áll:
  • Csatlakozás gomb: Egy backend-függvény a szolgáltatás bejelentkezési oldalára küldi a felhasználót egy egyszeri kóddal, amely a kérést hozzá köti.
  • Visszahívási függvény: Miután a felhasználó jóváhagyta a hozzáférést, a szolgáltatás visszaküldi őt az alkalmazás egy backend-függvényéhez. Ez ellenőrzi az egyszeri kódot, és a szolgáltatás válaszát az adott felhasználó tokenjeire cseréli.
  • Tokentábla: A tokenek egy adattáblába mentődnek, felhasználónként egy rekordba. Csak a backend-függvények olvassák, az alkalmazás oldalai soha.
  • API-függvények: A backend-függvények az adott felhasználó tokenjével hívják a szolgáltatást, és a frissítési tokennel újat kérnek, amikor lejár.
Az alkalmazásnak bejelentkezést kell kérnie a felhasználóktól, hogy tudja, kié az egyes kapcsolatok. További információ a Bejelentkezés és regisztráció kezelése oldalon.

Az OAuth-alkalmazás regisztrálása

Mielőtt az alkalmazás bárkit bejelentkeztethetne, regisztrálnia kell a szolgáltatásnál. A szolgáltatás ad egy ügyfélazonosítót (client ID) és egy titkos ügyfélkulcsot (client secret), és megkérdezi, hová küldje vissza a felhasználókat a bejelentkezés után. Ez a cím a visszahívási függvény nyilvános URL-je. Minden backend-függvénynek saját nyilvános URL-je van, ebben a formátumban:
Azt a címet használja, amelyen a felhasználók az alkalmazást megnyitják. Ha egyéni domaint csatlakoztatott, inkább azt használja, például https://your-domain.com/functions/yourFunctionName. Ha a szolgáltatás több átirányítási URI-t is elfogad, adja hozzá mindkét címet. Most válassza ki a visszahívási függvény nevét, például enedisCallback, hogy később ugyanezt a nevet adhassa meg az MI-csevegésnek. Az alkalmazás regisztrálása a szolgáltatásnál:
  1. Jelentkezzen be a szolgáltatás fejlesztői portáljára, és hozzon létre egy OAuth-alkalmazást. Egyes szolgáltatások kliensnek vagy alkalmazásnak nevezik.
  2. Átirányítási URI-ként adja meg a visszahívási függvény URL-jét, például https://your-app-name.base44.app/functions/enedisCallback.
  3. Csak az alkalmazás számára szükséges hatóköröket válassza ki.
  4. Másolja ki az ügyfélazonosítót és a titkos ügyfélkulcsot.
  5. Másolja ki a szolgáltatás engedélyezési URL-jét és token URL-jét a fejlesztői dokumentációjából.

A bejelentkezési folyamat felépítése

Az MI-csevegés megírja a függvényeket, a tokentáblát és a gombokat, amelyekre a felhasználók kattintanak. Adja meg neki a szolgáltatás fejlesztői dokumentációjában szereplő adatokat, mert egy privát szolgáltatás bejelentkezési beállításait önmagától nem tudja megkeresni.
A titkos ügyfélkulcsot soha ne írja be csevegőüzenetbe. Amikor az MI-csevegés kéri, a megjelenő űrlapon adja meg, vagy adja hozzá titkos adatként saját maga. A Base44 csak a jól ismert szolgáltatások kulcsait ismeri fel és rejti el, így egy másik szolgáltatás titkos kulcsa az üzenetben marad.
A bejelentkezési folyamat felépítése:
  1. Nyissa meg az alkalmazásszerkesztőt.
  2. Kérje meg az MI-csevegést, hogy építse fel a folyamatot a szolgáltatás URL-jeivel, a hatókörökkel és a regisztrált visszahívási függvény nevével. Például:
  3. Amikor az MI-csevegés kéri az ügyfélazonosítót és a titkos ügyfélkulcsot, adja meg őket a megjelenő űrlapon.
  4. Ellenőrizze, hogy a visszahívási függvény neve pontosan megegyezik-e a regisztrálttal. Ha nem, kérje meg az MI-csevegést, hogy nevezze át.
  5. Kattintson a Dashboard elemre.
  6. Kattintson az Adatok elemre, majd válassza ki a tokentáblát.
  7. Kattintson a tábla tetején az Engedélyek elemre, és ellenőrizze, hogy csak az adminisztrátorok hozhatnak-e létre, olvashatnak, frissíthetnek vagy törölhetnek rekordokat. További információ az Adatjogosultságok módosítása részben.
  8. Kattintson az Engedélyek tesztelése az előnézetben gombra, majd normál felhasználóként ellenőrizze, hogy nem lát-e egyetlen rekordot sem a tokentáblában.

Közzététel és tesztelés

A szolgáltatás mindig a közzétett alkalmazásba küldi vissza a felhasználókat, így a visszahívás a függvény legutóbb közzétett verzióját futtatja, az akkori titkos adatokkal. Tesztelés előtt tegye közzé az alkalmazást, és tegye közzé újra, valahányszor egy függvényt vagy titkos adatot módosít. A kapcsolat tesztelése:
  1. Nyissa meg az alkalmazásszerkesztőt.
  2. Tegye közzé az alkalmazást.
  3. Nyissa meg a közzétett alkalmazást, és jelentkezzen be.
  4. Kattintson az MI-csevegés által hozzáadott csatlakozás gombra.
  5. Jelentkezzen be a szolgáltatásba egy olyan fiókkal, amelyet használhat, és hagyja jóvá a hozzáférést.

Hogyan csatlakoznak a felhasználók

Az alkalmazásba bejelentkező minden felhasználó a saját fiókját csatlakoztatja. A csatlakozás gombra kattint, bejelentkezik a szolgáltatás saját oldalán, és jóváhagyja a hozzáférést. Az alkalmazás soha nem látja a szolgáltatáshoz tartozó jelszavát. A tokenjei az alkalmazás tokentáblájába mentődnek, amelyet csak a backend-függvények használnak. Ön és az alkalmazás többi szerkesztője továbbra is láthatja ezt a táblát az irányítópulton, ezért kezelje úgy, mint bármely más privát adatot. Csak olyan fiókok csatlakoztatását kérje, amelyek a felhasználóké, vagy amelyeket használhatnak, és csak az alkalmazás számára szükséges hozzáférést kérje. Az alkalmazásban tájékoztassa őket, milyen adatokat olvas, és mit kezd velük. Egyes szolgáltatásoknak, különösen a személyes vagy háztartási adatokat megosztóknak, saját szabályaik vannak a hozzájárulásról, ezért közzététel előtt nézze meg a szolgáltatás feltételeit.

Hibaelhárítás

Ha a bejelentkezési folyamat nem működik, keresse meg alább a helyzetét.
A szolgáltatásnál regisztrált visszahívási URL-nek pontosan meg kell egyeznie a függvény URL-jével. Ellenőrizze, hogy ugyanazt a domaint használja-e, amelyen az alkalmazás fut, és hogy a függvény neve egyezik-e a Kód részben, a base44/functions alatt lévő mappájának nevével, a nagybetűket is beleértve.
Tegye közzé az alkalmazást, majd próbálja újra a közzétett alkalmazásból. Ha továbbra sem sikerül, nyissa meg a visszahívási függvény fájlját a Kód részben, kattintson a Naplók elemre, és illessze be a hibát az MI-csevegésbe, hogy javíthassa a függvényt.
A hozzáférési token valószínűleg lejár, és nem frissül. Kérje meg az MI-csevegést, hogy frissítse a frissítési tokennel. Egyes szolgáltatások csak akkor küldenek frissítési tokent, ha egy adott hatókört vagy beállítást kér, ezért nézze meg a szolgáltatás dokumentációját.
Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az angol nyelvű változatot.