Spring Boot CAPTCHA Integration
Add a Spring Boot CAPTCHA to a controller in a few lines of Java. It stops bot spam on logins, sign-ups and contact forms and leaves Thymeleaf templates, Bean Validation and Spring Security as they are. 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 Thymeleaf template
Drop the TrustCaptcha widget into the Thymeleaf form you want to protect. As soon as a visitor interacts with the form, the CAPTCHA runs in the background and adds a hidden tc-verification-token field on submit. Spring Boot will hand it to your controller like any other form parameter.
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>
<form th:action="@{/contact}" method="post">
<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 Spring Boot controller
In your Spring Boot controller, take the verification token from the form, look up the result via our Java library, and decide whether to accept the request.
First, install our TrustCaptcha Java library:
<dependency>
<groupId>com.trustcomponent</groupId>
<artifactId>trustcaptcha</artifactId>
<version>3.0.0</version>
</dependency>Then validate the token inside your controller and act on the result:
@PostMapping("/contact")
public String submit(@RequestParam("tc-verification-token") String token, Model model) {
VerificationResult result;
try {
result = TrustCaptcha.getVerificationResult("<your_api_key>", token);
} catch (CaptchaFailureException e) {
return "contact"; // verification failed — show the form again
}
if (!result.isVerificationPassed() || result.getScore() > 0.5) {
return "contact"; // looks like a bot — block it
}
// CAPTCHA passed — process the request
return "contact-success";
}Need detailed information about the Spring Boot CAPTCHA integration?
For full step-by-step instructions, including a Bean Validation refactor for projects with several protected endpoints, please read our documentation.
Read the documentation
Other backend framework instead of Spring Boot?
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
Which Spring Boot versions are supported?
Where should the Spring Boot CAPTCHA verification happen?
Can I use TrustCaptcha together with Spring Security?
Can I trigger CAPTCHA validation through Bean Validation (@Valid)?
Does TrustCaptcha work with WebFlux / reactive controllers?
Where should I store the CAPTCHA API key in a Spring Boot project?
TrustCaptcha blocks spam and bots, not customers. No puzzles, GDPR-compliant, EU-hosted.


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