DokumentationAEM as a Cloud ServiceBenutzerhandbuch

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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende
  • Entwickler

Diese Funktion ist im Rahmen des Programms für frühzeitige Bearbeitung 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 dem Turnstile Captcha

Das Turnstile Captcha von Cloudflare ist eine Sicherheitsmaßnahme, um Formulare und Sites vor automatisierten Bots, bösartigen Angriffen, Spam und unerwünschtem automatisierten Traffic zu schützen. Es wird ein Kontrollkästchen bei der Formularübermittlung angezeigt, mit dem überprüft wird, ob es sich um menschliche Formulare handelt, bevor sie das Formular senden können. AEM Forms as a Cloud Service unterstützt Turnstile Captcha in den adaptiven Forms-Kernkomponenten.

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

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

Turnstile konfigurieren steps-to-configure-hcaptcha

Führen Sie die folgenden Schritte aus, um AEM Forms mit dem Turnstile-Dienst zu integrieren:

  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. So erstellen und konfigurieren Sie einen Konfigurations-Container, um Ihre AEM Forms-Umgebung mit Turnstile zu verbinden:

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

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

    3. Im Konfigurationsbrowser können Sie einen vorhandenen Ordner auswählen oder einen Ordner erstellen. Sie können einen Ordner erstellen und die Cloud-Konfigurationsoption dafür aktivieren oder die Option „Cloud-Konfigurationen“ für einen vorhandenen Ordner aktivieren:

      • Erstellen eines Ordners und Aktivieren der entsprechenden Cloud-Konfigurationsoption:

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

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

        1. Wählen Sie im Konfigurations-Browser den Ordner aus und wählen Sie Eigenschaften.
        2. Aktivieren Sie im Dialogfeld „Konfigurationseigenschaften“ die Option Cloud-Konfigurationen.
        3. Wählen Sie Speichern und schließen, um die Konfiguration zu speichern und das Dialogfeld zu schließen.

  2. Konfigurieren des Cloud-Service:

    1. Wechseln Sie in Ihrer AEM-Autoreninstanz zu tools-1 > Cloud Service und wählen Sie Turnstile aus.

      Turnstile in ui

    2. Wählen Sie einen Konfigurations-Container aus, der erstellt oder aktualisiert wurde, wie im vorherigen Abschnitt beschrieben. Wählen Sie Erstellen aus.

      Konfigurations-Turnstile

    3. Geben Sie den Widget-Typ als verwaltet, den Titel, den Namen, den Site-Schlüssel und den geheimen Schlüssel für den Turnstile-Dienst an, der unter Voraussetzung abgerufen wurde.

    4. Klicken Sie auf Erstellen.

      Konfigurieren des Cloud Service für die Verbindung Ihrer AEM Forms-Umgebung mit der Turnstile

    note note
    NOTE
    Benutzer müssen die clientseitige JavaScript-Validierungs-URL und die serverseitige Validierungs-URL nicht ändern, da sie bereits für die Turnstile-Validierung vorausgefüllt sind.

    Sobald der Turnstile Captcha-Dienst konfiguriert ist, ist er für die Verwendung in einem adaptiven Formular basierend auf Kernkomponenten verfügbar.

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 ein adaptives Formular und dann Eigenschaften aus. Wählen Sie für die Option Konfigurations-Container den Konfigurationscontainer aus, der die Cloud-Konfiguration enthält, die AEM Forms mit der Turnstile verbindet, und wählen Sie Speichern und schließen aus.

    Wenn Sie über keinen solchen Konfigurations-Container verfügen, finden Sie im Abschnitt Verbinden Ihrer AEM Forms-Umgebung mit Turnstile Informationen zum Erstellen eines Konfigurations-Containers.

    Auswählen eines Konfigurations-Containers

  4. Wählen Sie ein adaptives Formular und danach Bearbeiten aus. Das adaptive Formular wird im Editor für adaptive Formulare geöffnet.

  5. Ziehen Sie die Komponente Turnstile des adaptiven Formulars aus dem Komponenten-Browser in das adaptive Formular oder fügen Sie sie hinzu.

  6. Wählen Sie die Komponente Turnstile des adaptiven Formulars aus und klicken Sie auf das Symbol "Eigenschaften" Symbol Eigenschaften . Dadurch wird das Dialogfeld „Eigenschaften“ geöffnet. Geben Sie die folgenden Eigenschaften an:

    Turnstile v2

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

    • Titel: Geben Sie den Titel für Ihre Captcha-Komponente an.

    • Konfigurationseinstellungen: Wählen Sie eine Cloud-Konfiguration für die Turnstile aus.

    • Validierungsmeldung: Stellen Sie eine Validierungsmeldung für die Validierung von Captcha bei Formularübermittlung bereit.

    • Skript-Validierungsmeldung: Mit dieser Option können Sie eine Meldung eingeben, die angezeigt wird, wenn die Skriptvalidierung fehlschlägt.

      note note
      NOTE
      Sie können für einen ähnlichen Zweck mehrere Cloud-Konfigurationen in Ihrer Umgebung haben. Wählen Sie den Dienst daher sorgfältig aus. Wenn kein Dienst aufgelistet ist, finden Sie unter Verbinden Ihrer AEM Forms-Umgebung mit Turnstile Informationen zum Erstellen eines Cloud Service, der Ihre AEM Forms-Umgebung mit dem Turnstile-Dienst verbindet.

      * **Fehlermeldung:** Geben Sie die Fehlermeldung an, die dem Benutzer angezeigt werden soll, wenn die Captcha-Übermittlung fehlschlägt.

  7. Wählen Sie Fertig.

Jetzt sind nur legitime Formulare für die Formularübermittlung zulässig, bei denen der Benutzer die vom Turnstile-Dienst ausgehende Herausforderung erfolgreich löscht.

Turnstile-Herausforderung

Häufig gestellte Fragen

  • Q: Kann ich mehrere Captcha-Komponenten in einem adaptiven Formular verwenden?
  • s: Die Verwendung von mehr als einer Captcha-Komponente in einem adaptiven Formular wird nicht unterstützt. Es wird außerdem nicht empfohlen, eine Captcha-Komponente in einem Fragment oder in einem Bereich zu verwenden, der für verzögertes Laden markiert ist.

Siehe auch see-also

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