← Cloudflare Turnstile / turnstile / troubleshooting

Проверьте свою реализацию Turnstile

Используйте тестовые sitekey и секретные ключи, чтобы проверить свою реализацию Turnstile, не запуская настоящие проверки, которые мешали бы наборам автотестов.

Наборы автотестов (например, Selenium, Cypress или Playwright) Turnstile распознаёт как ботов, из-за чего возможны:

• Падение тестов, когда Turnstile блокирует автоматизированные браузеры
• Непредсказуемые результаты тестов из-за различий в проверках
• Помехи при тестировании отправки формы
• Трудности с тестированием полных пользовательских сценариев

Тестовые ключи (dummy keys) решают эту задачу: они дают предсказуемые, управляемые ответы, которые работают с инструментами автоматического тестирования.

Эти секретные ключи используйте для тестирования серверной проверки:

Тестовые ключи работают на любом домене, в том числе:

• localhost
• 127.0.0.1
• 0.0.0.0
• Любой домен разработки

Cloudflare рекомендует, чтобы боевые sitekey не допускали локальные домены (localhost или 127.0.0.1), но пользователи могут добавить локальные домены в список разрешённых доменов в разделе Управление именами хостов. Тестовые sitekey можно использовать с любого домена, в том числе на localhost.

Замените рабочий sitekey тестовым.

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

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

Замените рабочий секретный ключ тестовым.

// 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);

Заведите отдельные ключи для каждой среды.

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

Тестовые sitekey выдают фиктивный токен: XXXX.DUMMY.TOKEN.XXXX

• Тестовые секретные ключи: принимают только фиктивный токен и отклоняют настоящие.
• Рабочие секретные ключи: принимают только настоящие токены и отклоняют фиктивные.

{
  "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"]
}