C# .NET 9.0 Blazor server component for hCaptcha.
Get Started
$ dotnet add package ChatAIze.CaptchaReadme
CAPTCHA
C# .NET 9.0 Blazor server component for hCaptcha.
[!WARNING] This library is designed to be used in a Blazor server app with interactive rendering enabled. It does NOT support Blazor WebAssembly.
Installation
NuGet Package
NuGet CLI
dotnet add package ChatAIze.Captcha
Package Manager Console
Install-Package ChatAIze.Captcha
Service (Program.cs)
builder.Services.AddCaptcha(o =>
{
o.SiteKey = builder.Configuration["Captcha:SiteKey"]!;
o.Secret = builder.Configuration["Captcha:Secret"]!;
o.VerifyIpAddresses = false; // optional, default is false
o.IsConnectionProxied = false; // optional, default is false
});
[!NOTE] If users are connecting to your app via a reverse proxy like Cloudflare,
IsConnectionProxiedshould be set totrue. In such a case, theX-Forwarded-Forheader will be used to determine the client's IP address.
Middleware (Program.cs)
app.UseCaptcha();
Javascript (App.razor)
<head>
<!-- ... -->
<script src="https://js.hcaptcha.com/1/api.js" async defer></script>
<!-- ... -->
</head>
Using (_Imports.razor)
@using ChatAIze.Captcha
Usage
<Captcha @bind-IsVerified="_isVerified" />
<h1>Verified: @_isVerified</h1>
@code {
private bool _isVerified;
}
[!TIP] Make sure that the component containing the CAPTCHA has interactive rendering enabled.
@rendermode InteractiveServer
Properties
- SiteKey: Overrides service settings
- Secret: Overrides service settings