ReCaptcha.Verify.Net是一个专为ASP.NET Core 3.1及更高版本设计的库，用于处理和验证Google的reCAPTCHA服务返回的响应令牌。reCAPTCHA是一种流行的验证码系统，旨在保护网站免受自动化机器人和恶意活动的侵害，同时保持用户体验的友好性。在ASP.NET Core应用程序中集成此库，可以方便地在表单提交或其他敏感操作中添加额外的安全层。
该库的核心功能是验证用户在与reCAPTCHA交互后收到的令牌。当用户成功完成reCAPTCHA挑战（例如点击复选框或回答图像问题）时，Google会返回一个响应令牌。这个令牌随后被发送到服务器，由ReCaptcha.Verify.Net库进行验证，以确认该操作是由人类而非机器执行的。
集成ReCaptcha.Verify.Net的步骤通常包括以下几个关键部分：
1. **设置Google reCAPTCHA**：您需要在Google reCAPTCHA网站上注册您的应用，获取一个site key和secret key。这两个密钥将用于在客户端显示reCAPTCHA并进行服务器端验证。
2. **安装库**：在ASP.NET Core项目中，可以通过NuGet包管理器或使用dotnet CLI安装ReCaptcha.Verify.Net。这将添加必要的依赖项到项目中。
3. **配置服务**：在`Startup.cs`文件的`ConfigureServices`方法中，注入reCAPTCHA服务，并提供之前获取的site key和secret key。
```csharp
services.AddReCaptcha(options =>
{
options.SecretKey = Configuration["ReCaptcha:SecretKey"];
options.SiteKey = Configuration["ReCaptcha:SiteKey"];
});
```
4. **客户端集成**：在需要reCAPTCHA验证的视图中，使用site key渲染reCAPTCHA控件。这通常是在HTML表单中添加一段JavaScript代码。
5. **处理表单提交**：在处理表单提交的控制器方法中，使用验证服务来检查响应令牌的有效性。
```csharp
[HttpPost]
public IActionResult MyAction(MyViewModel model, string gRecaptchaResponse)
{
var result = _recaptchaService.Verify(gRecaptchaResponse);
if (result.Succeeded)
{
// 验证成功，处理业务逻辑
}
else
{
// 验证失败，返回错误信息或重试
}
}
```
6. **验证结果**：`_recaptchaService.Verify()`方法会返回一个包含验证结果的对象，可以检查`Succeeded`属性来判断验证是否通过。如果验证失败，还可以查看`ErrorCodes`属性获取具体错误原因。
ReCaptcha.Verify.Net库简化了与Google reCAPTCHA服务的交互，让开发者可以专注于其他业务逻辑。它支持异步验证，并且可以根据需要自定义HTTP客户端以适应特定的网络环境。通过使用这个库，ASP.NET Core开发者可以快速、安全地在他们的应用程序中实施强大的反垃圾邮件和机器人防护机制。
ReCaptcha_Verify_Net-master.zip （6个子文件） 
ReCaptcha.Verify.Net-master 
.gitattributes 2KB
