← Cloudflare Turnstile / turnstile / troubleshooting

Otestujte svou implementaci Turnstile

K testování implementace Turnstile používejte testovací sitekey a tajné klíče, abyste nespouštěli skutečné výzvy, které by narušovaly automatizované testovací sady.

Automatizované testovací nástroje (například Selenium, Cypress nebo Playwright) vyhodnotí Turnstile jako boty, což může způsobit:

• Testy selhávají, když Turnstile blokuje automatizované prohlížeče
• Nepředvídatelné výsledky testů kvůli různým variantám výzev
• Narušení testování odesílání formulářů
• Obtížné testování celých uživatelských toků

Dummy klíče to řeší tím, že vracejí předvídatelné, řízené odpovědi, se kterými si nástroje pro automatizované testování poradí.

K testování ověřování na straně serveru použijte tyto tajné klíče:

Testovací klíče fungují na libovolné doméně, včetně:

• localhost
• 127.0.0.1
• 0.0.0.0
• Libovolná vývojová doména

Cloudflare doporučuje, aby sitekeys používané v produkci nepovolovaly lokální domény (localhost nebo 127.0.0.1), uživatelé si však mohou lokální domény přidat do seznamu povolených domén v části Správa hostname. Dummy sitekeys lze používat z libovolné domény, včetně localhost.

Produkční sitekey nahraďte testovacím sitekey.

<!-- Development/Testing -->
<div class="cf-turnstile" data-sitekey="1x00000000000000000000AA"></div>

<!-- Production -->
<div class="cf-turnstile" data-sitekey="your-real-sitekey"></div>

Produkční tajný klíč nahraďte testovacím tajným klíčem.

// Environment-based configuration
const SECRET_KEY = process.env.NODE_ENV === 'production' 
  ? process.env.TURNSTILE_SECRET_KEY 
  : '1x0000000000000000000000000000000AA';

// Use in validation
const validation = await validateTurnstile(token, SECRET_KEY);

Pro každé prostředí nastavte samostatné klíče.

# .env.development
TURNSTILE_SITEKEY=1x00000000000000000000AA
TURNSTILE_SECRET_KEY=1x0000000000000000000000000000000AA

# .env.test  
TURNSTILE_SITEKEY=2x00000000000000000000AB
TURNSTILE_SECRET_KEY=2x0000000000000000000000000000000AA

# .env.production
TURNSTILE_SITEKEY=your-real-sitekey
TURNSTILE_SECRET_KEY=your-real-secret-key

Testovací klíče sitekey generují fiktivní token: XXXX.DUMMY.TOKEN.XXXX

• Testovací tajné klíče: přijímají pouze fiktivní token, skutečné tokeny odmítají.
• Produkční tajné klíče: přijímají pouze skutečné tokeny, fiktivní tokeny odmítají.

{
  "success": true,
  "challenge_ts": "2022-02-28T15:14:30.096Z",
  "hostname": "localhost",
  "error-codes": [],
  "action": "test",
  "cdata": "test-data"
}

{
  "success": false,
  "error-codes": ["invalid-input-response"]
}

{
  "success": false,
  "error-codes": ["timeout-or-duplicate"]
}