Using a CAPTCHA Client Extension
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

CAPTCHA YAML 設定リファレンス

CAPTCHA クライアント拡張機能は、 client-extension.yaml ファイルで定義できます。

使用法の詳細

この client-extnesion.yaml ファイルは CAPTCHA クライアント拡張を定義します。

liferay-recaptcha-etc-spring-boot:
    captchaName: reCAPTCHA CX
    captchaResponseParameterName: g-recaptcha-response
    customElementExternalReferenceCode: LXC:liferay-recaptcha-custom-element
    name: Liferay reCAPTCHA Etc Spring Boot
    oAuth2ApplicationExternalReferenceCode: liferay-recaptcha-etc-spring-boot-oauth-application-user-agent
    resourcePath: /validation
    type: captcha

必須の g-recaptcha-response プロパティは、ユーザーの CAPTCHA 応答で応答パラメータを定義します。 この値の名前は、CAPTCHA チャレンジを発行するプロバイダーまたはエンジンによって異なります。 このパラメータは、ユーザーの応答を受信し、プロバイダーで検証するために必要です。

resourcePath プロパティは、CAPTCHA エンジンまたはプロバイダーを使用してユーザー応答の検証を処理する REST コントローラーの場所を定義します。 外部アプリケーションとしてアクセス可能な REST コントローラーの実装 (Java Spring Boot アプリケーションなど) をポイントします。

CAPTCHA クライアント拡張機能では、Liferay のオブジェクトアクションによってトリガーされるリクエストを保護するために、OAuth2 アプリケーション プロファイルが必要です。 client-extension.yaml は、このプロファイルの追加の OAuth ユーザー エージェント クライアント拡張 を定義し、 oAuth2ApplicationExternalReferenceCode プロパティはそのクライアント拡張のキー値を参照します。

CAPTCHA クライアント拡張機能では、フロントエンドを処理するために カスタム要素クライアント拡張機能 も必要であり、通常は外部コンポーネントと統合されます。 customElementExternalReferenceCode プロパティは、そのクライアント拡張機能のキー値を参照します。

YAML プロパティ

これらのプロパティは CAPTCHA クライアント拡張に固有のものです。

名前データ型説明
captchaName文字列(必須) インスタンス設定メニューに表示される CAPTCHA エンジンの名前。
captchaResponseParameterName文字列(必須) ユーザーの CAPTCHA 応答を含むパラメータ名 (プロバイダーによる検証に使用)。
customElementExternalReferenceCode文字列(必須) フロントエンドでユーザーに CAPTCHA チャレンジを発行するために必要な、カスタム要素クライアント拡張機能の外部参照コード。
oAuth2ApplicationExternalReferenceCode文字列(必須) リクエストを保護するために必要な、OAuth2アプリケーションプロファイルの外部参照コード。
resourcePath文字列(必須) ユーザーの CAPTCHA 応答を処理する外部アプリケーションのアクセス可能なエンドポイント。