ReCaptcha-ASP.NET-MVC

KO | EN

gitlite — search

#python #hacktoberfest #llm #go #android #deep-learning #macos #nodejs #windows #kubernetes #vue #security #mcp #openai

ReCaptcha-ASP.NET-MVC

(★ 16)

ReCaptcha ASP.NET MVC version 2.0 wrapper

ReCaptcha-ASP.NET-MVC 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

ReCaptcha-ASP.NET-MVC [![Twitter](https://img.shields.io/twitter/url/https/github.com/wildcard/ReCaptcha-ASP.NET-MVC.svg?style=social)](https://twitter.com/intent/tweet?text=Wow%20exactly%20what%20I%20was%20looking%20for!:&url=https://github.com/wildcard/ReCaptcha-ASP.NET-MVC)
=====================

[![Join the chat at https://gitter.im/wildcard/ReCaptcha-ASP.NET-MVC](https://badges.gitter.im/wildcard/ReCaptcha-ASP.NET-MVC.svg)](https://gitter.im/wildcard/ReCaptcha-ASP.NET-MVC?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![NuGet Status](https://img.shields.io/nuget/dt/reCaptcha.AspNet.Mvc.svg)](https://www.nuget.org/packages/reCaptcha.AspNet.Mvc)
[![NuGet Version](https://img.shields.io/nuget/v/reCaptcha.AspNet.Mvc.svg)](https://www.nuget.org/packages/reCaptcha.AspNet.Mvc)

ReCaptcha ASP.NET MVC latest version wrapper

https://www.google.com/recaptcha

# Install via Nuget

```
Install-Package reCaptcha.AspNet.Mvc
```

# Simple usage

### 1) Get Google reCAPTCHA at https://www.google.com/recaptcha

### 2) Add Site key and Secret key to your Web.config

```xml
<add key="ReCaptcha:SiteKey" value="your-site-key" />
<add key="ReCaptcha:SecretKey" value="your-secret-key" />
```

### 3) Add server-side integration to your back-end

> Add `using reCaptcha;` to the top of your C# file [see MSDN](https://msdn.microsoft.com/en-us/library/sf0df423.aspx)

```c#
public class AccountsController : Controller
{
    [HttpGet]
    public ActionResult Register()
    {
        ViewBag.Recaptcha = ReCaptcha.GetHtml(ConfigurationManager.AppSettings["ReCaptcha:SiteKey"]);
        ViewBag.publicKey = ConfigurationManager.AppSettings["ReCaptcha:SiteKey"];
        return View();
    }

[HttpPost]
    [ValidateAntiForgeryToken]
    public ActionResult Register(RegisterMerchantViewModel request)
    {
        try
        {
            if (ModelState.IsValid && ReCaptcha.Validate(ConfigurationManager.AppSettings["ReCaptcha:SecretKey"]))
            {
                // Do what you need

return View("RegisterConfirmation");
            }

ViewBag.RecaptchaLastErrors = ReCaptcha.GetLastErrors(this.HttpContext);
            
            ViewBag.publicKey = ConfigurationManager.AppSettings["ReCaptcha:SiteKey"];

return View(request);
        }
        catch (Exception)
        {
            return new HttpStatusCodeResult(HttpStatusCode.InternalServerError);
        }
    }
}
```

### 4) Add client-side integration to your front-end

> Before you can use the Helper you should declare using it.
  By add `@using reCaptcha` to the top of your Razor file. [See Link](http://stackoverflow.com/questions/3239006/how-do-i-import-a-namespace-in-razor-view-page) [#14](https://github.com/wildcard/ReCaptcha-ASP.NET-MVC/issues/14)

*if you need multiple instance on one page please skip to next header*

Add the following code to your ``Views/Merchants/Register.cshtml``:

```c#
@ReCaptcha.GetHtml(@ViewBag.publicKey)
            
@if (ViewBag.RecaptchaLastErrors != null)
{
    <div>Oops! Invalid reCAPTCHA =(</div>
}
```

#### Add client-side integration to your front-end for explicit use or multiple instance
introduced in `1.2.3` requested in [#11](https://github.com/wildcard/ReCaptcha-ASP.NET-MVC/issues/11)

```c#
@ReCaptcha.GetExplictHtml("example1", @ViewBag.publicKey)

@ReCaptcha.GetExplictHtml("example2", @ViewBag.publicKey)

@ReCaptcha.GetExplictScript()
            
@if (ViewBag.RecaptchaLastErrors != null)
{
    <div>Oops! Invalid reCAPTCHA =(</div>
}
```

## Done!

## Usage

### `@ReCaptcha.GetHtml(...)`

Let's talk more about the most basic way to get started:

``` razor
@ReCaptcha.GetHtml("site-key")
```

#### Arguments

The synopsis for the `@ReCaptcha.GetHtml` function is:

``` razor
@ReCaptcha.GetHtml(publicKey, [theme], [type], [callback], [lang])
```

##### ReCaptcha Parameter [reCaptcha doc](https://developers.google.com/recaptcha/docs/display)

key | value | default | description
----|-------|---------|------------
`publicKey` | | | Your sitekey.
`theme` | dark/light | light | Optional. The color theme of the widget.
`type` | audio/image | image | Optional. The type of CAPTCHA to serve.
`callback` |  |  | Optional. Your callback function that's executed when the user submits a successful CAPTCHA response. The user's response, g-recaptcha-response, will be the input for your callback function.
`lang` | See [language codes](https://developers.google.com/recaptcha/docs/language) | | Optional. Forces the widget to render in a specific language. Auto-detects the user's language if unspecified.

### `@ReCaptcha.GetExplictHtml(...)`

For enabling multi captcha in one page. please check the example for [Explicit rendering for multiple widgets](https://developers.google.com/recaptcha/docs/display?hl=en#example)

simple use

``` razor
@ReCaptcha.GetExplictHtml("id","site-key")
```

#### Arguments

The synopsis for the `@ReCaptcha.GetExplictHtml` function is:

``` razor
@ReCaptcha.GetExplictHtml(id, publicKey, [widgetRenderCallsArr], [theme], [type], [callback])
```

##### ReCaptcha Parameter [reCaptcha doc](https://developers.google.com/recaptcha/docs/display)

key | value | default | description
----|-------|---------|------------
`id`  | | | the recaptcha widget id. __required__ uniquely identifies the recaptcha widget
`publicKey` | | | Your sitekey.
`widgetRenderCallsArr` | | __recaptcha_widgetRenderCallsArr | js variable name for recaptcha render calls.
`theme` | dark/light | light | Optional. The color theme of the widget.
`type` | audio/image | image | Optional. The type of CAPTCHA to serve.
`callback` |  |  | Optional. Your callback function that's executed when the user submits a successful CAPTCHA response. The user's response, g-recaptcha-response, will be the input for your callback function.

### `@ReCaptcha. GetExplictScript([lang], [load], [widgetRenderCallsArr])`

``` razor
@ReCaptcha.GetExplictScript()
```

#### Arguments

The synopsis for the `@ReCaptcha.GetExplictScript` function is:

``` razor
@ReCaptcha.GetExplictScript([lang], [load], [widgetRenderCallsArr])
```

##### ReCaptcha Parameter

key | value | default | description
----|-------|---------|------------
`lang` | See [language codes](https://developers.google.com/recaptcha/docs/language) | | Optional. Forces the widget to render in a specific language. Auto-detects the user's language if unspecified.
`load`  | | __recaptcha_onloadCallback | js variable name for recaptcha on load explicit call.
`widgetRenderCallsArr` | | __recaptcha_widgetRenderCallsArr | js variable name for recaptcha render calls.

### `@ReCaptcha.Validate(privateKey)`

see [recaptcha doc](https://developers.google.com/recaptcha/docs/verify)

returns true for valid response from user, false otherwise.

##### ReCaptcha Parameter

privateKey 'Secret key' is Required. The shared key between your site and ReCAPTCHA.

### `@ReCaptcha.GetLastErrors(HttpContextBase context)`

see [recaptcha doc](https://developers.google.com/recaptcha/docs/verify#error-code-reference)

returns a `IEnumerable<reCaptcha.ErrorCodes>`. 
if returns null the no errors occurred.

##### ReCaptcha Parameter

context is your HttpContenxt e.g. `this.HttpContext`

ReCaptcha-ASP.NET-MVC

ReCaptcha-ASP.NET-MVC 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ReCaptcha-ASP.NET-MVC

ReCaptcha-ASP.NET-MVC 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README