SilentShield

Migração de outras soluções

Guia passo a passo para migrar do reCAPTCHA, hCaptcha ou outras soluções CAPTCHA para o SilentShield.

Do Google reCAPTCHA

  1. Crie uma conta SilentShield e uma API key para o seu domínio
  2. Remova a tag de script do reCAPTCHA (google.com/recaptcha/api.js)
  3. Remova quaisquer chamadas a grecaptcha.render() ou grecaptcha.execute()
  4. Adicione a tag de script do SilentShield e a chamada init
  5. Substitua a verificação do reCAPTCHA no servidor pela verificação de nonce do SilentShield
  6. Teste com ?silentshield-debug para verificar se o widget está a funcionar

O SilentShield deteta formulários automaticamente — não precisa de adicionar atributos data-sitekey nem callbacks de formulário.

Do hCaptcha

  1. Remova a tag de script do hCaptcha (hcaptcha.com/1/api.js)
  2. Remova quaisquer elementos div h-captcha e atributos data-sitekey
  3. Adicione a tag de script do SilentShield e a chamada init
  4. Substitua a verificação do hCaptcha no servidor (hcaptcha.com/siteverify) pela verificação de nonce do SilentShield
  5. Teste os formulários para verificar se a proteção está ativa

Do Cloudflare Turnstile

  1. Remova a tag de script do Turnstile (challenges.cloudflare.com/turnstile/v0/api.js)
  2. Remova quaisquer elementos div cf-turnstile
  3. Adicione a tag de script do SilentShield e a chamada init
  4. Substitua a verificação do Turnstile no servidor pela verificação de nonce do SilentShield
  5. Teste os formulários para verificar se a proteção está ativa

Dicas de migração

  • Execute ambas as soluções em paralelo durante a migração para evitar tempo de inatividade
  • Utilize o modo de depuração do SilentShield (?silentshield-debug) para verificar o funcionamento correto
  • Comece pelo ambiente de desenvolvimento antes de implementar em produção
  • Monitorize o painel de análises após a migração para garantir as taxas de deteção esperadas