KgCaptcha验证码实现笔记

背景

闲来无聊，在网上发现了一个验证码产品KgCaptcha，下面是我用KgCaptcha开发验证码的记录。

开发过程

Web接入

访问官网，注册账号后登录控制台，创建应用，系统会分配一个唯一的AppId、AppSecret。

引入JS

这里的appid在用户控制台获取。

<script src="captcha.js?appid=xxx"></script>

JS接入代码

<script>
kg.captcha({
    // 绑定元素，验证框显示区域
    bind: "#captchaBox",
    // 验证成功事务处理
    success: function(e) {
        console.log(e); 
    },
    // 验证失败事务处理
    failure: function(e) {
        console.log(e); 
    },
    // 点击刷新按钮时触发
    refresh: function(e) {
        console.log(e);
    }
});
</script>

Python后台验证

from wsgiref.simple_server import make_server
from KgCaptchaSDK import KgCaptcha
def start(environ, response):
    # 填写你的 AppId，在应用管理中获取
    AppID = "xxx"
    # 填写你的 AppSecret，在应用管理中获取
    AppSecret = "xxx"
    request = KgCaptcha(AppID, AppSecret)
    # 填写应用服务域名，在应用管理中获取
    request.appCdn = "https://cdn.kgcaptcha.com"
    # 请求超时时间，秒
    request.connectTimeout = 10
    # 用户id/登录名/手机号等信息，当安全策略中的防控等级为3时必须填写
    request.userId = "kgCaptchaDemo"
    # 使用其它 WEB 框架时请删除 request.parse，使用框架提供的方法获取以下相关参数
    parseEnviron = request.parse(environ)
    # 前端验证成功后颁发的 token，有效期为两分钟
    request.token = parseEnviron["post"].get("kgCaptchaToken", "")  # 前端 _POST["kgCaptchaToken"]
    # 客户端IP地址
    request.clientIp = parseEnviron["ip"]
    # 客户端浏览器信息
    request.clientBrowser = parseEnviron["browser"]
    # 来路域名
    request.domain = parseEnviron["domain"]
    # 发送请求
    requestResult = request.sendRequest()
    if requestResult.code == 0:
        # 验证通过逻辑处理
        html = "验证通过"
    else:
        # 验证失败逻辑处理
        html = f"{requestResult.msg} - {requestResult.code}"
    response("200 OK", [("Content-type", "text/html; charset=utf-8")])
    return [bytes(str(html), encoding="utf-8")]
httpd = make_server("0.0.0.0", 8088, start)  # 设置调试端口  http://localhost:8088/
httpd.serve_forever()

JS刷新验证码

<script>kg.reload(kg.param);</script>

效果展示

最后

SDK开源地址：KgCaptcha (KgCaptcha) · GitHub，顺便做了一个演示：凯格行为验证码在线体验