快速接入Google两步认证Google Authenticator

已于 2023-03-20 16:55:42 修改
阅读量2.9w 收藏 48
点赞数 12
分类专栏： google 认证 文章标签： java spring maven tomcat java-ee
于 2021-08-14 12:30:55 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/tanyu159/article/details/119698790
版权
本文详细介绍了谷歌两步验证的工作原理和用户绑定过程，并提供了Java实现的相关代码，包括生成随机秘钥、校验验证码、生成二维码等步骤。此外，还分享了登录时如何检查和验证6位验证码，以及注意事项，确保验证码的有效性和安全性。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

(一)介绍

 

 既然来看该文章就应该知道Google的两步认证是干什么的，这边再提供一次app的下载链接

(apkpure搜索谷歌身份验证器)

 验证原理讲解：

  1. 在数据库中查找该登陆用户之前绑定的32位随机码（该码一般会存入数据库）
  2. 调用API传入32位随机码，生成正确的6位验证码（每隔1min会变化）
  3. 根据用户输入的6位验证码和正确的6位验证码做匹配，相同则登陆成功，不同则验证码时间失效或错误

用户绑定讲解：

  1. 调用API生成32位随机码，准备绑定给用户
  2. 调用API生成二维码QR字符串，需要传入用户信息（比如邮箱,id,昵称等），标题，以及生成的32位随机码
  3. 调用API将二维码QR字符串转化为图片后以Base64的方式展现到前端页面上
  4. 用户使用app扫码添加后，在前端页面点击确认绑定，输入本次看到的6位验证码
  5. 后端根据本次获得的32位随机码，用户信息（用来确定数据库中用户记录），以及输入6位验证码，通过API传入32位随机码获得正确的6位验证码，当其与输入的验证码相同时，则绑定成功，把32位随机码持久化到数据库中对应用户记录上

（二）准备工作

 导入一下Maven依赖

         <!--google两步认证相关-->
        <dependency>
            <groupId>de.taimos</groupId>
            <artifactId>totp</artifactId>
            <version>1.0</version>
        </dependency>

        <dependency>
            <groupId>commons-codec</groupId>
            <artifactId>commons-codec</artifactId>
            <version>1.10</version>
        </dependency>

        <dependency>
            <groupId>com.google.zxing</groupId>
            <artifactId>javase</artifactId>
            <version>3.2.1</version>
        </dependency>

 导入工具类GoogleAuthenticationTool

import com.google.zxing.BarcodeFormat;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.WriterException;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.common.BitMatrix;
import de.taimos.totp.TOTP;
import org.apache.commons.codec.binary.Base32;
import org.apache.commons.codec.binary.Hex;
import sun.misc.BASE64Encoder;

import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.*;
import java.net.URLEncoder;
import java.security.SecureRandom;

/**
 * @Author bilibili-nanoda
 * @Date 2021/8/13 10:33
 * @Version 1.0
 */
public class GoogleAuthenticationTool {

    public static String generateSecretKey() {
        SecureRandom random = new SecureRandom();
        byte[] bytes = new byte[20];
        random.nextBytes(bytes);
        Base32 base32 = new Base32();
        return base32.encodeToString(bytes);
    }

    /**
     * 根据32位随机码获得正确的6位数字
     *
     * @param secretKey
     * @return
     */
    public static String getTOTPCode(String secretKey) {
        Base32 base32 = new Base32();
        byte[] bytes = base32.decode(secretKey);
        String hexKey = Hex.encodeHexString(bytes);
        return TOTP.getOTP(hexKey);
    }


    /**
     * 生成绑定二维码（字符串）
     *
     * @param account   账户信息（展示在Google Authenticator App中的）
     * @param secretKey 密钥
     * @param title     标题 （展示在Google Authenticator App中的）
     * @return
     */
    public static String spawnScanQRString(String account, String secretKey, String title) {
        try {
            return "otpauth://totp/"
                    + URLEncoder.encode(title + ":" + account, "UTF-8").replace("+", "%20")
                    + "?secret=" + URLEncoder.encode(secretKey, "UTF-8").replace("+", "%20")
                    + "&issuer=" + URLEncoder.encode(title, "UTF-8").replace("+", "%20");
        } catch (UnsupportedEncodingException e) {
            throw new IllegalStateException(e);
        }
    }

    /**
     * 生成二维码（文件）【返回图片的base64，若指定输出路径则同步输出到文件中】
     *
     * @param barCodeData 二维码字符串信息
     * @param outPath     输出地址
     * @param height
     * @param width
     * @throws WriterException
     * @throws IOException
     */
    public static String createQRCode(String barCodeData, String outPath, int height, int width)
            throws WriterException, IOException {
        BitMatrix matrix = new MultiFormatWriter().encode(barCodeData, BarcodeFormat.QR_CODE,
                width, height);
        BufferedImage bufferedImage = MatrixToImageWriter.toBufferedImage(matrix);

        ByteArrayOutputStream bof = new ByteArrayOutputStream();
        ImageIO.write(bufferedImage, "png", bof);
        String base64 = imageToBase64(bof.toByteArray());
        if(outPath!=null&&!outPath.equals("")) {
            try (FileOutputStream out = new FileOutputStream(outPath)) {
                MatrixToImageWriter.writeToStream(matrix, "png", out);
            }
        }
        return base64;
    }

    /**
     * 将图片文件转换成base64字符串，参数为该图片的路径
     *
     * @param dataBytes
     * @return java.lang.String
     */
    private static String imageToBase64(byte[] dataBytes) {
        // 对字节数组Base64编码
        BASE64Encoder encoder = new BASE64Encoder();
        if (dataBytes != null) {
            return "data:image/jpeg;base64," + encoder.encode(dataBytes);// 返回Base64编码过的字节数组字符串
        }
        return null;
    }

}

（三）使用流程

Tips:其实看工具类就已经知道怎么使用了，但我这边还是贴出我的代码以供参考

  • 首次绑定逻辑判断

UserController的login中判断该登陆用户是否存在32位随机码

    //登陆逻辑
    @PostMapping("/login")
    public String login(WebLoginDTO webLoginDTO, HttpSession httpSession, Model model, HttpServletRequest httpServletRequest,RedirectAttributes redirectAttributes) {
        System.out.println("尝试登录：" + webLoginDTO.getEmail() + ":" + webLoginDTO.getEmail());
        Subject subject = SecurityUtils.getSubject();
        UsernamePasswordToken token = new UsernamePasswordToken(webLoginDTO.getEmail(), webLoginDTO.getPassword());
        try {
            subject.login(token);
        } catch (IncorrectCredentialsException e) {
            e.printStackTrace();
            model.addAttribute("msg", "密码错误");
            return "error/systemError";
        } catch (AuthenticationException e) {
            e.printStackTrace();
            model.addAttribute("msg", "账户不存在");
            return "error/systemError";
        }
        //说明登录成功
        ActiveUser activeUser = (ActiveUser) subject.getPrincipal();
        if (activeUser.isLokced()) {
            model.addAttribute("msg", "账户被封锁");
            return "error/systemError";
        }
        //没有32位随机码的情况
        if(activeUser.getTwoFactorCode()==null||activeUser.getTwoFactorCode().equals(""))            
        {
            //前往code绑定页面
            redirectAttributes.addAttribute("userId",activeUser.getUser_id());
            //todo 处理设计该页面绑定谷歌认证码（QR二维码）
            return "redirect:/user/bindingGoogleTwoFactorValidate";
        }

  不存在则定向到 绑定页面（要携带用户信息，如id）

    /**
     * 前往谷歌两步验证绑定页面
     * @param userId
     * @return
     */
    @GetMapping("/bindingGoogleTwoFactorValidate")
    public String toBindingGoogleTwoFactorValidate(@RequestParam("userId")int userId,Model model){
        String randomSecretKey = GoogleAuthenticationTool.generateSecretKey();
        User user = userService.getUserByUserId(userId);
        //此步设置的参数就是App扫码后展示出来的参数
        String qrCodeString = GoogleAuthenticationTool.spawnScanQRString(user.getEmail(),randomSecretKey,"pilipili2333");
        String qrCodeImageBase64 = null;
        try {
             qrCodeImageBase64 = GoogleAuthenticationTool.createQRCode(qrCodeString,null,512,512);
        } catch (WriterException | IOException e) {
            e.printStackTrace();
        }
        model.addAttribute("randomSecretKey",randomSecretKey);
        model.addAttribute("qrCodeImageBase64",qrCodeImageBase64);

        return "bindingGoogleTwoFactorValidate";
    }

前端页面发起ajax执行绑定，且输入本次的6位验证码做校验

function confirmBinding() {
    var googleRegex =/\d{6}/;
    var inputGoogleCode = window.prompt("请输入6位google验证码");
    if(googleRegex.test(inputGoogleCode)){
        $.ajax({
            url:"[[@{/user/bindingGoogleTwoFactorValidate}]]",
            type:"post",
            data:{
                "userId":"[[${param.userId}]]",
                "randomSecretKey":"[[${randomSecretKey}]]",
                "inputGoogleCode":inputGoogleCode

            },
            dataType:"json",
            success:function (data) {
                if(data.state==='success'){
                    window.alert("绑定成功");
                }else if(data.state==='fail'){
                    window.alert("操作失败："+data.msg);
                }
            }
        });
    }else {
        window.alert("请正确输入6位google验证码")
    }

}

 后端对执行绑定再做一次6位验证码是否正确的校验

     /**
     * 执行谷歌两步验证绑定
     * @return
     */
    @PostMapping("/bindingGoogleTwoFactorValidate")
    @ResponseBody
    public String bindingGoogleTwoFactorValidate(@RequestParam("userId")int userId,@RequestParam("randomSecretKey")String randomSecretKey,@RequestParam("inputGoogleCode")String inputGoogleCode){
        JSONObject respJsonObj =new JSONObject();
        User user = userService.getUserByUserId(userId);
        if(user.getTwoFactorCode()!=null&&!user.getTwoFactorCode().equals("")){
            respJsonObj.put("state","fail");
            respJsonObj.put("msg","该用户已经绑定了，不可重复绑定，若不慎删除令牌，请联系管理员重置");
            return respJsonObj.toString();
        }
        String rightCode =GoogleAuthenticationTool.getTOTPCode(randomSecretKey);
        if(!rightCode.equals(inputGoogleCode)){
            respJsonObj.put("state","fail");
            respJsonObj.put("msg","验证码失效或错误，请重试");
            return respJsonObj.toString();
        }
        user.setTwoFactorCode(randomSecretKey);
        int res = userService.updateUserByUser(user);

        if(res>0){
            respJsonObj.put("state","success");
        }else {
            respJsonObj.put("state","fail");
            respJsonObj.put("msg","数据库操作失败");
        }
        return respJsonObj.toString();
    }

  • 登陆时校验6位验证码的逻辑

UserController的login方法中处理

@PostMapping("/login")
    public String login(WebLoginDTO webLoginDTO, HttpSession httpSession, Model model, HttpServletRequest httpServletRequest,RedirectAttributes redirectAttributes) {
        System.out.println("尝试登录：" + webLoginDTO.getEmail() + ":" + webLoginDTO.getEmail());
        /*
         shiro认证相关代码。。。
        */
        //注意：1min内有效
        String rightGoogleCode = GoogleAuthenticationTool.getTOTPCode(activeUser.getTwoFactorCode());
        if(!webLoginDTO.getGoogleCode().equals(rightGoogleCode)){
            model.addAttribute("msg","谷歌验证码不正确或已超时");
            return "error/systemError";
        }
        /*
         后续逻辑
        */
        
}

需要注意：

与短信验证，邮件验证不同，验证码的生成与刷新是由我们自己控制的，而对于这种谷歌两步认证，他是1min刷新一次，对于同时刻，我们事先约定好了一套加密解密规则。因此在进行输入的6位验证码验证时，应当在输入之后再去获得此刻正确的6位CODE，而不是事先生成好正确的Code，再等用户输入。后者可能会因为延时问题（用户动作很摸，app上的已经更新了，但系统保留的还是上一次），导致经常性的验证码失效

更多教程，可见我的官方网站：最咔酷线上教程：www.zuikakuedu.cn

HTTP状态码有哪些？分别代表是什么意思
IT修真院：初学者转行到互联网的聚集地
05-14 1606
这里是修真院web小课堂，每篇分享文从 【背景介绍】【知识剖析】【常见问题】【解决方案】【编码实战】【扩展思考】【更多讨论】【参考文献】 八个方面深度解web知识/技能，本篇分享的是： 【 HTTP状态码有哪些？分别代表是什么意思】 大家好，我是IT修真院武汉分院第五期的学员，一枚正直纯洁善良的web程序员 今天给大家分享一下，HTTP状态码有哪些？分别代表是什么意思？ 1.背景介...
HTTP状态码及含义大全
Sime507的专栏
07-15 2024
HTTP状态码及含义大全 当用户在防问Internet信息服务(IIS)的服务器上的内容时时，IIS服务器响应请求，会自动返回一个表示该请求的状态的数字代码，提供关于相关请求的状态信息。同样当搜索引擎蜘蛛在抓取的过程中，服务器也会相关的http状态码，通过了解http状态代码，可以更详细的分析日志中的访问情况，下面Seoer惜缘收集的http状态代码含义表与部分解决方法： 　　100 - 表示
常见的 14 个 HTTP 状态码详解
最新发布
chirrupy_hamal的博客
04-14 1582
常见的 14 个 HTTP 状态码详解
http状态码有那些，分别代表什么意思
qq_43364234的博客
02-28 397
1**(信息类)：表示接收到请求并且继续处理 100——客户必须继续发出请求 101——客户要求服务器根据请求转换HTTP协议版本 2**(响应成功)：表示动作被成功接收、理解和接受 200——表明该请求被成功地完成，所请求的资源发送回客户端 201——提示知道新文件的URL 202——接受和处理、但处理未完成 203——返回信息不确定或不完整 204——请求收到，但返回信息为空 205——服务器...
HTTP响应码
yongzhewuwei_2008的专栏
08-14 1024
一、HTTP响应码响应码由三位十进制数字组成，它们出现在由HTTP服务器发送的响应的第一行。响应码分五种类型，由它们的第一位数字表示：1.1xx：信息，请求收到，继续处理2.2xx：成功，行为被成功地接受、理解和采纳3.3xx：重定向，为了完成请求，必须进一步执行的动作4.4xx：客户端错误，请求包含语法错误或者请求无法实现5.5xx：服务器错误，服务器不能实现一种明显无效的请求下表显示每个响
HTTP 1.1状态代码
weixin_33962923的博客
05-15 201
下表显示了常见的HTTP 1.1状态代码以及它们对应的状态信息和含义。 应当谨慎地使用那些只有HTTP 1.1支持的状态代码，因为许多浏览器还只能够支持HTTP 1.0。如果你使用了HTTP 1.1特有的状态代码，最好能够检查一下请求的HTTP版本号。 状态代码 ...
http状态码总结
AlexYBB的专栏
08-22 601
http状态码
HTTP的常见状态码有哪些，代表什么含义？
Mark66890620
03-23 842
首先状态码的开头不同代表不同的类型： 1xx：代表指示信息，表示请求已接收，继续处理 2xx：代表成功，表示请求已被成功接收，理解，接受 3xx：重定向，表示完成请求必须进行进一步的操作 4xx：客户端错误，请求有语法错误或请求无法实现 5xx：服务器端错误，服务器未能实现合法的请求 常见状态码： 200OK：正常返回信息 400BadRequest：客户端请求有语法错误，不能被服务器所理解 403Forbidden：服务器收到请求，但是拒绝提供服务 404NotFound：请求资源不存
http状态码
weixin_34007291的博客
08-14 137
100 客户端应当继续发送请求。这个临时响应是用来通知客户端它的部分请求已经被服务器接收，且仍未被拒绝。客户端应当继续发送请求的剩余部分，或者如果请求已经完成，忽略这个响应。服务器必须在请求完成后向客户端发送一个最终响应。101 服务器已经理解了客户端的请求，并将通过Upgrade 消息头通知客户端采用不同的协议来完成这个请求。在发送完这个响应最后的空行后，服务器将会切换到在...
HTTP状态代码及其含义
weixin_52579117的博客
04-17 1692
目录 1.常见的状态代码： 200（成功） 400（错误请求） 404（未找到） 500（服务器内部错误） 2.http状态代码： 1.2XX（请求成功） 2.3XX（重定向） 3.4XX（请求错误） 4.5XX（服务器错误） 　　 1.常见的状态代码： 200（成功） 服务器已成功处理了请求并提供了请求的网页。 400（错误请求） 请求格式错误。 原因及解决方法： 1）前端提交数据的字段名称或者是字段类型和后台的实体类不一致，导致无法封装；前端提交的到后台的数据应该
HTTP状态的含义（HTTP100，HTTP304等）
酱油家的老陈醋
12-11 1412
转载自http://www.kuqin.com/web/20090913/68714.html 下表显示了常见的HTTP 1.1状态代码以及它们对应的状态信息和含义。 应当谨慎地使用那些只有HTTP 1.1支持的状态代码，因为许多浏览器还只能够支持HTTP 1.0.如果你使用了HTTP 1.1特有的状态代码，最好能够检查一下请求的HTTP版本号。 状态代码
Nginx#Http协议状态码含义
kakaops_qing的博客
10-08 1918
http协议状态码
常见的HTTP状态码
weixin_30681615的博客
07-25 571
本内容摘抄自RESTful WebServices 中文译本附录B '42种常见的HTTP响应代码'。 原文作者：Leonard Ricbardson & Sam Ruby 翻译：徐涵、李红军、胡伟 1、三至七种最基本的响应代码 200("OK") 一切正常。实体主体中的文档（若存在的话）是某资源的表示。 500("Bad Request") 客户端方面的问题。实体主题中的文档（若存在的...
HTTP的状态码及其含义：
weixin_40279039的博客
11-01 578
HTTP的状态码及其含义： 1xx——信息提示 这些状态代码表示临时的响应。客户端在收到常规响应之前，应准备接收一个或多个 1xx 响应。 • 100——Continue 初始的请求已经接受，客户应当继续发送请求的其余部分。（HTTP 1.1新） • 101——Switching Protocols 服务器将遵从客户的请求转换到另外一种协议。（HTTP 1.1新） 2xx——成功 这类...
HTTP状态码及其含义
u011927449的博客
11-05 122
1XX ：信息状态码 　　100 Continue 继续，一般在发送 post 请求时，已发送了 http header 之后服务端 将返回此信息，表示确认，之后发送具体参数信息 2XX ：成功状态码...
Java网络编程基础：HTTP状态码详解
在Java中，`HttpURLConnection` 类提供了对HTTP协议的支持，并且内置了一系列常量，这些常量与HTTP状态码相对应，比如 `HttpURLConnection.HTTP_OK` 代表200状态码，`HttpURLConnection.HTTP_UNAUTHORIZED` 对应401...
评论 23
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

最咔酷学院

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值