Turnstile.Net 1.0.0

Turnstile.Net

Turnstile.Net is a .Net library that provides you method to validate your form using Cloudflare Turnstile captcha.

How to use it

Provide the key

Just provide in your configuration (either on appsettings.json/appsettings.development.json or Azure KeyVault) with the key :

"Turnstile" : {
	"SiteKey": "YOUR_SITE_KEY",
	"SecretKey": "YOUR_SECRET_KEY"
}

Configure client side rendering

Don't forget to add the cloudflare javascript script to your page in order to get the captcha shown on your page.

<script src="https://challenges.cloudflare.com/turnstile/v0/api.js"></script>

Use it in your project

First, activate the services from your Program.cs file

builder.Services.AddTurnstile();

Then add the dependecy to your controller.

public class YourController : Controller {

	private readonly ITurnstileService _turnstileService;

	public YourController(ITurnstileService turnstileService) {
	
		_turnstileService = turnstileService;
	}

}

And finally you can handle it on your post action method :

[HttpPost]
[ValidateAntiForgeryToken]
public IActionResult FormHandler(YourModel model) {
	if(!ModelState.IsValid) {
		return View(model);
	}

	var captchaFormToken = Request.Form["cf-turnstile-response"].ToString();
	var isFormValid = _turnstileService.ValidateCaptchaAsync(captchaFormToken);
	if(isFormValid) {
		// Do your stuff here
	}
	return View(model);
}

Same principle applies to Razor Pages or Blazor.