在自适应Forms中使用CAPTCHA

CAPTCHA(Completely Automated Public Turing test to tell Computers and Humans Apart)是一种在线交易中常用的程序，用于区分人类和自动程序或机器人。 它会给用户带来挑战并评估用户响应，以确定它是人还是机器人与站点进行交互。 它可阻止用户在测试失败时继续操作，并通过防止机器人发布垃圾邮件或恶意目的，帮助确保在线交易的安全。

AEM Forms 支持自适应Forms中的CAPTCHA。 您可以使用Google提供的reCAPTCHA服务来实施CAPTCHA。

注意
  • AEM Forms 仅支持reCaptcha v2。 不支持任何其他版本。
  • 自适应Forms中的验证码，在 AEM Forms 应用程序。

通过Google配置ReCAPTCHA服务

表单作者可以使用Google提供的reCAPTCHA服务在自适应Forms中实施CAPTCHA。 它提供高级验证码功能以保护您的网站。 有关reCAPTCHA工作原理的更多信息，请参阅 Google reCAPTCHA.

Recaptcha

在 AEM Forms:

  1. 获取 reCAPTCHA API密钥对 从Google。 它包括站点密钥和密钥。

  2. 为云服务创建配置容器。

    1. 转到 工具>常规>配置浏览器.

    2. 执行以下操作可为云配置启用全局文件夹，或跳过此步骤以为云服务配置创建和配置其他文件夹。

      1. 在配置浏览器中，选择 全球 文件夹，然后点按 属性.

      2. 在配置属性对话框中，启用 云配置.

      3. 点按 保存并关闭 保存配置并退出对话框。

    3. 在配置浏览器中，点按 创建.

    4. 在创建配置对话框中，指定文件夹的标题并启用 云配置.

    5. 点按 创建 创建云服务配置启用的文件夹。

  3. 为reCAPTCHA配置云服务。

    1. 在您的Experience Manager创作实例中，转到 tools-1 > Cloud Services.
    2. 点按 reCAPTCHA. 此时将打开“配置”页面。 选择在上一步中创建的配置容器，然后点按 创建.
    3. 为reCAPTCHA服务指定名称、站点密钥和密钥，然后点按 创建 创建云服务配置。
    4. 在编辑组件对话框中，指定在步骤1中获取的站点和密钥。 点按 保存设置 然后点按 确定 以完成配置。

    配置reCAPTCHA服务后，即可在自适应Forms中使用。 有关更多信息，请参阅 在自适应Forms中使用CAPTCHA.

在自适应Forms中使用CAPTCHA

要在自适应Forms中使用CAPTCHA，请执行以下操作：

  1. 在编辑模式下打开自适应表单。

    注意

    确保在创建自适应表单时选择的配置容器包含reCAPTCHA云服务。 您还可以编辑自适应表单属性以更改与表单关联的配置容器。

  2. 在组件浏览器中，拖放 验证码 组件添加到自适应表单。

    注意

    不支持在自适应表单中使用多个验证码组件。 此外，不建议在标记为延迟加载的面板或片段中使用CAPTCHA。

    注意

    验证码对时间敏感，大约一分钟后过期。 因此，建议将Captcha组件放在自适应表单中“提交”按钮之前。

  3. 选择您添加的Captcha组件，然后点按 cppr 以编辑其属性。

  4. 指定CAPTCHA小组件的标题。 默认值为 验证码. 选择 隐藏标题 如果您不希望显示标题，请执行以下操作：

  5. 从 验证码服务 下拉列表，选择 reCaptcha 启用reCAPTCHA服务(如果您按照 ReCAPTCHA服务，由Google提供. 从设置下拉列表中选择配置。

  6. 将类型选择为 正常 或 紧凑 用于reCAPTCHA小组件。 您还可以选择 不可见 仅在可疑活动时显示验证码挑战的选项。 受reCAPTCHA保护的徽章（如下所示）显示在受保护的表单上。

    Google受reCAPTCHA徽章保护

    注意

    不选择 默认 从Captcha服务下拉列表中，弃用默认Experience ManagerCAPTCHA服务。

  7. 保存属性。

reCAPTCHA服务在自适应表单上启用。 您可以预览表单并查看CAPTCHA正常工作。

根据规则显示或隐藏CAPTCHA组件

您可以根据对自适应表单中的组件应用的规则，选择显示或隐藏CAPTCHA组件。 点按组件，选择 编辑规则，然后点按 创建 创建规则。 有关创建规则的更多信息，请参阅 规则编辑器.

例如，仅当表单中的“货币值”字段的值大于25000时，CAPTCHA组件才必须在自适应表单中显示。

点按 货币值 字段，并创建以下规则：

显示或隐藏规则

验证验证码

在提交表单时或根据用户操作和条件对CAPTCHA验证进行基础时，您都可以在自适应表单中验证CAPTCHA。

在提交表单时验证验证码

要在提交自适应表单时自动验证验证码，请执行以下操作：

  1. 点按CAPTCHA组件，然后选择 cppr 查看组件属性。
  2. 在 验证验证验证码 选择 在表单提交时验证验证码.
  3. 点按 完成 以保存组件属性。

验证用户操作和条件的验证验证码

要根据条件和用户操作验证验证验证码，请执行以下操作：

  1. 点按CAPTCHA组件，然后选择 cppr 查看组件属性。
  2. 在 验证验证验证码 选择 在用户操作中验证验证验证码.
  3. 点按 完成 以保存组件属性。

Experience Manager Forms 提供 ValidateCAPTCHA 用于使用预定义条件验证验证验证码的API。 您可以使用自定义提交操作或在自适应表单中定义组件规则来调用API。

以下是 ValidateCAPTCHA 用于使用预定义条件验证CAPTCHA的API:

if (slingRequest.getParameter("numericbox1614079614831").length() >= 5) {
     GuideCaptchaValidatorProvider apiProvider = sling.getService(GuideCaptchaValidatorProvider.class);
        String formPath = slingRequest.getResource().getPath();
        String captchaData = slingRequest.getParameter(GuideConstants.GUIDE_CAPTCHA_DATA);
        if (!apiProvider.validateCAPTCHA(formPath, captchaData).isCaptchaValid()){
            response.setStatus(400);
            return;
        }
    }

此示例表示 ValidateCAPTCHA 仅当用户在填写表单时指定的数字框中的位数大于5时，API才会验证表单中的CAPTCHA。

选项1:使用 Experience Manager Forms 验证CAPTCHA API以使用自定义提交操作验证CAPTCHA

执行以下步骤以使用 ValidateCAPTCHA 使用自定义提交操作验证验证码的API:

  1. 添加包含 ValidateCAPTCHA 用于自定义提交操作的API。 有关自定义提交操作的更多信息，请参阅 为自适应Forms创建自定义提交操作.
  2. 从 提交操作 下拉列表(位于 提交 自适应表单的属性。
  3. 点按 提交. 根据 ValidateCAPTCHA 自定义提交操作的API。

选项2:使用 Experience Manager Forms 在提交表单之前，验证CAPTCHA API以验证用户操作上的CAPTCHA

您还可以调用 ValidateCAPTCHA API，方法是对自适应表单中的组件应用规则。

例如，您添加 验证验证验证码 按钮，并创建规则以在单击按钮时调用服务。

下图说明了在单击 验证验证验证码 按钮：

验证验证码

您可以调用包含的自定义Servlet ValidateCAPTCHA API使用规则编辑器，并根据验证结果启用或禁用自适应表单的提交按钮。

同样，您也可以使用规则编辑器包含自定义方法来验证自适应表单中的CAPTCHA。

添加自定义CAPTCHA服务

Experience Manager Forms 提供reCAPTCHA作为CAPTCHA服务。 但是，您可以添加一个自定义服务，以在 CAPTCHA服务 下拉列表。

以下是界面的实施示例，用于向自适应表单添加其他CAPTCHA服务：

package com.adobe.aemds.guide.service;

import org.osgi.annotation.versioning.ConsumerType;

/**
 * An interface to provide captcha validation at server side in Adaptive Form
 * This interface can be used to provide custom implementation for different captcha services.
 */
@ConsumerType
public interface GuideCaptchaValidator {
    /**
     * This method should define the actual validation logic of the captcha
     * @param captchaPropertyNodePath path to the node with CAPTCHA configurations inside form container
     * @param userResponseToken  The user response token provided by the CAPTCHA from client-side
     *
     * @return  {@link GuideCaptchaValidationResult} validation result of the captcha
     */
     GuideCaptchaValidationResult validateCaptcha(String captchaPropertyNodePath, String userResponseToken);

    /**
     * Returns the name of the captcha validator. This should be unique among the different implementations
     * @return  name of the captcha validator
     */
     String getCaptchaValidatorName();
}

captchaPropertyNodePath 指Sling存储库中CAPTCHA组件的资源路径。 使用此属性可包含特定于CAPTCHA组件的详细信息。 例如， captchaPropertyNodePath 包括有关在CAPTCHA组件上配置的reCAPTCHA云配置的信息。 云配置信息提供 网站密钥 和 密钥 用于实施reCAPTCHA服务的设置。

userResponseToken 是指 g_recaptcha_response 在表单中解析验证码后生成的。

编辑reCAPTCHA服务域

reCAPTCHA服务使用 https://www.recaptcha.net/ 作为默认域。 您可以修改设置 https://www.google.com/ 或用于加载、渲染和验证reCAPTCHA服务的任何自定义域名。

设置 af.cloudservices.recaptcha.domain 属性 自适应表单与交互式通信Web信道配置 配置 https://www.google.com/ 或任何其他自定义域名。 以下JSON文件显示一个示例：

{
  "af.cloudservices.recaptcha.domain": "https://www.google.com/"
}

要设置配置的值，请使用 AEM SDK 生成 OSGi 配置，并向 Cloud Service 实例部署配置。

在此页面上