Uso de CAPTCHA en formularios adaptables

CAPTCHA (prueba de Turing pública completamente automatizada para distinguir entre ordenadores y humanos) es un programa que se utiliza comúnmente en transacciones en línea para distinguir entre humanos y programas o bots automatizados. Plantea un desafío y evalúa la respuesta del usuario para determinar si es un humano o un bot que interactúa con el sitio. Evita que el usuario siga adelante si la prueba falla y ayuda a que las transacciones en línea sean seguras al impedir que los bots publiquen contenido no deseado o con fines malintencionados.

AEM Forms admite CAPTCHA en formularios adaptables. Google puede usar el servicio reCAPTCHA para implementar CAPTCHA.

Configurar el servicio ReCAPTCHA de Google

Los autores de formularios pueden utilizar el servicio reCAPTCHA de Google para implementar CAPTCHA en formularios adaptables. Ofrece funciones CAPTCHA avanzadas para proteger su sitio. Para obtener más información sobre cómo funciona reCAPTCHA, consulte Google reCAPTCHA.

Para implementar el servicio reCAPTCHA en AEM Forms:

1. Obtenga par de claves de API reCAPTCHA de Google. Incluye una clave de sitio y un secreto.

2. Cree un contenedor de configuración para Cloud Services.

   1. Vaya a Tools > General > Configuration Browser.

      • Consulte la documentación Configuration Browser para obtener más información.

   2. Haga lo siguiente para habilitar la carpeta global para configuraciones de nube o omita este paso para crear y configurar otra carpeta para configuraciones de servicios de nube.

      1. En el Explorador de configuración, seleccione la carpeta global y pulse Propiedades.

      2. En el cuadro de diálogo Propiedades de configuración, habilite Configuraciones de nube.

      3. Pulse Guardar y cerrar para guardar la configuración y salir del cuadro de diálogo.

   3. En el Explorador de configuración, pulse Crear.

   4. En el cuadro de diálogo Crear configuración, especifique un título para la carpeta y habilite Configuraciones de nube.

   5. Toque Crear para crear la carpeta habilitada para las configuraciones del servicio en la nube.

3. Configure el servicio en la nube para reCAPTCHA.

   1. En la instancia de autor de AEM, vaya a > Cloud Services.
   2. Toque reCAPTCHA. Se abre la página Configuraciones. Seleccione el contenedor de configuración creado en el paso anterior y pulse Crear.
   3. Especifique Nombre, Clave del sitio y Clave secreta para el servicio reCAPTCHA y pulse Crear para crear la configuración del servicio en la nube.
   4. En el cuadro de diálogo Editar componente , especifique el sitio y las claves secretas obtenidas en el paso 1. Pulse Guardar configuración y, a continuación, pulse Aceptar para completar la configuración.

   Una vez configurado el servicio reCAPTCHA, está disponible para su uso en formularios adaptables. Para obtener más información, consulte Uso de CAPTCHA en formularios adaptables.

Utilizar CAPTCHA en formularios adaptables

Para utilizar CAPTCHA en formularios adaptables:

1. Abra un formulario adaptable en modo de edición.

   NOTA

   Asegúrese de que el contenedor de configuración seleccionado al crear el formulario adaptable contiene el servicio en la nube reCAPTCHA. También puede editar las propiedades del formulario adaptable para cambiar el contenedor de configuración asociado al formulario.

2. Desde el navegador de componentes, arrastre y suelte el componente Captcha en el formulario adaptable.

   NOTA

   No se admite el uso de más de un componente Captcha en un formulario adaptable. Además, no se recomienda utilizar CAPTCHA en un panel marcado para la carga diferida o en un fragmento.

   NOTA

   Captcha distingue entre tiempo y caduca en aproximadamente un minuto. Por lo tanto, se recomienda colocar el componente Captcha justo antes del botón Enviar en el formulario adaptable.

3. Seleccione el componente Captcha que ha agregado y pulse para editar sus propiedades.

4. Especifique un título para el widget CAPTCHA. El valor predeterminado es Captcha. Seleccione Ocultar título si no desea que aparezca el título.

5. En la lista desplegable Captcha service, seleccione reCaptcha para habilitar el servicio reCAPTCHA si lo configuró como se describe en el servicio ReCAPTCHA de Google. Seleccione una configuración en la lista desplegable Configuración . Además, seleccione el tamaño como Normal o Compacto para el widget reCAPTCHA.

   NOTA

   No seleccione Default en la lista desplegable del servicio Captcha porque el servicio AEM CAPTCHA predeterminado está obsoleto.

6. Guarde las propiedades.

El servicio reCAPTCHA está habilitado en el formulario adaptable. Puede obtener una vista previa del formulario y ver cómo funciona CAPTCHA.

Mostrar u ocultar el componente CAPTCHA basado en reglas

Puede seleccionar mostrar u ocultar el componente CAPTCHA en función de las reglas que aplique en un componente de un formulario adaptable. Pulse el componente, seleccione y pulse Crear para crear una regla. Para obtener más información sobre la creación de reglas, consulte Editor de reglas.

Por ejemplo, el componente CAPTCHA debe mostrarse en un formulario adaptable solo si el campo Valor de moneda del formulario tiene un valor superior a 25000.

Pulse el campo Currency Value del formulario y cree las siguientes reglas:

Validar CAPTCHA

Puede validar CAPTCHA en un formulario adaptable al enviar el formulario o basar la validación CAPTCHA en las acciones y condiciones del usuario.

Validación de CAPTCHA en el envío de formulario

Para validar un CAPTCHA automáticamente al enviar un formulario adaptable:

1. Pulse el componente CAPTCHA y seleccione para ver las propiedades del componente.
2. En la sección Validar CAPTCHA, seleccione Validar CAPTCHA al enviar el formulario.
3. Toque para guardar las propiedades del componente.

Validar CAPTCHA en acciones y condiciones del usuario

Para validar un CAPTCHA basado en condiciones y acciones del usuario:

1. Pulse el componente CAPTCHA y seleccione para ver las propiedades del componente.
2. En la sección Validar CAPTCHA, seleccione Validar CAPTCHA en una acción del usuario.
3. Toque para guardar las propiedades del componente.

Experience Manager Forms proporciona ValidateCAPTCHA API para validar CAPTCHA mediante condiciones predefinidas. Puede invocar la API utilizando una acción de envío personalizada o definiendo reglas sobre los componentes de un formulario adaptable.

El siguiente es un ejemplo de API ValidateCAPTCHA para validar CAPTCHA con condiciones predefinidas:

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;
        }
    }

El ejemplo significa que la API ValidateCAPTCHA valida el CAPTCHA en el formulario solo si el número de dígitos en el cuadro numérico especificado por el usuario mientras rellena el formulario es bueno a 5.

Opción 1: Utilice la API Experience Manager Forms ValidateCAPTCHA para validar CAPTCHA mediante una acción de envío personalizada

Realice los siguientes pasos para utilizar la API ValidateCAPTCHA para validar CAPTCHA mediante una acción de envío personalizada:

1. Agregue la secuencia de comandos que incluye la API ValidateCAPTCHA a la acción de envío personalizada. Para obtener más información sobre las acciones de envío personalizadas, consulte Crear una acción de envío personalizada para Forms adaptable.
2. Seleccione el nombre de la acción de envío personalizada en la lista desplegable Acción de envío de las propiedades Envío de un formulario adaptable.
3. Toque Enviar. El CAPTCHA se valida en función de las condiciones definidas en la API ValidateCAPTCHA de la acción de envío personalizada.

Opción 2: Utilice la API Experience Manager Forms ValidateCAPTCHA para validar CAPTCHA en una acción del usuario antes de enviar el formulario

También puede invocar la API ValidateCAPTCHA aplicando reglas en un componente en un formulario adaptable.

Por ejemplo, se agrega un botón Validar CAPTCHA en un formulario adaptable y se crea una regla para invocar un servicio al hacer clic en un botón.

La siguiente ilustración ilustra cómo puede invocar un servicio al hacer clic en un botón Validar CAPTCHA:

Puede invocar el servlet personalizado que incluye la API ValidateCAPTCHA mediante el editor de reglas y habilitar o deshabilitar el botón de envío del formulario adaptable en función del resultado de validación.

Del mismo modo, puede utilizar el editor de reglas para incluir un método personalizado para validar CAPTCHA en un formulario adaptable.

Agregar servicios personalizados de CAPTCHA

Experience Manager Forms proporciona reCAPTCHA como servicio CAPTCHA. Sin embargo, puede agregar un servicio personalizado para que se muestre en la lista desplegable Servicio CAPTCHA.

A continuación se muestra un ejemplo de implementación de la interfaz para agregar un servicio CAPTCHA adicional al formulario adaptable:

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 hace referencia a la ruta de recurso del componente CAPTCHA en el repositorio de Sling. Utilice esta propiedad para incluir detalles específicos del componente CAPTCHA. Por ejemplo, captchaPropertyNodePath incluye información para la configuración de nube reCAPTCHA configurada en el componente CAPTCHA. La información de configuración de la nube proporciona las configuraciones Clave del sitio y Clave secreta para implementar el servicio reCAPTCHA.

userResponseToken hace referencia a g_recaptcha_response que se genera después de resolver un CAPTCHA en un formulario.