TrustComponent
Vue.js
TrustCaptcha · Bot-Schutz

Vue.js CAPTCHA-Integration

TrustCaptcha ist ein Vue.js CAPTCHA, das Logins, Registrierungen und Kontaktformulare in deiner Vue-App mit risikobasierter Bot-Erkennung schützt. Diese Anleitung zeigt dir, wie du das Widget einbindest und jede Prüfung serverseitig verifizierst. Datenschutzorientiert, in der EU gehostet, DSGVO-konform und auf Barrierefreiheit ausgelegt, ganz ohne Bilderrätsel.

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

Dokumentation lesen

Installiere zunächst unser TrustCaptcha-Vue.js-Paket:

Install
bash
npm i @trustcomponent/trustcaptcha-vue

Registriere das TrustCaptcha-Element als Custom Element:

vite-config.js
JavaScript
export default defineConfig({
plugins: [
vue({
template: {
compilerOptions: {
isCustomElement: (tag) => tag.includes('trustcaptcha'),
}
}
}),
],
})

Füge die TrustCaptcha-Komponente zu deiner Anwendung hinzu:

main.js
JavaScript
import {TrustcaptchaComponent} from "@trustcomponent/trustcaptcha-vue";

createApp(App).use(TrustcaptchaComponent).mount('#app')

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

app.vue
Vue
<form>
  <!-- your input fields -->
  <trustcaptcha-component
    sitekey="<your_site_key>"
    @captchaSolved="handleSuccess($event.detail)"
    @captchaFailed="handleError($event.detail)"
  ></trustcaptcha-component>
  <!-- further input fields / submit button -->
</form>

Das CAPTCHA-Widget wird nun auf deiner Vue.js-Website angezeigt:

CAPTCHA-Widget vor dem Start

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

Andere Frontend-Technologie statt Vue.js?
Wenn du nicht mit Vue.js 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 ist TrustCaptcha für Vue, und ist es eine reCAPTCHA-Alternative für Vue?
TrustCaptcha ist ein datenschutzfreundliches CAPTCHA-Widget, das du in Vue-Formulare einbaust, um Bots und Spam ohne Bilderrätsel zu stoppen. Es kombiniert Proof-of-Work mit einem risikobasierten Verifikationsergebnis und optionalen Sicherheitsregeln, sodass du Registrierungen, Kontaktformulare, Checkouts und mehr schützen kannst. Nutzt deine Vue-App heute reCAPTCHA v2 oder v3, tauschst du die reCAPTCHA-Komponente gegen die TrustCaptcha-Komponente und prüfst das neue Token auf deinem Server.
Wie funktioniert die Vue-Integration (einfach erklärt)?
Du platzierst das TrustCaptcha-Widget in deinem Vue-Formular. Nachdem ein Nutzer es abgeschlossen hat, erhält deine Seite ein Verifikationstoken. Dein Backend sendet dieses Token an TrustCaptcha, um das Verifikationsergebnis abzurufen (zum Beispiel einen Risiko-Score), und entscheidet dann, ob die Anfrage angenommen oder blockiert wird.
Was brauche ich für die Einrichtung in einem Vue-Projekt?
Du brauchst ein TrustCaptcha-Konto und einen CAPTCHA-"sitekey" aus deinem Dashboard sowie das Vue-Paket. In deinem Vue-Projekt installierst du das Paket, registrierst die Komponente einmal und platzierst dann die <trustcaptcha-component> mit deinem sitekey auf der Seite.
Muss das Widget innerhalb eines <form>-Elements stehen?
Ja. Die TrustCaptcha-Komponente muss innerhalb eines HTML-<form> platziert werden. Wenn deine Seite bisher keine Formulare nutzt, kannst du ein kleines Formular um das Widget und deinen Absenden-Button legen.
Brauche ich trotzdem eine serverseitige Validierung?
Ja, immer. Das Verifikationstoken aus dem Browser muss auf deinem Server (mit deinem API-Key) geprüft werden, um das offizielle Verifikationsergebnis abzurufen. Ohne serverseitige Validierung ist die Integration nicht sicher.
Wie bekomme ich das Verifikationstoken und wie lange ist es gültig?
Nach einer erfolgreichen Verifizierung steht das Token entweder als verstecktes Formularfeld (Standardname: tc-verification-token) oder über das Event captchaSolved bereit. 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. Bei mehrstufigen Abläufen platzierst du das Widget am besten nahe am letzten Absenden-Schritt.
Kann ich mehrere TrustCaptcha-Widgets auf derselben Seite verwenden?
Ja. Mehrere Formulare können jeweils ein eigenes Widget haben. Wenn du mehrere Widgets im selben Formular platzierst, gib jedem Widget einen anderen Namen für das Token-Feld (oder nutze die Events), damit sich die Tokens nicht gegenseitig überschreiben.
Kann ich Sprache, Theme oder Branding anpassen?
Ja. Grundlegendes wie Sprache und helles oder dunkles Theme stellst du direkt ein. Ein eigenes Design und ein eigener Datenschutzlink brauchen einen License Key, das eigene Design ist ab dem Team-Plan enthalten. Ein komplett unsichtbares Widget und das Ausblenden unseres Brandings gibt es mit dem kostenpflichtigen Add-on Captcha Branding.
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 Vue.js-Anwendung in wenigen Schritten mit TrustCaptcha!

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