EU CAPTCHA für React

Häufig gestellte Fragen

• Wie füge ich EU CAPTCHA zu einer React-Anwendung 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} /> innerhalb Ihrer Formularkomponente. Rufen Sie isEuCaptchaDone() in Ihrem Submit-Handler auf und senden Sie den eu-captcha-response-Token zur serverseitigen Verifizierung an Ihre Backend-API.

• Funktioniert EU CAPTCHA mit React-Funktionskomponenten und Hooks?

  Ja. Das Paket @myrasec/eu-captcha ist eine Standard-React-Komponente, die mit Funktionskomponenten und Hooks kompatibel ist. Sie können useState für den Formularzustand, useRef für den Zugriff auf das Widget-Element bei Bedarf sowie die bereitgestellten Callback-Props onComplete, onExpired und onError nutzen, um auf Lebenszyklusereignisse des Widgets zu reagieren.

• Funktioniert EU CAPTCHA mit React 18 und dem Concurrent Mode?

  Ja. EU CAPTCHA ist eine in sich geschlossene React-Komponente, die unabhängig vom Concurrent Mode, Suspense-Grenzen oder Transitions funktioniert. Das Widget initialisiert sich, sobald der DOM-Knoten verfügbar ist, und greift nicht in die Render-Pipeline von React ein.

• Kann ich EU CAPTCHA in einer React-SPA mit clientseitigem Routing verwenden?

  Ja. Da die EuCaptcha-Komponente den standardmäßigen Lebenszyklusregeln von React-Komponenten folgt, initialisiert sie sich bei jedem Mounten neu. Bei der Navigation zwischen Routen mit React Router oder ähnlichen Bibliotheken initialisiert sich das Widget beim Mounten automatisch neu. Verwenden Sie eine key-Prop, die an die Route gebunden ist, wenn Sie eine vollständige Neuinitialisierung erzwingen möchten.

• Wie kann ich die EU CAPTCHA-Herausforderung verzögern oder manuell auslösen?

  Setzen Sie autostart={false} für die EuCaptcha-Komponente und geben Sie eine widgetId-Prop an. Wenn Sie bereit sind, die Herausforderung auszulösen – zum Beispiel wenn der Benutzer auf „Absenden“ klickt – rufen Sie window.euCaptcha.execute(widgetId) auf. Dies ist nützlich für mehrstufige Formulare, bei denen Sie die Herausforderung bis zur endgültigen Einreichung verzögern möchten.

• Ist EU CAPTCHA DSGVO-konform für React-Anwendungen?

  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 React-Implementierung. Diese Informationen stellen keine Rechtsberatung dar; bitte konsultieren Sie Ihren Rechtsberater für eine Beurteilung Ihres individuellen Falls.

• Wie sende ich den CAPTCHA-Token von React an mein Backend?

  Wenn die Herausforderung abgeschlossen ist, erstellt das Widget ein verstecktes Eingabefeld mit dem Namen eu-captcha-response. Lesen Sie dessen Wert mit document.querySelector('input[name="eu-captcha-response"]')?.value aus und fügen Sie ihn in den Body Ihrer fetch- oder axios-Anfrage ein. Ihr Backend validiert den Token gegen die EU CAPTCHA API mit Ihrem geheimen Schlüssel, bevor das Formular verarbeitet wird.