Planfact.Yandex.SmartCaptcha 1.0.1

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. 
dotnet add package Planfact.Yandex.SmartCaptcha --version 1.0.1
                    


                    

                
NuGet\Install-Package Planfact.Yandex.SmartCaptcha -Version 1.0.1
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="Planfact.Yandex.SmartCaptcha" Version="1.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Planfact.Yandex.SmartCaptcha" Version="1.0.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Planfact.Yandex.SmartCaptcha" />
                    


                            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 Planfact.Yandex.SmartCaptcha --version 1.0.1
                    


                    

                
#r "nuget: Planfact.Yandex.SmartCaptcha, 1.0.1"
#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 Planfact.Yandex.SmartCaptcha@1.0.1
#: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=Planfact.Yandex.SmartCaptcha&version=1.0.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Planfact.Yandex.SmartCaptcha&version=1.0.1
                    


                            Install as a Cake Tool

Planfact.Yandex.SmartCaptcha

NuGet Version NuGet Downloads Build Status codecov License: MIT .NET GitHub release

Идиоматичный и типобезопасный .NET клиент для сервиса Yandex SmartCaptcha.

Установка

dotnet add package Planfact.Yandex.SmartCaptcha

Быстрый старт

using Planfact.Yandex.SmartCaptcha;

var settings = new SmartCaptchaSettings { SecretKey = "YOUR_SECRET_KEY" };
var validator = new SmartCaptchaValidator(settings);

var result = await validator.ValidateAsync("captcha_token", "127.0.0.1");
if (result.IsValid)
{
    Console.WriteLine("Валидация прошла успешно!");
}

Интеграция с ASP.NET Core

// Program.cs
builder.Services.AddSmartCaptcha(builder.Configuration);

// Внедрение зависимости
public class CaptchaController : Controller
{
    private readonly ISmartCaptchaValidator _validator;

    public CaptchaController(ISmartCaptchaValidator validator)
    {
        _validator = validator;
    }

    public async Task<IActionResult> Verify(string token)
    {
        var clientIp = Request.HttpContext.Connection.RemoteIpAddress?.ToString();
        var result = await _validator.ValidateAsync(token, clientIp);
        return Json(new { isValid = result.IsValid });
    }
}

💡 Конфигурирование: Для настройки IAM Token, API Key и других параметров см. документацию по конфигурированию

Особенности

  • 🔐 Три типа аутентификации: Secret Key, IAM Token, API Key
  • 🌐 IP валидация для повышения точности
  • ⚙️ Гибкие настройки: пропуск IP-адресов, таймауты, отключение валидации
  • 📝 Интеграция с логированием Microsoft.Extensions.Logging
  • 🛡️ Встроенная надежность: автоматические retry, circuit breaker, и resilience patterns
  • 🚀 Enterprise-готовность: основан на Reliable.HttpClient для production-нагрузок
  • 🧪 Готовность к тестированию с поддержкой DI

Поддержка платформ

  • .NET 6.0+
  • .NET 8.0+
  • .NET 9.0+

Документация

Лицензия

MIT License. См. LICENSE для деталей.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  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 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 is compatible.  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.

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.1 8,633 10/31/2025
1.0.0 559 9/29/2025

Релиз v1.0.1: Исправление ошибок

Что нового:

Валидация токена на пустоту перед отправкой в Yandex SmartCaptcha производится после проверки включения капчи.

Для чего это нужно:

При отключенной капче не должно пробрасываться исключения в случае передачи пустого токена.