중요: reCAPTCHA API 버전 1.0은 더 이상 지원되지 않습니다. 버전 2.0으로 업그레이드하세요. 자세히 알아보기
reCAPTCHA ASP.NET 라이브러리를 사용하면 ASP.NET 웹사이트에 보안문자를 간단하게 입력하여 봇의 악용을 방지할 수 있습니다. 라이브러리는 reCAPTCHA API를 래핑합니다. C# 및 Visual Basic .NET을 비롯한 모든 .NET 언어의 라이브러리를 사용할 수 있습니다.
ASP.NET에서 reCAPTCHA를 사용하려면 reCAPTCHA ASP.NET 라이브러리를 다운로드하면 됩니다.
빠른 시작
API 키를 등록한 후 ASP.NET으로 사이트에 reCAPTCHA를 설치하기 위한 기본 안내는 다음과 같습니다.
- 라이브러리의 참조를 library/bin/Release/Recaptcha.dll에 추가합니다. Visual Studio 웹사이트 메뉴에서 '참조 추가'를 선택한 다음 대화상자에서 .NET 탭을 클릭합니다. .NET 구성요소 목록에서 Recaptcha .dll 구성요소를 선택한 후 OK를 클릭합니다. 구성요소가 표시되지 않으면 찾아보기 탭을 클릭하고 하드 드라이브에서 어셈블리 파일을 찾습니다.
- 다음 코드 스니펫을 추가하여 보호하려는 양식에 reCAPTCHA 컨트롤을 삽입합니다.
aspx 페이지 상단에 다음을 삽입하세요.
<%@ Register TagPrefix="recaptcha" Namespace="Recaptcha" Assembly="Recaptcha" %>
그런 다음 <form runat="server"> 태그 내부에 reCAPTCHA 컨트롤을 삽입합니다.
<recaptcha:RecaptchaControl ID="recaptcha" runat="server" PublicKey="your_public_key" PrivateKey="your_private_key" />
공개 키와 비공개 키를 각각 공개 키와 비공개 키로 대체해야 합니다.
- ASP.NET 유효성 검사를 사용하여 양식의 유효성을 검사해야 합니다 (제출 시 Page.IsValid를 확인해야 함).
다음은 Visual Basic을 사용하는 reCAPTCHA를 사용한 'Hello World'입니다. C# 샘플은 라이브러리 다운로드에 포함되어 있습니다.
<%@ Page Language="VB" %> <%@ Register TagPrefix="recaptcha" Namespace="Recaptcha" Assembly="Recaptcha" %> <script runat=server%gt; Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs) If Page.IsValid Then lblResult.Text = "You Got It!" lblResult.ForeColor = Drawing.Color.Green Else lblResult.Text = "Incorrect" lblResult.ForeColor = Drawing.Color.Red End If End Sub </script> <html> <body> <form runat="server"> <asp:Label Visible=false ID="lblResult" runat="server" /> <recaptcha:RecaptchaControl ID="recaptcha" runat="server" Theme="red" PublicKey="your_public_key" PrivateKey="your_private_key" /> <asp:Button ID="btnSubmit" runat="server" Text="Submit" OnClick="btnSubmit_Click" /> </form> </body> </html>