天爱验证码（Tianai-CAPTCHA）使用指南

天爱验证码（Tianai-CAPTCHA）使用指南

项目地址:https://gitcode.com/gh_mirrors/ti/tianai-captcha

---

项目介绍

天爱验证码（Tianai-CAPTCHA），被誉为Java领域内领先的开源行为验证码解决方案。该项目提供了多种交互式的验证码模式，包括滑块验证码、旋转验证码、滑动还原验证码以及文字点选验证码，并承诺持续更新引入更多创意的验证方式。基于JAVA实现，天爱验证码设计旨在提高网站安全，同时也为用户带来友好的交互体验。

项目快速启动

要快速启动并应用天爱验证码到你的项目中，遵循以下步骤：

第一步：添加依赖

如果你的项目是基于Spring Boot，推荐使用tianai-captcha-springboot-starter来简化配置。对于非Spring Boot项目，通过Maven添加基础依赖：

<dependency>
    <groupId>cloud.tianai.captcha</groupId>
    <artifactId>tianai-captcha</artifactId>
    <version>1.5.1</version>
</dependency>

第二步：生成及校验验证码

在你的应用中导入必要的类并创建验证码实例：

import cloud.tianai.captcha.validator.common.model.dto.MatchParam;
import cloud.tianai.captcha.generator.common.model.dto.CaptchaResponse;
import cloud.tianai.captcha.builder.TACBuilder;

public class QuickStart {
    public static void main(String[] args) {
        // 初始化验证码生成器
        ImageCaptchaApplication application = TACBuilder.builder()
                .addDefaultTemplate()
                // 自定义配置，如设置不同类型的验证码背景图
                .build();

        // 生成滑动验证码
        CaptchaResponse<ImageCaptchaVO> response = application.generateCaptcha("SLIDER");
        System.out.println(response);

        // 假设这是从前端接收的数据，进行校验
        String captchaId = response.getId();
        ImageCaptchaTrack track = ...; // 前端传递的跟踪信息
        ApiResponse<Void> validationResult = application.matching(captchaId, new MatchParam(track));
        System.out.println(validationResult.isSuccess());
    }
}

应用案例和最佳实践

在实际应用中，天爱验证码可以无缝集成到任何形式的Web应用中。最佳实践建议使用其提供的Spring Boot Starter来自动配置，并结合前端框架如Vue.js或React，利用天爱验证码的Web SDK来优雅地展示和处理验证码交互。确保前后端通信安全，可以通过JWT或其他安全令牌机制，结合验证码校验结果，为用户登录或关键操作提供双重保护。

典型生态项目

天爱验证码作为一个核心组件，它可以与其他多个生态系统项目协同工作，比如：

• 与Spring Security整合：加强身份验证过程，为基于Spring的web应用提供额外的安全层。
• 前端框架集成：与React或Vue的项目结合，利用其SDK轻松构建用户体验流畅的验证码界面。
• 微服务环境中的部署：在分布式系统中作为独立的服务，通过API接口为各个微服务提供验证码验证服务。

通过这些生态项目的搭配使用，能够最大化提升系统的安全性与用户体验。

---

本指南仅涵盖了天爱验证码的基础应用，深入探索其多样化的功能和高级定制化选项，请参考其在线文档和参与社区讨论，获取第一手的技术支持和经验分享。

tianai-captcha 可能是java界最好的开源行为验证码 [滑块验证码、点选验证码、行为验证码、旋转验证码， 滑动验证码] 项目地址: https://gitcode.com/gh_mirrors/ti/tianai-captcha