reCAPTCHA.AspNetCore
3.0.10
dotnet add package reCAPTCHA.AspNetCore --version 3.0.10
NuGet\Install-Package reCAPTCHA.AspNetCore -Version 3.0.10
<PackageReference Include="reCAPTCHA.AspNetCore" Version="3.0.10" />
paket add reCAPTCHA.AspNetCore --version 3.0.10
#r "nuget: reCAPTCHA.AspNetCore, 3.0.10"
// Install reCAPTCHA.AspNetCore as a Cake Addin #addin nuget:?package=reCAPTCHA.AspNetCore&version=3.0.10 // Install reCAPTCHA.AspNetCore as a Cake Tool #tool nuget:?package=reCAPTCHA.AspNetCore&version=3.0.10
reCAPTCHA.AspNetCore
Google reCAPTCHA for .NET Core 3.x. The older .NET Core 2.x version can be found here.
Note: There have been changes to this libraries structure between versions 2, and 3. If you still wish to use version 2 it's been frozen at version 2.2.5 on nuget.
Install
From a command prompt
dotnet add package reCAPTCHA.AspNetCore
Install-Package reCAPTCHA.AspNetCore
You can also search for package via your nuget ui / website:
https://www.nuget.org/packages/reCAPTCHA.AspNetCore/
Requirements
You must first have a secret key and a site key in order to use the reCAPTCHA service. This package supports v2 and v3 api keys. You can read more about reCAPTCHA v2, and v3 as well as sign up for free here: https://www.google.com/recaptcha/intro/
Configure
Choose how you want to configure the storage of your RecaptchaSettings
. This contains your site key, and site secret so it's recommended to use secrets.json
with Azure Key Vault (or similar setup). However you can also just add the section to your appconfig.json
file.
appconfig.json
Add the follow entry to the file make sure to paste in your secret key and site key followed by setting the correct version to v2 or v3 depending on your key type:
"RecaptchaSettings": {
"SecretKey": "paste secret key here",
"SiteKey": "paste site key here"
}
secrets.json
Right click on your project file and goto Manage Secrets.
This will open secrets.json. Add the follow entry to the file make sure to paste in your secret key and site key followed by setting the correct version to v2 or v3 depending on your key type:
"RecaptchaSettings": {
"SecretKey": "paste secret key here",
"SiteKey": "paste site key here"
}
Note: This will also require you to have a setup such as Azure Key Vault (or similar setup) when running in production.
Content Security Policy
If you use a content security policy you can specify the values for script-src, and frame-src using the below example. Note that you should also make sure the Site option used for those who suffer from censorship matches the values you are using. The default value for Site is www.google.com.
"RecaptchaSettings": {
"SecretKey": "paste secret key here",
"SiteKey": "paste site key here",
"ContentSecurityPolicy": "https://www.google.com/recaptcha/"
}
This is an example for those that have to use recaptcha.net which would also have to change the site value:
"RecaptchaSettings": {
"SecretKey": "paste secret key here",
"SiteKey": "paste site key here",
"Site": "www.recaptcha.net",
"ContentSecurityPolicy": "https://www.recaptcha.net/recaptcha/"
}
Versions
These are the currently supported versions. Below is also the list of class names for T when using Html.Recaptcha<T>
Examples
Open Startup.cs
and add the following code as shown below to your ConfigureServices
method:
// Add recaptcha and pass recaptcha configuration section
services.AddRecaptcha(Configuration.GetSection("RecaptchaSettings"));
// Or configure recaptcha via options
services.AddRecaptcha(options =>
{
options.SecretKey = "Your secret key";
options.SiteKey = "Your site key";
});
Usage
In order to prevent having to copy and paste your site key all over your view files (a nightmare to update later). You can inject your settings from the Startup method by adding the following code to top of your view file:
@inject IOptions<RecaptchaSettings> RecaptchaSettings
You can then freely include the Recaptcha script inside of forms you wish to vaidate later in your controller (supports multiple forms).
@using (Html.BeginForm("SomeMethod", "SomeController")) {
@(Html.Recaptcha<RecaptchaV2Checkbox>(RecaptchaSettings?.Value))
}
If you wish to trigger a JavaScript function on callback you can pass a method name to the Html helper.
@using (Html.BeginForm("SomeMethod", "SomeController")) {
@(Html.Recaptcha<RecaptchaV2Checkbox>(RecaptchaSettings?.Value, new RecaptchaV2Checkbox { successCallback = "methodName" }))
}
<script>
function methodName() {
alert('caw caw caw!');
}
</script>
You may find that you need to add a reference to Microsoft.Extensions.Options before you can use IOptions.
@using Microsoft.Extensions.Options
@using reCAPTCHA.AspNetCore
You can see a tested example of usage in the Contact.cshtml view. However you will need to configure it with your key information before running yourself. You should also take note of the allowed domains security policy in the Google Recaptcha docs.
Validation
You can validate the recaptcha attempts using the ValidateRecaptchaAttribute on your HttpPost method:
[HttpPost]
[ValidateRecaptcha]
public async Task<IActionResult> SomeMethod(SomeModel model)
{
return View(model);
}
You can also specify a minimum score you wish to accept when a success occurs:
[HttpPost]
[ValidateRecaptcha(0.5)]
public async Task<IActionResult> SomeMethod(SomeModel model)
{
return View(model);
}
You can see a tested example of usage in the HomeController.cs controller. However you will need to configure it with your key information before running yourself. You should also take note of the allowed domains security policy in the Google Recaptcha docs.
Recaptcha.net
Users who suffer from censorship concerns can now bypass the libraries default of www.google.com to www.recaptcha.net, or a proxy of there choosing using the following optional setting in appsettings.json
.
"RecaptchaSettings": {
"Site": "www.recaptcha.net",
"SecretKey": "paste secret key here",
"SiteKey": "paste site key here"
}
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp3.1 is compatible. |
-
.NETCoreApp 3.1
- No dependencies.
NuGet packages (1)
Showing the top 1 NuGet packages that depend on reCAPTCHA.AspNetCore:
Package | Downloads |
---|---|
FenixAlliance.ACL.Dependencies
Application Component for the Alliance Business Suite. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
3.0.10 | 1,038,735 | 8/26/2020 |
3.0.9 | 745 | 8/25/2020 |
3.0.8 | 1,527 | 8/22/2020 |
3.0.7 | 3,434 | 8/12/2020 |
3.0.6 | 14,433 | 7/10/2020 |
3.0.5 | 2,615 | 6/25/2020 |
3.0.4 | 10,819 | 6/24/2020 |
3.0.3 | 19,285 | 5/8/2020 |
3.0.2 | 4,055 | 5/4/2020 |
3.0.1 | 871 | 5/4/2020 |
3.0.0 | 1,075 | 5/3/2020 |
2.2.5 | 31,791 | 5/2/2020 |
2.2.3 | 171,167 | 4/15/2019 |
2.2.2 | 3,645 | 4/11/2019 |
2.2.1 | 1,074 | 4/9/2019 |
2.2.0 | 1,881 | 4/8/2019 |
2.1.3 | 34,718 | 1/12/2019 |
2.1.2 | 1,448 | 1/4/2019 |
2.1.1 | 2,567 | 11/24/2018 |
2.1.0 | 2,055 | 10/13/2018 |
2.0.0 | 1,400 | 9/20/2018 |
1.0.1 | 4,308 | 11/5/2017 |
1.0.0 | 1,369 | 11/1/2017 |