Verwenden von Google reCAPTCHA in einem adaptiven AEM-Formular, das auf Kernkomponenten basiert using-reCAPTCHA-in-adaptive-forms

Erstellen oder wählen Sie ein Google Cloud-Projekt und aktivieren Sie reCAPTCHA Enterprise API.

Beziehen Sie die Projekt-ID und erstellen Sie einen API-Schlüssel und einen Site-Schlüssel für Websites.

Erstellen Sie einen Konfigurations-Container für Cloud Services.

1. Wählen Sie Tools > Allgemein > Konfigurationsbrowser.

2. Wählen Sie einen Ordner aus oder erstellen Sie einen Ordner und aktivieren Sie ihn für Cloud-Konfigurationen, indem Sie folgende Schritte ausführen:

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

Konfigurieren Sie den Cloud Service für reCAPTCHA Enterprise.

1. Gehen Sie in der Experience Manager-Autoreninstanz zu > Cloud Services.
2. Wählen Sie reCAPTCHA aus. Die Konfigurationsseite öffnet sich. Wählen Sie den erstellten Konfigurations-Container aus und wählen Sie dann Erstellen.
3. Wählen Sie die Version als reCAPTCHA Enterprise und geben Sie den Namen, die Projekt-ID, den Site-Schlüssel und den API-Schlüssel (erhalten in Schritt 2) für den reCAPTCHA-Enterprise-Dienst an.
4. Wählen Sie den Schlüsseltyp aus. Der Schlüsseltyp sollte mit dem im Google Cloud-Projekt konfigurierten Site-Schlüssel übereinstimmen, z. B. Checkbox-Site-Schlüssel oder Bewertungsbasierter Site-Schlüssel.
5. Geben Sie einen Schwellenwert im Bereich von 0 bis 1 an. Werte, die größer oder gleich den Schwellenwerten sind, kennzeichnen menschliche Interaktionen, ansonsten wird von einer Bot-Interaktion ausgegangen.
6. Wählen Sie Erstellen aus, um die Cloud-Service-Konfiguration zu erstellen.

Rufen Sie ein reCAPTCHA-API-Schlüsselpaar von Google ab. Er enthält einen Site-Schlüssel und einen geheimen Schlüssel.

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 zum Verbinden Ihrer AEM Forms-Umgebung mit dem reCAPTCHA-Dienst von Google:

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

2. Wählen Sie „Tools“ > „Allgemein“ > „Konfigurations-Browser“. Im Konfigurations-Browser haben Sie folgende Möglichkeiten:

3. Wählen Sie einen vorhandenen Ordner aus oder erstellen Sie einen Ordner. 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 Titel an 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.

Konfigurieren des Cloud-Service:

1. Navigieren Sie in Ihrer AEM-Autoreninstanz zu > Cloud-Services und wählen Sie reCAPTCHA.
2. Wählen Sie einen Konfigurations-Container aus, der im vorherigen Abschnitt erstellt oder aktualisiert wurde. Wählen Sie Erstellen aus.
3. Geben Sie Titel, Namen, Site-Schlüssel und den geheimen Schlüssel für den reCAPTCHA-Dienst (abgerufen in Schritt 1) an. Wählen Sie Erstellen aus.

Sobald der reCAPTCHA-Dienst konfiguriert ist, kann er in adaptiven Formularen verwendet werden. Weitere Informationen finden Sie unter Verwenden von Google reCAPTCHA in einem adaptiven Formular.

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

Gehen Sie zu Formulare > Formulare und Dokumente.

Wählen Sie ein adaptives Formular aus und wählen Sie Eigenschaften. Wählen Sie für die Option Konfigurations-Container den Konfigurations-Container aus, der die Cloud-Konfiguration enthält, die AEM Forms mit dem reCAPTCHA-Dienst von Google verbindet, und wählen Sie Speichern und schließen.

Wenn Sie über keinen solchen Konfigurations-Container verfügen, erfahren Sie im Abschnitt Verbinden Ihrer AEM Forms-Umgebung mit dem reCAPTCHA-Dienst von Google, wie Sie einen solchen Konfigurations-Container erstellen.

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

Ziehen Sie im Komponenten-Browser die Komponente reCAPTCHA für adaptive Formulare per Drag-and-Drop auf das adaptive Formular.

Wählen Sie die Komponente reCAPTCHA für adaptive Formulare aus und wählen Sie dann das Symbol „Eigenschaften“ . Dadurch wird das Dialogfeld „Eigenschaften“ geöffnet. Geben Sie die folgenden obligatorischen Eigenschaften an:

• Name: Sie können sowohl im Formular als auch im Regeleditor eine Formularkomponente leicht mit ihrem eindeutigen Namen identifizieren. Der Name darf jedoch keine Leerzeichen oder Sonderzeichen enthalten.

• Titel: Geben Sie einen Titel für das CAPTCHA-Widget an. Der Standardwert ist CAPTCHA. Wählen Sie Titel ausblenden aus, wenn der Titel nicht angezeigt werden soll. Wählen Sie Rich-Text für Titel zulassen aus, um den Titel im Rich-Text-Format zu bearbeiten. Sie können Ihren Titel auch als ungebundenes Formularelement markieren.

• CAPTCHA-Konfiguration: Wählen Sie eine Konfiguration aus der Dropdownliste "Einstellungen"für reCAPTCHA Enterprise oder reCAPTCHA v2 aus, um das Google-Dialogfeld "reCAPTCHA"für das Formular anzuzeigen:

  1. Wenn Sie die Version reCAPTCHA Enterprise auswählen, kann der Schlüsseltyp Kontrollkästchen oder punktebasiert sein. Er basiert auf Ihrer Auswahl bei der Konfiguration des Site-Schlüssels für Websites:

     note note
     NOTE
     In der Cloud-Konfiguration mit Schlüsseltyp als Kontrollkästchen erscheint die angepasste Fehlermeldung als Inline-Meldung, wenn die Captcha-Validierung fehlschlägt. In der Cloud-Konfiguration mit Schlüsseltyp als punktebasiert wird die benutzerdefinierte Fehlermeldung als Popup-Meldung angezeigt, wenn die Captcha-Validierung fehlschlägt.

     1. Sie können zwischen den Größen **Normal** und **Kompakt** wählen.

  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 Dienst daher sorgfältig aus. Wenn kein Dienst aufgeführt ist, lesen Sie Verbinden Ihrer AEM Forms-Umgebung mit dem reCAPTCHA-Dienst von Google, um zu erfahren, wie Sie einen Cloud Service erstellen, der Ihre AEM Forms-Umgebung mit dem reCAPTCHA-Dienst von Google verbindet.

• Captcha-Größe: Sie können die Anzeigegröße des Dialogfelds für die Google reCAPTCHA-Herausforderung auswählen. Verwenden Sie die Option Kompakt , um eine kleine Größe anzuzeigen, und die Option Normal , um ein Dialogfeld mit einer relativ großen Google-reCAPTCHA-Herausforderung anzuzeigen.
  Wenn Sie die Version reCAPTCHA v2 wählen:

  1. Sie können die Größe als Normal oder Kompakt für das reCAPTCHA-Widget auswählen.
  2. Sie können die Option Unsichtbar wählen, um die CAPTCHA-Abfrage nur im Falle einer verdächtigen Aktivität anzuzeigen.

Der reCAPTCHA-Dienst wird im adaptiven Formular aktiviert. Sie können das Formular in der Vorschau anzeigen und die CAPTCHA-Funktionsweise sehen. Das unten abgebildete Abzeichen mit reCAPTCHA geschützt wird auf den geschützten Formularen angezeigt.

Wählen Sie Fertig.

Jetzt wird geschützt durch reCAPTCHA in Ihrem adaptiven Formular angezeigt. Dies wird in allen adaptiven Formularen angezeigt, die für die Verwendung des Google reCAPTCHA-Dienstes konfiguriert sind.

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