SixLaborsCaptcha.Core 1.0.0

SixLaborsCaptcha

SixLaborsCaptcha is a simple cross-platform NuGet package for generating image captcha.

Features

• Simple & Cross-Platform
• Compatible with Linux and Windows
• Compatible with Docker images based on Linux 😃

What's New

Version 1.0.0 - March 13, 2024

Update

• Upgrade SixLabors.ImageSharp.* packages
• Drop support of .net standard
• Support .net 8

Version 0.2.2 - Sep 26, 2022

Fix

• Fixed a bug in draw lines feature

Version 0.2.1 - Jul 22, 2022

Add

• Add BackgroundColor option

Fix

• Fixed a typo (Extentions renamed to Extensions)

Version 0.2.0 - Apr 22, 2022

Change

• Upgrade SixLabors.ImageSharp to 2.1.1
• ⚠ WARNING: This version incompatible with the previous version of SixLabors.ImageSharp 1.0.0+

Version 0.1.5 - Mar 30, 2022

Fix

• Update readme file

Version 0.1.4 - Mar 30, 2022

Fix

• Use DrawLinesColor instead of TextColor in creating random lines (#2 by @NK201)

Version 0.1.3 - Oct 8, 2021

Add

• Add NoiseRateColor/NoiseRate options
• Add MinLineThickness/MaxLineThickness options

Change

• Improve the rendering speed
• Improve the captcha image security

Packages

SixLaborsCaptchaOptions

FontFamilies Option: Notice: This default fonts working only on Windows, if you want to run it on Linux you have to use the Linux fonts

Install via CLI

To install SixLaborsCaptcha.Core, run the following command in the terminal:

> dotnet add package SixLaborsCaptcha.Core --version 0.2.1

Usage:

using SixLaborsCaptcha.Core;
using SixLabors.ImageSharp;
using System.IO;

namespace ConsoleAppSample
{
	class Program
	{
		static void Main(string[] args)
		{
			var slc = new SixLaborsCaptchaModule(new SixLaborsCaptchaOptions
			{
				DrawLines = 7,
				TextColor = new Color[] { Color.Blue, Color.Black },
			});

			var key = Extensions.GetUniqueKey(6);
			var result = slc.Generate(key);
			File.WriteAllBytes($"six-labors-captcha.png", result);
		}
	}
}

To install SixLaborsCaptcha.Mvc.Core for ASP.NET Core MVC, run the following command in the Terminal:

> dotnet add package SixLaborsCaptcha.Mvc.Core --version 1.0.0

Usage:

1. In the ConfigureServices method of Startup.cs, register the AddSixLabCaptcha generator

using SixLaborsCaptcha.Mvc.Core;
...
		public void ConfigureServices(IServiceCollection services)
		{
			services.AddSixLabCaptcha(x =>
			{
				x.DrawLines = 4;
			});
		}
...

2. Create an action to generate image

using SixLaborsCaptcha.Core;
...

[HttpGet]
[Route("[action]")]
public FileResult GetCaptchaImage([FromServices] ISixLaborsCaptchaModule sixLaborsCaptcha)
{
	string key = Extensions.GetUniqueKey(6);
	var imgText = sixLaborsCaptcha.Generate(key);
	return File(imgText, "Image/Png");
}

...

3. Get the image from action

<div class="text-center">
	<h1 class="display-4">Welcome to SixLaborsCaptcha</h1>
	<img src='@Url.Action("GetCaptchaImage","Home")?v1' />
	<br />
	<img src='@Url.Action("GetCaptchaImage","Home")?v2' />
	<br />
	<img src='@Url.Action("GetCaptchaImage","Home")?v3' />
	<br />
	<img src='@Url.Action("GetCaptchaImage","Home")?v4' />
</div>

Run asp.net core mvc app on Linux os:

1. Download a font (also, you can use the system fonts and don't needs to do this step)

wget -O ~/Downloads/marlboro.zip https://www.1001freefonts.com/d/3761/marlboro.zip
unzip -p ~/Downloads/marlboro.zip Marlboro.ttf > ~/Downloads/Marlboro.ttf
rm ~/Downloads/marlboro.zip
cp ~/Downloads/Marlboro.ttf ~/.fonts/
# other paths
# ~/.fonts/ - for your own fonts.
# /usr/local/share/fonts/ - system-wide, user installed fonts.
# /usr/share/fonts/ - system's font location.

2. Config the serivce

services.AddSixLabCaptcha(x => {
			   x.FontFamilies = new string[] { "Marlboro" };
		         });