4. Povoľte svoj web

Váš formulár bude obsahovať váš verejný kľúč. To je v poriadku – je určený na to, aby bol verejný –, no ktokoľvek si ho môže skopírovať zo zdrojového kódu stránky. To, že bude fungovať iba pre váš formulár, zabezpečia dve veci: zoznam povolených webov a CAPTCHA na šablóne.

Pridajte svoju doménu

1. Otvorte Zabezpečenie. Karta Povolené weby obsahuje domény, ktoré môžu posielať s vaším verejným kľúčom.

2. Do poľa Pridať doménu napíšte svoju doménu a kliknite na Pridať. Podporované formáty:

   Záznam	Povoľuje
   example.com	presne example.com
   *.example.com	akúkoľvek subdoménu, napr. www.example.com alebo shop.example.com – ale nie samotnú example.com
   localhost:3000	konkrétny host a port
   localhost	localhost na akomkoľvek porte – praktické pri lokálnom vývoji

   Väčšina webov je dostupná s www aj bez neho, preto pridajte example.com aj *.example.com (alebo www.example.com).

3. Hore na stránke kliknite na Uložiť.

Frontmail porovnáva hlavičku Origin každej požiadavky z prehliadača s týmto zoznamom:

• Žiadne domény – karta upozorní Nie sú nastavené žiadne domény – váš verejný kľúč môže použiť akýkoľvek web. Posielanie funguje odkiaľkoľvek, čo je pohodlné na prvé vyskúšanie, ale ostatní vám tak môžu minúť kredity. Takto do prevádzky nechoďte.
• Doména, ktorá v zozname nie je – požiadavka je odmietnutá s chybou origin_not_allowed a nič sa neodošle. Ak túto chybu vidíte, skontrolujte presný host v adresnom riadku (s www alebo bez neho, číslo portu).

Zapnite CAPTCHA (odporúčame)

Povolené weby zastavia iné weby, ale nie bota, ktorý posiela požiadavky priamo na API. To dokáže CAPTCHA Cloudflare Turnstile – zvyčajne ako neviditeľná kontrola, bez hádaniek. Požiadavky bez platného tokenu zlyhajú s chybou captcha_required skôr, ako vás budú stáť kredit.

Na weboch beží Turnstile na vašom vlastnom bezplatnom widgete Cloudflare (bezplatný tarif Cloudflare povoľuje iba 10 hostov na widget, takže Frontmail nemôže zdieľať jeden kľúč pre weby všetkých zákazníkov). Nastavenie trvá asi dve minúty:

1. Prihláste sa do dashboardu Cloudflare (stačí bezplatný účet), otvorte Turnstile a kliknite na Add widget.

2. Pomenujte widget, pridajte hostov svojho webu – napr. example.com a www.example.com –, Widget mode nechajte na Managed a kliknite na Create.

3. Skopírujte Site Key a Secret Key.

4. Vo Frontmaile na stránke Zabezpečenie vložte oba kľúče do karty Ochrana pred botmi (Turnstile) a kliknite na Uložiť kľúče. Frontmail overí secret key v Cloudflare, uloží ho zašifrovaný a už ho nikdy nezobrazí.

5. Kliknite na Zapnúť CAPTCHA pre všetky šablóny. Kontaktná šablóna z tohto tutoriálu má teraz zapnuté Vyžadovať CAPTCHA (Turnstile) (v šablóne Nastavenia → Ochrana); šablóna automatickej odpovede sa preskočí, pretože ju posiela Frontmail, nie váš formulár.

Site key si majte poruke – v ďalšom kroku ho vložíte do formulára. Komponenty pre frameworky (FrontmailForm pre React, Vue a Svelte) widget vykreslia za vás. Odteraz má každá nová šablóna CAPTCHA predvolene zapnutú.

Tip

Len skúšate veci na localhost? Túto časť môžete zatiaľ preskočiť a vrátiť sa k nej pred spustením do prevádzky, alebo použiť testovacie kľúče Cloudflare – nikdy však nie v produkcii, pustia totiž každú požiadavku.

Upozornenie

Verejný formulár bez CAPTCHA je otvorenou bránou pre spamových botov. Turnstile nastavte skôr, ako formulár spustíte.

Voliteľné doplnky

Karta Ochrana pred zneužitím ponúka Blokovať headless prehliadače a Prísne parametre a nižšie môžete nastaviť Rate limit na IP adresu a Zoznam blokovaných hodnôt. Predvolené hodnoty na tento tutoriál stačia – keď budete chcieť ochranu sprísniť, pozrite si Ochrana pred botmi a Nastavenia zabezpečenia.

Viac: Povolené domény.