开头的话
最近有在用一款好玩的验证码产品，乐于探索的我，决定从不同的语言去探索这款验证码。
KgCaptcha支持PHP、Python、Java、C#的接入。下面是我接入过程记录中的代码。
HTML
<script src="captcha.js?appid=xxx"></script>
<script>
kg.captcha({
// 绑定元素，验证框显示区域
bind: "#captchaBox",
// 验证成功事务处理
success: function(e) {
console.log(e);
},
// 验证失败事务处理
failure: function(e) {
console.log(e);
},
// 点击刷新按钮时触发
refresh: function(e) {
console.log(e);
}
});
</script>
<div id="captchaBox">载入中 ...</div>
PHP
<?php
include "public/KgCaptchaSDK.php";
// 填写你的 AppId，在应用管理中获取
$appId = "xxx";
// 填写你的 AppSecret，在应用管理中获取
$appSecret = "xxx";
$request = new kgCaptcha($appId, $appSecret);
// 填写应用服务域名，在应用管理中获取
$request->appCdn = "https://cdn.kgcaptcha.com";
// 前端验证成功后颁发的 token，有效期为两分钟
$request->token = $_POST["kgCaptchaToken"];
// 当安全策略中的防控等级为3时必须填写
$request->userId = "kgCaptchaDemo";
// 请求超时时间，秒
$request->connectTimeout = 10;
$requestResult = $request->sendRequest();
if ($requestResult->code === 0) {
// 验签成功逻辑处理
echo "验证通过";
} else {
// 验签失败逻辑处理
echo "验证失败，错误代码：{$requestResult->code}， 错误信息：{$requestResult->msg}";
}
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()
Java
package com.kyger;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.Map;
public class demo extends HttpServlet {
private static final long serialVersionUID = 1L;
public demo() {
super();
}
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 编码
request.setCharacterEncoding("utf-8");
response.setCharacterEncoding("utf-8");;
response.setContentType("text/html; charset=utf-8");
// 后台处理
if (request.getMethod().equals("POST")){
String html, appId, appSecret;
// 设置 AppId 及 AppSecret，在应用管理中获取
appId = "xxx";
appSecret = "xxx";
KgCaptchaSDK KgRequest = new KgCaptchaSDK(appId, appSecret);
// 前端验证成功后颁发的 token，有效期为两分钟
KgRequest.token = request.getParameter("kgCaptchaToken");
// 填写应用服务域名，在应用管理中获取
KgRequest.appCdn = "https://cdn.kgcaptcha.com";
// 请求超时时间，秒
KgRequest.connectTimeout = 5;
// 用户登录或尝试帐号，当安全策略中的防控等级为3时必须填写，一般情况下可以忽略
// 可以填写用户输入的登录帐号（如：request.getParameter("username"），可拦截同一帐号多次尝试等行为
KgRequest.userId = "kgCaptchaDemo";
// request 对象，当安全策略中的防控等级为3时必须填写，一般情况下可以忽略
KgRequest.request = request;
// java 环境中无法提供 request 对象，请分别定义：clientIp¦clientBrowser¦domain 参数，即：
// 发送验证请求
Map<String, String> requestResult = KgRequest.sendRequest();
if("0".toString().equals(requestResult.get("code"))) {
// 验签成功逻辑处理 ***
// 这里做验证通过后的数据处理
// 如登录/注册场景，这里通常查询数据库、校验密码、进行登录或注册等动作处理
// 如短信场景，这里可以开始向用户发送短信等动作处理
// ...
html = "<script>alert(´验证通过´);history.back();</script>";
} else {
// 验签失败逻辑处理
html = "<script>alert(\"" + requestResult.get("msg") + " - " + requestResult.get("code") + "\");history.back();</script>";
}
response.getWriter().append(html);
} else {
response.sendRedirect("index.html");
}
}
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
doGet(request, response);
}
}
C#
using System;
using KgCaptchaSDK;
public partial class _Default : System.Web.UI.Page{
protected void Page_Load(object sender, EventArgs e) {
// 后端处理
string html, appId, appSecret, Token;
if (Request.Form.ToString().Length > 0){ // 有数据处理
// 填写你的 AppId，在应用管理中获取
appId = "xxx";
// 填写你的 AppSecret，在应用管理中获取
appSecret = "xxx";
var request = new kgCaptcha(appId, appSecret);
// 前端验证成功后颁发的 token，有效期两分钟
request.token = Request.Form["kgCaptchaToken"];
// 填写应用服务域名，在应用管理中获取
request.appCdn = "https://cdn.kgcaptcha.com";
// 当安全策略中的防控等级为3时必须填写，一般情况下可以忽略
// 可以填写用户输入的登录帐号（如：Request.Form["username"]），可拦截同一帐号多次尝试等行为
request.userId = "kgCaptchaDemo";
// 请求超时时间，秒
request.connectTimeout = 5;
// 发送验证请求
var requestResult = request.sendRequest();
if (requestResult.code == 0) {
// 验签成功逻辑处理 ***
// 这里做验证通过后的数据处理
// 如登录/注册场景，这里通常查询数据库、校验密码、进行登录或注册等动作处理
// 如短信场景，这里可以开始向用户发送短信等动作处理
// ...
html = "<script>alert(´验证通过´);history.back();</script>";
} else {
// 验签失败逻辑处理
html = "<script>alert(\"" + requestResult.msg + " - " + requestResult.code + "\");history.back();</script>";
}
// 输出结果
Response.Write(html);
}
Response.Redirect("index.html");
}
}
最后
SDK开源地址：KgCaptcha (KgCaptcha) · GitHub，顺便做了一个演示：凯格行为验证码在线体验
