DokumentationAEM as a Cloud ServiceBenutzerhandbuch

Verbinden Ihrer AEM Forms-Umgebung mit Turnstile connect-your-forms-environment-with-turnstile-service

Last update: Wed Feb 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende
  • Entwickler

Diese Funktion ist im Rahmen des Early-Adopter-Programms verfügbar. Sie können von Ihrer offiziellen E-Mail-Adresse aus an aem-forms-ea@adobe.com schreiben, um dem Early-Adopter-Programm beizutreten und den Zugriff auf diese Funktion zu beantragen.

CAPTCHA („Completely Automated Public Turing test to tell Computers and Humans Apart“ – „vollautomatischer öffentlicher Turing-Test zur Unterscheidung von Computern und Menschen“) ist ein Programm, das bei Onlinetransaktionen eingesetzt wird, um zwischen Menschen und Bots oder automatisierten Programmen zu unterscheiden. Es stellt eine herausfordernde Aufgabe und bewertet die Benutzerantwort, um festzustellen, ob es sich um einen Menschen oder einen Bot handelt, der mit der Site interagiert. Dabei wird verhindert, dass der Benutzer fortfährt, wenn der Test fehlschlägt, wodurch Onlinetransaktionen sicherer werden, da Bots keinen Spam senden oder andere bösartige Zwecke verfolgen können.

AEM Forms as a Cloud Service unterstützt die folgenden CAPTCHA-Lösungen:

Integrieren der AEM Forms-Umgebung mit Turnstile Captcha

Cloudflare's Turnstile Captcha ist eine Sicherheitsmaßnahme, die darauf abzielt, Formulare und Websites vor automatischen Bots, bösartigen Angriffen, Spam und unerwünschtem automatisierten Traffic zu schützen. Bei der Formularübermittlung wird ein Kontrollkästchen angezeigt, mit dem Sie überprüfen können, ob es sich um menschliche Daten handelt, bevor Sie ihnen das Senden des Formulars ermöglichen. AEM Forms as a Cloud Service unterstützt Drehkreuz-Captcha in den Kernkomponenten von Adaptive Forms.

Voraussetzungen für die Integration der AEM Forms-Umgebung mit Turnstile Captcha prerequisite

Um das Drehkreuz für AEM Forms-Kernkomponenten zu konfigurieren, müssen Sie den Drehkreuz-Standortschlüssel und geheimen Schlüssel von der Drehkreuz-Website abrufen.

Drehkreuz konfigurieren steps-to-configure-hcaptcha

So integrieren Sie AEM Forms mit dem Drehkreuz-Service:

  1. Erstellen Sie einen Konfigurations-Container in Ihrer AEM Forms as a Cloud Service-Umgebung. Ein Konfigurations-Container enthält Cloud-Konfigurationen, mit denen AEM mit externen Diensten verbunden wird. Gehen Sie wie folgt vor, um einen Konfigurations-Container für die Verbindung Ihrer AEM Forms-Umgebung mit Turnstile zu erstellen und zu konfigurieren:

    1. Öffnen Sie Ihre AEM Forms as a Cloud Service-Instanz.

    2. Wählen Sie Tools > Allgemein > Konfigurations-Browser.

    3. Erstellen Sie im Konfigurations-Browser entweder einen neuen Ordner und aktivieren Sie Cloud-Konfigurationen dafür oder aktivieren Sie Cloud-Konfigurationen für einen vorhandenen Ordner wie unten beschrieben:

      • Gehen Sie wie vor, um einen neuen Ordner“ zu erstellen und die entsprechenden Cloud-Konfigurationen zu aktivieren:

        1. Klicken Sie im Konfigurations-Browser auf Erstellen.
        2. Geben Sie im Dialogfeld „Konfiguration erstellen“ einen Namen und einen Titel an und wählen Sie die Option Cloud-".
        3. Klicken Sie auf Erstellen.

      • So aktivieren Sie die Option Cloud-Konfigurationen für einen Ordner:

        1. Wählen Sie im Konfigurationsbrowser den vorhandenen Ordner aus und klicken Sie auf Eigenschaften.
        2. Aktivieren Sie im Dialogfeld „Konfigurationseigenschaften“ die Option Cloud-Konfigurationen.
        3. Klicken Sie auf Speichern und schließen, um die Konfiguration zu speichern und zu beenden.

  2. Konfigurieren des Cloud-Service:

    1. Wechseln Sie in der AEM-Autoreninstanz zu tools-1 > Cloud Services und klicken Sie auf Drehkreuz.

      Drehkreuz in der Benutzeroberfläche

    2. Wählen Sie einen erstellten oder aktualisierten Konfigurations-Container aus, wie im vorherigen Abschnitt beschrieben. Wählen Sie Erstellen aus.

      Konfigurations-Drehkreuz

    3. Geben Sie Widget-Typ als verwaltet, nicht interaktiv oder unsichtbar an. Weitere Informationen zum Widget-Typ finden Sie unter Drehkreuz-Widget.

    4. Geben Sie Titel, Name, Site-Schlüssel und Geheimer Schlüssel für den an (in der Voraussetzung erhalten.

    5. Klicken Sie auf Erstellen.

      Konfigurieren Sie den Cloud Service, um Ihre AEM Forms-Umgebung mit Turnstile zu verbinden

    note note
    NOTE
    Benutzende müssen die Client-seitige JavaScript-Validierungs-URL und die Server-seitige Validierungs-URL nicht ändern, da sie bereits für die Drehkreuz-Validierung vorausgefüllt sind.

    Sobald der Service „Drehkreuz-CAPTCHA“ konfiguriert ist, kann er in einem adaptiven Formular auf der Grundlage von Kernkomponenten“ verwendet.

Verwenden von Turnstile in einem adaptiven Formular using-turnstile-core-components

  1. Öffnen Sie Ihre AEM Forms as a Cloud Service-Instanz.

  2. Gehen Sie zu Formulare > Formulare und Dokumente.

  3. Wählen Sie Ihr adaptives Formular aus und klicken Sie auf Eigenschaften. Wählen Sie im Abschnitt Konfigurations-Container den Konfigurations-Container aus, der die Cloud-Konfiguration enthält, die AEM Forms mit Turnstile verbindet.

  4. Klicken Sie auf Speichern und schließen.

    Wenn Sie keinen Konfigurations-Container haben, erfahren Sie im Abschnitt Konfigurieren eines", wie Sie einen Konfigurations-Container erstellen.

    Auswählen eines Konfigurations-Containers

  5. Wählen Sie ein adaptives Formular aus und klicken Sie Bearbeiten, um ein Formular im Editor zu öffnen.

  6. Ziehen Sie im Komponenten-Browser per Drag & Drop die Komponente Adaptives Formular - Drehkreuz auf das adaptive Formular.
    Hinzufügen der Captcha-Komponente „Drehkreuz“

  7. Wählen Sie die Komponente Adaptives Formular - Drehkreuz aus und klicken Sie auf das Symbol Eigenschaften Symbol Eigenschaften . Dadurch wird das Dialogfeld „Eigenschaften“ geöffnet. Geben Sie die folgenden Eigenschaften an:

    Drehkreuz v2

    • Name: Geben Sie den Namen für Ihre CAPTCHA-Komponente an. Sie können eine Formularkomponente sowohl im Formular als auch im Regeleditor einfach mit ihrem eindeutigen Namen identifizieren.

    • Titel: Geben Sie den Titel für die CAPTCHA-Komponente an. Sie können Rich-Text für den Titel zulassen und auch den Titel ausblenden, indem Sie die Kontrollkästchen aktivieren.

    • Konfigurationseinstellungen: Wählen Sie eine Cloud-Konfiguration aus, die für den Turnstile CAPTCHA-Service konfiguriert ist.

      note note
      NOTE
      • Sie können in Ihrer Umgebung mehrere Cloud-Konfigurationen für einen ähnlichen Zweck verwenden. Wählen Sie den Dienst daher sorgfältig aus. Wenn kein Dienst aufgeführt ist, erfahren Sie im Abschnitt Konfigurieren von Drehkreuz, wie Sie einen Konfigurations-Container erstellen, um Ihre AEM Forms-Umgebung mit dem Drehkreuz-Dienst zu verbinden.

    • Validierung: CAPTCHA-Validierung in Form einer Fehlermeldung bereitstellen:

      • Fehlermeldung: Geben Sie die Fehlermeldung an, die Benutzern angezeigt werden soll, wenn die CAPTCHA-Übermittlung fehlschlägt.

        note note
        NOTE
        • Eine Fehlermeldung wird nur angezeigt, wenn das CAPTCHA Client-seitig ausgefüllt ist.

  8. Klicken Sie auf Fertig.

Für die Formularübermittlung sind jetzt nur noch Formulare zulässig, in denen der Formularbenutzer die vom Dienst „Drehkreuz“ ausgehende Herausforderung erfolgreich löscht.

Turnstile Challenge

Häufig gestellte Fragen

  • F: Kann ich mehr als eine CAPTCHA-Komponente in einem adaptiven Formular verwenden?
  • A: Die Verwendung von mehr als einer CAPTCHA-Komponente in einem adaptiven Formular wird nicht unterstützt. Außerdem wird nicht empfohlen, eine CAPTCHA-Komponente in einem Fragment oder einem Bereich zu verwenden, der für verzögertes Laden markiert ist.

Siehe auch see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab