# Cloudflare Turnstile védelem

> A Cloudflare Turnstile beállítása a pénztáron és a fiókoldalakon a botok és a kéretlen rendelések ellen.

A Cloudflare Turnstile egy adatvédelmi szempontból kíméletes, CAPTCHA-mentes védelem a botok és a kéretlen rendelések ellen. A vásárlónak nem kell rejtvényt megoldania: a háttérben futó ellenőrzés állapítja meg, hogy ember használja-e az oldalt.

## Követelmények

- Pro vagy Agency csomag (az alap csomagban nem érhető el).
- Cloudflare-fiók Turnstile-hozzáféréssel.
- A Turnstile **oldal kulcsa** és **titkos kulcsa**.

## 1. lépés: a Turnstile létrehozása a Cloudflare-ben

1. Jelentkezz be a Cloudflare irányítópultjára.
2. Az oldalsávban nyisd meg a **Turnstile** pontot.
3. Kattints az **Add Site** gombra.
4. Add meg a webhely nevét (például „Minta Bolt pénztár”) és a domaint.
5. A widget módjánál válaszd a **Managed** (ajánlott) vagy a **Non-interactive** módot.
6. Kattints a **Create** gombra, majd másold ki az oldal kulcsát (Site Key) és a titkos kulcsot (Secret Key).

## 2. lépés: a beállítás a CheckoutWC-ben

Nyisd meg a **CheckoutWC → Integrációk** oldalt, és a **Cloudflare Turnstile** szakaszban jelöld be a **Cloudflare Turnstile engedélyezése** négyzetet. Ekkor megjelennek a további beállítások.

![Az Integrációk oldal a bekapcsolt Cloudflare Turnstile beállításaival](./kepek/beallitasok-turnstile.webp)

*Az Integrációk oldal a bekapcsolt Cloudflare Turnstile beállításaival* (https://minta-bolt.hu/wp-admin/admin.php?page=cfw-settings-integrations)

A képen a bekapcsolt Turnstile beállításai láthatók: a két kulcs mezője, a helyek, a pozíció, a téma és a méret.

| Beállítás | Mit csinál | Alapérték |
| --- | --- | --- |
| Cloudflare Turnstile engedélyezése | A fő kapcsoló: a kiválasztott oldalakon bekapcsolja a védelmet. | ki |
| Oldal kulcs | A Cloudflare-ben létrehozott nyilvános kulcs (betűkből és számokból álló szöveg). Kötelező, ha a Turnstile be van kapcsolva. | üres |
| Titkos kulcs | A Cloudflare-ben létrehozott privát kulcs. A mező jelszómező, a tartalma nem látszik. Kötelező, ha a Turnstile be van kapcsolva. | üres |
| Engedélyezés a fizetésnél | A Turnstile megjelenik a pénztároldalon. Ez az elsődleges védelem a rendelés leadása előtt. | be |
| Engedélyezés a rendelés fizetésénél | A Turnstile megjelenik a rendelés fizetési oldalán (függőben lévő rendeléseknél). | ki |
| Engedélyezés bejelentkezéskor | A Turnstile megjelenik a **Saját fiók** bejelentkezési űrlapján: megakadályozza a jelszótalálgató támadásokat. | ki |
| Engedélyezés regisztrációnál | A Turnstile megjelenik a **Saját fiók** regisztrációs űrlapján: megakadályozza a kéretlen fiókok létrehozását. | ki |
| Pozíció a fizetésnél | Hol jelenjen meg a widget a pénztáron: **A rendelés leadása gomb előtt**, **Fizetési módok előtt** vagy **Fizetési módok után**. | A rendelés leadása gomb előtt |
| Téma | **Világos**, **Sötét** vagy **Automatikus** (a látogató rendszerbeállítása szerint). | Világos |
| Méret | **Normál** (300×65 képpont) vagy **Kompakt** (150×140 képpont, mobilra vagy szűk elrendezésbe jó). | Normál |
| Csak vendég felhasználók | Csak a be nem jelentkezett látogatóknak mutatja a widgetet. A visszatérő, bejelentkezett vásárlókat nem zavarja, a névtelen botok ellen pedig véd. | ki |

A mentéshez kattints a **Módosítások mentése** gombra.

## Ajánlott beállítás

A legtöbb boltnál ez jól működik:

- a Turnstile be van kapcsolva, a pénztáron, a rendelés fizetésénél, a bejelentkezésnél és a regisztrációnál is engedélyezve,
- a pozíció **A rendelés leadása gomb előtt** (az átváltás szempontjából a legjobb, mert az ellenőrzés közvetlenül a rendelés előtt történik; a **Fizetési módok előtt** korai ellenőrzést ad, de növelheti a lemorzsolódást),
- a téma **Automatikus**,
- a méret **Normál**,
- a **Csak vendég felhasználók** be van kapcsolva.

## Hibaelhárítás

**A Turnstile nem jelenik meg**

1. Ellenőrizd, hogy a csomagod Pro vagy Agency.
2. Nézd meg, hogy a Turnstile be van-e kapcsolva a CheckoutWC beállításaiban.
3. Ellenőrizd, hogy az oldal kulcsa és a titkos kulcs helyesen van megadva.
4. Ürítsd ki a gyorsítótárazó bővítmények tárát.

**Ütközésre figyelmeztető üzenet**

Ez azt jelenti, hogy egy másik bővítmény már CAPTCHA-funkciót ad. Olvasd el az üzenetet, kapcsold ki az ütköző CAPTCHA-bővítményt, vagy állítsd be úgy, hogy a két védelem ne ugyanazokon az oldalakon fusson.

**A hitelesítés sikertelen**

- Ellenőrizd, hogy a titkos kulcs a megadott oldal kulcsához tartozik.
- Nézd meg a Cloudflare Turnstile irányítópultján a hibanaplókat.
- Győződj meg róla, hogy a domain helyesen szerepel a Cloudflare-ben.

**Mobilon rosszul jelenik meg**

- Próbáld a **Kompakt** méretet.
- Használd az **Automatikus** témát.

## Gyakori kérdések

**Kell hozzá Pro vagy Agency csomag?** Igen, a beépített Turnstile-támogatás ezekben érhető el. Az alap csomagban használhatsz külön Turnstile-bővítményt, de a beépített megoldás a legegyszerűbb és a legjobban tesztelt.

**Ingyenes a Cloudflare Turnstile?** Igen, teljesen ingyenes és korlátlan. Nem kell fizetős Cloudflare-csomag, bár a fizetős csomagok kiegészítő védelmet adnak.

**Hová tegyem a widgetet a pénztáron?** A **A rendelés leadása gomb előtt** pozíció a legjobb: közvetlenül a beküldés előtt ellenőriz, és a legjobb egyensúlyt adja a biztonság és az átváltás között. A többi pozíció korábban zavarja a vásárlót.

**Lassítja a pénztárat?** Nem. A CheckoutWC aszinkron módon tölti be a widgetet, így nem akadályozza az oldal megjelenítését. Mobilra érdemes a **Kompakt** méretet és az **Automatikus** témát választani.

**Megjeleníthetem csak a vendégeknek?** Igen, kapcsold be a **Csak vendég felhasználók** beállítást: a bejelentkezett vásárlókat nem zavarja, a névtelen botok ellen pedig véd.

**Védhetek mást is, nem csak a pénztárat?** Igen: a pénztár, a rendelés fizetése, a bejelentkezés és a regisztráció külön-külön kapcsolható. A bejelentkezés és a regisztráció védelme csökkenti a fiókfeltörési kísérleteket és a kéretlen regisztrációkat.

**Mit nézzek meg először, ha nem jelenik meg?**

- Pro vagy Agency csomagod van-e.
- A Turnstile be van-e kapcsolva, és az oldal kulcsa és a titkos kulcs helyes-e.
- A domain szerepel-e a Cloudflare Turnstile-ban.
- Ürítsd az oldal- és CDN-gyorsítótárat.
- Kapcsold ki ideiglenesen a többi CAPTCHA-bővítményt.

**Ütközésre figyelmeztet egy másik CAPTCHA-bővítmény. Mit tegyek?** Kapcsold ki a másikat, vagy zárd ki az átfedő oldalakat (pénztár, bejelentkezés, regisztráció), hogy csak az egyik védelem fusson. Két CAPTCHA együtt bosszantja a vásárlókat, és blokkolhatja a rendeléseket.

**Működik a Cloudflare CDN nélkül?** Igen, bármilyen tárhellyel vagy CDN-nel működik, csak egy ingyenes Cloudflare-fiók kell a kulcsok létrehozásához.

**Elrontja az Apple Pay vagy a Google Pay működését?** A CheckoutWC beépített megoldása minden gyorsfizetési móddal tesztelt. Ha külön bővítményt használsz, próbáld ki alaposan a gyorsfizetést, mert egyes megoldások zavarhatják.

**Tiltsam le a vendégként fizetést a kéretlen rendelések ellen?** Nem, mert rontja az átváltást. A Turnstile és más védelmi rétegek a fiókkészítés kikényszerítése nélkül állítják meg a botokat.

**Turnstile vagy reCAPTCHA?** A Turnstile általában jobb felhasználói élményt és adatvédelmet ad: a legtöbb valódi vásárló nem is lát kihívást, mobilon gördülékenyebb, és nem küld személyes adatot harmadik félnek viselkedéselemzésre. A reCAPTCHA többet zavar, és több vásárló morzsolódik le tőle.

**Mi van, ha a bot minden próbálkozásnál más IP-címet használ?** Az IP-cím alapú tiltás önmagában kevés. A Turnstile a böngésző viselkedését és az interakciós mintákat elemzi, ezeket sokkal nehezebb hamisítani, még változó IP-címek mellett is.

## Adatvédelem

A Turnstile az adatvédelmet szem előtt tartva készült: az ellenőrzéshez nem kell személyes adat, megfelel a GDPR-nak, nem követi a felhasználót több webhelyen át, és a legtöbb esetben a látogató nem is veszi észre.