Google ReCAPTCHA v2/v3 Library for .NET 6 and above
Get Started
$ dotnet add package AspNetCore.ReCaptchaReadme
AspNetCore.ReCaptcha
ReCAPTCHA Library for .NET Core 3.1 and .NET 5.0/6.0.
Requirements
This package requires a secret key as well as a site key provided by ReCaptcha. You can aquire your keyset at https://www.google.com/recaptcha/intro/v3.html. It's possible to use either v2 or v3 ReCaptcha.
Installation
You can install this package using NuGet. You can use the following command:
# Package Manager
PM> Install-Package AspNetCore.ReCaptcha
# .NET CLI
dotnet add package AspNetCore.ReCaptcha
Configuration
Place the aquired secret key and site key in the appsettings.json of your project. An example of the appsettings file is below:
{
"ReCaptcha": {
"SiteKey": "your site key here",
"SecretKey": "your secret key here",
"Version": "v2", // The ReCaptcha version to use, can be v2, v2invisible or v3
"UseRecaptchaNet": false, // Value whether to use google recaptcha or recaptcha.net
"ScoreThreshold": 0.5, // Only applicable for recaptcha v3, specifies the score threshold when it is considered successful
}
}
Usage
To use AspNetCore.ReCaptcha in your project, you must add the following code to your startup.cs:
public void ConfigureServices(IServiceCollection services) {
services.AddReCaptcha(Configuration.GetSection("ReCaptcha"));
}
or if you are using the new minimal API in .NET 6.0 add this to your program.cs instead:
builder.Services.AddReCaptcha(builder.Configuration.GetSection("ReCaptcha"));
In your .cshtml file you add the following using statement:
@using AspNetCore.ReCaptcha
And then you can add the ReCaptcha element to your DOM using the following code or make use of the tag-helper:
@Html.ReCaptcha()
<recaptcha />