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

Esta página contiene instrucciones paso-a-paso de cómo implementar y usar BotDetect ASP.NET CAPTCHA como un (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 2.0 GAC
• Agregar BotDetect a la lista de las referencias disponibles en Visual Studio 2005
• 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 ensamblado Lanap.BotDetect.dll a .NET 2.0 GAC

Este paso se aplica tanto a sus máquinas de implementación y 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 2.0 Configuration > Manage the Assembly Cache > Add an Assembly to the Assembly Cache (Programas; Herramientas Administrativas; Configuración de Microsoft .NET Framework 2.0; 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 2.0\v2.0\Assembly\Lanap.BotDetect.dll

Método 2: Usando la Linea de Comandos

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

Si tiene instalado el .NET Framework 2.0 SDK, puede simplemente correr el siguiente comando:

"C:\Archivos de programa\Microsoft Visual Studio 8\SDK\v2.0\Bin\
  gacutil.exe" /i "C:\Archivos de programa\Lanapsoft\
  BotDetect 2.0 CAPTCHA\ASP.Net 2.0\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 2005

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

Método 1: El intento recomendado por Microsoft

• Corra regedit.exe
• Diríjase a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\ v2.0.50727\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 2.0\Assembly)

Método 2: El intento "rápido y sucio"

• Copie Lanap.BotDetect.dll a la carpeta %WINDIR%\Microsoft.NET\Framework\v2.0.50727\

[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 2005.

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 una combinación de llaves privada/pública para firmar su ensamblado en Visual Studio 2005

• Click derecho en el nombre del proyecto BotDetect en el Solution Explorer (Explorador de Soluciones) > Properties (Propiedades)> Signing tab (Pestaña de Firmado)> chequear "Sign the assembly" (Firmar el ensamble), seleccione "New..." (Nuevo...) desde el desplegable y siga las siguientes instrucciones
• Luego de firmar el ensamble, puede agregarlo a GAC.
• Puede chequear el token llave público de su ensamble modificado después de satisfactoriamente agregarlo a GAC
• Para cada proyecto ASP.NET que usa esa copia modificada de BotDetect, debe usar el token exacto en la línea de registro HttpHandler de su archivo web.config; por ejemplo cambie 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]