Migrazione da altre soluzioni

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

Da Google reCAPTCHA

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

Da hCaptcha

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

Da Cloudflare Turnstile

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

Consigli per la migrazione

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