Añadir la protección de BotDetect CAPTCHA usando ASP

Esta página muestra todo los pasos necesarios para proteger sus formularios ASP con Lanapsoft BotDetect ASP CAPTCHA.

• LanapBotDetectHandler.asp
• Renderizando una imagen CAPTCHA
• Usando un CAPTCHA de audio
• Cargando nuevamente la imagen CAPTCHA
• Validando el ingreso del usuario
• Proyectos de ejemplo de ASP CAPTCHA

LanapBotDetectHandler.asp

La instalación de Lanapsoft BotDetect ASP CAPTCHA incluye el archivo LanapBotDetectHandler.asp, este archivo ASP puede ayudarle fácilmente a incorporar nuestra tecnología a sus páginas.

Este archivo utiliza el control BotDetect CAPTCHA COM para crear imágenes CAPTCHA aleatorias, cada vez que se dibuja la página. Usted puede usar este archivo tal como se entrega, sin modificaciones ni cambios, para sus proyectos.

¡Siempre use el método POST!

El código PHP que invoca a LanapBotDetectHandler.asp debe estar dentro de un formuladio <form> que utilice el método POST.

[arriba]

Renderizando una imagen CAPTCHA

La forma más simple de mostrar la imagen CAPTCHA (usando los parámetros por defecto) en su página php es definiendo un objeto <img> así:

<img src="LanapBotDetectHandler.asp?Command=CreateImage" 
  alt="CAPTCHA image" id="CaptchaImage" />
    

Si usted tiene BotDetect instalado y ha copiado el archivo LanapBotDetectHandler.asp en la misma carpeta de su formulario, la imagen resultante deberá ser similar a la siguiente:

Configurando parámetros adicionales de la imagen CAPTCHA

Si usted quiere configurar parámetros adicionales (como por ejemplo el tamaño, tipo, entre otros) sólo debe especificar esto en la cadena de solicitud de la imagen. Por ejemplo:

<img src="LanapBotDetectHandler.asp?Command=CreateImage&
  TextStyle=28&ImageWidth=300&imageHeight=40&CodeLength=7&
  CodeType=1&Format=PNG" alt="CAPTCHA image" id="CaptchaImage" />

La imagen resultante tendrá un aspecto similar al siguiente:

Todos los otros parámetros (aparte de ?Command=CreateImage) son opcionales, y si uno de ellos no es proporcionado, se utilizará un valor por defecto.

Por ejemplo, el parámetro TextStyle especifica que algoritmo será usado para generar el dibujo del CAPTCHA (uno de los 50 algoritmos incluídos en BotDetect CAPTCHA). Puede encontrar una lista de todos los valores válidos, ejemplos y capturas de pantalla en la página de referencia de TextStyle.

Para más información sobre todos los parámetros disponibles, vea la documentación de Componentes de Interfaz de BotDetect.

[arriba]

Usando un CAPTCHA de audio

Si desea utilizar un sonido para mejorar la accesibilidad de su CAPTCHA, la forma más simple de hacerlo es así:

<a href="LanapBotDetectHandler.asp?Command=CreateSound">
  <img src="speaker.gif" alt="Play Sound" style="border:0;" />
</a>
    

Una imagen de un altavoz aparecerá que al hacerle clic ejecutará un sonido que representa el texto del CAPTCHA. Puede también utilizar un enlace de texto (como "Reproducir sonido") o incluso otra imagen si así lo desea.

Usando JavaScript para ejecutar el audio del CAPTCHA

El último ejemplo del uso del audio no es muy elegante- abre el sonido con las letras o números del CAPTCHA directamente, preguntándole al usuario si desea abrir o guardar el archivo de sonido.

Sería mucho mejor que el sonido se reproduciera automáticamente como sonido de fondo al hacer clic sobre el altavoz, siempre y cuando el navegador del usuario lo soporte. Veamos el siguiente código:

<a href="LanapBotDetectHandler.asp?Command=CreateSound" 
  onclick="LBD_LoadSound('soundPlaceholder', 
    'LanapBotDetectHandler.asp?Command=CreateSound'); 
    return false;">
  <img src="speaker.gif" alt="Play sound" style="border:0;" />
</a>
<div id="soundPlaceholder" style="visibility:hidden; border:0; 
  width:0; height:0;"></div>
    

El ejemplo utiliza BotDetectScript.js, un código Javascript que carga automáticamente el sonido del CAPTCHA a la página, y lo reproduce en segundo plano (los archivos .wav se abren generalmente en Windows Media Player sobre IE, o con QuickTime para Firefox, Opera o Safari).

El mismo script funcionará para clientes con navegadores que no soporten Javascript, comportándose como en el primer caso en donde el usuario debe descargar el archivo, así es fácil abarcar el máximo de audiencia.

El archivo BotDetectScript.js también puede encontrarse en la carpeta de ejemplos de BotDetect ASP CAPTCHA, y puede copiarlo a la carpeta de su proyecto de la misma forma que sucede con el archivo LanapBotDetectHandler.asp. Puede aprender más aún leyendo el código de estos ficheros.

[arriba]

Cargando nuevamente la imagen CAPTCHA

Si desea incorporar un botón para cargar nuevamente la imagen del CAPTCHA, el código JavaScript incluído en BotDetectScript.js contiene un método para hacerlo. La función LBD_ReloadImage function usa un identificador, para cargar nuevamente el elemento <img>:

<a href='#' onclick='LBD_ReloadImage("CaptchaImage"); return false;' 
  title="Change the code">
    <img src="reload.gif" alt="Cambiar el código" />
</a>

[arriba]

Validando el ingreso del usuario

En un escenario típico de uso, el usuario tendrá un código en una imagen CAPTCHA que deberá escribir en un cuadro de texto. Luego de recibir y comprobar el código, podremos decir si la validación es correcta o no. El método Validate del componente BotDetect CAPTCHA compara el código codificado (hash) con el código correspondiente.

<%
Dim result, codeKey, inputCode
result = False
codeKey = "LanapBotDetectCode"
'TODO: read it from the submitted text box value
inputCode = Request("CaptchaCode")

If (Session(codeKey)<>"") Then
  code = Session(codeKey)
  result = (0 = StrComp(inputCode, code, 1))
  'each Captcha code can only be validated once
  Session(codeKey) = ""
End If

If result = True Then
  'TODO: the user entered the correct value
  Response.Redirect ("CORRECT_INPUT_PAGE.ASP")
Else
  'TODO: the user entered an invalid value
  Response.Redirect ("INCORRECT_INPUT_PAGE.ASP")
End If
%>

[arriba]

Proyectos de ejemplo de ASP CAPTCHA

Puede encontrar una serie de proyectos de ejemplo utilizando BotDetect CAPTCHA en proyectos ASP de ejemplo, el cual se incluye con la instalación del componente. Además de poder copiar los archivos que usted necesita (LanapBotDetectHandler.asp, BotDetectScript.js, speaker.gif, reload.gif), usted también puede estudiar el código fuente con la finalidad de aprender o utilizar ese código para sus páginas.

[arriba]