# 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](http://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](https://dash.cloudflare.com/?to=/:account/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**](http://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.