DokumentationAEM as a Cloud ServiceBenutzerhandbuch

Verbinden Ihrer AEM Forms-Umgebung mit hCaptcha® connect-your-forms-environment-with-hcaptcha-service

Last update: Thu Nov 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Gilt für:
  • Experience Manager as a Cloud Service

Erstellt für:

  • Benutzende
  • Entwickler

Diese Funktion befindet sich im Early-Adopter-Programm. 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 hCAPTCHA

Der hCaptcha®-Dienst schützt Ihre Formulare vor Bots, Spam und automatisiertem Missbrauch. Er führt einen Kontrollkästchen-Widget-Test durch und ermittelt anhand der Benutzerantwort, ob ein Mensch oder ein Bot mit dem Formular interagiert. Dabei wird verhindert, dass Benutzende fortfahren, wenn der Test fehlschlägt. Dies erhöht die Sicherheit von Online-Transaktionen, indem Bots keinen Spam senden oder andere bösartige Aktivitäten durchführen können.

AEM Forms as a Cloud Service unterstützt hCAPTCHA® in adaptiven Forms-Kernkomponenten. Sie können es verwenden, um bei der Formularübermittlung eine Herausforderung mit einem Kontrollkästchen-Widget zu präsentieren.

Voraussetzungen für die Integration der AEM Forms-Umgebung mit hCaptcha® prerequisite

Um hCAPTCHA® mit AEM Forms zu konfigurieren, müssen Sie den hCAPTCHA®-SiteKey und den geheimen Schlüssel von der hCAPTCHA®-Website abrufen.

Konfigurieren von hCaptcha® steps-to-configure-hcaptcha

Um AEM Forms mit dem hCAPTCHA®-Service zu integrieren, führen Sie die folgenden Schritte aus:

  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 hCAPTCHA zu verbinden®:

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

    2. Navigieren Sie zu Tools > Allgemein > Konfigurations-Browser.

    3. Im Konfigurations-Browser 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 an und wählen Sie die Option Cloud-".
        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 der AEM-Autoreninstanz zu tools-1 > Cloud Services und wählen Sie hCaptcha®.
      hCaptcha® in der Benutzeroberfläche

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

    3. Geben Sie Titel, Name, Site-Schlüssel und Geheimer Schlüssel für den hCAPTCHA®-Service erhalten in PREREQUISITE an. Wählen Sie Erstellen aus.

      Konfigurieren des Cloud-Service für die Verbindung Ihrer AEM Forms-Umgebung mit hCaptcha®

    note note
    NOTE
    Benutzende brauchen die Client-seitige JavaScript-Validierungs-URL und die Server-seitige Validierungs-URL nicht zu ändern, da sie bereits für die hCaptcha®-Validierung vorausgefüllt sind.

    Sobald der hCAPTCHA-Service konfiguriert ist, kann er in einem (​ Formular, das auf Kernkomponenten basiert) verwendet ​.

Verwenden von hCAPTCHA® in Kernkomponenten von Adaptive Forms {#using-hCaptcha®-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 Konfigurations-Container den Konfigurations-Container aus, der die Cloud-Konfiguration enthält, die AEM Forms mit hCAPTCHA® verbindet, und wählen Sie Speichern und schließen.

    Wenn Sie keinen solchen Konfigurations-Container haben, erfahren Sie im Abschnitt Verbinden Ihrer AEM Forms-Umgebung mit hCAPTCHA®, wie Sie einen Konfigurations-Container erstellen.

    Auswählen eines Konfigurations-Containers

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

  5. Ziehen Sie im Komponenten-Browser per Drag-and-Drop die Komponente Adaptives Formular hCAPTCHA® auf das adaptive Formular und fügen Sie sie hinzu.

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

    hCaptcha® 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.

    • Konfigurationseinstellungen: Wählen Sie eine für hCaptcha® konfigurierte Cloud-Konfiguration aus.

    • Captcha-Größe: Sie können die Anzeigegröße des hCaptcha®-Challenge-Dialogfelds auswählen. Verwenden Sie die Option Kompakt zur Anzeige eines kleinen und die Option Normal zur Anzeige eines relativ großen Dialogfelds für den hCaptcha®-Test.

    • Validierungsmeldung: Geben Sie bei der Formularübermittlung eine Validierungsmeldung für Ihre CAPTCHA-Validierung ein.

    • Meldung zur Skriptvalidierung: Mit dieser Option können Sie eine Meldung eingeben, die angezeigt werden soll, wenn die Skriptvalidierung fehlschlägt.

      note note
      NOTE
      Es kann sein, dass Sie für ähnliche Zwecke über mehrere Cloud-Konfigurationen in Ihrer Umgebung verfügen. Wählen Sie den Service daher sorgfältig aus. Wenn kein Service aufgeführt ist, lesen Sie unter Verbinden Ihrer AEM Forms-Umgebung mit hCaptcha® nach, wie Sie einen Cloud-Service erstellen, der Ihre AEM Forms-Umgebung mit dem hCaptcha®-Service verbindet.

  7. Wählen Sie Fertig aus.

Jetzt sind nur noch legitime Formulare für die Formularübermittlung zulässig, bei denen der Formularausfüller die vom hCAPTCHA®-Service ausgehende Herausforderung erfolgreich löscht. hCaptcha®

hCaptcha® ist eine eingetragene Marke von Intuition Machines, Inc.

Häufig gestellte Fragen

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

Siehe auch see-also

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