[AEM Forms]{class="badge positive" title="AEM Formsに適用）。"}

AEM Forms 環境と hCaptcha® の接続 connect-your-forms-environment-with-hcaptcha-service

最終更新日： 2026年3月11日

適用対象：
Experience Manager as a Cloud Service

作成対象：

User
Developer

CAPTCHA（コンピュータと人間を区別する完全に自動化された公開チューリングテスト）は、人間と自動化されたプログラム／ボットを区別するために、オンライントランザクションで一般的に使用されるプログラムです。テストを行ってユーザーの反応を評価し、サイトを使用しているのが人間かボットかを判断します。テストが失敗した場合の続行を防ぎ、ボットによるスパムの投稿や悪意のある目的を防止することで、オンライントランザクションの安全性を高めます。

AEM Forms as a Cloud Service は、次の CAPTCHA ソリューションをサポートしています。

AEM Forms環境とCaptcha Captchaの統合

hCaptcha® サービスは、ボット、スパム、自動化された不正使用からフォームを保護します。チェックボックスウィジェットテストを行ってユーザーの反応を評価し、フォームを使用しているのが人間かボットかを判断します。テストが失敗した場合の続行を防ぎ、ボットによるスパムの投稿や悪意のあるアクティビティを防止することで、オンライントランザクションの安全性を高めます。

AEM Forms as a Cloud Serviceは、アダプティブ Forms コアコンポーネントのhCaptcha®をサポートしています。これを使用して、フォームの送信時にチェックボックスウィジェットの課題を提示できます。

AEM Forms 環境を hCaptcha® と統合するための前提条件 prerequisite

AEM FormsでhCaptcha®を設定するには、hCaptcha® web サイトからhCaptcha® サイトキーと秘密鍵を取得する必要があります。

hCaptcha® の設定 steps-to-configure-hcaptcha

AEM Forms を hCaptcha® サービスと統合するには、次の手順を実行します。

AEM Forms as a Cloud Service環境にConfiguration Containerを作成します。設定コンテナには、AEM を外部サービスに接続するために使用されるクラウド設定が格納されます。 AEM Forms環境をhCaptcha®に接続するためのConfiguration Containerを作成および設定するには：
1. AEM Forms as a Cloud Service インスタンスを開きます。
2. ツール／一般／設定ブラウザーに移動します。
3. 設定ブラウザーでは、既存のフォルダーを選択するか、フォルダーを作成できます。フォルダーを作成して、そのフォルダーの「クラウド設定」オプションを有効にしたり、既存のフォルダーの「クラウド設定を有効にする」オプションを有効にしたりできます。
  - フォルダーを作成し、それに対して「クラウド設定」オプションを有効にするには、次の手順を実行します。
    1. 設定ブラウザーで「作成」をタップします。
    2. 設定を作成ダイアログで、名前、タイトルを指定し、クラウド設定 オプションを選択します。
    3. 「作成」をクリックします。
  - 既存のフォルダーに対して「クラウド設定」オプションを有効にするには：
    1. 設定ブラウザーで、フォルダーを選択して「プロパティ」を選択します。
    2. 設定プロパティダイアログで、「クラウド設定」を有効にします。
    3. 「保存して閉じる」を選択して設定内容を保存し、ダイアログを閉じます。

Cloud Service を設定：

AEM オーサーインスタンスで、 > Cloud Servicesに移動し、hCaptcha®を選択します。
前の節で説明したように、作成または更新した設定コンテナを選択します。「作成」を選択します。
前提条件🔗で取得したhCaptcha® サービスに対して、タイトル、名前、サイトキーおよび 秘密鍵 を指定します。「作成」を選択します。

note
NOTE
クライアントサイド JavaScript 検証 URL とサーバーサイド検証 URL は、hCaptcha® 検証用に既に事前入力されているので、ユーザーは変更する必要がありません。

hCAPTCHA サービスを設定すると、コアコンポーネント 🔗に基づいてアダプティブフォームで使用できるようになります。

アダプティブ Forms コアコンポーネントでのCaptcha®の使用 {#using-hCaptcha®-core-components}

AEM Forms as a Cloud Service インスタンスを開きます。
Forms／フォームとドキュメントに移動します。
アダプティブフォームを選択し、プロパティを選択します。 Configuration Container オプションで、AEM FormsとCaptchaを接続するCloud Configurationを含むConfiguration Containerを選択し®Save & Closeを選択します。

このようなConfiguration Containerがない場合は、Configuration Containerの作成方法については、「AEM Forms環境とhCaptcha®の接続」を参照してください。
アダプティブフォームを選択し、編集を選択します。アダプティブフォームエディターでアダプティブフォームが開きます。
コンポーネントブラウザーから、アダプティブフォーム Captcha® コンポーネントをアダプティブフォームにドラッグ&ドロップまたは追加します。

アダプティブフォームのCaptcha® コンポーネントを選択し、プロパティアイコンをクリックします。プロパティダイアログが開きます。次のプロパティを指定します。

hCaptcha® v2

名前: Captcha コンポーネントの名前を指定すると、フォームとルールエディターの両方で、一意の名前を使用してフォームコンポーネントを簡単に識別できます。
タイトル： Captcha コンポーネントのタイトルを指定します。
設定： hCaptcha® 用に設定されたクラウド設定を選択します。
Captcha サイズ： hCaptcha® テストダイアログの表示サイズを選択できます。「コンパクト」オプションを選択すると小さいサイズ、「標準」オプションを選択すると比較的大きなサイズの hCaptcha® テストダイアログを表示できます。
検証メッセージ : フォーム送信時にCaptcha検証の検証メッセージを提供します。

スクリプト検証メッセージ - スクリプトの検証が失敗した場合に表示するメッセージを入力できます。

note
NOTE
同様の目的で、環境内に複数のクラウド設定を作成することができます。そのため、サービスは慎重に選択してください。サービスが表示されない場合は、AEM Forms 環境と hCaptcha® の接続で、AEM Forms 環境と hCaptcha® サービスを接続する Cloud Service を作成する方法を参照してください。

「完了」を選択します。

現在、フォームの入力者は hCaptcha® サービスによって提供される課題を正常にクリアした正規のフォームのみをフォーム送信できます。 hCaptcha®

hCaptcha® は、Intuition Machines, Inc. の登録商標です。

よくある質問

Q：アダプティブフォーム内で複数の Captcha コンポーネントを使用できますか？
A：アダプティブフォームでは、複数の Captcha コンポーネントを使用することはできません。また、遅延読み込みのマークが付けられたフラグメントやパネルで Captcha コンポーネントを使用することはお勧めしません。