Cloudflare Turnstile

Proteja o acesso à sua loja e ao painel administrativo com o Cloudflare Turnstile, uma ferramenta de segurança que ajuda a impedir acessos automatizados, tentativas de abuso e cadastros realizados por robôs.

Para que serve a integração?

O Cloudflare Turnstile é um serviço de verificação de segurança que ajuda a identificar acessos automatizados sem exigir que todos os visitantes resolvam desafios tradicionais de CAPTCHA.

Com essa integração, você pode adicionar uma camada extra de proteção aos processos de login e cadastro da sua loja na Nortgraf.

O Turnstile utiliza verificações gerenciadas pela Cloudflare e, dependendo das condições de acesso, pode realizar a validação sem exigir uma interação adicional do usuário.

Na Nortgraf, é possível configurar as chaves do serviço e escolher separadamente onde a proteção deverá ser exigida: no login administrativo ou no login e cadastro de clientes.

1 - Atenção e Regras

Antes de iniciar a configuração, observe algumas informações importantes:

• Conta Cloudflare: É necessário possuir uma conta para criar e administrar o widget do Turnstile.
• Widget: Você precisará cadastrar um widget correspondente aos domínios utilizados pela loja.
• Site Key: É a chave pública utilizada para apresentar a verificação nas páginas protegidas.
• Secret Key: É a chave privada utilizada pelo servidor para validar as respostas do Turnstile.
• Domínios: Os endereços utilizados precisam estar autorizados na configuração do widget.
• Login administrativo: É possível exigir a verificação ao acessar o painel administrativo.
• Login e cadastro do cliente: É possível habilitar a proteção no acesso e na criação de contas de clientes.
• Ativação geral: O Turnstile somente será utilizado quando a opção principal estiver habilitada.
• Segurança: A Secret Key deve ser mantida em sigilo.
• Disponibilidade: O funcionamento depende da comunicação com os serviços da Cloudflare.

Importante: A ativação geral e as opções de proteção são configurações diferentes. Para exigir o Turnstile em determinado processo, é necessário habilitar o serviço e a opção correspondente.

2 - Criando uma Conta na Cloudflare

Caso ainda não possua uma conta, será necessário realizar o cadastro.

Passo 1 - Acessar a Cloudflare

1. Acesse dash.cloudflare.com.
2. Crie uma conta ou entre com seus dados.
3. Conclua as verificações solicitadas.
4. Acesse o painel principal.

Passo 2 - Localizar o Turnstile

1. No painel da Cloudflare, localize Turnstile.
2. Abra a área de gerenciamento de widgets.
3. Inicie a criação de um novo widget.

Você também pode utilizar o endereço Abrir Cloudflare Turnstile para acessar a ferramenta.

Dica: Não é obrigatório transferir o gerenciamento de DNS da sua loja para a Cloudflare apenas para utilizar o Turnstile. O serviço pode ser configurado por meio de um widget específico.

3 - Criando um Widget Turnstile

O widget identifica o site que utilizará as verificações de segurança.

Passo 1 - Identificar o widget

Durante o cadastro:

1. Informe um nome para identificar a configuração.
2. Utilize um nome relacionado à sua loja.
3. Continue para a configuração dos domínios.

Exemplo:

Turnstile — Minha Loja

Passo 2 - Configurar os domínios

Informe os domínios nos quais o Turnstile será utilizado.

Exemplo:

www.sualoja.com.br

Se você também pretende proteger o acesso administrativo realizado por outro endereço, confira se ele precisa ser incluído na lista de domínios autorizados.

Passo 3 - Escolher o modo de verificação

A Cloudflare disponibiliza diferentes opções para o funcionamento do widget.

Para uma utilização convencional, selecione o modo gerenciado, quando disponível.

Nesse modo, a Cloudflare determina a verificação apropriada conforme as características do acesso.

Passo 4 - Concluir a criação

Confira os dados cadastrados e finalize a criação.

Após a conclusão, a Cloudflare disponibilizará as credenciais necessárias à integração.

Importante: Os domínios autorizados devem corresponder aos endereços efetivamente utilizados pelos visitantes e administradores da loja.

4 - Obtendo a Site Key e a Secret Key

Depois de criar o widget, localize as duas chaves disponibilizadas pela Cloudflare.

Site Key

É a chave pública utilizada pelo navegador para carregar o widget de verificação.

Essa informação identifica a configuração do Turnstile que deverá ser apresentada ao usuário.

Secret Key

É a chave privada utilizada pelo servidor para validar as respostas recebidas durante a verificação.

Essa credencial deve permanecer protegida.

Como copiar?

1. Abra o widget criado no painel da Cloudflare.
2. Localize a Site Key.
3. Copie o valor apresentado.
4. Localize a Secret Key.
5. Copie o valor correspondente.

Mantenha as duas informações disponíveis para configurar a integração na Nortgraf.

Atenção: Utilize a Site Key e a Secret Key do mesmo widget. Credenciais pertencentes a configurações diferentes podem impedir a validação.

5 - Configurando o Cloudflare Turnstile na Nortgraf

Com as chaves em mãos, acesse o painel administrativo da sua loja.

Passo 1 - Acessar a integração

1. Entre no painel administrativo da Nortgraf.
2. Acesse Configurações > Integrações.
3. Localize Cloudflare Turnstile.
4. Abra a página de configuração.

A tela apresenta três seções principais:

Chaves do widget

Reúne as credenciais fornecidas pela Cloudflare.

Onde exigir o desafio

Permite escolher quais processos deverão utilizar a verificação.

Ativação

Controla o funcionamento geral do Turnstile na loja.

Passo 2 - Informar a Site Key

Na seção Chaves do widget:

1. Localize o campo Site Key.
2. Cole a chave pública fornecida pela Cloudflare.
3. Confira se o valor foi informado corretamente.

Passo 3 - Informar a Secret Key

Ainda na seção Chaves do widget:

1. Localize o campo Secret Key.
2. Cole a chave secreta correspondente.
3. Confira se a informação está correta.

Passo 4 - Salvar as configurações

Depois de preencher as credenciais, confira os demais campos e salve as alterações.

Importante: A Secret Key é uma informação confidencial. Não a compartilhe publicamente nem a utilize em códigos expostos aos visitantes.

6 - Protegendo o Login Administrativo

A Nortgraf permite utilizar o Turnstile na autenticação dos usuários que acessam o painel administrativo.

Como ativar?

1. Abra Configurações > Integrações > Cloudflare Turnstile.
2. Localize a seção Onde exigir o desafio.
3. Encontre a opção Login do admin.
4. Habilite essa opção.
5. Confira se a ativação geral também está habilitada.
6. Salve as configurações.

Como funciona?

Quando a proteção está ativa, a verificação do Turnstile passa a fazer parte do processo de autenticação administrativa compatível.

A Cloudflare poderá validar o acesso automaticamente ou solicitar uma interação adicional, conforme sua análise.

Quando utilizar?

Recomendamos manter a proteção habilitada para ajudar a reduzir:

• Tentativas automatizadas de login;
• Ataques de força bruta;
• Acessos realizados por robôs;
• Requisições suspeitas direcionadas à autenticação.

Importante: O Turnstile complementa as demais medidas de segurança. Ele não substitui senhas fortes, autenticação de dois fatores ou controle de permissões.

7 - Protegendo o Login e Cadastro de Clientes

Além do painel administrativo, você poderá habilitar a verificação nos processos de acesso dos clientes da loja.

Como ativar?

1. Acesse a integração Cloudflare Turnstile.
2. Localize Onde exigir o desafio.
3. Habilite Login e cadastro do cliente.
4. Confira se a ativação geral está habilitada.
5. Clique em Salvar.

Quais processos são protegidos?

Essa opção controla a utilização do Turnstile em:

Login do cliente

Protege o processo de autenticação realizado pelo cliente na loja.

Cadastro do cliente

Protege a criação de uma nova conta.

Por que utilizar?

A proteção pode ajudar a reduzir:

• Criação automatizada de contas;
• Tentativas repetitivas de autenticação;
• Cadastros suspeitos;
• Abusos realizados por scripts automatizados.

Dica: Após habilitar a proteção, teste tanto o login quanto o cadastro de clientes para confirmar que os processos continuam funcionando corretamente.

8 - Ativando o Turnstile na Loja

Depois de configurar as chaves e selecionar os processos protegidos, será necessário habilitar a integração.

Como ativar?

1. Abra a integração Cloudflare Turnstile.
2. Localize a seção Ativação.
3. Habilite Usar o Turnstile na loja.
4. Clique em Salvar.

Como funciona a ativação geral?

A opção Usar o Turnstile na loja controla o funcionamento geral do serviço.

Se ela estiver desabilitada, a verificação não será utilizada pelos processos controlados por essa integração, mesmo que as opções individuais estejam habilitadas.

Exemplo de configuração

Configuração

Situação

Usar o Turnstile na loja

Ativado

Login do admin

Ativado

Login e cadastro do cliente

Desativado

Nesse exemplo, a proteção será utilizada no login administrativo, mas não será exigida nos processos de login e cadastro dos clientes.

Importante: Confira sempre a ativação geral e as opções individuais antes de salvar as configurações.

9 - Entendendo o Funcionamento do Desafio

O Turnstile foi desenvolvido para realizar verificações de segurança com o menor atrito possível para visitantes legítimos.

Verificação automática

Em determinadas situações, a Cloudflare poderá realizar a análise sem exigir que o usuário resolva um desafio manual.

Verificação com interação

Dependendo do modo de funcionamento e das características do acesso, o serviço poderá solicitar uma interação adicional.

Validação

Após a verificação, o sistema utiliza a resposta do Turnstile para confirmar se a operação poderá continuar.

Importante: O comportamento visual pode variar entre dispositivos, navegadores e condições de acesso. A ausência de um desafio tradicional não significa necessariamente que a verificação não foi realizada.

10 - Testando a Proteção do Login Administrativo

Após ativar o Turnstile no login administrativo, recomendamos realizar uma verificação.

Passo 1 - Manter uma sessão ativa

Antes de testar, mantenha sua sessão administrativa atual aberta.

Isso permite revisar as configurações caso o novo acesso apresente algum problema.

Passo 2 - Abrir uma nova janela

1. Abra uma janela anônima ou outro navegador.
2. Acesse a página de login administrativo da Nortgraf.
3. Confira se a verificação do Turnstile é carregada corretamente.
4. Informe suas credenciais.
5. Conclua a autenticação.

Passo 3 - Conferir o resultado

Verifique se o acesso é concluído normalmente após a validação.

Atenção: Não encerre sua sessão administrativa original antes de confirmar que o login funciona corretamente com o Turnstile ativado.

11 - Testando o Login e Cadastro de Clientes

Se você habilitou o Turnstile para clientes, teste os processos correspondentes na loja pública.

Testando o login

1. Abra o endereço público da loja.
2. Acesse a área de autenticação do cliente.
3. Confira se o Turnstile funciona corretamente.
4. Informe credenciais de teste válidas.
5. Conclua o acesso.

Testando o cadastro

1. Acesse a área de criação de conta.
2. Preencha os dados necessários.
3. Conclua a verificação solicitada.
4. Envie o formulário.
5. Confira o resultado.

Resultado esperado

O cliente deverá conseguir concluir as operações normalmente quando as verificações e os demais dados estiverem corretos.

Dica: Faça os testes em um computador e em um celular para verificar a experiência nos diferentes dispositivos.

12 - Alterando ou Substituindo as Chaves

Em algumas situações, poderá ser necessário substituir as credenciais do Turnstile.

Isso pode ocorrer após alterações no widget, mudanças de domínio ou procedimentos de segurança.

Como substituir?

1. Acesse o painel da Cloudflare.
2. Abra o widget correspondente.
3. Consulte ou gere as credenciais necessárias.
4. Retorne à integração na Nortgraf.
5. Atualize a Site Key e, quando necessário, a Secret Key.
6. Salve as alterações.
7. Teste novamente os processos protegidos.

Preservação da Secret Key

Quando uma Secret Key já está cadastrada, a Nortgraf apresenta o campo de forma mascarada.

Se você deseja manter a chave existente, pode deixar o campo em branco ou manter o valor mascarado.

A Nortgraf preservará a credencial anteriormente salva.

Importante: Não é necessário informar novamente a Secret Key sempre que você alterar outra opção da integração.

13 - Diferença entre Turnstile e Google reCAPTCHA

A Nortgraf possui integrações específicas para dois serviços de proteção contra acessos automatizados.

Cloudflare Turnstile

Utiliza os mecanismos de verificação da Cloudflare.

Permite configurar individualmente a proteção do login administrativo e do login e cadastro dos clientes.

Google reCAPTCHA v2

Utiliza os mecanismos de verificação do Google, podendo apresentar desafios tradicionais de CAPTCHA.

Possui uma configuração própria de chaves e ativação.

Qual utilizar?

A escolha depende das necessidades da loja e dos formulários que você deseja proteger.

O Turnstile oferece controles específicos para os processos de autenticação disponíveis na integração da Nortgraf.

Atenção: Evite configurar diferentes verificações no mesmo processo sem avaliar a compatibilidade e a experiência do usuário.

14 - Desativando o Turnstile

Se precisar interromper a verificação de segurança controlada pela integração:

1. Acesse Configurações > Integrações.
2. Abra Cloudflare Turnstile.
3. Localize a seção Ativação.
4. Desabilite Usar o Turnstile na loja.
5. Clique em Salvar.

Com a ativação geral desligada, os desafios controlados pela integração deixam de ser exigidos, independentemente das opções individuais.

Desativando apenas um processo

Se desejar manter o Turnstile ativo somente no login administrativo ou somente no acesso dos clientes:

1. Mantenha Usar o Turnstile na loja ativado.
2. Acesse Onde exigir o desafio.
3. Desabilite apenas a opção correspondente.
4. Salve as alterações.

Importante: Desativar o Turnstile na Nortgraf não exclui o widget ou as credenciais da sua conta Cloudflare.

15 - Seções de Referência

Chaves do widget

Reúne as credenciais necessárias à integração.

Site Key

Chave pública utilizada pelo navegador para carregar o Turnstile.

Secret Key

Chave privada utilizada pelo servidor para validar a resposta.

Onde exigir o desafio

Permite selecionar os processos protegidos.

Login do admin

Habilita a verificação no login administrativo da loja.

Login e cadastro do cliente

Habilita a proteção na autenticação e na criação de contas dos clientes.

Ativação

Controla o funcionamento geral do serviço.

Usar o Turnstile na loja

Quando habilitada, permite a execução das verificações nas áreas selecionadas.

Abrir Turnstile

Disponibiliza o acesso ao painel da Cloudflare para administração do widget.

16 - Problemas Comuns

Não encontro a Site Key e a Secret Key.

Acesse o painel Cloudflare Turnstile, abra o widget cadastrado e consulte as credenciais disponibilizadas.

O Turnstile não aparece no login administrativo.

Confira se a opção Usar o Turnstile na loja está habilitada e se Login do admin também está ativado.

Verifique as chaves e os domínios autorizados.

O Turnstile não aparece no login dos clientes.

Confira se a ativação geral está habilitada e se a opção Login e cadastro do cliente está ativada.

Configurei as chaves, mas a proteção não funciona.

Verifique se a Site Key e a Secret Key pertencem ao mesmo widget e se os domínios utilizados estão autorizados.

A Secret Key aparece como ****.

Esse comportamento é esperado. A Nortgraf apresenta a chave de forma mascarada para protegê-la.

Preciso preencher a Secret Key toda vez que salvar?

Não. Se a chave já estiver cadastrada, você poderá deixar o campo em branco ou manter a máscara para preservar o valor existente.

A verificação funciona na loja, mas não no painel administrativo.

Confira se o domínio utilizado para acessar o painel administrativo também está autorizado na configuração do widget.

A verificação funciona no computador, mas não no celular.

Teste a conexão e o navegador utilizado. Verifique também se existem recursos de bloqueio que interfiram no carregamento do widget.

Ativei a proteção e não consigo mais entrar no painel.

Confira se o domínio e as credenciais estão corretos. Caso tenha perdido o acesso administrativo, entre em contato com o suporte da Nortgraf para verificar o procedimento seguro de recuperação.

O login do cliente apresenta erro de verificação.

Confira os domínios autorizados, as credenciais do widget e as condições de comunicação com a Cloudflare.

Desativei o login administrativo, mas a verificação continua aparecendo.

Confira se as alterações foram salvas e se existe outro mecanismo de segurança ativo no processo.

Preciso utilizar o Turnstile e o reCAPTCHA ao mesmo tempo?

Não obrigatoriamente. Utilize os mecanismos de proteção adequados aos formulários e evite verificações redundantes.

Alterei o domínio da loja. Preciso atualizar o Turnstile?

Confira os domínios autorizados no widget da Cloudflare e inclua ou ajuste os endereços utilizados, quando necessário.

---

Dica: Após configurar o Cloudflare Turnstile, mantenha uma sessão administrativa aberta e teste o login em outra janela antes de encerrar seu acesso. Isso ajuda a confirmar que as chaves e os domínios estão corretos sem comprometer sua capacidade de administrar a loja.