# Google reCAPTCHA v2 Proteja os formulários da sua loja contra acessos automatizados, envios indevidos e tentativas de abuso utilizando o **Google reCAPTCHA v2**, uma ferramenta de segurança que ajuda a diferenciar visitantes legítimos de robôs. ## Para que serve a integração? O Google reCAPTCHA é um serviço de segurança desenvolvido pelo Google para reduzir interações automatizadas em sites e formulários. Com essa integração, você pode adicionar uma etapa de verificação aos formulários compatíveis da sua loja, ajudando a prevenir cadastros automatizados, mensagens de spam e outras atividades suspeitas. O reCAPTCHA v2 pode apresentar uma caixa de verificação ou desafios adicionais, dependendo do tipo de chave configurado e da análise realizada pelo Google. A Nortgraf permite informar as chaves fornecidas pelo Google e ativar a exigência de reCAPTCHA nos formulários compatíveis. ## 1 - Atenção e Regras Antes de configurar a integração, observe algumas informações importantes: - **Conta Google:** É necessário possuir uma conta Google para cadastrar e administrar o reCAPTCHA. - **Versão:** A integração da Nortgraf utiliza o Google reCAPTCHA v2. - **Site Key:** É a chave utilizada para identificar o site na verificação apresentada ao visitante. - **Secret Key:** É a chave privada utilizada pelo servidor para validar as respostas do reCAPTCHA. - **Domínio:** O endereço da sua loja deve estar autorizado nas configurações do Google reCAPTCHA. - **Ativação:** A opção Exigir reCAPTCHA nos formulários deve estar habilitada para utilizar o recurso. - **Credenciais:** As duas chaves precisam estar corretamente preenchidas. - **Privacidade:** A utilização do serviço deve respeitar as regras aplicáveis de privacidade e tratamento de dados. - **Segurança:** A proteção ajuda a reduzir abusos, mas não elimina todas as tentativas de fraude ou automação. **Importante:** Utilize chaves do **reCAPTCHA v2** compatíveis com a implementação da loja. Chaves de versões diferentes podem impedir o carregamento ou a validação do desafio. ## 2 - Criando sua Configuração no Google reCAPTCHA Caso ainda não possua as chaves do serviço, será necessário cadastrar sua loja no painel do Google reCAPTCHA. ### Passo 1 - Acessar o painel 1. Acesse [www.google.com/recaptcha/admin](https://www.google.com/recaptcha/admin). 2. Entre com sua conta Google. 3. Inicie o cadastro de um novo site. 4. Preencha as informações solicitadas. ### Passo 2 - Identificar o site No campo de identificação, informe um nome que facilite reconhecer a configuração. Exemplo: **reCAPTCHA — Minha Loja** Esse nome será utilizado para organização no painel do Google. ### Passo 3 - Selecionar a versão Na configuração do tipo de reCAPTCHA: 1. Selecione **reCAPTCHA v2**. 2. Escolha a modalidade compatível com a verificação utilizada no site. 3. Continue o cadastro. Para implementações com caixa de seleção, utilize a modalidade correspondente a **"Não sou um robô"**. **Atenção:** A Nortgraf identifica essa integração como Google reCAPTCHA v2. Não selecione reCAPTCHA v3 apenas por ser uma versão mais recente, pois as chaves e os métodos de validação são diferentes. ## 3 - Cadastrando o Domínio da Loja Durante o cadastro no Google, será necessário informar os domínios autorizados a utilizar as chaves. ### Passo 1 - Identificar o endereço Consulte o domínio utilizado pelos visitantes para acessar sua loja. Exemplo: [**www.sualoja.com.br**](http://www.sualoja.com.br) ### Passo 2 - Informar o domínio 1. Localize a seção de domínios no Google reCAPTCHA. 2. Informe o domínio da loja. 3. Acrescente outros domínios utilizados, quando necessário e permitido. 4. Confira as informações cadastradas. Normalmente, o domínio deve ser informado sem o protocolo HTTPS e sem o caminho de uma página específica. ### Passo 3 - Concluir o cadastro Leia as condições apresentadas pelo Google e finalize o cadastro. **Importante:** Se sua loja utiliza um domínio próprio e também um endereço alternativo, confira quais domínios precisam estar autorizados para que o desafio funcione nos locais desejados. ## 4 - Obtendo a Site Key e a Secret Key Após concluir o cadastro, o Google disponibilizará duas chaves. ### Site Key É a chave pública utilizada pelo site para apresentar a verificação ao visitante. A Nortgraf utiliza essa informação para identificar a configuração do reCAPTCHA. ### Secret Key É a chave privada utilizada pelo servidor para verificar a validade das respostas recebidas. Essa chave não deve ser compartilhada publicamente. ### Como copiar? 1. Acesse a configuração criada no painel do Google reCAPTCHA. 2. Localize a **Site Key**. 3. Copie seu valor. 4. Localize a **Secret Key**. 5. Copie o valor correspondente. Mantenha essas informações disponíveis para preencher a integração na Nortgraf. **Atenção:** As chaves devem pertencer à mesma configuração. Não misture a Site Key de um cadastro com a Secret Key de outro. ## 5 - Configurando o Google reCAPTCHA na Nortgraf Depois de obter as chaves, 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 **Google reCAPTCHA v2**. 4. Abra a página de configuração. A tela apresenta duas seções principais: **Chaves do reCAPTCHA** Permite informar as credenciais fornecidas pelo Google. **Ativação** Permite habilitar ou desabilitar a proteção nos formulários compatíveis. ### Passo 2 - Informar a Site Key Na seção **Chaves do reCAPTCHA**: 1. Localize o campo **Site Key**. 2. Cole a chave pública fornecida pelo Google. 3. Confira se o valor foi informado corretamente. ### Passo 3 - Informar a Secret Key Ainda na seção **Chaves do reCAPTCHA**: 1. Localize o campo **Secret Key**. 2. Cole a chave secreta correspondente. 3. Confira se a informação está correta. **Importante:** A Secret Key é uma credencial de segurança. Informe-a somente na página de configuração da integração. ## 6 - Ativando a Proteção dos Formulários Após preencher as duas chaves, será necessário habilitar o reCAPTCHA. ### Como ativar? 1. Na página **Google reCAPTCHA v2**, localize a seção **Ativação**. 2. Encontre a opção **Exigir reCAPTCHA nos formulários**. 3. Habilite essa opção. 4. Clique em **Salvar**. Com o recurso habilitado e as chaves corretamente configuradas, os formulários compatíveis poderão utilizar a verificação do Google. ### Requisitos para funcionar Confira se: - A Site Key está preenchida; - A Secret Key está preenchida; - As duas chaves pertencem ao mesmo cadastro; - O domínio da loja está autorizado no Google; - A versão configurada é compatível; - A integração está ativada. **Atenção:** Se uma das chaves estiver ausente, o desafio não será carregado corretamente, mesmo que a opção de ativação esteja habilitada. ## 7 - Como Funciona a Verificação para o Cliente Quando o reCAPTCHA está configurado em um formulário compatível, o visitante poderá precisar realizar uma verificação antes de concluir a operação. ### Caixa de verificação Na modalidade com caixa de seleção, o visitante encontra uma opção identificada como: **Não sou um robô** Ao marcar essa opção, o Google realiza a verificação correspondente. ### Desafios adicionais Dependendo da análise do Google, poderá ser apresentado um desafio adicional. Esses desafios podem envolver a identificação de elementos em imagens ou outras verificações disponibilizadas pelo serviço. ### Conclusão do formulário Depois de concluir a verificação, o visitante poderá continuar o envio do formulário, desde que os demais dados também estejam válidos. **Importante:** Nem todos os visitantes necessariamente receberão o mesmo desafio. O comportamento depende das verificações realizadas pelo Google. ## 8 - Testando a Integração Após salvar as configurações, recomendamos verificar se o reCAPTCHA está funcionando corretamente. ### Passo 1 - Abrir a loja 1. Acesse o endereço público da sua loja. 2. Localize um formulário compatível com a verificação. 3. Abra a página correspondente. ### Passo 2 - Conferir o carregamento Verifique se o componente de verificação aparece corretamente. Caso seja exibida a caixa Não sou um robô, confira se ela pode ser utilizada normalmente. ### Passo 3 - Concluir uma operação de teste 1. Preencha os dados necessários do formulário. 2. Realize a verificação do reCAPTCHA. 3. Envie o formulário. 4. Confira o resultado apresentado. ### Resultado esperado O formulário deverá permitir a conclusão da operação quando a verificação for válida e os demais campos estiverem corretos. **Dica:** Teste também em um navegador diferente para verificar se o componente está sendo carregado adequadamente. ## 9 - Conferindo os Domínios Autorizados Se a verificação não funcionar, confira os domínios cadastrados no Google. ### Como verificar? 1. Acesse o painel do Google reCAPTCHA. 2. Abra a configuração correspondente à sua loja. 3. Consulte a lista de domínios autorizados. 4. Compare com o endereço público utilizado pelos visitantes. 5. Corrija as informações, quando necessário. ### Exemplo Se o site é acessado por um domínio próprio, confira se esse domínio está autorizado no cadastro do reCAPTCHA. Se a loja utiliza diferentes endereços, avalie a necessidade de incluir os domínios correspondentes. **Importante:** Uma configuração criada para outro domínio pode apresentar erros quando utilizada em sua loja. ## 10 - Diferença entre reCAPTCHA e Cloudflare Turnstile A Nortgraf disponibiliza integrações específicas para o Google reCAPTCHA e o Cloudflare Turnstile. Embora ambos sejam utilizados para proteção contra interações automatizadas, são serviços diferentes. ### Google reCAPTCHA v2 Utiliza o mecanismo de verificação do Google e pode apresentar uma caixa Não sou um robô ou desafios adicionais. A configuração exige uma Site Key e uma Secret Key fornecidas pelo Google. ### Cloudflare Turnstile Utiliza o sistema de verificação do Cloudflare, com suas próprias credenciais e configurações. A integração possui opções específicas para os locais em que a proteção deverá ser utilizada. ### Qual utilizar? A escolha depende das funcionalidades desejadas e dos formulários compatíveis com cada implementação. **Dica:** Evite ativar diferentes mecanismos de verificação no mesmo fluxo sem avaliar a compatibilidade, pois isso pode criar obstáculos desnecessários para os clientes. ## 11 - Desativando o reCAPTCHA Se desejar interromper a proteção controlada por essa integração: 1. Acesse **Configurações > Integrações**. 2. Abra **Google reCAPTCHA v2**. 3. Localize a seção **Ativação**. 4. Desabilite **Exigir reCAPTCHA nos formulários**. 5. Clique em **Salvar**. Após a desativação, os formulários que dependem dessa configuração deixarão de exigir o reCAPTCHA por esse mecanismo. ### O que acontece com as chaves? As credenciais poderão continuar cadastradas, conforme o estado salvo na integração. Desativar o serviço na Nortgraf não exclui o cadastro realizado no Google. **Atenção:** Caso existam outras proteções configuradas, elas deverão ser administradas separadamente. ## 12 - Seções de Referência **Chaves do reCAPTCHA** Reúne as credenciais necessárias para configurar a integração. **Site Key** Chave utilizada para identificar o site e apresentar a verificação ao visitante. **Secret Key** Chave privada utilizada pelo servidor para validar as respostas do reCAPTCHA. **Ativação** Permite controlar o funcionamento da integração. **Exigir reCAPTCHA nos formulários** Habilita ou desabilita a utilização do serviço nos formulários compatíveis. **Abrir reCAPTCHA** Disponibiliza o acesso ao painel externo do Google para criar e administrar as credenciais. ## 13 - Problemas Comuns **Não encontro a Site Key e a Secret Key.** Acesse o painel do Google reCAPTCHA, selecione a configuração da sua loja e consulte as chaves disponibilizadas. **O reCAPTCHA não aparece na loja.** Confira se a integração está ativada, se as duas chaves foram informadas e se o formulário utiliza esse mecanismo de verificação. **Ativei a integração, mas o desafio não carrega.** Verifique se a Site Key e a Secret Key estão preenchidas corretamente. Sem as duas credenciais, o desafio não funciona adequadamente. **Aparece uma mensagem de chave inválida.** Confira se as credenciais correspondem a uma configuração de reCAPTCHA v2 compatível com a implementação. **O Google informa que o domínio não é válido.** Verifique se o domínio utilizado pela loja está autorizado nas configurações do reCAPTCHA. **O cliente não consegue concluir a verificação.** Peça que verifique a conexão com a internet e tente novamente. Também é possível testar outro navegador para identificar interferências locais. **O formulário não é enviado mesmo após a verificação.** Confira se os demais campos estão preenchidos corretamente e se existem mensagens adicionais de validação. **Preciso utilizar reCAPTCHA v3?** Não. A integração documentada é destinada ao reCAPTCHA v2. Utilize chaves compatíveis com essa versão. **Posso utilizar a mesma chave em mais de uma loja?** Isso depende dos domínios autorizados e da configuração realizada no Google. Para facilitar a organização, recomendamos manter as credenciais associadas às lojas e aos domínios correspondentes. **O reCAPTCHA funciona em uma página, mas não em outra.** Confira se o formulário da outra página possui suporte à integração. A ativação geral não significa que todos os formulários da plataforma utilizem necessariamente o mesmo mecanismo. **Desativei o reCAPTCHA, mas ainda existe uma verificação de segurança.** Verifique se há outro serviço de proteção configurado, como Cloudflare Turnstile ou mecanismos independentes. **Troquei o domínio da loja. Preciso alterar alguma configuração?** Confira os domínios autorizados no painel do Google reCAPTCHA e atualize a configuração quando necessário. --- **Dica:** Após ativar o Google reCAPTCHA v2, realize uma operação de teste em um formulário compatível da sua loja. Confirme que o desafio carrega corretamente e que o formulário pode ser enviado após uma verificação válida.