带你玩转接口管理工具加解密

前言

哈喽，我是树酱。在平时开发过程中，你有没有遇到过跟后端对线的时候，后端说：

  • “切图仔，这个接口的数据需要加密”

  • “切图仔，这个接口返回数据需要解密”

那么到底哪些场景需要加对接口数据进行加密或解密？

场景一：登陆

在数据安全背景下，大部分的登陆接口都需要客户端将用户的用户名、密码等信息进行加密。

举个场景：为了安全起见，后端告知前端调登陆接口的时候，需要先对用户的登陆信息进行AES加密。

我们用接口管理工具Apifox验证一下

Apifox是一款国产热度🔥很高的接口管神器，支持前置操作、后置操作，一般情况下，在发送请求前需要对接口的数据做进一步处理，我们可以通过在前置操作中添加脚本对用户登陆数据进行加密处理

那如何通过Apifox的前置操作对密码进行加密？🤔️

首先，在调试接口的body中定义以下字段

  • password：存储加密后的数据，并设置变量

  • password2：定义加密前的原始数据

img

接下来我们在前置操作面板中，编写前置脚本。同时 Apifox 内置了crypto-js库，基本可以实现各种加密、解密算法。本次使用的是AES算法 步骤如下：👇

  • 1.引入crypto-js内置库

  • 2.通过pm.request.body.formdata 获取 password2参数

  • 3.对数据进行加密

img

  1. var cryptoJs = require("crypto-js");
  2. const password2 = pm.request.body.formdata.get("password2")
  3. const key = cryptoJs.enc.Utf8.parse('******');
  4. const iv = cryptoJs.enc.Utf8.parse('******');
  5. const encrypted = cryptoJs.AES.encrypt(password2, key, {
  6.    iv: iv,
  7.    mode: cryptoJs.mode.CBC,
  8.    padding: cryptoJs.pad.Pkcs7
  9. });

完成以上步骤，即可对数据进行加密处理

场景二：接口签名

接口签名是接口请求的一种常见的场景，那为什么需要对接口进行签名？通常为了防止参数被篡改

接口签名，一般操作步骤是：

  • 拼接成字符串: 按照请求参数名的字母升序排列非空请求参数，使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA；

  • 拼接Secretkey：在stringA最后拼接上Secretkey得到字符串stringSignTemp

  • MD5加密: 对stringSignTemp进行MD5运算

  • 得到sign值:并将得到的字符串所有字符转换为大写，得到sign值。

这里以微信支付签名为例子🌰：

img

🤔️ 那在Apifox这个接口工具如何调试需要接口签名的接口，我们可以怎么做？

以上面微信支付官方签名demo，我们先定义好Query参数 👇

img

然同样在前置脚本中，编辑签名脚本 👇 , 编写完成后点击发送可以看出右侧的控制台输出了最终签名的数据

img

上图中的脚本完整版如下 👇

  1. // 获取预先设置为环境变量的 APPKEY
  2. let key = pm.environment.get("APPKEY");
  4. // 存放所有需要用来签名的参数
  5. let param = {};
  7. // 加入 query 参数
  8. let queryParams = pm.request.url.query;
  9. queryParams.each(item => {
  10.     if (!item.disabled && item.value !== '') { // 启用且非空参数值的参数才参与签名
  11.         param[item.key] = item.value;
  12.     }
  13. });
  15. // 加入 body 参数
  16. if (pm.request.body) {
  17.     let formData;
  18.     switch (pm.request.body.mode) {
  19.         case 'formdata':
  20.             formData = pm.request.body.formdata;
  21.             break;
  22.         default:
  23.             break;
  24.     }
  25.     if (formData) {
  26.         formData.each(item => {
  27.             if (!item.disabled && item.value !== '') { // 启用且非空参数值的参数才参与签名
  28.                 param[item.key] = item.value;
  29.             }
  30.         });
  31.     }
  32. }
  35. // 取 key
  36. let keys = [];
  37. for (let key in param) {
  38.     // 注意这里，要剔除掉 sign 参数本身
  39.     if (key !== 'sign') {
  40.         keys.push(key);
  41.     }
  42. }
  44. // 参数名 ASCII 码从小到大排序（字典序）
  45. keys.sort();
  47. // 转成键值对
  48. let paramPair = [];
  49. for (let i = 0, len = keys.length; i < len; i++) {
  50.     let k = keys[i];
  51.     paramPair.push(k + '=' + encodeURIComponent(param[k])) // urlencode 编码
  52. }
  54. // 最后加上 key
  55. paramPair.push("key=" + key);
  57. // 拼接
  58. let stringSignTemp = paramPair.join('&');
  59. // console.log(stringSignTemp);
  61. let sign = CryptoJS.MD5(stringSignTemp).toString().toUpperCase();
  62. // console.log(sign);
  64. // 方案一：直接修改接口请求的 query 参数，注入 sign，无需使用环境变量。
  65. // 参考文档：https://www.apifox.cn/help/app/scripts/examples/request-handle/
  66. queryParams.upsert({
  67.     key: 'sign',
  68.     value: sign,
  69. });
  71. // 方案二：写入环境变量，此方案需要在接口里设置参数引用环境变量
  72. // pm.environment.set("SIGN", sign);

更详细的操作可以参考官方文档：Apifox 使用文档 - 接口签名

场景三：解密返回数据

当下抓包工具方便开发排查问题的同时，也带来一些新的隐患。数据明文暴露容易，接口内容返回数据加密成为一种基本的使用场景

举个例子：对我个人手机号码进行base64加密, 这里用的是 👇

  1. const phoneNumber = '1591954****'
  2. const wordArray = CryptoJS.enc.Utf8.parse(phoneNumber);
  3. const base64 = CryptoJS.enc.Base64.stringify(wordArray);
  4. //  MTU5MTk1NCoqKio=

你会得到一个字符串信息

🤔️ 同样我们在接口管理工具Apifox中可以对我上文加密后的个人信息进行解密吗？

可以的，这个时候我们使用的就不再是前文提到的前置脚本，而是后置脚本了

这里我通过Apifox的Mock服务去返回上述的base64数据

img

并且在后置操作定义脚本，对该数据进行base64解密，脚本代码实现如下 👇

img

最后

Apifox 是API 开发测试全流程集成工具，除了满足上文提及的API调试、加密、解密、签名等场景之外，还有很多功能包括：

  • 支持数据模型的可视化 API 文档管理

  • API 自动化测试

  • 零配置的 API 数据 Mock

  • 支持代码自动生成、CI 持续集成等等