SpringBoot2 API接口签名实现(接口参数防篡改)

最新推荐文章于 2025-06-02 15:27:31 发布

转载

最新推荐文章于 2025-06-02 15:27:31 发布 · 9.5k 阅读

35 ·

CC 4.0 BY-SA版权

原文链接：https://juejin.im/post/5cf0a1316fb9a07ef3764eb4

文章标签：

#java #json #前端 #ViewUI

本文介绍了如何在SpringBoot2项目中实现API接口签名，以确保参数在传输过程中的安全性。通过使用MD5加密和ASCII码排序，确保前端和后端都能校验参数是否被篡改。文章提供了前端和后端的代码示例，并提到了涉及的第三方技术如js-md5和axios。

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

简介

现在越来越多人关注接口安全，传统的接口在传输的过程中，容易被抓包然后更改里面的参数值达到某些目的。
传统的做法是用安全框架或者在代码里面做验证，但是有些系统是不需要登录的，随时可以调。
这时候我们可以通过对参数进行签名验证，如果参数与签名值不匹配，则请求不通过，直接返回错误信息。

项目代码地址：

github.com/MrXuan3168/…

测试

启动项目
GET请求可以用浏览器直接访问 http://localhost:8080/signTest?sign=A0161DC47118062053567CDD10FBACC6&username=admin&password=admin
- A0161DC47118062053567CDD10FBACC6 是 username=admin&password=admin MD5加密后的结果。可以打开 md5jiami.51240.com/ 然后输入 {"password":"admin","username":"admin"} 进行加密验证，json字符串里面，必须保证字段是按照 ascll码进行排序的,username的ascll码比 password的ascll码大，所以要放在后面。
打开 postman 进行POST请求测试，请求Url为 http://localhost:8080/signTest?sign=A0161DC47118062053567CDD10FBACC6 参数为
```
  {
      "username":"admin",
      "password":"admin"
  }
复制代码
```

调用过程

涉及第三方技术

前端：js-md5(vue md5-npm包)、axios(vue ajax请求npm包)
- 安装命令
```
 npm install js-md5
 npm install axios
复制代码
```

后端: fastjson、lombok

     <dependency>
         <groupId>org.projectlombok</groupId>
         <artifactId>lombok</artifactId>
         <optional>true</optional>
     </dependency>
     <dependency>
         <groupId>com.alibaba</groupId>
         <artifactId>fastjson</artifactId>
         <version>1.2.47</version>
         <scope>compile</scope>
     </dependency>
复制代码

签名逻辑

前端（客户端）： 1.不管GET Url 还是 POST Body 的参数，都转换成 json 对象，用 ascll码排序对参数排序。 2.排序后对参数进行MD5加密，存入 sign 值。 3.把 sign 值放在请求URL 后面或者 Head头里面(该项目直接放在URL后面)。
后端（服务端）： 1.把参数接收，转成 json对象，用 ascll码排序 2.排序后对参数进行MD5加密，存入 paramsSign 值。 3.和请求URL 中的 sign值做对比，相同则请求通过。

前端代码

加密工具类

import md5 from 'js-md5'

export default class signMd5Utils {
    /**
     * json参数升序
     * @param jsonObj 发送参数
     */

    static sortAsc(jsonObj) {
        let arr = new Array();
        let num = 0;
        for (let i in jsonObj) {
            arr[num] = i;
            num++;
        }
        let sortArr = arr.sort();
        let sortObj = {};
        for (let i in sortArr) {
            sortObj[sortArr[i]] = jsonObj[sortArr[i]];
        }
        return sortObj;
    }


    /**
     * @param url 请求的url,应该包含请求参数(url的?后面的参数)
     * @param requestParams 请求参数(POST的JSON参数)
     * @returns {string} 获取签名
     */
    static getSign(url, requestParams) {
        let urlParams = this.parseQueryString(url);
        let jsonObj = this.mergeObject(urlParams, requestParams);
        let requestBody = this.sortAsc(jsonObj);
        return md5(JSON.stringify(requestBody)).toUpperCase();
    }

    /**
     * @param url 请求的url
     * @returns {
    
    {}} 将url中请求参数组装成json对象(url的?后面的参数)
     */
    static parseQueryString(url) {
        let urlReg = /^[