TrustComponent
JavaScript
TrustCaptcha · Bot-Schutz

JavaScript CAPTCHA-Integration

Ein JavaScript-CAPTCHA bindest du mit einem einfachen Formular-Widget in wenigen Minuten auf jeder Website ein. Es schützt Registrierungen, Passwort-Resets, Lead-Formulare und Checkouts vor automatisiertem Missbrauch, ganz ohne Rätsel. EU-gehostet, DSGVO-konform und auf Barrierefreiheit ausgelegt.

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 JavaScript-Frontend einbaust. Die vollständige Anleitung findest du in der CAPTCHA-Integrationsanleitung für JavaScript unserer Dokumentation.

Dokumentation lesen

Installiere zunächst unser TrustCaptcha-JavaScript-Paket:

Install
HTML
ECMAScript Modules (esm)
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>

CommenJS (cjs)
<script src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.cjs.min.js"></script>

Universal Module Definition (umd)
<script src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.umd.min.js"></script>

Füge dann das CAPTCHA-Widget (den HTML-Tag trustcaptcha-component) in ein beliebiges HTML-Formular ein:

example.html
HTML
<form>
  <!-- your input fields -->
  <trustcaptcha-component
    sitekey="<your_site_key>"
  ></trustcaptcha-component>
  <!-- further input fields / submit button -->
</form>

<script>
  const trustcaptchaComponent = document.getElementsByTagName('trustcaptcha-component')[0];
  trustcaptchaComponent.addEventListener('captchaSolved', (event) => {
  console.log('Verification token:', event.detail); <!-- handle success -->
});
  trustcaptchaComponent.addEventListener('captchaFailed', (event) => {
  console.error(event.detail); <!-- handle error -->
});
</script>

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

CAPTCHA-Widget vor dem Start

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

Andere Frontend-Technologie statt JavaScript?
Wenn du nicht mit JavaScript 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 JavaScript-CAPTCHA auf einer einfachen Website?
Du fügst das Widget-Skript in deine Seite ein, platzierst das CAPTCHA-Element innerhalb deines <form> und konfigurierst deinen Site Key. Anschließend muss dein Backend den Verifikationstoken über unsere API prüfen, bevor du die Anfrage akzeptierst.
Funktioniert das nur mit JavaScript oder auch mit anderen Frameworks und CMS-Plattformen?
Die JavaScript-Integration funktioniert auf jeder Website, die JavaScript ausführen kann. Wenn du eine Plattform wie WordPress, TYPO3, Magento, Keycloak oder ein Framework wie Angular/React/Vue nutzt, kannst du alternativ auch ein fertiges Plugin oder einen Wrapper verwenden.
Warum muss das CAPTCHA innerhalb eines <form> eingebunden werden?
Weil das Widget für die Arbeit mit Formularen ausgelegt ist: Es erstellt automatisch ein verborgenes Token-Feld und verknüpft den Verifikationsablauf mit diesem <form>. Wenn es nicht innerhalb eines <form> liegt, kann es nicht korrekt funktionieren.
Wie bekomme ich den Verifikationstoken und sende ihn an meinen Server?
Das Widget fügt deinem <form> automatisch ein verborgenes Input-Feld hinzu (standardmäßig mit dem Namen "tc-verification-token"). Wenn du das Formular normal abschickst, wird der Verifikationstoken automatisch mitgesendet. Wenn du das Formular individuell sendest (z. B. per AJAX), kannst du das versteckte Feld auslesen oder auf das Event "captchaSolved" hören.
Brauche ich trotzdem eine serverseitige Validierung oder reicht das Frontend-Widget?
Du solltest immer serverseitig validieren. Das Frontend-Widget erzeugt nur einen Verifikationstoken; dein Backend muss diesen Verifikationstoken über unsere API prüfen, um eine sichere Entscheidung zu treffen.
Können wir die JavaScript-Datei selbst hosten, statt sie von eurem CDN zu laden?
Ja. Du kannst die JavaScript-Datei auf deiner eigenen Infrastruktur hosten und damit externe Abhängigkeiten reduzieren. Wenn du selbst hostest, bist du dafür verantwortlich, die Datei zu aktualisieren, wenn du Bugfixes und Verbesserungen übernehmen möchtest.
Wie richten wir autorisierte Websites (Domains) für Produktion und Entwicklung ein?
Trage die Domain oder Subdomain ein, die du schützen möchtest (z. B. "example.com" oder "app.example.com"). Für lokale Tests kannst du "localhost" oder eine IP-Adresse eintragen. Verwende dabei kein Protokoll, keine Ports, keine Pfade und keine Query-Parameter. Wildcard-Domains sind standardmäßig nicht aktiviert und können bei Bedarf über den Support freigeschaltet werden.
Kann ich mehrere CAPTCHAs auf derselben Seite verwenden?
Ja, das ist möglich. Empfohlen ist ein CAPTCHA pro <form>. Falls du mehrere CAPTCHAs innerhalb desselben <form> verwendest, solltest du unterschiedliche Namen für das Token-Feld setzen, um Konflikte zu vermeiden.
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 JavaScript-Anwendung in wenigen Schritten mit TrustCaptcha!

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