Anyproxy-rule模块实现拦截修改请求及内容功能

短命女 2021-12-12 04:57 431阅读 0赞

# 前言 #

AnyProxy不仅仅可以抓包，还可以拦截请求并修改服务端响应，实现接口mock功能。  
面试时候经常会问到第三方支付如何测试这种，如果对接的第三方没提供测试环境，那么就需要搭建一个mock服务器，模拟支付接口返回的各种情况。

# rule模块 #

AnyProxy提供了二次开发的能力，你可以用js编写自己的规则模块（rule），来自定义网络请求的处理逻辑。

> 注意：引用规则前，请务必确保文件来源可靠，以免发生安全问题

*  拦截并修改正在发送的请求

可修改内容包括请求头（request header)，请求体（request body），甚至是请求的目标地址等

*  拦截并修改服务端响应

可修改的内容包括http状态码(status code)、响应头（response header）、响应内容等

*  拦截https请求，对内容做修改

本质是中间人攻击（man-in-the-middle attack），需要客户端提前信任AnyProxy生成的CA

# 开发示例 #

举个栗子： 需要编写一个规则模块，在 GET [http://httpbin.org/user-agent][http_httpbin.org_user-agent] 的返回值里加上测试信息，并延迟5秒返回

Step 1，编写规则如下， 保存为sample.js文件，可以放电脑任意位置

// file: sample.js module.exports = { summary: 'a rule to hack response', *beforeSendResponse(requestDetail, responseDetail) { if (requestDetail.url === 'http://httpbin.org/user-agent') { const newResponse = responseDetail.response; newResponse.body += '- AnyProxy Hacked!'; return new Promise((resolve, reject) => { setTimeout(() => { // delay resolve({ response: newResponse }); }, 5000); }); } }, };

Step 2, 启动AnyProxy，加载规则

> anyproxy -i --rule sample.js

当看到出现：Active rule is: a rule to hack response 那就是加载成功了

![1070438-20190515235424666-1020251690.png][]

Step 3, 测试规则

用curl测试

> curl [http://httpbin.org/user-agent][http_httpbin.org_user-agent] --proxy [http://127.0.0.1:8001][http_127.0.0.1_8001]

![1070438-20190515235544364-147196490.png][]

也可以使用浏览器测试，配置浏览器http代理为 127.0.0.1:8001，访问 [http://httpbin.org/user-agent][http_httpbin.org_user-agent]， 经过代理服务器后，期望的返回如下

{
      "user-agent": "curl/7.43.0" } - AnyProxy Hacked!

Step 4, 查看请求信息.浏览器访问http://127.0.0.1:8002 ，界面上能看到刚才的请求信息

![1070438-20190515235829034-1555677926.png][]

# 处理流程 #

当http请求经过代理服务器时，具体处理过程是：

\-收集请求所有请求参数，包括method, header, body等

*  AnyProxy调用规则模块beforeSendRequest方法，由模块做处理，返回新的请求参数，或返回响应内容
 *  如果beforeSendRequest返回了响应内容，则立即把此响应返回到客户端（而不再发送到真正的服务端），流程结束。
 *  根据请求参数，向服务端发出请求，接收服务端响应。
 *  调用规则模块beforeSendResponse方法，由模块对响应内容进行处理
 *  把响应信息返回给客户端

当代理服务器收到https请求时，AnyProxy可以替换证书，对请求做明文解析。

*  调用规则模块beforeDealHttpsRequest方法，如果返回true，会明文解析这个请求，其他请求不处理
 *  被明文解析后的https请求，处理流程同http一致。未明文解析请求不会再进入规则模块做处理。

![1070438-20190516000516999-1572773303.png][]

# 如何引用 #

如下几种方案都可以用来引用规则模块：

使用本地路径

> anyproxy --rule ./rule.js

使用在线地址

> anyproxy --rule [https://sample.com/rule.js][https_sample.com_rule.js]

使用npm包,AnyProxy使用require()加载本地规则，你可以在参数里传入一个本地的npm包路径，或是某个全局安装的npm包

> anyproxy --rule ./myRulePkg/ \#本地包 npm i -g myRulePkg && anyproxy --rule myRulePkg \#全局包

# rule接口文档 #

规则模块应该符合cmd规范，一个典型的规则模块代码结构如下。模块中所有方法都是可选的，只需实现业务感兴趣的部分即可。

module.exports = { // 模块介绍 summary: 'my customized rule for AnyProxy', // 发送请求前拦截处理 *beforeSendRequest(requestDetail) { /* ... */ }, // 发送响应前处理 *beforeSendResponse(requestDetail, responseDetail) { /* ... */ }, // 是否处理https请求 *beforeDealHttpsRequest(requestDetail) { /* ... */ }, // 请求出错的事件 *onError(requestDetail, error) { /* ... */ }, // https连接服务器出错 *onConnectError(requestDetail, error) { /* ... */ } };

更多资料参考anyproxy 官方文档[https://github.com/alibaba/anyproxy/blob/master/docs/cn/src\_doc.md][https_github.com_alibaba_anyproxy_blob_master_docs_cn_src_doc.md]

转自：[https://www.cnblogs.com/yoyoketang/p/10873026.html][https_www.cnblogs.com_yoyoketang_p_10873026.html]

[http_httpbin.org_user-agent]: http://httpbin.org/user-agent
[1070438-20190515235424666-1020251690.png]: /images/20211211/7cdb2994aa1c4a088483b0904f3c1aff.png
[http_127.0.0.1_8001]: http://127.0.0.1:8001/
[1070438-20190515235544364-147196490.png]: /images/20211211/2f2a26472de2459cb4d95562888c4623.png
[1070438-20190515235829034-1555677926.png]: /images/20211211/cab666811f2547faaa5f7ba18f78e570.png
[1070438-20190516000516999-1572773303.png]: /images/20211211/5e638bce4d2c4ee3856f5963a2473f78.png
[https_sample.com_rule.js]: https://sample.com/rule.js
[https_github.com_alibaba_anyproxy_blob_master_docs_cn_src_doc.md]: https://github.com/alibaba/anyproxy/blob/master/docs/cn/src_doc.md
[https_www.cnblogs.com_yoyoketang_p_10873026.html]: https://www.cnblogs.com/yoyoketang/p/10873026.html