每一项特性都针对真实攻击场景,从图像对抗到协议安全,全面覆盖。
完整的验证链路涵盖生成、交互、校验三个阶段,任意环节均无法伪造。
安全体系建立在密码学基础上,而非依赖代码混淆,攻击者即使获得源码也无法伪造合法请求。
SDK 已封装全部加密逻辑,接入方无需了解协议细节,调用简洁直观。
通过 npm 安装前端 SDK,Vue 3 / React / 原生 JS 均支持。
在需要验证的页面挂载 CaptchaSlider 组件,监听 success 事件获取 Token。
将 captchaId + token 提交到业务后端,调用 /api/captcha/validate 接口完成最终校验,Token 一次性有效。
// 1. 安装 npm install nextgen-captcha-sdk // 2. 全局注册 import NextGenCaptcha from 'nextgen-captcha-sdk' import 'nextgen-captcha-sdk/style.css' app.use(NextGenCaptcha) // 3. 在模板中使用 <NextGenCaptchaSlider @success="onSuccess" @fail="onFail" /> // 4. 回调中获取 token function onSuccess({ token, captchaId }) { // 将 captchaId + token 提交到业务后端 submitLogin({ captchaId, captchaToken: token }) } // 5. 业务后端二次校验(Java 示例) // POST /api/captcha/validate // ?captchaId={id}&token={token} // 返回 true 表示合法,false 表示伪造
综合分超过阈值自动触发封禁,所有封禁记录持久化到 MySQL,重启不丢失。
| 维度 | 权重 | 触发条件 |
|---|---|---|
| IP 频率 | 25% | 60s 内超过 10 次请求 |
| 行为分析 | 40% | humanScore < 25 判定机器人 |
| 设备指纹 | 15% | 同指纹 1h 内超过 200 次 |
| 历史失败 | 20% | 同 IP 1h 失败次数超限 |
| 综合分 | 处置 | 错误码 |
|---|---|---|
| 0 - 59 | 正常通过 | 200 |
| 60 - 79 | 升级验证 | 200 + upgradeNeeded |
| 80+ | 封禁 IP | 2003 |
| 频率超限 | 频率限制 | 2002 |