Sam.ReCaptcha 2.1.0

Sam.ReCaptcha

Sam.ReCaptcha is a captcha generator and validator for ASP.NET Core applications.

Install via NuGet

To install Sam.ReCaptcha, run the following command in the Package Manager Console:

PM> Install-Package Sam.ReCaptcha 

You can also view the package page on NuGet.

Usage:

• To register its default providers, call services.AddReCaptchaServices(); method in your Startup class.

using Sam.ReCaptcha;

namespace Presentation
{
    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddReCaptchaServices(o =>
            {
                o.CodeCharacter = "0123456789";
                o.ForeColor = Color.DarkBlue;
                o.BackColor = Color.White;
                o.HatchColor = Color.DarkCyan;
            });
        }
    }
}

• After use the Sam.ReCaptcha package, add foo property in your model

public class MyModel
{
    public string foo { get; set; }
}

• Then to use it, add its new Htmlhelper to your view:

@using Sam.ReCaptcha

@model MyModel

<form method="post">

    @Html.AddReCaptcha()
    
    <input asp-for="foo" />
    <span asp-validation-for="foo"></span>
    
    <input type="submit" value="submit" />

</form>

• Now you can add the ReChaptchaValidator attribute to your action method to verify the entered security code:

[HttpPost]
[ReChaptchaValidator(inputName: "foo",errorMessage: "Chaptcha is not Valid")]
public IActionResult Index(MyModel model)
{
    return View(model);
}

Note:

To run this project on non-Windows-based operating systems, you will need to install libgdiplus too:

• Ubuntu :

  apt-get install libgdiplus

• Fedora :

  dnf install libgdiplus

• CentOS 7 and above:

  yum install autoconf automake libtool
  yum install freetype-devel fontconfig libXft-devel
  yum install libjpeg-turbo-devel libpng-devel giflib-devel libtiff-devel libexif-devel
  yum install glib2-devel cairo-devel
  git clone https://github.com/mono/libgdiplus
  cd libgdiplus
  ./autogen.sh
  make
  make install
  cd /usr/lib64/
  ln -s /usr/local/lib/libgdiplus.so libgdiplus.so