开头的话
最近有在用一款好玩的验证码产品,乐于探索的我,决定从不同的语言去探索这款验证码。
KgCaptcha支持PHP、Python、Java、C#的接入。下面是我接入过程记录中的代码。
HTML
<scriptsrc="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><divid="captchaBox">载入中 ...</div>
PHP
include"public/KgCaptchaSDK.php"; // 填写你的 AppId,在应用管理中获取$appId="xxx"; // 填写你的 AppSecret,在应用管理中获取$appSecret="xxx"; $request=newkgCaptcha($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
fromwsgiref.simple_serverimportmake_serverfromKgCaptchaSDKimportKgCaptchadefstart(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() ifrequestResult.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
packagecom.kyger; importjakarta.servlet.ServletException; importjakarta.servlet.http.HttpServlet; importjakarta.servlet.http.HttpServletRequest; importjakarta.servlet.http.HttpServletResponse; importjava.io.IOException; importjava.util.Map; publicclassdemoextendsHttpServlet { privatestaticfinallongserialVersionUID=1L; publicdemo() { super(); } protectedvoiddoGet(HttpServletRequestrequest, HttpServletResponseresponse) throwsServletException, IOException { // 编码request.setCharacterEncoding("utf-8"); response.setCharacterEncoding("utf-8");; response.setContentType("text/html; charset=utf-8"); // 后台处理if (request.getMethod().equals("POST")){ Stringhtml, appId, appSecret; // 设置 AppId 及 AppSecret,在应用管理中获取appId="xxx"; appSecret="xxx"; KgCaptchaSDKKgRequest=newKgCaptchaSDK(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"); } } protectedvoiddoPost(HttpServletRequestrequest, HttpServletResponseresponse) throwsServletException, IOException { doGet(request, response); } }
C#
usingSystem; usingKgCaptchaSDK; publicpartialclass_Default : System.Web.UI.Page{ protectedvoidPage_Load(objectsender, EventArgse) { // 后端处理stringhtml, appId, appSecret, Token; if (Request.Form.ToString().Length>0){ // 有数据处理// 填写你的 AppId,在应用管理中获取appId="xxx"; // 填写你的 AppSecret,在应用管理中获取appSecret="xxx"; varrequest=newkgCaptcha(appId, appSecret); // 前端验证成功后颁发的 token,有效期两分钟request.token=Request.Form["kgCaptchaToken"]; // 填写应用服务域名,在应用管理中获取request.appCdn="https://cdn.kgcaptcha.com"; // 当安全策略中的防控等级为3时必须填写,一般情况下可以忽略// 可以填写用户输入的登录帐号(如:Request.Form["username"]),可拦截同一帐号多次尝试等行为request.userId="kgCaptchaDemo"; // 请求超时时间,秒request.connectTimeout=5; // 发送验证请求varrequestResult=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,顺便做了一个演示:凯格行为验证码在线体验