...
Los parámetros requeridos en la solicitud solicitud de validación son:
- Secret (site secret key)
- Response (token)
...
La respuesta, siempre contiene una propiedad “success”, ya sea verdadera o falsa, indicando si la operación fue exitosa o no (Es la que utilizamos para comprobar que el token es válido)
La documentación de cloudflare turnstile está disponible en javascript modular, pero para implementarlo en java nosotros utilizamos la librería Jersey. Los pasos básicos a seguir son:
Configuración del cliente HTTP:
- Se crea una instancia de
ClientConfigpara configurar el cliente HTTP. - Se habilita el mapeo POJO para JSON en la configuración.
- Se crea una instancia de
Creación del cliente HTTP:
- Se instancia un objeto
Clientutilizando la configuración previamente definida.
- Se instancia un objeto
Creación del recurso web:
- Se crea un objeto
WebResourceapuntando a la URL proporcionada en${turnstile.url}.
- Se crea un objeto
Preparación de la solicitud:
- Se crea un objeto
CaptchaRequestque contiene los datos necesarios para la validación del token de captcha. - El token recibido como parámetro se establece en el objeto
CaptchaRequest. - Se proporciona un secreto en el objeto
CaptchaRequestobtenido de${TURNSTILE_SECRET_KEY}.
- Se crea un objeto
Realización de la solicitud HTTP POST:
- Se envía una solicitud HTTP POST al servicio web utilizando el objeto
webResource. - Se configura la solicitud para enviar y recibir datos en formato JSON.
- Se envía una solicitud HTTP POST al servicio web utilizando el objeto
Si la respuesta no es nula y todo ha ido bien (200 OK), entonces obtenemos se deserializa el cuerpo de la respuesta JSON en un objeto CaptchaResponse y devolvemos la propiedad success.
...