TrustCaptcha · Bot-Schutz

Go CAPTCHA-Integration

Mit einem Go-CAPTCHA sicherst du dein Go-Backend in wenigen Minuten: Widget in Formulare einbinden, Anfragen in deiner Go-API verifizieren und je nach Bot-Score reagieren. So verhinderst du Missbrauch bei Registrierung, Kontaktformularen und Checkout, ganz ohne Rätsel. 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

Integriere das CAPTCHA-Widget in deine Website oder App. Eine Schritt-für-Schritt-Anleitung findest du im CAPTCHA-Widget-Guide unserer Dokumentation.

Dokumentation lesen

Das CAPTCHA-Widget wird anschließend auf deiner Website oder in deiner App angezeigt:

Vorgefertigte Frontend-Integrationen
Mit unseren vorgefertigten Frontend-Integrationen baust du das CAPTCHA-Widget in deine Website oder Anwendung ein. Gibt es für deine Frontend-Technologie noch keine, können deine Entwickler das Widget mithilfe unserer Dokumentation selbst integrieren oder unser Support-Team nach einer vorgefertigten Integration fragen.

3. CAPTCHA-Ergebnis in deinem Backend validieren

Die folgenden Schritte zeigen, wie dein Go-Backend das CAPTCHA-Verifikationsergebnis von unserem Server abruft und anhand des Ergebnisses entscheidet, wie es weitergeht. Die vollständige Anleitung findest du in der CAPTCHA-Integrationsanleitung für Go unserer Dokumentation.

Dokumentation lesen

Installiere zunächst unser TrustCaptcha-Go-Modul:

Install

bash

go get github.com/trustcomponent/trustcaptcha-go/v3

Rufe das Verifikationsergebnis mit dem Verifikationstoken und deinem API-Key von unserem Server ab:

Fetch Result

// Verifikationsergebnis abrufen
verificationResult, err := trustcaptcha.GetVerificationResult("<your_api_key>", "<verification_token_from_your_client>")
if err != nil {
  // Abruf des Verifikationsergebnisses fehlgeschlagen – Fehler behandeln
  return
}

Entscheide anhand des Verifikationsergebnisses und deiner Anforderungen, wie du weiter vorgehst:

Handle Result

// Auf das Verifikationsergebnis reagieren
if !verificationResult.VerificationPassed || verificationResult.Score > 0.5 {
  // Verifizierung fehlgeschlagen oder Bot-Score > 0,5 – mögliche automatisierte Anfrage
}

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

Andere Backend-Technologie statt Go?
Wenn auf deinem Server nicht Go läuft oder du mehrere Backends hast, wähle hier eine andere Integration. Gibt es für deine Backend-Technologie noch keine vorgefertigte Integration, können deine Entwickler die CAPTCHA-Prüfung mithilfe unserer Dokumentation selbst integrieren oder unser Support-Team nach einer vorgefertigten Integration fragen.

4. Integration testen

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

Häufige Fragen

Wie funktioniert ein Go-CAPTCHA-Check?

Ein Go-CAPTCHA ist eine Prüfung, die dein Backend ausführt, bevor es eine Anfrage verarbeitet. Das Widget im Browser löst im Hintergrund eine Proof-of-Work-Aufgabe, sendet Signale für die Risikobewertung und hängt einen Verifikationstoken an das Formular. Dein Go-Handler übergibt diesen Token mit deinem API-Key an trustcaptcha.GetVerificationResult und erhält bestanden oder nicht bestanden, dazu einen Bot-Score von 0 (sehr wahrscheinlich Mensch) bis 1 (sehr wahrscheinlich Bot). Den Schwellenwert legst du fest, so stoppst du Bot-Traffic bei Registrierungen, Kommentaren oder im Checkout direkt dort, wo er ankommt.

Kann ich einen TrustCaptcha-Client über mehrere Goroutines teilen?

Ja. Für eigene Einstellungen erstellst du beim Start einmal einen Client mit trustcaptcha.New(apiKey, options). Die Instanz ist unveränderlich und für nebenläufige Nutzung sicher, alle Handler und Goroutines können sie also wiederverwenden. Sie nutzt net/http aus der Go-Standardbibliothek mit Standard-Timeouts von 3 Sekunden für den Verbindungsaufbau und 5 Sekunden fürs Lesen, die du in den Optionen änderst. Mit den Standardwerten reicht die Funktion GetVerificationResult auf Paketebene.

Funktioniert das Golang-CAPTCHA-Modul mit Gin, Echo und Fiber?

Ja. Das Modul braucht nur den Verifikationstoken aus der Anfrage und funktioniert daher in einfachen net/http-Handlern genauso wie in jedem Router oder Framework. Lies im Handler das Feld tc-verification-token aus, hol das Ergebnis ab und gib eine Fehlerantwort zurück, wenn die Prüfung fehlschlägt. Unsere Anleitungen für Gin, Echo und Fiber zeigen den Code für jedes Framework.

Wie sollte mein Go-Handler auf Fehler reagieren?

GetVerificationResult gibt typisierte Fehler zurück, etwa VerificationTokenInvalidError, VerificationResultExpiredError oder VerificationResultRetrievalLimitReachedError. Werte sie als nicht bestandene Prüfung. ServerUnreachableError heißt, dass dein Server unsere API gar nicht erreicht hat. Unsere Dokumentation schlägt vor, die Anfrage dann zuzulassen und den Vorfall zu protokollieren. ClientReportedServerUnreachableError heißt, dass das Widget einen Ausfall gemeldet hat, den dein Server nicht bestätigen kann. Lehne die Anfrage dann ab oder verlange eine weitere Prüfung.

Ist TrustCaptcha DSGVO-konform?

TrustCaptcha ist für einen DSGVO-konformen Einsatz gebaut: Die Daten werden ausschließlich in der EU auf ISO-27001-zertifizierter Infrastruktur verarbeitet und gespeichert, es werden keine Cookies gesetzt, und den Auftragsverarbeitungsvertrag (AVV) schließt du online ab. Ob dein Einsatz konform ist, hängt auch von deiner Einbindung und deiner Datenschutzerklärung ab. Dies ist keine Rechtsberatung; kläre die Details mit deinem Datenschutzbeauftragten.

Kann ich das Erscheinungsbild von TrustCaptcha in Go anpassen?

Ja, und nichts davon betrifft dein Go-Backend, denn das Aussehen stellst du am Widget im Frontend ein. Du bekommst 37+ Sprachen sofort einsatzbereit, kannst jede weitere Sprache ergänzen und jeden Widget-Text überschreiben und wählst ein helles oder dunkles Theme oder die Systemeinstellung. Ab dem Tarif Team passt du Farben, Rahmen und Eckenradius an. Ein Widget ohne unser Branding oder ein komplett unsichtbares Widget gibt es mit dem kostenpflichtigen Add-on Captcha Branding.

Wie bleibt TrustCaptcha barrierefrei und blockiert dennoch Bots?

Es gibt keine Bild- oder Audio-Rätsel: Das Widget erledigt ein Proof-of-Work im Hintergrund, und der Bot-Score bewertet die Anfrage. Das Widget bringt ARIA-Labels und Screenreader-Texte mit und ist darauf ausgelegt, die WCAG-Standards und den European Accessibility Act zu erfüllen. Bots zahlen mit Rechenzeit, weil das Proof-of-Work mit dem Risiko schwerer wird, und riskante Anfragen können zusätzlich an deinem Bot-Score-Schwellenwert scheitern.

Leads verlieren wegen CAPTCHAs?

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

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 Go-Anwendung in wenigen Schritten mit TrustCaptcha!

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

Loslegen Vertrieb kontaktieren