ASP.NET Core CAPTCHA Integration
Set up an ASP.NET Core CAPTCHA in your controller with a few lines of C#. TrustCaptcha stops bot spam on logins, signups and contact forms and leaves anti-forgery tokens and your model binding untouched. EU-hosted, GDPR-compliant, no image puzzles.
Quickstart
How the integration works
1. Create a CAPTCHA
Create a user account or log in with an existing one. Then create a new CAPTCHA or pick an existing one. If you want to try TrustCaptcha first, every plan comes with a 14-day free trial.
The CAPTCHA overview page shows your site key and license key, and you create your API key there. Add your website’s domains to the authorized domains in the CAPTCHA security rules so they can use your CAPTCHA.


2. Add the CAPTCHA widget to your Razor view
Drop the TrustCaptcha widget into the Razor view that renders your form. The widget runs the CAPTCHA in the background and adds a hidden tc-verification-token field on submit, which ASP.NET Core’s model binder hands to your controller.
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>
<form asp-action="Submit" method="post">
@Html.AntiForgeryToken()
<input type="email" name="email" required />
<trustcaptcha-component sitekey="<your_site_key>"></trustcaptcha-component>
<button type="submit">Send</button>
</form>The CAPTCHA widget will then be displayed inside your form:

Need detailed information about the CAPTCHA widget integration?
Our documentation has the full widget reference, including themes, languages and custom design.
Read the documentation
3. Validate the token in your ASP.NET Core controller
In your ASP.NET Core controller, take the verification token from the form, look up the result via our .NET library, and decide whether to accept the request.
First, install our TrustCaptcha .NET library:
dotnet add package TrustComponent.TrustCaptcha --version 3.0.0Then validate the token inside your controller and act on the result:
public class ContactController : Controller
{
[HttpPost]
public async Task<IActionResult> Submit(
[FromForm] string email,
[FromForm(Name = "tc-verification-token")] string tcVerificationToken)
{
try
{
var result = await TrustCaptcha.GetVerificationResultAsync("<your_api_key>", tcVerificationToken);
if (!result.VerificationPassed || result.Score > 0.5)
{
ModelState.AddModelError("captcha", "CAPTCHA verification failed.");
return View("Index");
}
}
catch (Exception)
{
ModelState.AddModelError("captcha", "CAPTCHA verification failed.");
return View("Index");
}
// CAPTCHA passed — process the request
return RedirectToAction("ThankYou");
}
}Need detailed information about the ASP.NET Core CAPTCHA integration?
For full step-by-step instructions, including a reusable action filter and a Minimal-APIs variant, please read our documentation.
Read the documentation
Other backend framework instead of ASP.NET Core?
If you use a different framework, pick the matching recipe here. If your framework isn’t listed, your software developers can integrate the verification themselves using our documentation or ask our support team for a pre-built integration.
4. Test your integration
TrustCaptcha is now active. Send a test request and check that it goes through.

FAQs
Where does the ASP.NET Core CAPTCHA check go?
Can I run the CAPTCHA verification as an action filter?
Does TrustCaptcha replace ASP.NET Core's anti-forgery token?
Does TrustCaptcha work with Minimal APIs?
How should I share the SDK in DI?
Where should I store the CAPTCHA API key?
TrustCaptcha blocks spam and bots, not customers. No puzzles, GDPR-compliant, EU-hosted.


Protect your ASP.NET Core application with TrustCaptcha in just a few steps!
- EU-hosted & GDPR-compliant
- No puzzles
- Try free for 14 days