Skip to Content

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 Token

Server-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_IP

wird zu

curl https://api.captchafox.com/siteverify \ -d secret=IHR_SECRET \ -d response=TOKEN \ -d remoteIp=BESUCHER_IP \ -d sitekey=IHR_SITEKEY

Die 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

  1. Senden Sie das geschützte Formular ab.
  2. Prüfen Sie, dass Ihr Server das Feld cf-captcha-response erhält.
  3. Prüfen Sie, dass die Verifizierungsanfrage "success": true zurückgibt.

Zum Testen ohne Seite verwenden Sie die Testschlüssel. Ersetzen Sie sie vor dem Livegang durch Ihre echten Schlüssel.

Zuletzt aktualisiert am