Von reCAPTCHA wechseln
Diese Anleitung behandelt reCAPTCHA v2, sowohl die Checkbox- als auch die unsichtbare Variante. Die meisten Änderungen sind Umbenennungen.
CaptchaFox-Schlüssel erhalten
Erstellen Sie eine Seite im CaptchaFox-Portal und kopieren Sie ihren Seitenschlüssel und Geheimschlüssel. Ihre reCAPTCHA-Schlüssel funktionieren nicht mit CaptchaFox.
Client-seitigen Code aktualisieren
Skript-Tag austauschen
<script src="https://www.google.com/recaptcha/api.js" async defer></script>wird zu
<script src="https://cdn.captchafox.com/api.js" async defer></script>Der Query-Parameter hl wird zu lang.
Container-Element aktualisieren
<div class="g-recaptcha" data-sitekey="RECAPTCHA_SITEKEY"></div>wird zu
<div class="captchafox" data-sitekey="IHR_SITEKEY"></div>Unsichtbares reCAPTCHA: data-size="invisible" wird zu data-mode="hidden". Siehe Versteckter Modus.
JavaScript-API-Aufrufe aktualisieren
Nur wenn Sie die JavaScript API verwenden:
const id = grecaptcha.render('container', {
sitekey: 'RECAPTCHA_SITEKEY',
callback: handleVerify,
'expired-callback': handleExpire,
'error-callback': handleError,
});
grecaptcha.getResponse(id);
grecaptcha.reset(id);
grecaptcha.execute(id);wird zu
const id = captchafox.render('container', {
sitekey: 'IHR_SITEKEY',
onVerify: handleVerify,
onExpire: handleExpire,
onError: handleError,
});
captchafox.getResponse(id);
captchafox.reset(id);
const token = await captchafox.execute(id); // liefert das TokenServer-seitigen Code aktualisieren
Lesen Sie das Token aus dem neuen Formularfeld und senden Sie es mit dem Geheimschlüssel Ihrer CaptchaFox-Seite an den CaptchaFox-Endpunkt:
curl https://www.google.com/recaptcha/api/siteverify \
-d secret=RECAPTCHA_SECRET \
-d response=TOKEN \
-d remoteip=BESUCHER_IPwird zu
curl https://api.captchafox.com/siteverify \
-d secret=IHR_SECRET \
-d response=TOKEN \
-d remoteIp=BESUCHER_IP \
-d sitekey=IHR_SITEKEYDie Felder der Antwort bleiben gleich: success, challenge_ts, hostname und error-codes. Siehe Antwort verifizieren.
Content Security Policy aktualisieren
Wenn Ihre Website eine Content Security Policy verwendet, entfernen Sie die reCAPTCHA-Quellen (www.google.com, www.gstatic.com, www.recaptcha.net) und fügen Sie die CaptchaFox-Quellen hinzu.
Bibliotheken austauschen
Wenn Sie eine reCAPTCHA-Bibliothek für Ihr Frontend oder Backend verwenden, wechseln Sie zu einer unserer Bibliotheken. Eine vollständige Übersicht finden Sie unter alle Integrationen .
Migration testen
- Senden Sie das geschützte Formular ab.
- Prüfen Sie, dass Ihr Server das Feld
cf-captcha-responseerhält. - Prüfen Sie, dass die Verifizierungsanfrage
"success": truezurückgibt.
Zum Testen ohne Seite verwenden Sie die Testschlüssel. Ersetzen Sie sie vor dem Livegang durch Ihre echten Schlüssel.