【Fiddler篇】FreeHttp无限篡改http报文数据调试和mock服务
目錄
- 引言
- FreeHttp起源
- ?FreeHttp 插件安裝
- FreeHttp 基本界面
- 一：規則匹配區
- 1.1：『get http sesion in left session list』獲取Session信息
- 1.2：『select url filter method』Url匹配方式
- 1.3：『edit advanced http filter』高級匹配
- 1.4：『new or edit rule』創建規則
- 二：請求或響應篡改規則編輯區域
- 2.1：『Request Modific』請求修改
- 2.2：『Request Replace』請求替換
- 2.3：『Response Modific』響應修改
- 2.4：『Response Replace』響應替換
- 三：規則編輯控制條及常規設置編輯區域
- 3.1『affirm rule』確認創建規則或保存規則修改
- 3.2『cancel edit』取消
- 3.3『set response latency』 設置響應延時
- 3.4『set parameter pick info』設置參數化數據獲取規則
- 3.5『Quick Rule』快速規則
- 3.6『Modific Tool』篡改工具及常規設置
- 四：『Execution Log』執行日志
- 五：『Tamper Rule』篡改規則列表
- 5.1 Tamper Rule控制選項
- 5.2 Tamper Rule信息顯示
- 5.3 Rule的編輯及排序
- 六：快速入門
- 七：簡單實踐
- 八：參數化數據設置
- 8.1 『parameter data manage』參數化數據管理器
- 8.2 在規則中使用參數化數據
- 8.3 動態拾取參數化數據
- 8.4 參數化數據示例
- 實現及源碼
?
引言
FreeHttp是一個Fiddler插件借助FreeHttp您可按照您自己的設定修改請求或響應報文，這對測試及調試都非常有用
比如您發現線上頁面js文件錯誤，直接使用規則替換新的js文件您可以在不對線上服務做任何改動的情況下直接在線上驗證
同樣在發現服務接口數據不符合預期時也可以直接修改驗證，甚至可以清除手機瀏覽器或微信服務號的登陸狀態
希望在您了解其基本功能及工作原理后，可以在實際工作中為您提供便利
?
FreeHttp起源
如今互聯網或IT行業幾乎跟HTTP已經分不開了，系統與系統之間的聯系相當一部分都需要借助HTTP，在平時的工作中（特別是測試工作）漸漸的會發現自己除了對抓取HTTP報文有需求，很多時候更需要篡改HTTP報文輔助測試或調試。
Fiddler實際已經提供斷點，AutoResponder及FiddlerScript 功能可以直接或間接實現報文篡改功能，不過使用過程中會發現，他們在很多情況下操作難度較大限制也多，甚至有些情況達不到我的需求。
為了滿足自己的一些特定需求，借助Fiddler擴展接口自己慢慢為其編寫開發了插件，后來隨著工作需要為插件添加的功能越來越多，自己就萌生了把功能實現成通用的形式或許可以給其他同學提供幫助（也就成為了FreeHttp的雛形）
之后利用業余時間逐步整理實現了當前版本的功能，由于時間以及水平方面的限制，相信FreeHttp依然存在許多缺陷及不足的地方，也希望大家能多包涵。發現問題可以直接提出，我會盡快修復，希望能為大家的工作提供便利。
?
?
FreeHttp篡改http報文的基本實現過程如上圖（綠線代表http請求，黃線代表http響應）
FreeHttp獲取請求及響應需要依賴fiddler代理，也就是說只要連接fiddler代理的終端設備的http請求報文都可以被FreeHttp篡改，同樣支持對https的篡改(當遇到http2.0請求時會先降級到http1.1，再進行報文篡改)
FreeHttp 插件安裝
1：您的計算機需要已經安裝Fiddler?（如未安裝，請至官網下載安裝?http://docs.telerik.com/fiddler/configure-fiddler/tasks/configurefiddler）
2：進入Fiddler安裝目錄的Scripts目錄下，將FreeHttp.dll復制到該目錄下即可? (文件下載請至：https://files.cnblogs.com/files/lulianqi/FreeHttp1.2.zip? 或?http://lulianqi.com/file/FreeHttp1.2.zip? ?解壓可得到?FreeHttp.dll? ）
3：重啟Fiddler即可在面板中出現?FreeHttp?標簽
?
?
備注：??由于本文篇幅較長，如果您當前時間不充裕或暫時不打算查看 FreeHttp的詳細功能，建議您直接閱讀第6章節【六：快速入門】，第7章節【七：簡單實踐】（這2章節有可以幫您快速了解FreeHttp的基本功能）
? ? ? ? ? ? 如果您對FreeHttp的代碼實現感興趣，或您打算修改FreeHttp的功能，您可以在末尾章節【實現及源碼】找到相關內容（源代碼地址及工程結構簡介）
?
FreeHttp 基本界面
基本操作界面如下圖，主要分為5個部分
? ? ? ? ?當請求發出或接收到響應時，freehttp會在篡改規則列表中匹配篡改規則（匹配使用Url Filter中的內容），如果匹配成功即執行http報文的篡改（篡改使用規則編輯區內容）
?
?
? ? ? ? ? ? 如上圖您可以簡單調整各顯示區域的布局
?
回到頂部
一：規則匹配區
?
1.1：『get http sesion in left session list』獲取Session信息
表示從fiddler Session列表獲取Session信息
點擊此圖標會將您選中的session的url自動填充到urlfilter輸入框中， 并將該session的request及response信息填入下方Http篡改規則的『Request Replace』及『Response Replace』中方便篡改規則的編輯
?
（如上圖：選擇fiddler默認更新session，點擊獲取按鈕，黃色區域即為獲取的信息）
?
1.2：『select url filter method』Url匹配方式
表示url匹配方式（匹配后方文本框中內容），支持Contain，StartWith，Is，Regex，AllPass
- Contion：在當前Http請求session url包含指定值時匹配通過。
- StartWith：在當前Http請求session url以指定值開始時匹配通過。
- Is：在當前Http請求session url與指定值完全一致時匹配通過。
- Regex：在當前Http請求session url 通過指定正則匹配時匹配通過。（如[“^https://www.bing.cn/js/page.\S*?.js\b”該正則匹配表示以“https://www.bing.cn/js/page.”開頭并以“.js”結尾并且中間含隨機版本的js請求url）
- AllPass：對任意Http請求session url匹配通過。（當您需要為所有通過fiddler的請求都進行指定規則的篡改時，比如為所有請求添加標記head頭，或設置禁用驗證緩存時可能會需要使用到AllPass匹配方式）
?
（如上圖：當鼠標懸停該區域，會有匹配方式提示出現）
?
1.3：『edit advanced http filter』高級匹配
點擊此圖標可以進行http篡改匹配規則的高級匹配
包括對request 對請求頭及請求實體的匹配檢查
如果前面的Url Filter 選項已經能幫助您篩選目標http請求，您不用再設置該項
默認狀態下『edit advanced http filter』圖標顯示為黑色，表示沒有對advanced http filter進行過設置
如果您對當前匹配規則的advanced http filter已經進行過設置，該圖標會顯示為藍色
點擊該圖標即可在彈出窗口中設置 advanced http filter
如上圖 advanced http filter分為4部分
1：Url Filter 部分內容與前面的Url Filter 完全一致（這里不在單獨說明）
2：Head Filter 部分可以幫你設置head頭篩選，點擊『+』彈出操作框按提示輸入Key于Value（表示被匹配http請求必須滿足，請求頭中必須含有Key值請求頭，并且該請求頭的內容必須含有Value值）
?點擊目標控制區域『+』彈出添加對話框進行添加
點擊目標控制區域『-』 可以刪除已經添加但不再需要的規則（不選擇任何指定item則移除當前所有）
雙擊任意條目彈出編輯框可以對已經添加條目進行編輯操作
3：HTTP Body Filter 部分的邏輯于Url Filter 維持一致，唯一不同的是此處的篩選條件是請求的body
4：Rule Alias 部分用于設置該規則的別名 （該別名會顯示在后面 『Tamper Rule』篡改規則列表區）
注意以上2，3，4都不是必須項如果不需要可以不用填寫（沒有設置過2，3，4項即為未設置advanced http filter）
?
?
1.4：『new or edit rule』創建規則
在創建模式確認創建新規則
在編輯模式確認保存當前規則
該按鈕與下方『規則編輯控制條』中確認按鈕意義一致
?
?
回到頂部
二：請求或響應篡改規則編輯區域
?
HTTP篡改區有4個tab分別是 請求修改『Request Modific』；請求替換『Request Replsce』；響應修改『Response Modific』；響應替換『Response Replace』
通過設置這4類篡改規則您幾乎可以對指定Http請求的request或response進行任意的篡改，使它變為您需要的樣子
篡改還包括對文件及動態參數化及外部文件數據源的支持
?
2.1：『Request Modific』請求修改
?
『Request Modific』可以完成對http請求的篡改，請求修改按HTTP自身結構分為4塊
分別是對請求url的修改，對請求頭的移除，對請求頭的添加，對請求實體的修改
?
2.1.1：請求行uri 修改 『Uri Modofic』
該編輯區用于控制修改匹配http request的url
不輸入任何值，則代表不修改該項
第一個文本框輸入需要替換的內容，第二個文本框輸入替換之后的內容
注意：該替換規則將替換目標中所有匹配字符串（如果發現多處匹配，將都被替換）
如果第一個文本框置空，僅在第二個文本框中輸入內容，則代表替換請求行的整個uri
如請求行是 GET https://www.fiddler2.com/UpdateCheck.aspx?isBeta=False HTTP/1.1 ，在第一個文本框中輸入""（置空不輸入）,在第二個文本框中輸入“http://test.com”
如果請求『Url Filter』規則匹配，請求在發送前請求行將被篡改為 GET http://test.com HTTP/1.1
?
如上圖，在第一個文本框中輸入"isBeta=False",在第二個文本框中輸入“isBeta=true”
如果請求『Url Filter』規則匹配，若請求行是 GET https://www.fiddler2.com/UpdateCheck.aspx?isBeta=False HTTP/1.1 ，則Url Modific執行（因為url含有“isBeta=False”），請求在發出前，請求行將被篡改為 GET https://www.fiddler2.com/UpdateCheck.aspx?isBeta=true HTTP/1.1
?
2.1.2：請求頭heads移除『Head Modific』『Remove Head』
該編輯區用于控制修改匹配http request的head頭，刪除指定request head頭
點擊目標控制區域『+』彈出添加對話框進行添加
點擊目標控制區域『-』 可以刪除已經添加但不再需要的head移除規則（不選擇任何指定item則移除當前所有）
雙擊任意條目彈出編輯框可以對已經添加條目進行編輯操作
（如上圖點擊添加，彈出窗口進行添加，或雙擊任意item彈出該窗口進行編輯）
以上『Remove Head』設置表示移除請求頭中的Pragram，Cache-Contorl，If-None-Match，If-Modified-Since請求頭
?
2.1.3：請求頭heads添加『Head Modific』『Add Head』
該編輯區用于控制修改匹配http request的head頭，添加指定request head頭
點擊目標控制區域『+』彈出添加對話框進行添加
點擊目標控制區域『-』 可以刪除已經添加但不再需要的head添加規則（不選擇任何指定item則移除當前所有）
雙擊任意條目彈出編輯框可以對已經添加條目進行編輯操作
?
?
（如上圖點擊添加彈出窗口進行添加，或雙擊任意item彈出該窗口進行編輯）
以上『Add Head』設置表示添加請求頭請求頭Pragma: no-cache ， Cache-Control: no-cache （因為在『Remove Head』中也有Pragme請求頭，所以實際含義是修改Pragme請求頭為no-cache）
?
2.1.3備注
- 關于『Remove Head』
因為RFC@2616 請求頭中頭域名稱不區分大小寫，所以host與hoST的意義是一樣的，一旦規則匹配將會移除請求頭中的host頭
- 關于『Add Head』
添加請求頭允許添加2個同名域頭，比如您可以同時添加Accept-Encoding: gzip 和Accept-Encoding: deflate 這2個頭會分別添加到請求頭域（即使使用一樣的頭域名稱）
注意由于同名頭域并不會相互覆蓋，所以如果你想實現指定請求頭的修改功能，需要先刪除指定頭域，再添加該頭域
比如您需要將Pragma：xxx 改為Pragma: no-cache，就需要先添加一個Remove Head測試規則Pragma，然后添加一個頭域修改規則Pragma: no-cache
- 關于請求或響應篡改規則編輯區域其他類似『Add Head』的操作規則
基本操作邏輯維持一致
點擊『+』添加項
點擊『-』刪除選定項（未選定任何項刪除全部）
雙擊任意項為編輯該項
?
?
2.1.4：請求體Body修改『Body Modific』
如果您的請求中含有Body，您可能也會有對請求體body的修改的需求
Body Modific的邏輯與Uri Modific基本維持一致，不過同時支持regex正則替換
不輸入任何值，則代表不修改該項
第一個文本框輸入需要替換的內容，第二個文本框輸入替換之后的內容
當第一個文本框以<regex>開頭時則表示啟用正則替換，后面的內容為查找替換的的正則表達式
如第一個文本框中輸入"<egex>nloginpwd=.*?&"(不包含引號)，第二個文本框中輸入“nloginpwd=123456&”
該正則替換規則表示將請求體Body中所有以“nloginpwd=”開頭，以“&”結尾的文本替換為“nloginpwd=123456”
如上圖，在第一個文本框置空,在第二個文本框中輸入“test”
如果請求『Url Filter』規則匹配，Http請求body將被替換為“test body”
注意這種設置即使原始body為空也會進行替換（實際上GET等請求是不含有請求實體的，此處僅為演示）
?
2.2：『Request Replace』請求替換
『Request Replace』可以完成對http請求的整體替換
Request Replace是http請求的另一種篡改模式，他不關心匹配請求的原始request內容，直接對整個請求做替換操作
Request Replace 對替換規則的編輯分為兩種方式，輔助模式及Raw模式
為了方便您創建替換規則，『Request Replace』按http請求結構分為3部分，請求行，請求頭請求體，及Raw描述切換（不使用格式輔助，進入Raw編輯進行編輯）
?
2.2.1 『Start Line』編輯替換請求行
請求行的編輯按請求行的規則分為
對請求方法的編輯（可以進行下拉輔助編輯，或手動輸入自定義方法）
對url的編輯（注意請保持url的完整性）
對http協議版本的編輯（可以進行下拉輔助編輯，或手動輸入自定義方法）
?
2.2.2 『Request Heads』編輯替換請求頭
請求替換中對請求頭的編輯與【2.1.3】中設置請求頭類似，使用同樣的方式進行配置編輯（此處不再重復說明）
此處的請求頭將與上面『Start Line』一起用于整體替換
?
2.2.3 『Request Body』編輯替換請求體
請求體的替換的編輯基本功能十分便捷，您只需要在圖中高亮部分填入您想要的request body正文即可
如果您的body正文是二進制的數據，或是一個需要上傳的文件，您可以直接在此處添加本地文件
?
編輯框單機鼠標右鍵，在彈出菜單中選擇『add file』
選擇計算機中本地文件文件
?
如上圖選擇文件后“<<replace file path>>C:\Users\administer\Pictures\3613e290-8028-4ddc-946c-b89c67f4f31a.jpg”將會被添加至編輯框
表示3613e290-8028-4ddc-946c-b89c67f4f31a.jpg該文件將直接作為request的請求實體進行替換
您也可以按照格式約定手動添加文件（以“<<replace file path>>”開頭，后接文件路徑）
注意：只有以<<replace file path>>開頭才表示文件模式(“data<<replace file path>>C:\test.jpg”這種數據將不會被當作文件處理)
關于『add Parameter』添加參數化數據
您可以在您需要的任意地方右鍵選擇『add Parameter』添加您想要的靜態化數據
詳細使用方法請查看【八：參數化數據設置】（不了解參數化數據的設置并不會影響您使用freehttp的主要功能）
?
2.2.4 『Raw Mode』切換原始數據視圖
如果您熟悉Http原始報文，您可以點擊下圖中的圖標進入raw mode，對將要替換的原始報文進行編輯
?
?
?
進入raw mode可以直接編輯（如果您使用『get http sesion in left session list』獲取過session信息，這里會提前填入目標http的request報文方便您的編輯）
您不用擔心您輸入的錯誤的http格式會影響替換，如果使用『raw mode』在您編輯或新增完成時，系統會檢查你的輸入，如果格式有誤，會給出明確提示告訴您什么地方不符合標準規范（標準規范請參見RFC2616）
?
?
raw mode 支持上文request replace的全部功能，包括【八：參數化數據設置】會介紹的參數化數據??
在raw mode您同樣可以使用文件替換request body，替換方式與【2.2.3】中的問題替換基本維持一致
需要注意的是，只有request body才能被替換為文件
如上圖如果您已經有body 內容為test data，則不能同時添加文件body
?
2.2.4備注
在右鍵添加文件時，同時可以看到右鍵菜單中有『anto Content-Length』,如果勾選該項在你創建或保存當前規則時會自動計算Body長度并為請求添加Content-Length頭。
在你點擊創建或保存按鈕時，『Request Replace』Tab當前停在raw mode模式 即保存raw mode 數據，停在輔助模式則使用輔助模式的數據
?
2.3：『Response Modific』響應修改
『Response Modific』可以完成對http響應的任意篡改，請求修改按HTTP自身結構分為3塊，分別是對響應頭的移除，對請響應的添加，對響應實體的修改
『Response Modific』的編輯及執行模式與『Response Modific』基本維持一致，不同的是在『Response Modific』不能對響應行及響應狀態碼進行篡改（因為對狀態碼的修改意味著對整個響應的完全修改，如果需要修改狀態碼請使用后面的『Response Replace』）
?
?
2.3.1：響應頭heads移除『Head Modific』『Remove Head』
該編輯區用于控制修改匹配http response的head頭，刪除指定response head頭
該項編輯邏輯與【2.1.2】中對請求頭的移除是一致的，這里不再重復說明
?
2.3.2：響應頭heads添加『Head Modific』『Add Head』
該編輯區用于控制修改匹配http response的head頭，添加指定response head頭
該項編輯邏輯與【2.1.3】中對請求頭的添加是一致的，這里不再重復說明
?
?
2.3.3：響應體Body修改『Body Modific』
如果您的響應中含有body，您可能也會有對響應body的修改的需求
同樣支持完全覆蓋，替換，正則替換
該項編輯邏輯與【2.1.4】中對請體的修改是一致的，這里不再重復說明
如上圖設置則表示為匹配的http響應添加一個Set-Cookie頭，內容為UM_distinctid=167,當瀏覽器接收到這個被篡改過的響應頭后，會為該域名添加名為UM_distinctid的cookie，如果已有同名cookie則會直接覆蓋
?
?
2.4：『Response Replace』響應替換
『Response Replace』可以完成對http響應的整體替換
Response Replace是http響應的另一種篡改模式，他不關心匹配請求的原始response內容，直接對整個響應做替換操作
Response Replace 對響應的替換直接使用Raw模式，不過為了方便替換提供了一組標準響應返回的模板
Response Replace 按編輯功能分為3部分，響應Raw內容編輯，模板選擇，Response Direct選擇
?
2.4.1 響應Raw原始報文編輯
在此Tab可以直接編輯替換用的Raw原始報文（如果您使用『get http sesion in left session list』獲取過session信息，這里會提前填入目標http的response報文方便您的編輯）
您不用擔心您輸入的錯誤的http格式會影響替換，如果使用『response replace』在您保存或新建時系統會檢查你的輸入，并給出明確提示告訴您什么地方不符合標準規范（標準規范請參見RFC2616）
與【2.2.4】 請求『Raw Mode』替換一樣，支持文件及參數化數據，除報文要求的格式外，其他編輯邏輯與【2.2.4】中規則維持一致，此處不再重復說明
?
2.4.2『Select Replace Template』選擇模板
如果您需要自己創建response響應內容，您可以使用模板輔助您的編輯，模板包含大多數常規響應的基本格式
如上圖下拉選擇您想要的模板即可，上圖中選擇了[HTTP/1.1 200 OK]的模板，模板內容即是一個常規Http 200 返回的例子，您可以直接在例子上進行修改
?
2.4.3『Response Direct』直接返回響應
該選項用于控制response返回時機，當『Url Filter』匹配到http請求后，同時該篡改規則為『Response Replace』時，可以使用該項設置請求是否直接返回
當『Response Direct』被勾選選時，feddler將不會把請求發送到目標服務器，而是使用Response Replace里的resonse直接返回，即客戶端發送請求后就會立即接收到您自定義的響應，這種模式對于實際請求是不存在的或暫時不能連通的情況是十分必要（比如您想要使用暫時未開發好的接口，這時就需要該選項mock接口），同時您可以設置接口的執行時間在后面【3.3】『set response latency』 會介紹如何為響應設置指定響應時間
當『Response Direct』未被勾選時，則使用常規請求路徑，請求會被發送至服務器（即使服務的返回并不會被使用），在服務返回響應結果后，執行替換操作 （默認不勾選）
?
?
回到頂部
三：規則編輯控制條及常規設置編輯區域
規則控制編輯條由3部分組成如上圖1，2，3，4組成的規則控制，5快速規則編輯，6篡改工具及常規設置
?
3.1『affirm rule』確認創建規則或保存規則修改
該按鈕的功能與【1.4】『new or edit rule』維持一致
在創建模式確認創建新規則
在編輯模式確認保存當前規則
如上圖當年點擊確認（黃色標記區域）時，即會創建能編輯的篡改規則
請注意上方『url Filter』右側文字提示（New Mode 表示現在處于創建模式）會顯示當前模式
還有一點需要說明當前篡改規則編輯區域停留在哪種編輯模式，即是對哪種規則的保存（『Request Modific』『Request Replsce』『Response Modific』『Response Replace』）
單個規則僅包含一種篡改規則，如果您需要對同一個請求同時執行多個篡改，您可以對其創建多個篡改規則（實際應用中這種場景是存在的）
如果當前創建的規則是『Request Modific』或『Request Replsce』，創建完成的規則會出現在『Request Rule』列表中，如果是『Response Modific』或『Response Replace』，創建完成則會出現在『Response Rule』中
完成創建后，下方日志會有相應記錄，并清空當前編輯區域（圖中編輯區域沒有清空僅為演示，實際使用中編輯區數據將完全被清除）
當您點擊確認時系統會檢查您編輯的規則，如果有不符合要求的地方會有相應提示，并在出現錯誤的編輯的區域進行短時間的高亮顯示以提示 （通常如果是新規則會在添加在規則類表末尾，并有短時間高亮顯示進行提示）
?
3.2『cancel edit』取消
『cancel edit』功能相對簡單，僅用于清除編輯區域保存的信息
在創建模式直接清除信息，在編輯模式可以取消對當前規則的編輯狀態
?
3.3『set response latency』 設置響應延時
『set response latency』可用于設置『Response Rule』的響應延遲（『Response Modific』及『Response Replace』為『Response Rule』）
如上圖該圖標按鈕有3種狀態（can set ， unable set，is seted）
1.can set：延時設置對當前篡改規則為可設置狀態，此時點擊該圖標即彈出設置框。
2.unable set ：延時設置對當前篡改規則為不可設置狀態，此時該圖標不能點擊，因為響應延時是針對http response的延時，即該設置對『Request Modific』『Request Replsce』是無效的
3.is seted：第3種狀態是已經設置過延時的情況，如圖設置過數值將會直接顯示在剛剛圖標的位置。（這個時候也可以點擊該數值進行修改）
設置窗口如上圖，您直接填入數值即可（單位為毫秒），如果填0或空則表示不設置延時
?
3.4『set parameter pick info』設置參數化數據獲取規則
『set parameter pick info』用于在原始請求或響應中捕獲初始化數據（對現有參數化數據做添加或修改操作）
該圖標有2種狀態含義分別是
1：該篡改規則未設置任何參數捕獲規則
2：該篡改規則至少已經設置一條參數捕獲規則
這兩種狀態下都可以點擊圖標直接進入編輯框，如果已經有設置過的規則，已有規則會在編輯框中直接加載
詳細使用方法請查看【八：參數化數據設置】（不了解參數化數據的設置并不會影響您使用freehttp的主要功能）
?
3.5『Quick Rule』快速規則
當前版本共有6個快速規則，幫助您快速完成篡改規則的設置
?
3.5.1『disable cache』禁止緩存
該quick rule針對Request Modific，可以為匹配規則的請求去除條件緩存并強制服務器不要使用緩存
如上圖使用該quick rule后會在『Request Modific』中『Head Modific』直接添加預設的值，這時您直接點擊確認即可用快速完成一個Request Rule的創建
?
3.5.2『add cookie 』添加請求Cookie
該quick rule針對Request Modific，可以為匹配規則的請求添加指定cookie
選擇項后彈出如上圖對話框，直接輸入您需要設置的cookie即可，（注意cookie的格式 key=value ）
?
3.5.3『delete cookie』刪除客戶端Cookie
該quick rule針對Response Modific，可以為匹配規則的響應添加Set-Cookie（通過設置指定cookie立即過期，從而實現刪除客戶端cookie的功能）
選擇項后彈出如上圖對話框，在Name處輸入你想要刪除cookie的名稱（同時為了讓瀏覽器準確定位到您要刪除的cookie，你還需要注意修改Domain及Path為正確的值，一般情況下Domain為當前網站域名，Path為/）
?
3.5.4『set client cookie』設置客戶端Cookie
該quick rule針對Response Modific，可以為匹配規則的響應添加指定Set-Cookie，設置客戶端cookie （這里是通過Set-Cookie完成對客戶端cookie的效果，比如在手機瀏覽器，或某些軟件的內置web瀏覽器并沒有提供調試模式，這個時候Set-Cookie將是不錯的解決方案）
選擇項后彈出如上圖對話框，按提示輸入指定值即可
?
3.5.5『copy session cookies』復制Cookies
該quick rule針對針對Response Modific，可以快速將指定session的所有cookies快速的設置到客戶端另一個域下（該功能可以讓您在多個瀏覽器，甚至多個設備，多個域名下共享同一份cookie，這在調試或測試中跳過授權會非常有效）
?
如上圖要使用該功能，您需要先在Filddler左側Session列表選擇您需要復制cookies的源請求（圖中選擇的是github.com/lulianqi/FreeHttp），選中指定session后點擊copy session cookies即可以看到在Heads Modific的Add Head編輯框自動添加了來自github的cookie信息（該規則會為匹配的請求添加Set-Cookies從而達到復制效果）
?
3.5.6『add UserAgent』添加UserAgent
該quick rule針對Request Modific，可以為匹配規則的請求添加指定UserAgent
如上圖該項相對簡單，直接填入您需要的UserAgent即可
?
3.6『Modific Tool』篡改工具及常規設置
當前版本共有4個工具項，方便您的使用或提供其他設置功能
3.6.1『show selected session stream』顯示session流信息
該工具可以將您選擇的session以RAW的模式顯示在一個新的窗口（該窗口一直頂層顯示，但不影響您在主窗口下的操作），您在創建篡改規則的同時可以使用該窗口查看session信息而不用切換Tab（您也可以直接在session列表中選中session拖動到編輯區域，raw形式的報文同樣會顯示在日志區，但不會打開新的窗口 ）
如上圖在fiddler左側session列表選擇任意請求，點擊show selected session stream將會彈出新的獨立窗口以顯示您選擇的session的原始報文
?
3.6.2『http tamper setting』基本設置
該項提供一些對FreeHttp插件的基本設置
- is only match fist tamper rule: （默認是）是否僅執行第一個匹配成功的篡改規則（因為您可以對同一個請求有多個篡改規則，您可以通過此選項控制是否能對一個http報文執行多個匹配規則篡改規則）
- is skip tls handshake:（默認是）是否跳過對TLS握手包進行匹配（除非您需要調試TLS握手，建議您維持默認設置）
- is default enable tamper rule:（默認否）是否默認啟用規則匹配（在『Request Rule』及『Response Rule』都有獨立啟用開關，該選項用于控制軟件啟動時的默認狀態）
?
3.6.3『parameter data manage』參數化數據管理器
該項提供對FreeHttp的參數化數據的集中管理
選擇該項后彈出層管理器窗口，您可以在管理器中對參數進行新增，修改，調試等操作
后面【八：參數化數據設置】會詳細介紹參數化數據的使用，這里暫不具體說明
?
3.6.4『issues and suggest』
點擊該選會使用您的默認瀏覽器打開問題提交頁，您可以在該頁提交您的問題及意見（在此處提交問題可能需要您擁有github帳號，如果不方便登錄可以直接發送郵件至mycllq@hotmail.com提交您的問題及建議）
?
?
回到頂部
四：『Execution Log』執行日志
該區域僅對篡改規則的操作及執行日志進行顯示
日志統一格式以數據開頭，并用顏色區分錯誤，提示及信息日志
?
?
?
回到頂部
五：『Tamper Rule』篡改規則列表
『Tamper Rule』篡改規則主要集中顯示及管理您已經創建的規則，您可以在這里設置需要生效的規則，刪除或修改已有規則，對規則排序等操作
列表分為2部分（這2部分的操作邏輯都是一致，僅是存儲的規則類型不一樣）
- 上部列表為『Request Rule』請求篡改規則（由『Request Modific』，以編輯圖標顯示及『Request Replsce』以替換圖標顯示組成）
- 下部列表為『Request Rule』響應篡改規則（由『Response Modific』，以編輯圖標顯示及『Response Replace』，以替換圖標顯示組成）
?
5.1 Tamper Rule控制選項
Tamper Rule控制選項主要由2部分組成
位于右上角的控制欄，從左至右分別是『+』添加，『-』刪除，『啟用』控制
點擊添加：編輯面板會直接切換至『Request Modific』提示您進行編輯（如果是在『Response Rule』上點擊添加編輯面板則會切換至『Response Modific』）
點擊刪除：刪除選中Rule，如果沒有選擇任何Rule則會向您詢問是否刪除全部Rule
啟用控制：Request Rule與Response Rule的啟用控制是獨立的，您可以分別設置他們的啟用狀態，只有當您選擇啟用后，Fillder才會匹配列表中處于Checked狀態的規則，匹配命中后執行規則（您可以設置啟動時直接啟用，詳見【3.6.2】『http tamper setting』）
在篡改規則列表區任意位置右鍵可提出Rule控制菜單
- remove selected rule 刪除選定規則
- remove all rule 刪除所有規則
- enable this rule 生效指定規則
- enable all rule 生效所有規則
- unable all rule 讓所有規則不生效
- edit this rule 編輯當前規則
?
5.2 Tamper Rule信息顯示
如上圖您創建的規則都會顯示在Tamper Rule列表里，每條規則在列表處顯示信息依次有如下4項
1：是否進行匹配復選框（如果您想要篡改規則生效，除了要設置『啟用』控制，還需要將此處設置為勾選狀態）
2：替換/編輯圖標，該處僅顯示一個圖標表示當前篡改規則是一個編輯規則還是替換規則
3：當前篡改規則的的序號，注意該序號是自動生成的唯一序號，在您對規則做添加或刪除操作時會重新生成每條規則的序號
4：規則名稱，如果您沒有設置規則別名這里會直接顯示匹配url的方式加匹配url值（別名的設置請參考【1.3】『edit advanced http filter』）
?
如上圖，當您將鼠標移至rule圖標處，會顯示規則匹配的詳細內容（僅顯示匹配信息，不顯示篡改詳情）
上圖規則表示當請求同時滿足 以下規則
1：請求url 必須等于“https://www.fiddler2.com/UpdateCheck.aspx?isBeta=False”
2：請求必須含有名為“Data”的請求頭，且該請求頭的值含有“GMT”
3：請求Body必須含有上圖指定字符串
?
5.3 Rule的編輯及排序
如上圖您在rule列表對任意篡改規則進行雙擊則進入編輯模式，對當前規則進行編輯
處于編輯模式的rule在列表處以紅色背景展示，在圖中紅線處也顯示了當前處于編輯狀態的規則ID
請注意編輯完成后務必點擊保存使更改生效（保存成功后當前rule規則特殊背景色會消失）
如果您想放棄修改請點擊取消（詳見：【3.2】『cancel edit』取消）
規則的匹配是由上至下的，所以最上面的規則會被先匹配到，如果您『is only match fist tamper rule』設置的是ON，那如果有2個生效規則都可以被匹配到，實際當前一個匹配規則匹配成功即會停止下面的匹配。這種情況下，規則順序的更改將十分必要。
Rule順序的調整也十分方便，您只需要選擇您想要調整位置的rule(支持多選)，將它拖動到您需要的位置即可。
?
回到頂部
六：快速入門
這里向您演示如何快速創建一個規則，并完成對http請求或響應的修改
以https://www.fiddler2.com/UpdateCheck.aspx?isBeta=False為例（該請求實際為fillder更新檢查的請求）
假設我們希望修改url中isBeta的值為ture，并將Connection:頭修改為Keep-Alive
您只需要在填入如上圖所示信息，點擊右下角確認
如上圖設置開啟規則匹配并勾選您需要參與匹配的規則（圖中序號為6的的請求即是我們剛剛創建的規則）
?
當系統匹配到http請求后，會將fiddler左側session列表中被匹配中session，及右側rule列表被匹配中規則同時以淺黃色高亮提示（rule列表處高亮提示將在2-3秒后消失），同時在Log日志區會出現相應日志
篡改結果如上圖Inspectors標紅處，可以看到對http的修改已經生效
?
回到頂部
七：簡單實踐
目標：將baidu首頁的logo替換為google的logo
我們先找到baidu首頁logo的請求為：https://www.baidu.com/img/bd_logo1.png
我們在網上搜索得到一個google的logo：https://upload.wikimedia.org/wikipedia/commons/thumb/2/2f/Google_2015_logo.svg/220px-Google_2015_logo.svg.png?（如果您無法訪問這個鏈接，您可以選擇任意一個其他的圖片url進行測試）
通過FreeHttp我們有多種方案可以完成目標
1：使用『Request Modific』修改請求url內容讓他實際請求google的logo
如上圖設置規則即可
效果如圖實際請求baidu logo的請求實際被修改為了google的（這些改動對客戶端瀏覽器是不可見的，不過因為是圖片文件所以您在測試的時候請注意瀏覽器緩存）
?
2：使用『Response Replace』修改請求重定向到google的鏈接
如上圖設置規則即可（如果您剛剛設置了對該圖片鏈接的Request Modific規則，為了不影響測試過程請將前面的規則設置為不可用）
?
?
效果如圖，bd_logo1.png的請求實際被重定向到了新的地址，同樣實現了剛剛的效果
?
3：使用『Response Replace』直接替換返回圖片內容
如上圖設置規則即可（本地圖片需要提前準備）
效果如圖（效果是一樣的實際原理稍有不同，這次是直接使用本地文件更改的請求響應）
?
4：使用『Response Modific』修改百度首頁HTML，將圖片元素的地址修改為google的鏈接
如上圖設置規則即可（注意這次不是修改https://www.baidu.com/img/bd_logo1.png的響應了，Url Filter匹配的是https://www.baidu.com/）
效果如圖，可以看到這次百度首頁的HTML的地址直接被修改了，瀏覽器解析到被篡改的url從而請求了錯誤的圖片
?
?
?
回到頂部
八：參數化數據設置
參數化數據的使用可以讓您使用篡改規則動態的修改http的內容，并且支持在http請求或相應中捕獲數據供篡改規則使用
當前版本支持以下類型的參數化數據 （所有種類的參數化數據可以使用『=』當前值，『+』下一個值，『-』上一個值這3種方式進行取值）
- Key-Value 這是最直接的參數類型，僅提供Key Value 功能，一般用于固定常量，或存放從HTTP報文中捕獲的數據
- Index 該參數類型提供一種類似索引的功能（您可以設置它的起始值及范圍，還可以設置每次取值的進步） (the max is 2147483647)
- LongIndex 該參數類型與Index類似，不過LongIndex提供了更大的范圍(the max is 9223372036854775807)
- StringIndex 該參數與與LongIndex類似，不過它提供一直固定長度的索引（如0001到9999而不是1到9999）
- Time 該參數可以讓您以指定格式獲取當前時間
- Random 該參數可以讓您以指定格式獲取一個隨機字符串/數
- List 該參數提供一組特定列表，如“小紅”，“小黑”，“小花”，您可以使用該參數依次或隨機取出設置的3個值
- CSV 該參數可以讓您直接使用CSV文件中的數據
?
8.1 『parameter data manage』參數化數據管理器
點擊Modific Tool中的parameter data manage 即可彈出如上圖所示參數化數據管理器（在request replace 機response replace 編輯區右鍵菜單中add parameter data -> edit data 也可以打開該管理器）
參數化數據管理器主要用于集中管理您所添加的參數化數據
?
8.1.1參數化數據管理器基本顯示及操作
如上圖『parameter data manage』主要分如上3個部分
1：parameter data manage類別 （點擊不同的類別分類可以進行列表切換）
- KeyValue：包含Key-Value參數列表
- Parameter：包含Index，LongIndex，StringIndex，Time，Random，List參數列表
- DataSouce：包含CSV參數列表
?
2：參數列表
列表依次顯示參數的名稱，類別，當前值（可能每一次取值都不一樣，列表僅顯示當前值）
您可以通過列表右上方添加刪除按鈕添加刪除參數
3：控制當前參數
您在參數列表中選擇任意參數，該參數會在這里進入編輯模式
該區依次顯示參數名稱（不可編輯），當前值（可編輯），控制按鈕
控制選項一共有3個
- 編輯當前值：點擊該按鈕即為用該區文本框中的內容設置當前參數（注意并不是任意值都是合法的，如字母“ABC”就對一個Index類型的參數一定不合法）
- 取下一個值：獲取當前參數的下一個值
- 重置參數：對當前參數進行重置
?
8.1.2添加參數化數據
如同點擊添加按鈕彈出添加框，依次選擇填寫圖中4處信息即可完成添加
1：下拉選擇參數化數據類別（大類別）
2：下拉選擇參數化數據具體類別
3：填寫您需要添加的參數化數據名稱
4：填寫您參數化數據的格式要求（當您選擇完類別后回顯示格式要求，含義及示例在圖中黃色高亮區域，以幫助您填寫正確的格式要求）
填寫完成后點擊添加即可完成添加，下面會以幾個例子說明添加過程
?
如上圖填寫每次與值后就添加了個簡單的Key-Value參數，參數名為cookie，值為FPkj······
?
如上圖設置將會添加一個名為RandomId，類型為Random的參數化數據，該Random參數為10位長度的數字
?
?
如上圖設置將會添加一個名為timestamp，類型為Time的參數化數據，該Time會提供當前毫秒時間戳
?
如上圖設置將會添加一個名為csv，類型為CSV的參數化數據，該參數使用本地文件D:\mycsv.csv作為數據源并以UTF-8讀取數據（注意@前綴表示使用絕對路徑，默認沒有@表示相對路徑，相對路徑為fiddler安裝根目錄下的FreeHttp文件夾）
https://docs.microsoft.com/zh-cn/dotnet/api/system.text.encoding?view=netframework-4.7.2?（65001即代表utf8，編碼代碼頁參考）
注意如果添加CSV類型數據后，若再在計算機中單獨在對改文件直接進行編輯后，您需要重新添加該數據源才能使您的編輯生效
?
?
8.1.3查看編輯導出CSV類型數據
您在任意一個CSV數據類型上雙擊都會彈出數據源顯示/編輯框
如上圖您可以選則csv表格中的任意數據（因為實際CSV參數取值都是按從左至右從上至下順序取值，所以當前游標十分重要，打開編輯框被選中的數據即是該數據源當前游標位置，通過選擇可以設置游標位置，點擊保存即可生效）
您同樣可以編輯（雙擊任意項可以進行編輯），刪除（選擇行按鍵盤Delete），添加（在尾行直接統計）
完成編輯后您可以點擊左上角save data圖標進行保存，或點擊export data將您的數據直接導出為文件（CSV參數里的數據可能全部來自HTTP捕獲，所以導出可能對您十分必要）
?
8.2 在規則中使用參數化數據
您在參數化數據管理器中添加的參數可以在『Request Replsce』，『Response Replace』規則中直接使用
?
8.2.1 使用插入的方式添加參數
如上圖您可以在『Request Replsce』或『Response Replace』編輯區域鼠標右鍵，在右鍵菜單中選擇add Parameter Data ，選擇添加參數的類別，選擇您要添加的參數（這里選擇的是剛剛添加的ran2），最后選擇取值方式
完成選擇后參數會自動添加到光標后方（圖中黃色高亮區域）
?
8.2.2使用拖拽的方式添加參數
如上圖所示您可以在參數管理器中選擇您需要的參數直接拖拽到編輯區的任意地方，同樣會為您自動完成添加（以拖拽添加的參數的取值方式都是“下一個”，您可以手動修改）
?
8.2.3使用手動編輯的方式進行添加
只要按照指定格式*#參數名稱(取值方式)*#您可以自己手動添加參數
參數名稱需要是已經存在的參數名稱
取值方式默認有 下一個(+)，上一個(-)，當前值(=) 3種可以使用
CSV數據參數除支持上面3種默認取值方式外還支持使用二維坐標系地址取值，比如 *#dtb(0-2)*# 表示取dtb這個csv數據源的第0列，第2行數據（以0為起始索引）
默認下一個取值(+)還支持(+N)，表示取后面第N個值
?
注意：使用手動添加參數后需要手動勾選use Parameter Data
? ? ? ? ? ?因為使用到了參數化數據，所以報文內容將在每次規則執行時動態生成，您可能無法預測報文實體長度，為此所有使用參數化數據的報文都會被自動添加正確的Content-Length。如果您在使用參數的同時又有意構造錯誤的Content-Length，請再添加一條Response Modific即可
?
8.3 動態拾取參數化數據
FreeHttp動態獲取http報文中的數據用于設置或添加參數
如上圖在控制條中有『set parameter pick info』圖標（【3.4】節）
您可以在Http請求報文，或響應報文中拾取參數，這取決于您當前創建的篡改規則的類型
點擊圖標即可進入參數拾取規則設置窗口
如上圖按提示依次填入參數名稱，拾取方式，拾取附加項，拾取范圍，拾取表達式，然后點擊添加或刪除按鈕
?
- 參數名稱：如果使用的參數名稱已經存在于參數管理器中，該拾取會修改當前參數的參數值（修改實際都是修改下一個值，對Key-Value來說當前值與下一個值都是同一個值），如果是一個新的參數則會直接添加一個Key-Value型參數
- 拾取方式：當前版本支持Regex，XML，String 3種拾取方式
- 拾取附加項：對拾取方式的附加說明
- 拾取范圍：無論是請求報文還是響應報文，都支持以Line請求/響應行，Heads 請求/響應頭，Entity 請求/響應實體為查找范圍
?
下面以Regex為例（Xml使用Xpath與Regex是類似的），說明參數拾取規則的填寫（獲取User-Agent括號內的數據）
Parameter Name填寫ua_1，PickType選擇Regex
PickAdditional選1，1表示取匹配結果的第一項（因為Regex于Xpath匹配都可能是多個結果），0表示把多個結果以逗號連接在一起返回，當然您可以手動填寫2，3，4等索引表示取第N個價格
PickRange 選擇Heads （因為User-Agent在head頭中）
Pick Expression 填寫 \(.*?\)
?
如果您對Regex還不是很熟悉可以直接使用Str（使用Str同樣可以完成大多數的查找）
如上圖,選擇PickType為Str，PickAdditional為str-str（str-str：字符串首尾拾取目標值，str-len：使用指定字符串開始并指定長度，index-len：以指定索引開始并指定長度，長度填0則表示拾取到最大長度）
PickRange依然選擇Heads，Pick Expression 填寫 (-)
?
最后如上圖使用str-len獲取請求行中的isBeta參數，完成后點擊確認
?
在HTTP請求被匹配命中后，即會執行設置好的參數拾取，如上圖參數已經在請求報文中拾取出來了（注意用Str方式匹配的結果是不含有首尾字符串的，所以上圖ua_2會少一個括號）
參數拾取過程也會被打印在日志區
?
8.4 參數化數據示例
目標：匹配www.test.com/parameter?name=value請求，并返回{"mes":"hello value"}
其中www.test.com是一個不存在的域名，value可能是任意字符串 （實際需求就是對不存在接口的mock）
?
如下配置即可
如上圖添加一個Request Modific規則，因為實際只需要獲取name名稱不需要對請求進行修改，所以修改區域不用填寫任何信息（不修改），僅添加一個參數拾取規則即可
如上圖再添加一個Response Replace，因為實際接口是不存在的所有必須手動替換一個虛擬的返回，返回body中使用到了請求將會獲取的testName參數（注意勾選Response Direct）
完成添加后，設置剛剛添加的2個規則生效。
?
?
如上圖，您在使用瀏覽器（對使用fiddler代理的任何設備任何客戶端都生效）訪問http://www.test.com/parameter?name=tom
可以看到這個并不存在的接口已經按預期返回了數據，并且成功取出了name
?
?
?
回到頂部
實現及源碼
完整工程源碼：?https://github.com/lulianqi/FreeHttp/
Fiddler 擴展插件開發環境配置 請參考官方文檔?https://docs.telerik.com/fiddler/Extend-Fiddler/ExtendWithDotNet?（該文檔已經詳細說明了搭建及調試項目的過程）
Fiddler 對外開放接口可以參見《Lulu.Debugging with Fiddler》（書中不僅介紹Fiddler的起源，還纖細介紹了Fiddler的使用，其中就包括對外提供的擴展接口）
?
當前FreeHttp擴展插件開發使用.net framework 版本為4.5（您在配置開發環境時需要注意您調試引用的Fiddler 的版本，及您開發環境所支持的最高版本）
?
基本基本結構如下圖
?
?
下載工程并加載成功后您可以看到如上圖的基本結構
以下是圖中主要命名空間的功能概述
- 1：AutoTest命名空間主要提供參數化數據的拾取及管理
- 2：FiddlerHelper命名空間 提供與Fiddler篡改直接相關的功能
- 3：FreeHttpControl命名空間提供UI界面及窗體操作邏輯
- 4：HttpHelper命名空間提供對HTTP協議報文處理的功能
- 5：MyHelper 命名空間提供公共的輔助工具
- 6：WebService命名空間提供使網絡服務的功能
- 7：FiddlerFreeHttp繼承至IAutoTamper，他是與FIddler數據交換的入口? ，?FiddlerSessionTamper是FiddlerFreeHttp的工具類
?
總結
以上是生活随笔為你收集整理的【Fiddler篇】FreeHttp无限篡改http报文数据调试和mock服务的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 【数据库】Mysql的CONCAT()函
- 下一篇： java 0xaarrggbb 转换_R