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
- Acesse www.google.com/recaptcha/admin.
- Entre com sua conta Google.
- Inicie o cadastro de um novo site.
- 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:
- Selecione reCAPTCHA v2.
- Escolha a modalidade compatível com a verificação utilizada no site.
- 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:
Passo 2 - Informar o domínio
- Localize a seção de domínios no Google reCAPTCHA.
- Informe o domínio da loja.
- Acrescente outros domínios utilizados, quando necessário e permitido.
- 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?
- Acesse a configuração criada no painel do Google reCAPTCHA.
- Localize a Site Key.
- Copie seu valor.
- Localize a Secret Key.
- 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
- Entre no painel administrativo da Nortgraf.
- Acesse Configurações > Integrações.
- Localize Google reCAPTCHA v2.
- 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:
- Localize o campo Site Key.
- Cole a chave pública fornecida pelo Google.
- Confira se o valor foi informado corretamente.
Passo 3 - Informar a Secret Key
Ainda na seção Chaves do reCAPTCHA:
- Localize o campo Secret Key.
- Cole a chave secreta correspondente.
- 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?
- Na página Google reCAPTCHA v2, localize a seção Ativação.
- Encontre a opção Exigir reCAPTCHA nos formulários.
- Habilite essa opção.
- 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
- Acesse o endereço público da sua loja.
- Localize um formulário compatível com a verificação.
- 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
- Preencha os dados necessários do formulário.
- Realize a verificação do reCAPTCHA.
- Envie o formulário.
- 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?
- Acesse o painel do Google reCAPTCHA.
- Abra a configuração correspondente à sua loja.
- Consulte a lista de domínios autorizados.
- Compare com o endereço público utilizado pelos visitantes.
- 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:
- Acesse Configurações > Integrações.
- Abra Google reCAPTCHA v2.
- Localize a seção Ativação.
- Desabilite Exigir reCAPTCHA nos formulários.
- 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.