Cómo Usar BotDetect ASP.NET CAPTCHA en Visual Studio 2008

Esta guía muestra como usar BotDetect ASP.NET CAPTCHA en un nuevo proyecto de ASP.NET 2.0 con Visual Studio 2008.

Paso 1. Crear un nuevo sitio web ASP.NET 2.0

• Arrancar Visual Studio 2008

• Seleccione el lugar del proyecto, nombre y lenguaje de programación utilizado

[arriba]

Paso 2. Agregar una referencia de BotDetect al proyecto

• En el Solutions Explorer (explorador de soluciones), haga click-derecho en el proyect del Sitio Web, y escoja "Add Reference" (Agregar Referencia)"

• Navegue al archivo Lanap.BotDetect.dll localizado en la carpeta de instalación de BotDetect CAPTCHA

• La referencia es agregada a la carpeta Bin del proyecto

[arriba]

Step 3. Configure your site to use BotDetect CAPTCHA

En el Solutions Explorer (explorador de soluciones), abra su archivo web.config del proyecto:

• En la sección <system.Web>, agregue las siguientes lineas a la sección <httpHandlers>:

<add verb="*" path="LanapCaptcha.aspx" 
  type="Lanap.BotDetect.CaptchaHandler, Lanap.BotDetect" />

Eso registra el HttpHandler usado para dibujar las imágenes Captcha y los sonidos Captcha.

• También en el archivo web.config, agregue la siguiente delcaración a la sección <system.Web> (después del elemento <httpHandlers>, por ejemplo):

<sessionState mode="InProc" cookieless="AutoDetect" 
  timeout="20" sessionIDManagerType="
    Lanap.BotDetect.Persistence.CustomSessionIDManager, 
    Lanap.BotDetect" />

Si ya tiene una declaración <sessionState>, modifíquela para que incluya el atributo sessionIDManagerType. Esta es una solución requerida para que el audio CAPTCHA trabaje correctamente para usuarios de IE 7.0 Vista y Google Chrome, así como es explicado en Preguntas Frecuentes de BotDetect ASP.NET CAPTCHA.

• También, en la sección <system.webServer> , añada también el registro del HttpHandler a <handlers>:

<remove name="LanapCaptchaHandler" />
<add name="LanapCaptchaHandler" 
  preCondition="integratedMode" verb="*" 
  path="LanapCaptcha.aspx" 
  type="Lanap.BotDetect.CaptchaHandler, Lanap.BotDetect" />

Esto es necesario para que BotDetect Captcha trabaje correctamente en servidores IIS 7.0 corriendo en modo "Integrado" (Integrated Mode).

[arriba]

Paso 4. Agregue BotDetect CAPTCHA a la Toolbox (Barra de Herramientas) de Visual Studio para referencias futuras.

• Clic-derecho en cualquier parte de la Barra de Herramientas y seleccione "Choose Items" (Seleccione Elementos)

• Una vez más, navegue al archivo Lanap.BotDetect.dll localizado en la carpeta de instalación de BotDetect CAPTCHA

[arriba]

Paso 5. Agregue el control BotDetect CAPTCHA a alguna página

• Arrastre el recientemente creado control Captcha desde la Barra de Herramientas a la página Default.aspx

• Guarde todos los archivos, luego compile y corra el proyecto. Verá una imagen CAPTCHA renderizada en su formulario web.

[arriba]

Paso 6. Agregue la lógica de validación de entrada de usuario

• Agregue un TextBox (Cuadro de Texto), un Button(Botón), y una Label (Etiqueta) de control de servidor a la página

• Renombre los controles y configure el diseño de la página - el fragmento de archivo .aspx debería verse así:

  <div>
    <BotDetect:Captcha ID="SampleCaptcha" runat="server" />
  </div>
  <div>
    <asp:TextBox ID="CodeTextBox" runat="server"></asp:TextBox>
    <asp:Button ID="ValidateButton" runat="server" Text="Validate" />
    <asp:Label ID="MessageLabel" runat="server"></asp:Label>
  </div>

• Agregue el siguiente código al manejador Page_Load en el código detrás de la página:

  protected void Page_Load(object sender, EventArgs e)
  {
    if (IsPostBack)
    {
      string code = CodeTextBox.Text.Trim().ToUpper();
  	
      if (SampleCaptcha.Validate(code))
      {
        MessageLabel.Text = "Correct";
      }
      else
      {
        MessageLabel.Text = "Incorrect";
      }
  
      CodeTextBox.Text = null;
    }
  }

• Guarde todos los archivos, luego compile y corra el proyecto. Entonces puede probar la validación CAPTCHA en acción

• En sitios web de producción cambiará regularmente el código de validación para redirigir al usuario al recurso solicitado si esque la validación CAPTCHA es lograda

[arriba]

Ejemplo del código fuente de un proyecto BotDetect CAPTCHA

Puede encontrar el código fuente completo similar al resultado que obtendrá cuando siga estas instrucciones en el ejemplo de proyecto que viene con la instalación de BotDetect CAPTCHA.

[arriba]