HttpCanary使用指南——静态注入器
静态注入器是HttpCanary最强大的功能之一,可以实现对Http请求数据和响应数据的拦截修改。静态注入器需要先选定一个请求,然后对其进行预编辑,编辑完成后便可对后续的相同请求进行自动修改。
比如App发往服务器的请求为:https://test.com?city=beijing ,我们可以使用HttpCanary的静态注入器将参数值beijing修改为nanjing 。对App的开发和测试而言,可以模拟很多不同场景的请求,来提高测试效率。
本篇文章将详细讲解如何使用静态注入器。
测试请求范例
https://www.apiopen.top/weatherApi?city=北京
复制代码
创建静态注入器
首先,长按抓包记录,在弹框中选择“静态注入“,然后给注入器命名(方便后面对注入器进行管理)。
命名完成后,进入注入器编辑界面。编辑页面会展示出此请求的所有Http协议数据,包括请求行(Start Line)、请求头(Headers)、请求体(Body)、状态行(StatusLine)、响应头(Headers)、响应体(Body)。
左边Tab是请求数据,右边是响应数据。
关于Http协议的报文结构,下面这张图做了详细描述(图中非范例请求数据),更多内容请见:https://developer.mozilla.org/en-US/docs/Web/HTTP/Messages
在了解Http协议报文之后,我们下面开始讲解如何使用注入器修改数据。
1. URL参数修改
我们希望将请求参数city的值由北京修改为南京。
https://www.apiopen.top/weatherApi?city=南京
复制代码
只需要点击”city=北京“这个参数区域。
打开URL参数编辑页后,将参数值由北京改为南京,并保存。
修改完成后,返回注入器页面。city前面的点颜色由灰色变为绿色,表示参数是修改状态。即如果后续相同请求参数中包含city参数,其值会被强制替换成南京。
点击右上角完成注入器的创建。
下面我们重新用AppTest应用发送一条相同的请求,来测试修改是否能生效。抓到包后,打开抓包内容详情:
由于南京是中文,作为URL一部分会被Encode,不怕,我们点击这个URL打开URL预览页:
我们最后再来看看响应数据,确认下是否是真的生效了。
完美!
2. URL参数添加和删除
如果我们希望将请求修改为这种:
https://www.apiopen.top/weatherApi?province=江苏&days=7
复制代码
即删除city参数,新增province和days参数。
同样先按照上一步的步骤打开静态注入器编辑页面。点击city参数右侧的三个点按钮,打开功能选择弹框,一共有三个选项:跟随,自定义,禁用。
这里解释下三个选项的含义。
- 跟随,表示使用原始数据,不做任何修改(默认选项),颜色为灰色。
- 自定义,表示强行覆盖或添加设定的参数值,颜色为绿色。
- 禁用,表示强行删除此参数和值,颜色为红色。
所以,删除city参数,我们选择禁用选项,注意参数前面的点变成了红色。
下一步,点击新增按钮添加两个参数,province=江苏和days=7。
点击右上角保存,完成注入器创建后,我们重新再发一条请求,看看效果。
很明显,city参数没有了,多了province和days两个参数。
完美!
3. Headers修改、添加和删除
同上面URL操作相同,参考1和2,不再赘述。
4. 响应行(Status Line)修改
Http协议中响应行用来表示请求服务的结果状态,比如常用的200表示成功,404表示资源未找到,500表示服务器异常等等。
有的时候为了测试一些极端情况,比如服务器不返回200而是404,App状态是否会出现bug等。我们可以使用HttpCanary来强行修改响应行中的状态码来实现这种效果。
点击编辑按钮,打开列表,其中列出来几乎所有常用的响应行(都是标准响应行),我们从列表中选择404 Not Found。
选择后自动返回,如果想撤销操作,点击右边复位按钮。
我们点击右上角保存按钮完成注入器的创建,重新用AppTest应用发送一条相同请求。从下图中能看出,后面接收到的请求已经是404 Not Found了。
完美!
5. 请求/响应体(Body)修改
在App实际开发和测试中,修改请求数据和返回数据是最经常用到的。比如,测试地理位置相关接口时,需要修改经纬度;再比如,服务器返回了某些时间戳,我们希望将其延长或者缩短。
同样以此天气接口为例,希望将响应体中的yesterday的high改为100℃,low改为-100℃,type改为冰雹
打开创建静态注入器的页面后,拉到最下面。点击右侧向上的箭头,选择编辑方式。
静态注入器提供了两种方式用来编辑Body:上传文件和直接编辑。如果Body是二进制格式数据(比如音频、视频、ProtoBuffer等),HttpCanary内置的文本编辑器是无法处理的,只能使用上传文件的方式。如果Body是json、xml、fromdata等文本格式,可以使用直接编辑。
由于接口返回的天气数据是JSON格式,我们可以使用直接编辑选项,打开后直接进行数据修改。
保存后完成静态注入器的创建,用AppTest应用再发送一条相同请求,来看看结果。
修改成功!完美!
5. 静态注入器管理
静态注入器和我们常用的断点(BreakPoint)方式修改数据不同,它是通过预设的方式来拦截和修改数据,可以极大地提高数据修改的效率。
HttpCanary可以对一个请求配置多个静态注入器,按照先配置先生效的原则进行拦截处理。静态注入器一旦创建了,将会以Mod的形式作为插件功能存在于HttpCanary中,即使是杀掉HttpCanar APP后再重启也能生效。
那我们如何对注入器进行管理呢?打开设置->模组管理页面,能看到所有创建的静态注入器。
点击进入详情后,能看到注入器是属于哪个请求的。
如果需要删除或者禁用已经创建的静态注入器,只需要在列表页长按打开功能选项即可!
结语
如果您对HttpCanary有任何疑问或者建议,可以访问HttpCanary Github并创建issue!
静态注入器的使用指南到此结束,感谢您的阅读!
作者:MegatronKing
链接:https://juejin.im/post/5c795b6d51882523f026826b
来源:掘金
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。