Configurando o Google reCAPTCHA

Você pode usar o captcha padrão do site ou o reCaptcha do Google.

 5

O que é o reCAPTCHA?

O reCAPTCHA é um serviço gratuito do Google que ajuda a proteger seu site contra:

  • Spam

  • Registros maliciosos

  • Ataques automatizados (bots)

Ele funciona como um widget que pode ser facilmente adicionado a formulários de cadastro, login, comentários, etc., garantindo que as ações estejam sendo realizadas por humanos.


Primeiros Passos

  1. Acesse: https://www.google.com/recaptcha/admin

  2. Escolha a versão do reCAPTCHA (v2 ou v3)

  3. Copie sua chave do site (Site Key) e chave secreta (Secret Key)


Configuração via Painel de Administração

  1. Vá para:
    Painel de Administração → Configurações → Geral → Segurança

  2. Em Captcha → Opções, selecione:
    “Google reCAPTCHA”

  3. Preencha os campos:

    • Versão do reCAPTCHA (v2 ou v3)

    • Chave do site (Site Key)

    • Chave secreta (Secret Key)


Configuração via arquivo .env

  1. Acesse seu servidor via FTP

  2. Abra o arquivo: /.env

  3. Configure as variáveis abaixo:

CAPTCHA="recaptcha"  # Ativa o reCAPTCHA (ou CAPTCHA="" para desativar)

RECAPTCHA_VERSION=v2  # ou v3, conforme escolhido no Google
RECAPTCHA_SITE_KEY=sua-chave-do-site
RECAPTCHA_SECRET_KEY=sua-chave-secreta

  1. Salve o arquivo e envie para o servidor


Importante:

  • A configuração via .env sobrescreve as definições feitas no painel administrativo.

  • Certifique-se de que as chaves estejam corretamente configuradas para evitar falhas na exibição do captcha.