Migrazione da altre soluzioni

Guida passo passo per la migrazione da reCAPTCHA, hCaptcha o altre soluzioni CAPTCHA a SilentShield.

Da Google reCAPTCHA

1. Crei un account SilentShield e una API key per il Suo dominio
2. Rimuova il tag script di reCAPTCHA (google.com/recaptcha/api.js)
3. Rimuova tutte le chiamate a grecaptcha.render() o grecaptcha.execute()
4. Aggiunga il tag script di SilentShield e la chiamata init
5. Sostituisca la verifica lato server di reCAPTCHA con la verifica del nonce di SilentShield
6. Testi con ?silentshield-debug per verificare che il widget funzioni

Da hCaptcha

1. Rimuova il tag script di hCaptcha (hcaptcha.com/1/api.js)
2. Rimuova tutti gli elementi div h-captcha e gli attributi data-sitekey
3. Aggiunga il tag script di SilentShield e la chiamata init
4. Sostituisca la verifica lato server di hCaptcha (hcaptcha.com/siteverify) con la verifica del nonce di SilentShield
5. Testi i moduli per verificare che la protezione sia attiva

Da Cloudflare Turnstile

1. Rimuova il tag script di Turnstile (challenges.cloudflare.com/turnstile/v0/api.js)
2. Rimuova tutti gli elementi div cf-turnstile
3. Aggiunga il tag script di SilentShield e la chiamata init
4. Sostituisca la verifica lato server di Turnstile con la verifica del nonce di SilentShield
5. Testi i moduli per verificare che la protezione sia attiva

Consigli per la migrazione

• Esegua entrambe le soluzioni in parallelo durante la migrazione per evitare tempi di inattività
• Usi la modalità debug di SilentShield (?silentshield-debug) per verificare il corretto funzionamento
• Inizi con l'ambiente di sviluppo prima di distribuire in produzione
• Monitori il pannello di analisi dopo la migrazione per assicurarsi dei tassi di rilevamento attesi