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

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

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

• Arrancar Visual Studio 2005

• 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]

Paso 3. Configure su sitio para usar BotDetect CAPTCHA

• En el Solution Explorer, haga click-derecho en el proyecto del Sitio Web, y escoja "Add New Item" (Agregar Nuevo Item)

• Agregue un nuevo archivo de Configuración al proyecto

• Agregue las siguientes líneas a la sección <system.web> del archivo recientemente creado "Web.config":

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

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

• If you want to deploy your project on servers running IIS 7.0 in integrated mode, you will also have to add a <system.webServer> element at the bottom of the <configuration> element, with the following content:

<system.webServer>
  <validation validateIntegratedModeConfiguration="false"/>
  <handlers>
    <remove name="LanapCaptchaHandler" />
    <add name="LanapCaptchaHandler" 
      preCondition="integratedMode" verb="*" 
      path="LanapCaptcha.aspx" 
      type="Lanap.BotDetect.CaptchaHandler, Lanap.BotDetect" />
  </handlers>
</system.webServer>

[arriba]

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

• Click-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" 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]