OSCHINA-MIRROR/yiyungent-SimCaptcha

SimCaptcha

Простой в использовании точечный проверочный код, включающий в себя реализацию на стороне клиента и сервера.

Введение

Простой в использовании проверочный код SimCaptcha поможет ускорить разработку.

Простота: соглашения предпочтительнее конфигурации, минимальное количество настроек помогает сосредоточиться на бизнесе.
Расширяемость: легко расширить собственную стратегию проверки с помощью реализации различных компонентов проверки интерфейса и использования внедрения зависимостей ASP.NET Core.
Готов к использованию: используйте существующий Web SDK для подключения к серверной проверке.
Безопасность: проверка изображений и информации осуществляется на сервере и сохраняется.
Распределённость: поддержка замены локального кэша по умолчанию с использованием интерфейса ICache.
Лёгкая настройка: простая настройка позволяет настроить срок действия, количество отказов, фоновое изображение, шрифт и т. д.

Онлайн-демонстрация

http://captcha-client.yiyungent.eu.org:10002/index.html

Только для демонстрации, нестабильно и не является последней версией.

Имя пользователя и пароль — admin.

Диаграмма последовательности вызовов между клиентом и сервером

Зависимости

Достаточно выполнить одно из следующих условий.

Установлен .NET Framework (>= 4.0).
Установлен .NET Standard (>= 2.0).

Установка

Рекомендуется использовать NuGet. В корне вашего проекта выполните следующую команду. Если вы используете Visual Studio, последовательно нажмите «Tools» → «NuGet Package Manager» → «Package Manager Console», убедитесь, что «Default project» — это проект, который вы хотите установить, и введите следующую команду для установки.

PM> Install-Package SimCaptcha

Использование в ASP.NET Core

PM> Install-Package SimCaptcha.AspNetCore

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

Создание службы проверки в ASP.NET Core за три шага

// Startup.cs
// Обратите внимание: часть кода опущена, сохранена только основная часть, см. пример (/examples/EasyAspNetCoreService)
// Только для SimCaptcha.AspNetCore v0.3.0+
public void ConfigureServices(IServiceCollection services)
{
    // 1. Важно: зарегистрировать конфигурацию проверочного кода
    services.Configure<SimCaptchaOptions>(Configuration.GetSection(SimCaptchaOptions.SimCaptcha));

    // 2. Добавить SimCaptcha
    services.AddSimCaptcha();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 3. Включить промежуточное ПО SimCaptcha
    app.UseSimCaptcha();

    Теперь
    "https://yourdomain.com/api/SimCaptcha/Img", "https://yourdomain.com/api/SimCaptcha/Check", "https://yourdomain.com/api/SimCaptcha/TicketVerify"
    начнёт работать.
}

Быстрое развёртывание Docker

Следующая команда развёртывает службу проверки:

docker run -d -p 5004:80 -e ASPNETCORE_URLS="http://*:80" --name simcaptcha-container yiyungent/simcaptcha

Примечание: если вы одновременно развёртываете службу проверки и клиентскую службу в Docker, обратите внимание на изоляцию контейнеров по умолчанию, контейнеры по умолчанию не могут взаимодействовать друг с другом через сеть. Вы можете поместить их в одну сеть, чтобы клиент мог получить доступ к службе проверки билетов. Для справки см. файл docker-compose.yml в корне репозитория. Кроме того, если клиент и сервер не находятся в одном домене, необходимо учитывать проблемы с CORS. Конфигурация службы проверки /app/appsettings.Docker.json в контейнере должна быть изменена, и в список CorsWhiteList необходимо добавить домен клиента.

Использование

[Подробная документация (/docs)](https://moeci.com/SimCaptcha «онлайн-документация»).
Примеры (/examples).

Версии зависимостей

SimCaptcha	0.0.1	0.1.0	0.2.0
SimCaptcha.AspNetCore	0.0.1	0.1.0-0.2.0	0.3.0
sim-captcha-js	0.0.1-0.0.4	0.0.1-0.1.0	0.0.1-0.1.0
vue-sim-captcha	0.0.1-0.0.3	0.0.1-0.1.1	0.0.1-0.1.1

SimCaptcha
SimCaptcha.AspNetCore

Вопросы и ответы

Вопрос: почему вы выбрали SimCaptcha? Ответ: сравнение популярных открытых и коммерческих проверочных кодов приведено ниже.

Среда

Среда выполнения: .NET Framework (> = 4.0) или .NET Standard (> = 2.0)
Среда разработки: Visual Studio Community 2019

Связанные проекты

— Благодарность

Дизайн капчи SimCaptcha вдохновлён проектом NetCoreVerificationCode, автор которого — wangchengqun. Благодарим автора за вклад в проект.
Шрифт капчи по умолчанию взят из библиотеки шрифтов Zcool. Благодарим за разрешение на использование.

Пожертвования

SimCaptcha — это проект с открытым исходным кодом под лицензией MIT, который можно использовать бесплатно. Однако без должной финансовой поддержки сложно поддерживать и развивать проект.

Мы принимаем пожертвования через следующие каналы:

爱发电

Автор

Автор и сопровождающий — yiyun при поддержке участников (список можно посмотреть здесь: https://github.com/yiyungent/SimCaptcha/contributors).

GitHub @yiyungent