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 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://api.hcaptcha.com/siteverify \
-d secret=HCAPTCHA_SECRET \
-d response=TOKEN \
-d remoteip=BESUCHER_IP \
-d sitekey=HCAPTCHA_SITEKEYwird 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 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
- 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.