新闻、帮助、产品更新动态

最新的业界新闻,产品系统更新开发动态,帮助教程和活动发布

从零玩转腾讯滑块验证码

发布日:2022-01-20 12:57       阅读数:

从零玩转腾讯滑块验证码
现在大部分公司的前端都是以滑块验证码进行验证机器人行为,后端也有但差不多都是图形验证码或者手机验证码,直接进入主题接下来我们要玩转的技术 是腾讯云出品的滑块验证码(可以免费领取5W以上的免费次数有效期限一年哦)

第一步、进入腾讯云官方网站
https://console.cloud.tencent.com/captcha/graphical

1. 点击图形验证码 可能需要开通 开通即可 ,点击领取免费包会赠送验证码使用次数,可在套餐包管理里面查看。

2.  点击新增验证
3.填写信息

3.0 完成新建后,可在验证列表中查看验证码 CaptchaAppId 及 AppSecretKey
3.1 进入官方文档
https://cloud.tencent.com/document/product/1110/36839
3.2 我们会看到一个快速接入第一步我们先获取到自己的腾讯云密钥

3.3 密钥先自己复制一份
APPID: xxxxxxxxxxxxxxxxxxx
SecretId: xxxxxxxxxxxxxxxxxxxxxxxxxxxx
SecretKey: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
第二步、创建前端页面
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>杨不易呀-Web 前端接入示例</title>
  <!-- 验证码程序依赖(必须) -->
  <script src="https://ssl.captcha.qq.com/TCaptcha.js"></script>
</head>
<body>
  <!--点击此元素会自动激活验证码, 此例使用的button元素, 也可以使用div、span等-->
  <!--id :            (不可变) 元素的 ID, 值必须是 'TencentCaptcha'-->
  <!--data-appid :    (必须) 验证码CaptchaAppId, 从腾讯云的验证码控制台中获取, 验证码控制台页面内【图形验证】>【验证列表】进行查看 。如果未新建验证,请根据业务需求选择适合的验证渠道、验证场景进行新建-->
  <!--data-cbfn :     (必须) 回调函数名, 函数名要与 data-cbfn 相同-->
  <!--data-biz-state :(可选) 业务自定义透传参数, 会在回调函数内获取到 (res.bizState)-->
  <button id="TencentCaptcha" data-appid="你的验证码CaptchaAppId" data-cbfn="callbackName" data-biz-state="data-biz-state"
      type="button">验证</button>
</body>
<script>
  // 回调函数需要放在全局对象window下
  window.callbackName = function (res) {
      // 返回结果
      // ret         Int       验证结果,0:验证成功。2:用户主动关闭验证码。
      // ticket      String    验证成功的票据,当且仅当 ret = 0 时 ticket 有值。
      // CaptchaAppId       String    验证码应用ID。
      // bizState    Any       自定义透传参数。
      // randstr     String    本次验证的随机串,请求后台接口时需带上。
      console.log('callback:', res);

      // res(用户主动关闭验证码)= {ret: 2, ticket: null}
      // res(验证成功) = {ret: 0, ticket: "String", randstr: "String"}
      if (res.ret === 0) {
          // 复制结果至剪切板
          let str = `【randstr】->【${res.randstr}】      【ticket】->【${res.ticket}`;
          let ipt = document.createElement('input');
          ipt.value = str;
          document.body.appendChild(ipt);
          ipt.select();
          document.execCommand("Copy");
          document.body.removeChild(ipt);
          alert('1. 返回结果(randstr、ticket)已复制到剪切板,ctrl+v 查看。\n2. 打开浏览器控制台,查看完整返回结果。');
        }
  }
</script>
</html>

1. 写入 验证码CaptchaAppId, 从腾讯云的验证码控制台中获取, 验证码控制台页面内【图形验证】>【验证列表】进行查看

<button id="TencentCaptcha" data-appid="2071484082" data-cbfn="callbackName" data-biz-state="data-biz-state"  type="button">验证</button>

2.打开页面进行查看效果


3.滑动滑块至终点校验
// 返回结果
// ret         Int       验证结果,0:验证成功。2:用户主动关闭验证码。
// ticket      String    验证成功的票据,当且仅当 ret = 0 时 ticket 有值。
// CaptchaAppId       String    验证码应用ID。
// bizState    Any       自定义透传参数。
// randstr     String    本次验证的随机串,请求后台接口时需带上。

【randstr】>【@uKe】
【ticket】>【t03vNwGSyE5PYZpSALqZsjsr7M5Z8lzRMhzgC7UExz7_DSmmxq_B1iLBB_VYhxp76wY5jQXVOdq_K2Ye8jjx7XiDSRmDAT3sJAME9NUlgxqQoyVOyDpdOUjbA**

 

4.那么腾讯验证码接入已经完成,接下来我们进行与后端进行连接校验
第三步、创建DescribeCaptchaResult  maven后端工程
1. 加入依赖
  <dependencies>
        <dependency>
            <groupId>com.tencentcloudapi</groupId>
            <artifactId>tencentcloud-sdk-java</artifactId>
            <!-- go to https://search.maven.org/search?q=tencentcloud-sdk-java and get the latest version. -->
            <!-- 请到https://search.maven.org/search?q=tencentcloud-sdk-java查询所有版本,最新版本如下 -->
            <version>3.1.217</version>
        </dependency>
    </dependencies>
    <repositories>
        <repository>
            <id>nexus-tencentyun</id>
            <name>Nexus tencentyun</name>
            <url>https://mirrors.tencent.com/nexus/repository/maven-public/</url>
        </repository>
    </repositories>

2.创建工具类DescribeCaptchaResultUtils

public class TencentCaptchaUtils {
	/**
	 * 腾讯验证码校验
	 * @param randStr 前端回调函数返回的随机字符串
	 * @param token(Ticket)   前端回调函数返回的用户验证票据 
	 * @return
	 */
	public static boolean tencentCaptcha(String randStr, String token) {
		try {
			/*
			Action	是	String	公共参数,本接口取值:DescribeCaptchaResult。
			Version	是	String	公共参数,本接口取值:2019-07-22。
			Region	否	String	公共参数,本接口不需要传递此参数。
			CaptchaType	是	Integer	固定填值:9。可在控制台配置不同验证码类型。
			Ticket	是	String	前端回调函数返回的用户验证票据
			UserIp	是	String	透传业务侧获取到的验证码使用者的IP
			Randstr	是	String	前端回调函数返回的随机字符串
			CaptchaAppId	是	Integer	验证码应用ID
			AppSecretKey	是	String	用于服务器端校验验证码票据的验证密钥,请妥善保密,请勿泄露给第三方
			BusinessId	否	Integer	业务 ID,网站或应用在多个业务中使用此服务,通过此 ID 区分统计数据
			SceneId	否	Integer	场景 ID,网站或应用的业务下有多个场景使用此服务,通过此 ID 区分统计数据
			MacAddress	否	String	mac 地址或设备唯一标识
			Imei	否	String	手机设备号
			NeedGetCaptchaTime	否	Integer	是否返回前端获取验证码时间,取值1:需要返回
			* */
			Credential cred = new Credential("你的腾讯云密钥", "你的腾讯云密钥");

			HttpProfile httpProfile = new HttpProfile();
			httpProfile.setEndpoint("captcha.tencentcloudapi.com");

			ClientProfile clientProfile = new ClientProfile();
			clientProfile.setHttpProfile(httpProfile);

			CaptchaClient client = new CaptchaClient(cred, "", clientProfile);
			DescribeCaptchaResultRequest req = new DescribeCaptchaResultRequest();
			// 	固定填值:9。可在控制台配置不同验证码类型
			req.setCaptchaType(9L);
			// 	前端回调函数返回的用户验证票据
			req.setTicket(token);
			// 透传业务侧获取到的验证码使用者的IP,请自己通过业务获取请求者的ip地址
			req.setUserIp("127.0.0.1");
			// 前端回调函数返回的随机字符串
			req.setRandstr(randStr);
			// 验证码应用ID
			req.setCaptchaAppId(你新增验证的CaptchaAppId);
			// 用于服务器端校验验证码票据的验证密钥,请妥善保密,请勿泄露给第三方
			req.setAppSecretKey("你新增验证的密钥AppSecretKey");
			// 是否返回前端获取验证码时间,取值1:需要返回
			req.setNeedGetCaptchaTime(1L);
			// 场景 ID,网站或应用的业务下有多个场景使用此服务,通过此 ID 区分统计数据
			req.setSceneId(1L);
			DescribeCaptchaResultResponse resp = client.DescribeCaptchaResult(req);
			Gson gson = new Gson().newBuilder().create();
			Map map = gson.fromJson(DescribeCaptchaResultResponse.toJsonString(resp), Map.class);
			System.out.println(map);
			if ("ok".equalsIgnoreCase(map.get("CaptchaMsg").toString())){
				// 成功
				return true;
			} else {
				return false;
			}
		} catch (TencentCloudSDKException e) {
			System.out.println(e.toString());
			return false;
		}
	}
	/**
	验证
	*/
	public static void main(String[] args) {
				boolean b = tencentCaptcha("@UP0", "t03cnXnT-SNq8jywYVz4h22VFkNbQxXiShmEomvQRUAXaF9UWJBkLWDyCqZcONCjlYAC3-ytSkQ2IJtrG7xNJwfvvyD-QxgnNL0iSSkXyXGd3ePHFfLI_8FfA**", null);
		System.out.println(b);
	}

}

3.开始与前端进行同步校验

4.校验成功 ok
使用VUE接入腾讯滑块
1. 复制滑块js到全局html页面

2. 编写显示滑块方法
tencentCaptcha() {
      const captchaId = '你的appid' // 腾讯滑块验证码appid
      // 生成一个滑块验证码对象
      const _this = this// 此处处理是因为调用滑块验证码校验方法失效
      // eslint-disable-next-line no-undef
      var captcha = new TencentCaptcha(captchaId,
        function(res) {
          // 后台校验方法
          _this.handleLoginMe(res)// 图形验证码校验
        })
      // 滑块显示
      captcha.show()
}

3.调用后端接口工具类校验方法 传递两个 参数

 handleLoginMe(res) {
      // 后端校验参数()
      this.loginForm.params.randStr = res.randstr
      this.loginForm.params.token = res.ticket
      // 开始登陆请求
      this.$store.dispatch('user/login', this.loginForm).then(() => {
       	// 你的业务逻辑
      }).catch(() => {
      })
    }

2.后端的登陆逻辑配合前面创建的DescribeCaptchaResultUtils工具类来使用


编辑:航网科技   来源:腾讯云

本文版权归原作者所有 转载请注明出处

联系我们

客服部:深圳市龙华区龙胜商业大厦5楼B5区

业务部:深圳市南山区讯美科技广场2栋12楼1202

资质证书

  • Copyright © 2011-2020 www.hangw.com. All Rights Reserved 深圳航网科技有限公司 版权所有 增值电信业务经营许可证:粤B2-20201122 - 粤ICP备14085080号

    在线客服

    微信扫一扫咨询客服


    全国免费服务热线
    0755-36300002

    返回顶部