API-kulcsok: reCAPTCHA, Google, Facebook és X

A Hitelesítés beállításai oldalon a csalásvédelemhez és a közösségi bejelentkezéshez külső szolgáltatásoktól kapott kulcsok kellenek. Ez a fejezet lépésről lépésre végigvezet a kulcsok megszerzésén. A szolgáltatók felülete változhat, ezért a lépések sorrendje kissé eltérhet.

Google reCAPTCHA kulcsok

A Google reCAPTCHA kockázatelemzéssel védi az oldalt a csalásoktól. A Tutor LMS-hez csak a webhelykulcs (site key) és a titkos kulcs (secret key) kell.

1. Nyisd meg a Google reCAPTCHA adminisztrációs konzolját, és jelentkezz be a Google-fiókoddal.
2. Kattints a + gombra új webhely regisztrálásához, és adj neki címkét, hogy később felismerd.
3. Válaszd ki a reCAPTCHA típusát:
   • reCAPTCHA v2: a felhasználónak be kell jelölnie a „Nem vagyok robot” négyzetet, és képfelismerő feladatot kaphat. Az „Invisible reCAPTCHA badge” opcióval a Google a háttérben ellenőrzi a kérést.
   • reCAPTCHA v3: a háttérben fut, a felhasználó viselkedése alapján pontszámot ad, és ha az megfelelő, nem zavarja a felhasználót ellenőrzéssel. A kulcsok csak abban a verzióban működnek, amelyhez készültek, ezért gondosan válassz.
4. Add meg a domaineket, ahol a reCAPTCHA-t használni akarod. Több domain is megadható, az aldomaineket nem kell külön felsorolni, mert a Google a gyökérdomainből veszi őket.
5. Add meg a tulajdonosok e-mail-címét. Ők láthatják a webhelyek reCAPTCHA-jelentését.
6. Jelöld be a Send alerts to owners (riasztás küldése a tulajdonosoknak) négyzetet: így a Google e-mailt küld, ha hibás beállítást vagy a kéretlen forgalom megugrását észleli.
7. Fogadd el a használati feltételeket, és kattints a Submit gombra.
8. Megkapod a webhelykulcsot és a titkos kulcsot. Másold ki és tárold biztonságosan.

A kulcsok beírása a Tutor LMS-ben:

1. Nyisd meg a Tutor LMS Pro → Beállítások → Hitelesítés oldalt.
2. Kapcsold be a Csalásvédelem engedélyezése kapcsolót.
3. A módszernél válaszd a Google reCAPTCHA v2 vagy v3 lehetőséget. Két új mező jelenik meg.
4. Írd be a webhelykulcsot és a titkos kulcsot.
5. Jelöld ki a helyeket, ahol a reCAPTCHA megjelenjen, és kattints a Save Changes gombra.

Google kliensazonosító (Client ID)

A Google-bejelentkezés (a Közösségi bejelentkezés addonban) Google kliensazonosítót kér.

1. Jelentkezz be a Google-fiókodba.
2. Nyisd meg a Google Developer Console-t, kattints a Select a project lehetőségre, majd a jobb felső sarokban a NEW PROJECT gombra. Add meg a projekt nevét, és szükség esetén a szervezetet, majd kattints a CREATE gombra.
3. Állítsd be az OAuth hozzájárulási képernyőt (OAuth consent screen a bal oldali menüben):
   • A felhasználó típusa External (külső). Ha csak a szervezeted tagjainak szánod a projektet, válaszd az Internal értéket. Kattints a CREATE gombra.
   • Add meg az alkalmazás alapadatait: az alkalmazás nevét, az ügyfélszolgálati e-mail-címet, a logót, a kezdőoldal hivatkozását, az adatvédelmi tájékoztató és az általános szerződési feltételek hivatkozását, a jogosult domaineket és a fejlesztő e-mail-címét.
   • Az Add or Remove Scopes gombbal add hozzá a Tutor LMS-hez szükséges két hatókört: userinfo.email és userinfo.profile. Jelöld be mindkettőt, majd Save and Continue.
   • A következő képernyőn felvehetsz tesztfelhasználókat (kezdetben legfeljebb 100 fő). Ennél többhöz a Google ellenőrzése kell az alkalmazásra. A SAVE AND CONTINUE után az összefoglalón az EDIT gombbal javíthatsz, majd a BACK TO DASHBOARD gombbal visszatérsz.
4. Hozd létre az OAuth kliensazonosítót: a bal oldali Credentials lapon kattints a + CREATE CREDENTIALS gombra, és válaszd az OAuth client ID pontot.
5. Az alkalmazás típusa legyen Web application, add meg a nevét és a weboldalad címét.
6. Az Authorized JavaScript origins mezőbe írd a weboldalad címét, az Authorized redirect URIs mezőbe pedig az átirányítási címet. Ez utóbbit a Google Meet → Set API fülön találod. Ha a Google Meet menü nem látszik, kapcsold be a Google Meet addont, és frissítsd az oldalt. Másold át az URI-t a Google konzolba.
7. Mentsd, és várj kicsit, amíg a beállítások érvénybe lépnek. Kattints a CREATE gombra.
8. Megkapod a kliensazonosítót. Másold ki. Később a Google Cloud Credentials lapján is megtalálod a projekted alatt.

A kliensazonosítót a Tutor LMS Pro → Beállítások → Hitelesítés → Közösségi bejelentkezés résznél, a Google mezőben add meg (lásd Integrációk).

Facebook alkalmazásazonosító (App ID)

1. Nyisd meg a Facebook fejlesztői oldalát (developers.facebook.com), jelentkezz be, és a jobb felső sarokban kattints a Create App gombra.
2. A „mit szeretnél csinálni” kérdésnél válaszd az Other lehetőséget.
3. Az alkalmazás típusa: Consumer (a közösségi bejelentkezéshez).
4. Add meg az alkalmazás nevét, és kattints a Create app gombra.
5. Állítsd be a Facebook Login terméket (az alkalmazás irányítópultján vagy az Add Product gombbal), és add meg az általános adatokat.
6. A platform legyen Web.
7. Add meg a weboldalad címét, és mentsd.
8. Add meg az adatvédelmi tájékoztató és az adattörlési kérelem hivatkozását (ezek a felhasználói adatok kezeléséhez szükségesek).
9. A Facebook Login Settings oldalon kapcsold be a Login with the JavaScript SDK lehetőséget, és add meg a megengedett domaineket. Az alkalmazás csak ezeken a domaineken érhető el.
10. Az oldal tetején lévő kapcsolóval állítsd az alkalmazás állapotát élesre (Live).
11. Másold ki az App ID-t, és a Tutor LMS Pro → Beállítások → Hitelesítés → Közösségi bejelentkezés résznél írd a Facebook → App ID mezőbe, majd kattints a Save Changes gombra.

Ezután a felhasználók Facebookkal is bejelentkezhetnek a Tutor LMS bejelentkezési képernyőjén. A Facebooknak néha pár óra kell, hogy az alkalmazást élesre állítsa és a bejelentkezés működjön.

Az alkalmazás ellenőrzése a Facebookkal

A Facebook-azonosító használatához a Facebookkal ellenőriztetni kell az alkalmazást. A kérelem beállítása gyors, de az ellenőrzés körülbelül egy hétig tart. Előkészítendő:

1. teljesen kész Facebook-alkalmazás,
2. 1024 × 1024 képpontos, megfelelő alkalmazásikon,
3. legalább egy sikeres API-hívás,
4. képernyőfelvétel az alkalmazás felhasználói szemszögből történő használatáról,
5. az alkalmazás nyilvános elérhetősége,
6. tesztfelhasználó létrehozása és a belépési adatok megosztása.

Minden engedélyhez sikeres API-hívást kell végrehajtani az ellenőrzési kérelem beküldésétől számított 30 napon belül, különben a Facebook nem hagyja jóvá az alkalmazást.

X (Twitter) API-kulcs

1. Alkalmazás létrehozása: nyisd meg az X (Twitter) fejlesztői portált, és jelentkezz be. Első használatkor a fiókot telefonszámmal kell ellenőrizni, ha már ellenőrzött, jelentkezz az ingyenes fejlesztői fiókra. A Projects and Apps részben az Overview alatt kattints a Create App gombra, adj nevet az alkalmazásnak, és kattints a Next gombra.
2. A megjelenő képernyőn látod az API Key és az API Key Secret értéket. Másold ki mindkettőt.
3. Beírás a Tutor LMS-ben: a Tutor LMS Pro → Beállítások → Hitelesítés → Közösségi bejelentkezés résznél az X (Twitter) alatt írd be az API-kulcsot és a titkos kulcsot. Kattints az átirányítási URI másolására, és menj vissza a fejlesztői portálra.
4. Az alkalmazás befejezése: a Standalone Apps alatt kattints a Set up gombra a hitelesítés beállításához. A User authentication settings részben:
   • az App Permissions értéke Read, és kapcsold be a Request email from users (e-mail kérése a felhasználóktól) lehetőséget,
   • a Type of App értéke Web App,
   • a Redirect URL mezőbe illeszd be a Tutor LMS-ből másolt átirányítási URI-t,
   • add meg a weboldalad címét, az általános szerződési feltételek és az adatvédelmi tájékoztató hivatkozását.
5. Mentsd a beállításokat.
6. Ellenőrzés: nyisd meg a frontendet, és próbálj bejelentkezni. Megjelenik a bejelentkezés X (Twitter) fiókkal gomb.