Cómo Usar BotDetect ASP.NET CAPTCHA desde .NET 1.1 GAC

Esta página contiene instrucciones paso a paso de cómo implementar y usar BotDetect ASP.NET CAPTCHA como un (a nivel de máquina) ensamble globalmente disponible, en lugar de usar una implementación local xcopy para cada carpeta Bin de cada aplicación en individual.

• Agregar el ensamble Lanap.BotDetect.dll al .NET 1.1 GAC
• Agregar BotDetect a la lista de las referencias disponibles en Visual Studio 2003
• Configure su aplicación web ASP.NET para usar BotDetect desde GAC
• (Opcional) Modificaciones del Código Fuente BotDetect e implementación GAC

Paso 1: Agregar el ensamble Lanap.BotDetect.dll a .NET 1.1 GAC

Este pasó se aplica tanto a sus máquinas de implementación como a sus servidores de producción.

Método 1: Manualmente, usando la GUI (Interfaz Gráfica de Usuario) de Windows

Esta opción es simple y adecuada si necesita hacerla en una o un pequeño número de máquinas.

• Desde el menú de inicio, escoja Programas > Administrative Tools > Microsoft .NET Framework 1.1 Configuration > Manage the Assembly Cache > Add an Assembly to the Assembly Cache (Programas; Herramientas Administrativas; Configuración de Microsoft .NET Framework 1.1; Administrar el Caché del Ensamble; Agregar un Ensamble al Caché de Ensamble)
• Navegue a la carpeta de instalación de BotDetect CAPTCHA: < C:\Archivos de Programa\Lanapsoft\BotDetect\ASP.NET 1.1\v2.0\Assembly\Lanap.BotDetect.dl

Método 2: Usando la Linea de Comandos

Esta opción es más adecuada para instalaciones automatizadas, instalaciones en varias máquinas etc.

Corra lo siguiente desde la línea de comandos:

"C:\Windows\Microsoft.NET\Framework\v1.1.4322\gacutil.exe" /i 
  "C:\Archivos de programa\Lanapsoft\BotDetect 2.0 CAPTCHA\ASP.NET 1.1\
  Assembly\Lanap.BotDetect.dll"

(no olvide borrar los saltos de línea extra después de pegar)

[arriba]

Paso 2: Agregar BotDetect a la lista de las referencias disponibles en Visual Studio 2003

Este paso se aplica sólo a sus máquinas de implementación.

Método 1: El método recomendado por Microsoft

• Corra regedit.exe
• Diríjase a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v1.1.4322\AssemblyFoldersEx
• Click derecho en esta entrada y seleccione New Key (Nueva Llave)
• Renómbrelo a Lanapsoft y ajuste sus valores a la ruta de la sub-carpeta Assembly en la carpeta de instalación de BotDetect (C:\Archivos de Programa\Lanapsoft\BotDetect 2.0 CAPTCHA\ASP.Net 1.1\Assembly)

Método 2: El método "rápido & sucio"

• Copie Lanap.BotDetect.dll a la carpeta %WINDIR%\Microsoft.NET\Framework\v1.1.4322\

 

[arriba]

Paso 3: Configure su aplicación web ASP.NET para que use BotDetect desde GAC

Este paso se aplica sólo para sus máquinas de implementación.

Agregando una referencia BotDetect a su proyecto

Si ha completado el Paso 2, simplemente puede seleccionar Lanap.BotDetect.dll de la lista de ensambles disponibles en la pestaña ".NET" del diálogo "Add Reference" (Agregar Referencia) en Visual Studio 2003.

Registración de HttpHandler

Cambie el manejador de registros en el archivo web.config de su aplicación desde

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

a

<add verb="*" path="LanapCaptcha.aspx" 
  type="Lanap.BotDetect.CaptchaHandler, Lanap.BotDetect, 
  Version=2.0.15.0, Culture=neutral, 
  PublicKeyToken=74616036388b765f"/> 

Puede implementar el(los) archivo(s) web.config al servidor para propagar los cambios.

Nota

Si utiliza una versión diferente de Lanap.BotDetect.dll, debe especificar el número de versión exacto en esta declaración. Y si tiene una Licencia Edición Desarrollador y ha modificado el código fuente del componente, debería firmar primero el ensamble, como se explica más abajo.

[arriba]

Modificaciones del código fuente de BotDetect e implementación GAC

(Sólo para edición de desarrollador)

Diferencias de versiones no-modificadas de BotDetect

• Solo builds oficiales Lanapsoft de BotDetect ASP.NET CAPTCHA usan la combinación de clave pública/privada oficial de Lanapsoft
• Todas las versiones modificadas del código fuente usan un par de llaves diferentes, y de esta manera tienen un valor distinto de PublicKeyToken, cual debe usarlo en el archivo web.config en lugar del que lleva por defecto
• El código fuente distribuido con la Edición de Desarrollador viene sin un archivo llave, y no produce un ensamble firmado por defecto
• Si quiere poner su versión modificada de BotDetect ASP.NET CAPTCHA en GAC, primero debe firmar el ensamble, usando un archivo de llave distinto de usted.

Usando su par de llaves privada/pública único para el firmado del ensamble en Visual Studio 2003

• Arranque la utilidad sn.exe(localizada en c:\Archivos de Programa\Microsoft Visual Studio .NET 2003\SDK\v1.1\Bin\sn.exe) para generar un archivo .key – llamado, para propósitos de este ejemplo, custom.key
• Copie ese archivo a la carpeta del código fuente BotDetect CAPTCHA .NET 1.1, y use Visual Studio 2003 para agregarlo a la solución (a la raíz del proyecto BotDetect)
• Para firmar automáticamente el ensamble para cada build, agregue la siguiente línea al archivo AssemblyInfo.cs en la solución:

  [assembly: AssemblyKeyFile("..\\..\\custom.key")]

• Después de firmar el ensamble, puede añadirlo a GAC.
• Puede chequear el token de la llave pública del ensamble modificado luego de añadirlo satisfactoriamente al GAC
• Para cada proyecto ASP.NET que use esa copia modificada de BotDetect, tiene que usar el token exacto en la línea de registración HttpHandler de su archivo web.config; por ejemplo cambiar la línea

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

a

<add verb="*" path="LanapCaptcha.aspx" 
 type="Lanap.BotDetect.CaptchaHandler, Lanap.BotDetect, 
 Version=VERSION_GOES_HERE, Culture=neutral, 
 PublicKeyToken=TOKEN_GOES_HERE"/> 

[arriba]