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

AEM Forms 環境と Turnstile の接続 connect-your-forms-environment-with-turnstile-service

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

適用対象：
Experience Manager as a Cloud Service

作成対象：

User
Developer

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

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

AEM Forms 環境と Turnstile Captcha の統合

Cloudflare の Turnstile Captcha は、自動ボット、悪意のある攻撃、スパム、不要な自動トラフィックからフォームとサイトを保護することを目的としたセキュリティ対策です。フォームの送信を許可する前に、フォームの送信時にユーザーが人間であることを確認するチェックボックスが表示されます。 AEM Forms as a Cloud Serviceは、アダプティブ Forms コアコンポーネントのTurnstile Captchaをサポートしています。

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

AEM Forms コアコンポーネント用にTurnstileを設定するには、Turnstile web サイトからTurnstile サイトキーと秘密鍵を取得する必要があります。

Turnstile の設定 steps-to-configure-hcaptcha

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

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

Cloud Service を設定：

AEM オーサーインスタンスで、 > Cloud Servicesに移動し、Turnstileをクリックします。
前の節で説明したように、作成または更新した設定コンテナを選択します。「作成」を選択します。
ウィジェットタイプを管理対象、非インタラクティブまたは非表示として指定します。ウィジェットタイプについて詳しくは、ターンスタイルウィジェットをご覧ください。
前提条件🔗で取得したターンスタイルサービスに対して、タイトル、名前、サイトキーおよび 秘密鍵 を指定します。
「作成」をクリックします。

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

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

アダプティブフォームでの Turnstile の使用 using-turnstile-core-components

AEM Forms as a Cloud Service インスタンスを開きます。
Forms／フォームとドキュメントに移動します。
アダプティブフォームを選択し、プロパティをクリックします。 Configuration Container セクションで、AEM FormsとTurnstileを接続するCloud Configurationを含むConfiguration Containerを選択します。
「保存して閉じる」をクリックします。

設定コンテナがない場合は、設定コンテナの作成方法については、「Turnstileの設定」を参照してください。
アダプティブフォームを選択し、編集をクリックしてフォームをエディターで開きます。
コンポーネントブラウザーから、アダプティブフォームのターンスタイル コンポーネントをアダプティブフォームにドラッグ&ドロップまたは追加します。

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

回転式v2

名前: Captcha コンポーネントの名前を指定すると、フォームとルールエディターの両方で、一意の名前を使用してフォームコンポーネントを簡単に識別できます。
タイトル： Captcha コンポーネントのタイトルを指定します。タイトルにリッチテキストを許可したり、チェックボックスをオンにしてタイトルを非表示にしたりできます。

構成設定: Turnstile Captcha サービス用に設定されたクラウド設定を選択します。

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

検証: エラーメッセージの形式でCaptcha検証を提供します。

エラーメッセージ： Captchaの送信が失敗したときにユーザーに表示するエラーメッセージを指定します。

note
NOTE
CAPTCHAがクライアント側で入力された場合にのみ、エラーメッセージが表示されます。

「完了」をクリックします。

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

Turnstile の課題

よくある質問

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