DokumentationAEM as a Cloud ServiceBenutzerhandbuch

[AEM Forms]{class="badge positive" title="Gilt für AEM Forms)."}

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

Last update: Thu Mar 12 2026 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 Adaptive Forms. 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.

Schritte zum Konfigurieren von hCAPTCHA® steps-to-configure-hcaptcha

  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 Option Cloud-Konfigurationen dafür aktivieren oder die Option Cloud-Konfigurationen für einen vorhandenen Ordner aktivieren:

      • So erstellen Sie einen Ordner und aktivieren die Option Cloud-Konfigurationen:

        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. Wählen Sie Erstellen aus.

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

NOTE
Benutzende müssen die Clientseitige JavaScript-Validierungs-URL ​ die Server-seitige Validierungs-URL nicht ändern, da sie bereits für die hCAPTCHA®-Validierung vorausgefüllt sind. Für einige Länder können die Endpunkte unterschiedlich sein. Weitere Informationen finden Sie in hCaptcha® ​ FAQs).

Sobald der CAPTCHA-Dienst konfiguriert ist, kann er in einem adaptiven Formular verwendet werden.

Verwenden von hCaptcha® in einem adaptiven Formular{#using-hCaptcha®-foundation-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 die Captcha-Komponente im Komponenten-Browser in das adaptive Formular und legen Sie sie dort ab.

  6. Wählen Sie die CAPTCHA-Komponente aus und klicken Sie auf das Symbol Eigenschaften . Dadurch wird das Dialogfeld „Eigenschaften“ geöffnet.

    Alt-Text

    Geben Sie die folgenden Eigenschaften an:

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

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

    • CAPTCHA validieren: Sie können eine der Optionen zum Validieren von CAPTCHA auswählen:

      • Bei Formularübermittlung
      • Bei einer Benutzeraktion.

    • CAPTCHA-: Wählen Sie Ihren CAPTCHA-Service aus, hier wählen Sie den hCAPTCHA®-Service aus.

    • CAPTCHA-: Wählen Sie eine Cloud-Konfiguration aus, die für hCAPTCHA® konfiguriert ist.

      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.

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

    • CAPTCHA-Größe Sie wählen die Anzeigegröße des Dialogfelds „hCAPTCHA®-Herausforderung“ aus. Verwenden Sie die Compact-Option zum Anzeigen einer kleinen Größe und die Normal-Option zum Anzeigen eines relativ großen hCAPTCHA®-Dialogfelds oder Unsichtbar zum Überprüfen von hCAPTCHA®, ohne das Kontrollkästchen-Widget auf der Benutzeroberfläche explizit zu rendern.

  7. Wählen Sie Fertig aus.

Jetzt sind nur legitime Formulare zur Übermittlung zulässig, bei denen die Person, die das Formular ausfüllt, die vom hCaptcha®-Service ausgehende Herausforderung erfolgreich löst.

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