Dokumentation

Alles, was Sie zum Einbinden und Betreiben von CaptchaCore brauchen. Wenn Sie es eilig haben, reichen der Schnellstart und ein Blick auf die Verify-Antwort.

Wobei können wir helfen?

Ich will schnell starten Site anlegen, Script einbinden, Token prüfen. Fünf Minuten, drei Schritte. Einstieg → Ich nutze WordPress, Laravel oder Symfony Fertiges Plugin oder Paket installieren und konfigurieren. Integrationen → Ich baue ein eigenes Plugin Die Reihenfolge, die Vorlagen und die Checkliste vor der Veröffentlichung. Eigene Integration bauen → Ich suche ein bestimmtes Antwortfeld Alle Endpunkte, Felder, Statuscodes und Rate-Limits auf einen Blick. API-Referenz →

Alle Kapitel

01Einstieg Site anlegen, Widget einbauen, Token prüfen — der kürzeste Weg zum funktionierenden Schutz. SchnellstartHTML-Integration 02Integrationen Fertige Pakete für Laravel, Symfony, WordPress und die WoltLab Suite — und die Anleitung für eine eigene. Laravel-PaketSymfony-BundleWordPress-PluginWoltLab SuiteEigene Integration bauen 03Widget Alle Attribute, die drei Modi und die JavaScript-API für nachgeladene Formulare. Widget-OptionenWidget-ModiJavaScript-API 04API-Referenz Endpunkte, Antwortfelder, Statuscodes, Rate-Limits und unsere Zusagen zur Stabilität. Endpunkte & AntwortenWebhooksVersionierung 05Erkennung Wie die Risk Engine bewertet, wie Profile und Policies greifen und was im Angriffsfall passiert. Risk EngineSite-Profile & Form-PoliciesUnder-Attack-Mode 06Betrieb Verhalten bei Ausfall, Schlüsselrotation, Server-Beispiele, Domains und Content Security Policy. Fehlerbehandlung & Fail-OpenSchlüssel & RotationBackend-BeispieleDomains, CORS & CSP 07Hilfe & Datenschutz Die häufigsten Stolpersteine mit Lösung und was CaptchaCore über Ihre Besucher speichert. TroubleshootingDatenschutz

Das Wichtigste in Kürze

1 · Widget einbinden

<script src="https://src-eu.captchacore.eu/widget/captchacore-v2.min.js"
        data-service-url="https://api.captchacore.eu"
        data-site-key="cc_pub_…" async defer></script>

<form data-captchacore="interactive" method="post">
    <div data-captchacore-widget></div>
</form>

2 · Token prüfen

POST https://api.captchacore.eu/api/v2/verify
X-CaptchaCore-Key: cc_sec_…

{ "token": "…", "form_type": "contact" }

Antwort

{ "valid": true, "decision": "allow", "risk_score": 8, "confidence": 0.94 } Formular normal verarbeiten.

{ "valid": true, "decision": "challenge", "risk_score": 41, "confidence": 0.71 } Durchlassen, aber protokollieren. Optional eine zusätzliche eigene Prüfung, etwa eine Bestätigungsmail.

{ "valid": false, "decision": "step_up", "risk_score": 58, "step_up": { … } } NICHT hart ablehnen. Das Widget führt die Zusatzprüfung selbst durch; geben Sie dem Nutzer das Formular mit einer freundlichen Meldung zurück.

{ "valid": false, "decision": "block", "risk_score": 96, "confidence": 0.88 } Ablehnen. Fehlermeldung ohne Details anzeigen, damit Angreifer nichts lernen.

valid ist auch bei step_up false. Behandeln Sie step_up nicht wie block — Details.