Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
En esta sección se incluyen instrucciones para utilizar la API de integración de CAPTCHA.
La JavaScript API de CAPTCHA le permite configurar el rompecabezas de CAPTCHA y colocarlo donde desee en su aplicación cliente. Esta API aprovecha las características de la amenaza inteligente JavaScript APIs para adquirir y utilizar los AWS WAF tokens una vez que el usuario final haya completado satisfactoriamente un rompecabezas de CAPTCHA.
Implemente la JavaScript integración primero en un entorno de prueba y, después, en producción. Para obtener más información sobre la guía de codificación, consulta las secciones siguientes.
Uso de la API de integración de CAPTCHA
Instalación de la API
Inicie sesión en AWS Management Console y abra la AWS WAF consola en https://console.aws.amazon.com/wafv2/
. -
En el panel de navegación, elija Integración de la aplicación. En la página Integración de aplicaciones, puede ver las opciones agrupadas en pestañas.
Seleccione la Integración de CAPTCHA.
Copie la etiqueta del script de JavaScript integración que aparece en la lista para utilizarla en la integración.
En el código de la página de la aplicación, en la sección
<head>, inserte la etiqueta de script que copió. Esta inclusión hace que el rompecabezas de CAPTCHA esté disponible para su configuración y uso.<head> <script type="text/javascript" src="integrationURL/jsapi.js" defer></script> </head>Esta lista de
<script>está configurada con el atributodefer, pero puede cambiarlo por otroasyncsi desea un comportamiento diferente para su página.El script de CAPTCHA también carga automáticamente el script de integración de amenazas inteligentes si aún no está presente. El script de integración de amenazas inteligentes hace que la aplicación cliente recupere automáticamente un token en segundo plano al cargar la página y proporciona otras funciones de administración de tokens que necesita para usar la API de CAPTCHA.
-
(Opcional) Agregue una configuración de dominio para los tokens del cliente: de forma predeterminada, cuando AWS WAF crea un token, utiliza el dominio host del recurso que está asociado a la ACL web. Para proporcionar dominios adicionales para la JavaScript APIs, sigue las instrucciones que aparecen enSuministro de dominios para su uso en los tokens.
Obtenga la clave de API cifrada del cliente: la API de CAPTCHA requiere una clave de API cifrada que contenga una lista de dominios de cliente válidos. AWS WAF usa esta clave para comprobar que el dominio de cliente que utilizas con la integración está aprobado para usar AWS WAF CAPTCHA. Para generar su clave de API, siga las instrucciones que se indican en Administración de las claves de API para la API de JS CAPTCHA.
-
Codifique la implementación del widget de CAPTCHA: implemente la llamada a la API
renderCaptcha()en su página, en la ubicación en la que quiera usarla. Para obtener información acerca de cómo configurar y usar esta función, consulte las siguientes secciones, Especificación de la API CAPTCHA JavaScript y Cómo renderizar el rompecabezas de CAPTCHA.La implementación del CAPTCHA se integra con la integración inteligente de amenazas APIs para gestionar los tokens y ejecutar llamadas de búsqueda que utilizan los tokens. AWS WAF Para obtener orientación sobre su uso, consulte. APIs Uso de la JavaScript API de amenazas inteligentes
Agregue la verificación mediante token a su ACL web: añada al menos una regla a su ACL web que compruebe si hay un token de CAPTCHA válido en las solicitudes web que envíe su cliente. Puede utilizar el CAPTCHA acción de regla para comprobar, tal y como se describe enCAPTCHA y Challenge en AWS WAF.
Las incorporaciones de las ACL web comprueban que las solicitudes que van a sus puntos de conexión protegidos incluyen el token que adquirió en la integración con el cliente. Las solicitudes que incluyen un token CAPTCHA válido y vigente pasan el CAPTCHA reglamente la acción inspeccionada y no presente al usuario final otro acertijo de CAPTCHA.
Una vez que hayas implementado la JavaScript API, puedes revisar las CloudWatch métricas de los intentos y las soluciones de los acertijos de CAPTCHA. Para obtener información acerca de las métricas y las dimensiones, consulte Métricas y dimensiones de la cuenta.
Temas
