介绍 tianai-captcha：轻量级验证码解决方案

在现代互联网应用中，验证码（CAPTCHA）是防止恶意攻击和垃圾信息的关键工具。tianai-captcha 是一个轻量级、易于集成的开源验证码解决方案，特别适合中小型项目和个人开发者。本文将介绍 tianai-captcha 的主要功能、使用方法以及其在实际项目中的应用场景。

什么是 tianai-captcha？

tianai-captcha 是一个基于 Java 的验证码生成库，提供了多种验证码类型和自定义选项。它的设计目标是简化验证码的生成和验证过程，使开发者能够快速在项目中集成高效的验证码功能。

tianai-captcha 目前支持的行为验证码类型

• 滑块验证码
• 旋转验证码
• 滑动还原验证码
• 文字点选验证码
  快速上手

1. 导入xml

<!-- maven 导入 -->
<dependency>
    <groupId>cloud.tianai.captcha</groupId>
    <artifactId>tianai-captcha</artifactId>
    <version>1.5.0</version>
</dependency>

2. 构建 ImageCaptchaApplication负责生成和校验验证码

public class ApplicationTest {

    public static void main(String[] args) {
        ImageCaptchaApplication application = TACBuilder.builder()
                .addDefaultTemplate() // 添加默认模板
                // 给滑块验证码 添加背景图片，宽高为600*360, Resource 参数1为 classpath/file/url , 参数2 为具体url 
                .addResource("SLIDER", new Resource("classpath", "META-INF/cut-image/resource/1.jpg")) // 滑块验证的背景图
                .addResource("WORD_IMAGE_CLICK", new Resource("classpath", "META-INF/cut-image/resource/1.jpg")) // 文字点选的背景图
                .addResource("ROTATE", new Resource("classpath", "META-INF/cut-image/resource/1.jpg")) // 旋转验证的背景图
                .build();
        // 生成验证码数据， 可以将该数据直接返回给前端 ， 可配合 tianai-captcha-web-sdk 使用
        // 支持生成 滑动验证码(SLIDER)、旋转验证码(ROTATE)、滑动还原验证码(CONCAT)、文字点选验证码(WORD_IMAGE_CLICK)
        CaptchaResponse<ImageCaptchaVO> res = application.generateCaptcha("SLIDER");
        System.out.println(res);

        // 校验验证码， ImageCaptchaTrack 和 id 均为前端传开的参数， 可将 valid数据直接返回给 前端
        // 注意: 该项目只负责生成和校验验证码数据， 至于二次验证等需要自行扩展
        String id = res.getId();
        ImageCaptchaTrack imageCaptchaTrack = null;
        ApiResponse<?> valid = application.matching(id, imageCaptchaTrack);
        System.out.println(valid.isSuccess());


        // 扩展: 一个简单的二次验证
        CacheStore cacheStore = new LocalCacheStore();
        if (valid.isSuccess()) {
            // 如果验证成功，生成一个token并存储, 将该token返回给客户端，客户端下次请求数据时携带该token， 后台判断是否有效
            String token = UUID.randomUUID().toString();
            cacheStore.setCache(token, new AnyMap(), 5L, TimeUnit.MINUTES);
        }

    }
}

3.详细文档地址

 http://doc.captcha.tianai.cloud/

总结

tianai-captcha 是一个功能强大、使用简便的验证码解决方案。通过它，开发者可以快速为项目添加高效的验证码功能，提升系统的安全性。如果你正在寻找一个可靠的验证码库，不妨试试 tianai-captcha。