Skip to Content

Von hCaptcha wechseln

hCaptcha und CaptchaFox werden auf die gleiche Weise integriert. Die meisten Änderungen sind daher Umbenennungen.

CaptchaFox-Schlüssel erhalten

Erstellen Sie eine Seite im CaptchaFox-Portal und kopieren Sie ihren Seitenschlüssel und Geheimschlüssel. Ihre hCaptcha-Schlüssel funktionieren nicht mit CaptchaFox.

Client-seitigen Code aktualisieren

Skript-Tag austauschen

<script src="https://js.hcaptcha.com/1/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="h-captcha" data-sitekey="HCAPTCHA_SITEKEY"></div>

wird zu

<div class="captchafox" data-sitekey="IHR_SITEKEY"></div>

Unsichtbares hCaptcha: data-size="invisible" wird zu data-mode="hidden". Siehe Versteckter Modus.

JavaScript-API-Aufrufe aktualisieren

Nur wenn Sie die JavaScript API verwenden:

const id = hcaptcha.render('container', { sitekey: 'HCAPTCHA_SITEKEY', callback: handleVerify, 'expired-callback': handleExpire, 'error-callback': handleError, 'close-callback': handleClose, }); hcaptcha.getResponse(id); hcaptcha.reset(id); const { response } = await hcaptcha.execute(id, { async: true });

wird zu

const id = captchafox.render('container', { sitekey: 'IHR_SITEKEY', onVerify: handleVerify, onExpire: handleExpire, onError: handleError, onClose: handleClose, }); 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://api.hcaptcha.com/siteverify \ -d secret=HCAPTCHA_SECRET \ -d response=TOKEN \ -d remoteip=BESUCHER_IP \ -d sitekey=HCAPTCHA_SITEKEY

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 hCaptcha-Quellen (hcaptcha.com, *.hcaptcha.com) und fügen Sie die CaptchaFox-Quellen hinzu.

Bibliotheken austauschen

Wenn Sie eine hCaptcha-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