Migracao de outras solucoes

Guia passo a passo para migrar do reCAPTCHA, hCaptcha ou outras solucoes CAPTCHA para o SilentShield.

Do Google reCAPTCHA

  1. Crie uma conta SilentShield e uma API key para o seu dominio
  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 verificacao do lado do servidor do reCAPTCHA pela verificacao de nonce do SilentShield
  6. Teste com ?silentshield-debug para verificar que o widget esta a funcionar

O SilentShield deteta formularios automaticamente — nao precisa de adicionar atributos data-sitekey ou callbacks de formulario.

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 verificacao do lado do servidor do hCaptcha (hcaptcha.com/siteverify) pela verificacao de nonce do SilentShield
  5. Teste os formularios para verificar que a protecao esta 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 verificacao do lado do servidor do Turnstile pela verificacao de nonce do SilentShield
  5. Teste os formularios para verificar que a protecao esta ativa

Dicas de migracao

  • Execute ambas as solucoes em paralelo durante a migracao para evitar tempo de inatividade
  • Utilize o modo de depuracao do SilentShield (?silentshield-debug) para verificar o funcionamento correto
  • Comece pelo ambiente de desenvolvimento antes de implementar em producao
  • Monitorize o painel de analises apos a migracao para garantir as taxas de detecao esperadas