ilandev.AspNetCore.reCAPTCHA 1.0.2

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package ilandev.AspNetCore.reCAPTCHA --version 1.0.2
                    


                    

                
NuGet\Install-Package ilandev.AspNetCore.reCAPTCHA -Version 1.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="ilandev.AspNetCore.reCAPTCHA" Version="1.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="ilandev.AspNetCore.reCAPTCHA" Version="1.0.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="ilandev.AspNetCore.reCAPTCHA" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add ilandev.AspNetCore.reCAPTCHA --version 1.0.2
                    


                    

                
#r "nuget: ilandev.AspNetCore.reCAPTCHA, 1.0.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package ilandev.AspNetCore.reCAPTCHA@1.0.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=ilandev.AspNetCore.reCAPTCHA&version=1.0.2
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=ilandev.AspNetCore.reCAPTCHA&version=1.0.2
                    


                            Install as a Cake Tool

ilandev.AspNetCore.reCAPTCHA

nuget.org

A simple reCAPTCHA v3 verification client for ASP.NET Core.

Usage

  1. Call builder.Services.AddRecaptcha() and either pass in a configuration action to configure the middleware, or builder.Configuration to read the default configuration at the Recaptcha configuration section.

Examples

// Reads from the "Recaptcha" configuration section

builder.Services.AddRecaptcha(builder.Configuration);

// or..

builder.Services.AddRecaptcha(opts => 
{
	opts.SecretKey = "your secret key";
});

// in your controller..

public class MyController(IRecaptchaClient recaptchaClient) : ControllerBase
{
	[HttpPost("register")]
	public async Task Register([FromBody] RegisterModel model, CancellationToken cancellationToken)
	{
		var recaptchaResponse = await recaptchaClient.VerifyAsync(
			model.Token,
			HttpContext.Connection.RemoteIpAddress, // optional
			cancellationToken
		);
		
		if (!recaptchaResponse.Success)
		{
			// handle the error
		}
		
		// continue with registration
	}
}

Middleware Configuration

Configuration Default Value Details
TokenVerifyUrl https://www.google.com/recaptcha/api/siteverify The reCAPTCHA v3 verification endpoint.
SecretKey Your reCAPTCHA v3 secret key, found in the Google Cloud Console.
ThrowOnError false If true, will throw a RecaptchaVerificationException when token verification fails.
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  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.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net8.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.2 110 12/30/2024

Fixed the verification request being sent as JSON instead of as a form.