TrustComponent
React
TrustCaptcha · Bot-Schutz

React CAPTCHA-Integration

Die React-CAPTCHA-Integration von TrustCaptcha schützt deine Formulare vor Bots, ohne Bildrätsel. Sie hält Spam aus Registrierungen, Kontaktformularen und Zahlungen heraus, und echte Besucher müssen nichts lösen. In der EU gehostet und DSGVO-konform.

Schnellstart

So funktioniert die Integration

1. CAPTCHA erstellen

Erstelle ein Benutzerkonto oder melde dich mit einem bestehenden Konto an. Dann erstellst du ein neues CAPTCHA oder wählst ein vorhandenes aus. Wenn du TrustCaptcha erst ausprobieren willst: Jeder Tarif startet mit einer 14-tägigen kostenlosen Testphase.

Auf der Übersichtsseite des CAPTCHAs findest du den Site Key und den License Key, und dort erstellst du auch deinen API-Key. Trage die Domains deiner Website in den Sicherheitsregeln des CAPTCHAs als autorisierte Domains ein, damit sie dein CAPTCHA nutzen dürfen.

Start des Formulars zur Erstellung eines CAPTCHA.
CAPTCHA-Sicherheitsregeln eines Demo-CAPTCHAs.

2. CAPTCHA-Widget in dein Frontend integrieren

Die folgenden Schritte zeigen grob, wie du das TrustCaptcha-Widget in ein React-Frontend einbaust. Die vollständige Anleitung findest du in der CAPTCHA-Integrationsanleitung für React unserer Dokumentation.

Dokumentation lesen

Installiere zunächst unser TrustCaptcha-React-Paket:

Install
bash
npm i @trustcomponent/trustcaptcha-react

Füge dann das CAPTCHA-Widget (die TrustcaptchaComponent) in ein beliebiges HTML-Formular ein:

app.js
javascript
import {TrustcaptchaComponent} from "@trustcomponent/trustcaptcha-react";

function App() {

  function handleSuccess(verificationToken) { /* handle success */ }

  function handleError(error) { /* handle error */ }

  return (
    <div>
      <form>
        <!-- your input fields -->
        <TrustcaptchaComponent
          sitekey="<your_site_key>"
          onCaptchaSolved={event => handleSuccess(event.detail)}
          onCaptchaFailed={event => handleError(event.detail)}
        ></TrustcaptchaComponent>
        <!-- further input fields / submit button -->
      </form>
    </div>
  );
}

export default App;

Das CAPTCHA-Widget wird nun auf deiner React-Website angezeigt:

CAPTCHA-Widget vor dem Start

Benötigst du detaillierte Informationen zur React-CAPTCHA-Integration?
Detaillierte Anweisungen findest du in unserer React-CAPTCHA-Integrationsanleitung, ein vollständiges Integrationsbeispiel in unserem CAPTCHA-Samples-Repository auf GitHub.

Andere Frontend-Technologie statt React?
Wenn du nicht mit React arbeitest oder mehrere Websites und Apps betreibst, wähle hier ein anderes Framework oder eine andere Plattform. Gibt es für deine Frontend-Technologie noch keine vorgefertigte Integration, können deine Entwickler das CAPTCHA mithilfe unserer Dokumentation selbst integrieren oder unser Support-Team nach einer vorgefertigten Integration fragen.

Angular
Contact Form 7
Craft CMS
JavaScript
Joomla
JTL-Shop
Keycloak
Magento 2
React
Shopware 6
Svelte
TYPO3
Vue
Webflow
WordPress

3. CAPTCHA-Ergebnis in deinem Backend validieren

Sobald das CAPTCHA abgeschlossen ist, schickst du den Verifikationstoken an dein Backend. Dort rufst du das Verifikationsergebnis von unseren Servern ab und prüfst es. Wie du weiter vorgehst, hängt vom Bot-Risiko ab. Details zur Backend-Integration und zur Prüfung des Ergebnisses findest du in unserer Dokumentation.

Vorgefertigte Backend-Integrationen
Mit unseren vorgefertigten Integrationen baust du die CAPTCHA-Prüfung in deinen Backend-Service ein. Gibt es für deine Backend-Technologie noch keine, können deine Entwickler die Prüfung mithilfe unserer Dokumentation selbst integrieren oder unser Support-Team nach einer vorgefertigten Integration fragen.

.NET
Go
Groovy
Java
Kotlin
Node.js
PHP
Python
Ruby
Rust
Scala

4. Integration testen

TrustCaptcha ist jetzt aktiv. Schick eine Testanfrage ab und prüfe, ob sie durchgeht.

CAPTCHA abgeschlossen

Häufige Fragen

Was brauche ich für ein React-CAPTCHA in meiner App?
Du benötigst einen TrustCaptcha-Account, ein CAPTCHA, das du im Dashboard erstellt hast, sowie deine Zugangsdaten (Site Key, API-Key und optional License Key). In React installierst du das React-Package und platzierst die TrustCaptcha-Komponente innerhalb des Formulars, das du schützen möchtest.
Muss das TrustCaptcha-Widget innerhalb eines <form> sein?
Ja. Die TrustCaptcha-Komponente muss innerhalb eines <form>-Elements platziert werden. Wenn deine Seite kein klassisches Formular nutzt, solltest du die relevanten Eingabefelder und die TrustCaptcha-Komponente trotzdem in ein minimales <form> einbetten.
Wie erhalte ich den Verifikationstoken in React?
Du hast zwei Optionen: (1) Du liest ihn aus dem versteckten Input-Feld (Standardname: "tc-verification-token"), oder (2) du fängst ihn über ein Komponenten-Event ab (zum Beispiel über den React-Handler "onCaptchaSolved"). Verwende die Variante, die am besten zu deinem Formular- und API-Flow passt.
Muss ich das CAPTCHA trotzdem in meinem Backend validieren?
Ja, immer. Das React-Widget erzeugt nur einen Verifikationstoken. Dein Backend muss diesen Token an TrustCaptcha senden (unter Verwendung deines API-Keys) und das Ergebnis auswerten, bevor du eine Registrierung, einen Login, einen Checkout oder eine Kontaktanfrage akzeptierst.
Kann ich mehrere TrustCaptcha-Widgets auf einer Seite verwenden?
Ja. Mehrere Formulare auf derselben Seite sind problemlos möglich. Wenn du mehr als ein Widget im selben Formular platzierst, gib jedem Widget einen eigenen Namen für das Token-Feld (zum Beispiel über "tokenFieldName") oder nutze die Events, damit du die Tokens sauber getrennt verarbeiten kannst.
Wo sollte ich TrustCaptcha in einem Multi-Step-(Wizard-)Formular platzieren?
Platziere es möglichst nah an der finalen Submit-Aktion. Standardmäßig ist ein Verifikationstoken nur einmal verwendbar und 15 Minuten gültig. Im Enterprise-Plan kannst du die Gültigkeit verlängern und eine begrenzte Zahl von Abrufen erlauben. Wird das CAPTCHA in einem langen Ablauf zu früh gelöst, kann das unnötige Wiederholungen verursachen.
Funktioniert TrustCaptcha mit React-SSR/SSG-Frameworks (zum Beispiel Next.js)?
Ja. TrustCaptcha unterstützt gängige React-Setups, einschließlich SSR/SSG. In der Praxis rendern viele Teams das Widget clientseitig (im Browser), damit die Verifikation normal laufen kann, und validieren anschließend den Verifikationstoken serverseitig.
Leads verlieren wegen CAPTCHAs?

TrustCaptcha blockiert Spam und Bots, nicht deine Kunden. Keine Rätsel, DSGVO-konform, in der EU gehostet.

CAPTCHA-Start
CAPTCHA abgeschlossen
Keine Rätsel für Besucher
Die Prüfung läuft im Hintergrund, während Besucher tippen. So schicken mehr Menschen deine Formulare ab, statt vorher aufzugeben.
DSGVO-konform
In der EU gehostet, ohne Cookies, mit verschlüsselter Übertragung und automatischer Löschung. Jeder Kunde bekommt einen Auftragsverarbeitungsvertrag (AVV).
Mehrstufige Sicherheit
Adaptiver Proof-of-Work und Risiko-Scoring stoppen Missbrauch früh, auch wenn der Angriffs-Traffic plötzlich steigt.
Volle Kontrolle
Stell die Empfindlichkeit ein, pflege Allow- und Blocklisten und nutze Geoblocking. Du entscheidest, wie streng die Prüfung ist.

Schütze deine React-Anwendung in wenigen Schritten mit TrustCaptcha!

  • EU-hosted & DSGVO-konform
  • Keine Rätsel
  • 14 Tage kostenlos testen