Migracja z innych rozwiązań

Przewodnik krok po kroku dotyczący migracji z reCAPTCHA, hCaptcha lub innych rozwiązań CAPTCHA do SilentShield.

Z Google reCAPTCHA

  1. Utwórz konto SilentShield i klucz API dla swojej domeny
  2. Usuń tag skryptu reCAPTCHA (google.com/recaptcha/api.js)
  3. Usuń wszelkie wywołania grecaptcha.render() lub grecaptcha.execute()
  4. Dodaj tag skryptu SilentShield i wywołanie inicjalizacji
  5. Zastąp weryfikację reCAPTCHA po stronie serwera weryfikacją nonce SilentShield
  6. Przetestuj z ?silentshield-debug, aby sprawdzić, czy widget działa

SilentShield automatycznie wykrywa formularze — nie musisz dodawać atrybutów data-sitekey ani callbacków formularzy.

Z hCaptcha

  1. Usuń tag skryptu hCaptcha (hcaptcha.com/1/api.js)
  2. Usuń wszelkie elementy div h-captcha i atrybuty data-sitekey
  3. Dodaj tag skryptu SilentShield i wywołanie inicjalizacji
  4. Zastąp weryfikację hCaptcha po stronie serwera (hcaptcha.com/siteverify) weryfikacją nonce SilentShield
  5. Przetestuj formularze, aby upewnić się, że ochrona jest aktywna

Z Cloudflare Turnstile

  1. Usuń tag skryptu Turnstile (challenges.cloudflare.com/turnstile/v0/api.js)
  2. Usuń wszelkie elementy div cf-turnstile
  3. Dodaj tag skryptu SilentShield i wywołanie inicjalizacji
  4. Zastąp weryfikację Turnstile po stronie serwera weryfikacją nonce SilentShield
  5. Przetestuj formularze, aby upewnić się, że ochrona jest aktywna

Wskazówki dotyczące migracji

  • Uruchom oba rozwiązania równolegle podczas migracji, aby zapewnić brak przestojów
  • Użyj trybu debugowania SilentShield (?silentshield-debug), aby zweryfikować poprawne działanie
  • Zacznij od środowiska deweloperskiego przed wdrożeniem na produkcję
  • Monitoruj panel analityki po migracji, aby upewnić się, że wskaźniki wykrywania są zgodne z oczekiwaniami