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

> Hogyan szerezd meg a Google reCAPTCHA-, a Google-, a Facebook- és az X-bejelentkezés kulcsait, és hová írd be őket.

A [Hitelesítés beállításai](https://hub.hellowp.io/hu/plugins/tutor-pro/beallitasok-hitelesites/) 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](https://hub.hellowp.io/hu/plugins/tutor-pro/integraciok/)).

## 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.