EU CAPTCHA für Gatsby

Häufig gestellte Fragen

• Wie füge ich EU CAPTCHA zu einer Gatsby-Website hinzu?

  Installieren Sie das Paket mit npm i @myrasec/eu-captcha. Importieren Sie { EuCaptcha, isEuCaptchaDone } from '@myrasec/eu-captcha' und platzieren Sie <EuCaptcha sitekey={sitekey} /> in Ihrer Formularkomponente. Sichern Sie jeden DOM-Zugriff mit typeof window !== 'undefined' ab. Rufen Sie isEuCaptchaDone() beim Absenden auf und senden Sie den Token zur serverseitigen Verifizierung an eine Gatsby Function oder Backend-API.

• Funktioniert EU CAPTCHA mit der statischen Site-Generierung von Gatsby?

  Ja. Da die EuCaptcha-Komponente nach der Hydration nur im Browser ausgeführt wird, funktioniert sie nahtlos mit dem SSG-Ansatz von Gatsby. Die Komponente wird während des statischen Builds nicht gerendert – sie initialisiert sich, nachdem die Seite im Browser des Benutzers hydriert wurde, also genau dann, wenn Formularinteraktionen stattfinden.

• Wie verhindere ich Build-Fehler mit EU CAPTCHA in Gatsby?

  Gatsby erstellt Seiten zur Kompilierzeit mit Node.js, wo window und document nicht verfügbar sind. Das Paket @myrasec/eu-captcha geht damit zuverlässig um. Wenn Sie jedoch direkt auf das Widget-Element zugreifen, sichern Sie DOM-Abfragen stets mit einer typeof window !== 'undefined'-Prüfung ab oder platzieren Sie sie innerhalb eines useEffect-Hooks.

• Kann ich den CAPTCHA-Token mit Gatsby Functions verifizieren?

  Ja. Gatsby Functions (im Verzeichnis src/api/) stellen serverlose Endpunkte bereit, die auf Netlify oder anderen kompatiblen Hosts ausgeführt werden. Erstellen Sie eine Funktion, die den eu-captcha-response-Token empfängt, ihn per POST an die EU CAPTCHA Verification API mit Ihrem geheimen Schlüssel sendet und eine entsprechende Antwort an den Client zurückgibt, bevor die Formulardaten verarbeitet werden.

• Funktioniert EU CAPTCHA zusammen mit Formik oder React Hook Form?

  Ja. Die EuCaptcha-Komponente aus @myrasec/eu-captcha funktioniert unabhängig von jeder Formularbibliothek. Platzieren Sie sie in Ihrem Formular, verwenden Sie isEuCaptchaDone() zur Bestätigung der Abschluss und lesen Sie den versteckten eu-captcha-response-Eingabewert in Ihrem Submit-Handler aus. Fügen Sie ihn zusammen mit den übrigen Formulardaten ein, bevor Sie diese an den Server senden.

• Wie gehe ich mit der CAPTCHA-Neuinitialisierung bei der clientseitigen Navigation in Gatsby um?

  Die EuCaptcha-Komponente folgt den standardmäßigen React-Lebenszyklusregeln und initialisiert sich bei jedem Mounten neu. Wenn Gatsby zwischen Seiten navigiert, werden Komponenten ausgehängt und erneut eingehängt, sodass sich das Widget automatisch neu initialisiert. Verwenden Sie eine key-Prop, die an den aktuellen location-Pfadnamen gebunden ist, wenn Sie eine vollständige Neuinitialisierung erzwingen möchten.

• Ist EU CAPTCHA DSGVO-konform für Gatsby-Websites?

  Ja. EU CAPTCHA wird von einem in der EU ansässigen Unternehmen betrieben, ist vollständig in Deutschland gehostet und stützt sich nicht auf US-amerikanische Cloud-Anbieter oder Infrastrukturen, die US-Überwachungsgesetzen unterliegen. Der Dienst verarbeitet nur die Daten, die zur Bereitstellung und Verifizierung des CAPTCHAs erforderlich sind (wie IP-Adresse sowie technische Browser- oder Geräteinformationen), im Einklang mit den Anforderungen der DSGVO. Ihre Organisation bleibt verantwortlich für die Bereitstellung transparenter Datenschutzinformationen, die Wahl einer geeigneten Rechtsgrundlage und die Einholung etwaig erforderlicher Einwilligungen für Ihre spezifische Gatsby-Implementierung. Diese Informationen stellen keine Rechtsberatung dar; bitte konsultieren Sie Ihren Rechtsberater für eine Beurteilung Ihres individuellen Falls.