Como Habilitar o Google reCAPTCHA

Introdução

O Google reCAPTCHA é um serviço gratuito de segurança fornecido pelo Google que ajuda a proteger o seu site contra spam, bots automatizados e atividades maliciosas.

Ao habilitar o Google reCAPTCHA em seu site eDirectory, formulários como os de contato, cadastro de usuários e outras interações passam a ser protegidos pelo sistema de verificação do Google, ajudando a garantir que os envios sejam realizados por pessoas reais e não por softwares automatizados.

Este guia mostrará como criar as chaves da API do Google reCAPTCHA e integrá-las ao seu site eDirectory.

Antes de Começar

Antes de configurar o Google reCAPTCHA, certifique-se de que você possui:

• Uma Conta Google.
• Acesso de administrador ao eDirectory.
• Um domínio ativo conectado ao seu site.

Etapa 1: Registrar seu Site no Google reCAPTCHA

1.1. Acesse o site do Google reCAPTCHA e faça login com sua Conta Google.

1.2. Cadastre um novo site preenchendo as informações solicitadas:

• Etiqueta:  Informe um nome para identificar o seu site. Recomendamos utilizar o domínio do seu website. Por exemplo: edirectory.com
• Tipo do reCAPTCHA: Selecione: Desafio (v2) e Caixa de seleção "Não sou um robô".
• Domínios: Informe o domínio do seu site. Por exemplo: edirectory.com

• Nome do projeto: O Google agora exige que toda configuração do reCAPTCHA esteja associada a um projeto do Google Cloud Platform. Selecione o projeto correspondente ao seu website.

1.3. Clique em Enviar.

Etapa 2: Obter suas Chaves da API

2.1. O Google poderá levar alguns instantes para processar sua solicitação. Aguarde até que o processamento seja concluído antes de continuar.

2.2. Após a conclusão do processamento, o Google irá gerar duas chaves da API:

• Chave de site
• Chave secreta

Essas chaves identificam exclusivamente o seu site e permitem que o eDirectory se comunique de forma segura com o serviço Google reCAPTCHA.

Copie ambas as chaves, pois elas serão utilizadas na integração com o eDirectory.

Etapa 3: Integrar o Google reCAPTCHA ao eDirectory

3.1. Faça login na área administrativa do eDirectory.

3.2. Acesse Configurações → Integrações com Google → Google reCAPTCHA

3.3. Cole os seguintes valores em seus respectivos campos:

• Chave de site
• Chave secreta

3.4. Marque a opção Ativar reCAPTCHA.

3.5. Clique em Salvar Alterações.

Etapa 4: Configurar as Configurações de Segurança do Google reCAPTCHA

4.1. Após salvar a Chave do site e a Chave secreta no Site Manager do eDirectory, retorne à página do Google reCAPTCHA onde suas chaves foram geradas.

4.2. Clique em Acessar as configurações.

4.3. Na seção Preferência de segurança, mova o controle deslizante para Mais segura. Essa configuração aumenta o nível de proteção fornecido pelo Google reCAPTCHA, exigindo verificações mais rigorosas para solicitações consideradas suspeitas.

4.4. Marque a opção Enviar alertas aos proprietários. Essa opção permite que o Google envie notificações caso detecte problemas na configuração do reCAPTCHA ou atividades incomuns em seu site, como erros de configuração ou aumento de tráfego suspeito.

4.5. Clique em Salvar.

Sua configuração do Google reCAPTCHA estará concluída e otimizada para oferecer maior segurança.

Verificando a Integração

Após salvar as configurações, você poderá verificar se o Google reCAPTCHA foi integrado corretamente ao seu site.

1. Acesse seu website.
2. Clique em Entrar, localizado no canto superior direito da página.

3. Na janela exibida, clique em Registrar.
4. O formulário de cadastro será exibido e você deverá visualizar a caixa de seleção "Não sou um robô".

Se a caixa de seleção aparecer, isso significa que o Google reCAPTCHA foi configurado com sucesso e está protegendo o formulário de cadastro do seu site.

Solução de Problemas

Não consigo visualizar o reCAPTCHA no meu site.

Verifique se:

• A Chave do site e a Chave secreta foram copiadas corretamente.
• O tipo de reCAPTCHA selecionado no Google é Desafio (v2) → Caixa de seleção "Não sou um robô".
• O domínio cadastrado no Google corresponde exatamente ao domínio do seu site.
• O Google reCAPTCHA foi habilitado em Configurações → Integrações com Google → Google reCAPTCHA.
• Você clicou em Salvar Alterações após inserir as chaves.

O Google informa que meu domínio é inválido.

Certifique-se de que o domínio cadastrado no Google reCAPTCHA corresponde exatamente ao domínio utilizado pelos visitantes para acessar o seu site.

Por exemplo:

• ✅ seudominio.com
• ✅ www.seudominio.com (caso aplicável)

Se você alterou recentemente o domínio do seu site, será necessário atualizar a configuração do Google reCAPTCHA ou registrar o novo domínio no Google.

Estou vendo o erro "Invalid key type" (Tipo de chave inválida)

Esse erro indica que a chave do reCAPTCHA foi criada utilizando um tipo de reCAPTCHA diferente do suportado pelo eDirectory.

Para utilizar o Google reCAPTCHA no eDirectory, você deve selecionar:

• Desafio (v2)
• Caixa de seleção "Não sou um robô"

Caso tenha selecionado outra opção (como reCAPTCHA v3 ou Invisible reCAPTCHA v2), as chaves não funcionarão com o eDirectory.

Para corrigir esse problema, será necessário criar uma nova chave do reCAPTCHA seguindo novamente a Etapa 1.2 deste guia, certificando-se de selecionar:

• Desafio (v2)
• Caixa de seleção "Não sou um robô"

Após gerar uma nova Chave do site e a Chave secreta, substitua as chaves existentes em Configurações → Integrações com Google → Google reCAPTCHA em sua área admininstrativa do eDirectory e clique em Salvar Alterações.

Conclusão

Parabéns!

O Google reCAPTCHA agora está habilitado em seu site eDirectory.

Seu website passa a contar com uma camada adicional de proteção contra envios de spam, bots automatizados e atividades maliciosas, proporcionando uma experiência mais segura e confiável para seus visitantes e administradores.