Como Habilitar o Cloudflare Turnstile

Introdução

O Cloudflare Turnstile é uma alternativa moderna e fácil de usar para os CAPTCHAs tradicionais. Diferentemente de testes invasivos de solução de enigmas ou de verificação por imagem, o Turnstile protege os formulários e as interações do seu site contra bots automatizados, oferecendo uma experiência fluida, invisível ou de um único clique para visitantes reais.

Ao habilitar o Cloudflare Turnstile no seu site do eDirectory, pontos essenciais de acesso — como formulários de login, páginas de registro e formulários de contato do usuário — ficam protegidos contra spam e scripts maliciosos, sem adicionar atrito desnecessário à experiência do usuário.

Este guia orienta você na criação de um widget do Cloudflare Turnstile, na obtenção das suas chaves de API e na integração delas ao seu site do eDirectory.

Nota Importante: Este recurso está disponível apenas no eDirectory versão 14.2+

Antes de começar

Antes de configurar o Cloudflare Turnstile, verifique se você tem:

Uma conta no Cloudflare (você pode criar uma conta gratuita se ainda não tiver).
Acesso de administrador ao seu Site Manager do eDirectory.
Um domínio ativo conectado ao seu site do eDirectory.

Importante: O Cloudflare Turnstile valida estritamente o nome do domínio em que o desafio é executado. Se o seu site estiver usando atualmente uma URL temporária de staging ou se você planeja atualizar seu domínio principal em breve, entre em contato com nossa equipe de suporte em support@edirectory.com antes de configurar o Turnstile.

Passo 1: Registre seu site com o Cloudflare Turnstile

Acesse o Painel do Cloudflare e faça login com suas credenciais.
No menu de navegação à esquerda, vá em Protect & Connect → Application Security → Turnstile.

Clique em Adicionar Widget (ou Adicionar Widget Manualmente).

Preencha o formulário de criação do widget com os seguintes detalhes:
- Nome do Widget: Insira uma identificação reconhecível para seu site (por exemplo, seudominio.com.br).
- Domínio / Nome do host: Clique para adicionar o nome de domínio totalmente qualificado (FQDN) do seu site.
  - Exemplo: seudominio.com.br
  - Não inclua http:// ou https://.
  - Não inclua caminhos de páginas específicos (por exemplo, seudominio.com.br/contato).
- Modo do Widget: Selecione Gerenciado (Recomendado).

Nota sobre o Modo Gerenciado: O Modo Gerenciado da Cloudflare analisa o tráfego dos visitantes de forma não intrusiva. Visitantes reais passam automaticamente ou por meio de uma caixa de seleção leve, sem desafios de imagem tediosos, enquanto solicitações suspeitas são desafiadas com eficácia.

Clique em Criar para gerar seu widget.

Passo 2: Obtenha suas chaves de API

Depois que o widget é criado, a Cloudflare exibe imediatamente suas credenciais:

Chave do Site: A chave pública usada pelo eDirectory para exibir o widget do Turnstile nos seus formulários.
Chave Secreta: A chave privada usada para comunicação segura de servidor para servidor entre o eDirectory e a Cloudflare.

Copie as duas chaves e mantenha-as abertas em uma aba segura. Você precisará colá-las no seu eDirectory Site Manager na próxima etapa.

Passo 3: Integre o Cloudflare Turnstile ao eDirectory

Abra uma nova aba e faça login no seu eDirectory Site Manager.
Acesse Configurações → Configurações Gerais → Captcha.
Em Seleção de Captcha, escolha Cloudflare Turnstile.
Cole suas chaves nos campos correspondentes:
- Chave do Site
- Chave Secreta
Clique em Salvar alterações.

Verificando a integração

Para confirmar que o Cloudflare Turnstile está ativo e protegendo seus formulários:

Abra uma nova janela de navegador privada/incógnito e navegue até o seu site.
Clique em Entrar no canto superior direito do cabeçalho.
No modal pop-up, selecione Registrar.
Observe a parte inferior do formulário de registro: você deve ver o widget de verificação do Cloudflare Turnstile (por exemplo, exibindo “Sucesso!” ou um ícone de verificação leve).

Se o bloco do Turnstile carregar com sucesso, sua integração está ativa e funcionando.

Solução de problemas

Verifique o seguinte:

Confirme que você selecionou Cloudflare Turnstile em Configurações → Configurações Gerais → Captcha e clicou em Salvar alterações.
Verifique se as duas chaves, Chave do Site e Chave Secreta, foram copiadas completamente, sem espaços extras.
Limpe o cache do seu navegador ou abra a página em uma aba de Incógnito para ignorar o conteúdo em cache.

A Cloudflare exibe “Domain Validation Error” ou “Error 110200”

Garanta que o nome do host inserido na configuração do seu widget do Cloudflare Turnstile corresponda exatamente à URL do seu site ao vivo.
Evite adicionar prefixos como https:// ou extensões de caminho extras no campo de hostname da Cloudflare.

Vejo um erro de “Chave inválida”

Verifique novamente se você não colou acidentalmente as chaves do Google reCAPTCHA nos campos do Turnstile ou vice-versa. As Chaves do Site e as Chaves Secretas do Turnstile são exclusivas da plataforma da Cloudflare.

Conclusão

Parabéns! O Cloudflare Turnstile agora está protegendo ativamente seu site do eDirectory contra spam e abuso automatizado, oferecendo aos seus visitantes uma experiência de navegação moderna e fluida.