Hướng dẫn sử dụng BotDetect ASP.NET CAPTCHA từ .NET 2.0 GAC

Trang này hướng dẫn từng bước cách triển khai và sử dụng dll của BotDetect ASP.NET CAPTCHA ở dạng toàn cục (mức độ toàn hệ thống), thay vì phải dùng xcopy để copy dll vào từng thư mục Bin của từng ứng dụng.

• Thêm Lanap.BotDetect.dll vào .NET 2.0 GAC
• Thêm BotDetect vào danh sách các tham khảo có sẵn trong Visual Studio 2005
• Cấu hình ứng dụng web ASP.NET của bạn để sử dụng BotDetect từ GAC
• (Tuỳ chọn) Thay đổi mã nguồn BotDetect và triển khai GAC

Bước 1: Thêm Lanap.BotDetect.dll vào .NET 2.0 GAC

Bước này áp dụng cho cả máy lập trình và máy chủ.

Phương pháp 1: Bằng tay, sử dụng giao diện Windows

Lựa chọn này đơn giản và phù hợp nếu bạn muốn thực hiện trên một hoặc vài máy.

• Từ Start Menu, chọn Programs > Administrative Tools > Microsoft .NET Framework 2.0 Configuration > Manage the Assembly Cache > thêm một Assembly vào Assembly Cache
• Tìm đến thư mục cài đặt BotDetect CAPTCHA: C:\Program Files\Lanapsoft\BotDetect\ASP.NET 2.0\v2.0\Assembly\Lanap.BotDetect.dll

Phương pháp 2: Sử dụng dòng lệnh

Lựa chọn này phù hợp hơn cho việc cài đặt tự động, cài đặt trên nhiều máy...

Nếu bạn đã cài .NET Framework 2.0 SDK, bạn có thể chạy lệnh sau đây:

"C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\Bin\
  gacutil.exe" /i "C:\Program Files\Lanapsoft\
  BotDetect 2.0 CAPTCHA\ASP.Net 2.0\Assembly\Lanap.BotDetect.dll"

( nhớ xoá ký tự xuống dòng sau khi bạn copy )

[lên đầu trang]

Bước 2: Thêm BotDetect vào danh sách các tham khảo có sẵn trong Visual Studio 2005

Bước này chỉ áp dụng cho các máy lập trình.

Phương pháp 1: Phương pháp được Microsoft khuyên dùng

• Chạy regedit.exe
• Tìm tới HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\ v2.0.50727\AssemblyFoldersEx
• Click phải vào mục này rồi chọn New Key
• Đặt tên là Lanapsoft và giá trị là đường dẫn tới thư mục con Assembly trong thư mục cài đặt BotDetect ( C:\Program Files\Lanapsoft\BotDetect 2.0 CAPTCHA\ASP.Net 2.0\Assembly )

Phương pháp 2: Phương pháp "nhanh"

• Copy file Lanap.BotDetect.dll vào thư mục %WINDIR%\Microsoft.NET\Framework\v2.0.50727\

[lên đầu trang]

Bước 3: Cấu hình ứng dụng ASP.NET của bạn để sử dụng BotDetect từ GAC

Bước này chỉ áp dụng cho các máy lập trình.

Thêm tham khảo BotDetect vào dự án của bạn

Nếu bạn hoàn thành bước 2, bạn chỉ cần chọn Lanap.BotDetect.dll từ danh sách các assembly sẵn có trong tab ".NET" của hộp thoại "Add Reference" trong Visual Studio 2005.

Đăng ký HttpHandler

Thay đổi phần đăng ký BotDetect Captcha trong file web.config từ

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

thành

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

Sau đó bạn có thể triển khai file web.config đã được thay đổi lên máy chủ.

Chú ý

Nếu bạn dùng phiên bản khác của Lanap.BotDetect.dll, bạn phải xác định một số nhất định cho phiên bản trong phần khai báo này. Và nếu bạn có Bản quyền phiên bản lập trình viên và đã thay đổi mã nguồn, đầu tiên bạn phải đăng ký assembly, như giải thích dưới đây.

[lên đầu trang]

Thay đổi mã nguồn của BotDetect và triển khai GAC

(Chỉ cho phiên bản lập trình viên)

Sự khác nhau từ các phiên bản đã được thay đổi của BotDetect

• Chỉ phiên bản được chính thức biên dịch bởi Lanapsoft của BotDetect ASP.NET CAPTCHA sử dụng sử dụng cặp khoá công cộng/riêng tư chính thức
• Mọi phiên bản sửa đổi của mã nguồn sử dụng cặp khoá khác, và vì vậy có giá trị PublicKeyToken, mà bạn phải dùng trong file web.config thay vì mặc định
• Mã nguồn được gửi với Phiên bản lập trình viên có thể không có file khoá, và mặc định thì không sinh ra assembly đã được đóng dấu
• Nếu bạn muốn để phiên bản BotDetect ASP.NET CAPTCHA đã thay đổi trong GAC, đầu tiên bạn phải ký tên cho assembly, sử dụng file key của riêng bạn.

Sử dụng cặp khoá private/public để đăng ký assembly trong Visual Studio 2005

• Click phải vào tên dự án của BotDetect trong Solution Explorer > Properties > Signing tab > chọn "Sign the assembly", chọn "New..." từ menu và làm theo hướng dẫn
• Sau khi đăng ký assembly, bạn có thể thêm nó vào GAC.
• Bạn có thể kiểm tra khoá công cộng đã thay đổi sau khi thêm nó vào GAC thành công
• Mỗi dự án ASP.NET sử dụng bản sao đã thay đổi của BotDetect, bạn phải sử dụng đúng khoá đó trong file web.config ở dòng đăng ký HttpHandler; ví dụ thay đổi dòng

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

thành

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

[lên đầu trang]