Comment on page
🤖
Captcha
A continuación, te explicaremos como utilizar Captcha con Forms para maximizar la seguridad e integridad de tu cuenta.
Por motivos de seguridad, no es posible quitar Captcha.
Este SDK permite que puedas añadir una validación captcha (Completely Automated Public Turing test to tell Computers and Humans Apart) única de forma sencilla sin importar el proveedor disponible.
Estamos trabajando para ofrecer más integraciones con proveedores que ofrezcan captcha invisibles.
- hCaptcha
- Google reCaptcha Enterprise
- Cloudflare Turnstile
Para utilizar Forms SDK podrás instarlo mediante nuestro CDN.
HTML
Javascript
<script src="https://cdn.videsk.io/sdk/captcha.min.js"></script>
const script = document.createElement('script');
script.src = 'https://cdn.videsk.io/sdk/captcha.min.js';
document.body.appendChild(script);
const captcha = new CaptchaSDK(providerName, options);
El segundo argumento de Captcha es un object de opciones, el cual debe contener:
resource
: URL del recurso JS del proveedor captchanode
: id DOM comostring
sin query, es decir,#myButton
debe sermyButton
.
Definir la opción
node
solo aplica para proveedores: hCaptcha.La opción
node
utiliza document.getElementById(node)
, por lo tanto NO puedes utilizar selectores CSS.Podrás encontrar un ejemplo funcional junto a nuestro Phone SDK.
Ya instanciado el SDK podrás acceder a los siguientes métodos:
Este método tiene como objetivo que definas un oyente cuando un evento ocurra. Los dos argumentos que recibe son:
event
: nombre del eventocallback
: función que se ejecutará al ocurrir el evento
captcha.on('token', callback);
Este método ejecuta la activación del captcha, el cual podría ser visible o invisible. Esto último dependerá del proveedor.
captcha.exec();
Este método permite eliminar el nodo captcha generado.
captcha.remove();
Como buena práctica utiliza este método al momento en que la validación captcha se complete exitosamente.
Los eventos disponibles son
token
, close
, error
.Este evento se dispara una vez que se ha completado la validación de forma exitosa. El único argumento es un
token
.captcha.on('token', token => {
doSomething();
})
Este token es un valor generado automáticamente que utilizamos para validar la autenticidad del usuario.
Este evento se dispara solo si el proveedor captcha es visible y se ha cerrado/ocultado la interfaz de validación. No hay argumentos.
captcha.on('close', () => {});
Este evento se dispara cuando existe un error en la validación, el cual no necesariamente debe estar relacionado con la validación robot-humano.
captcha.on('error', (error) => {
doSomething();
});
const captcha = new CaptchaSDK('hcaptcha', {
siteKey: '...',
resource: '...',
node: 'myButton'
});
captcha.on('token', token => sendMyForm(token));
myButton.addEventListener('click', () => captcha.exec());
Última actualización 1yr ago