Postman Interceptor 是一個(gè) Chrome 擴(kuò)展，充當(dāng) Postman 桌面應(yīng)用程序的瀏覽器伴侶。攔截器使您能夠直接從 Chrome 瀏覽器捕獲網(wǎng)絡(luò)請(qǐng)求和 cookie。

一旦 Interceptor 在 Chrome 中運(yùn)行，您就可以啟動(dòng)調(diào)試會(huì)話，這是一個(gè)限時(shí)的流量捕獲會(huì)話。您可以啟動(dòng)、暫停和停止攔截器調(diào)試會(huì)話，然后再啟動(dòng)另一個(gè)。每個(gè)調(diào)試會(huì)話都記錄在“歷史記錄”選項(xiàng)卡中，并顯示總會(huì)話時(shí)間和捕獲的所有流量。從記錄的會(huì)話中，您可以向集合發(fā)送請(qǐng)求和響應(yīng)，并將 cookie 保存到 Postman cookie jar。

您還可以使用 Postman 攔截器自動(dòng)將 cookie 從 Chrome 瀏覽器同步到 Postman cookie jar。了解有關(guān)同步 cookie 的更多信息。

安裝攔截器

您不能將 Interceptor 與Postman 網(wǎng)絡(luò)應(yīng)用程序一起使用。確保您已經(jīng)安裝了Postman 桌面應(yīng)用程序。

1. 在 Chrome 網(wǎng)上應(yīng)用店下載攔截器。如果您已有擴(kuò)展，請(qǐng)確保它是 v0.2.26 或更高版本。
2. 在 Postman 頁(yè)腳中選擇  捕獲請(qǐng)求。
3. 在Capture requests窗口中，選擇Via Interceptor選項(xiàng)卡。
4. 選擇Install Interceptor Bridge以下載 Bridge，這是一個(gè)獨(dú)立的可執(zhí)行文件，可促進(jìn)與攔截器的通信。如果您使用的是 Windows 或 Linux，Postman 將為您處理一切。如果您使用的是 macOS，系統(tǒng)會(huì)提示您安裝 NodeJS（如果您的計(jì)算機(jī)上尚未安裝）。如果未出現(xiàn)下載選項(xiàng)，您可以使用以下鏈接手動(dòng)下載和安裝：macOS、Linux或Windows。
5. 通過檢查右上角的已連接狀態(tài)是否為綠色來確認(rèn)攔截器已準(zhǔn)備好使用。您可以捕獲來自瀏覽器的請(qǐng)求和來自任何域的 cookie，以在 Postman 中使用。

使用攔截器

連接攔截器后，您可以啟動(dòng)攔截器調(diào)試會(huì)話，這是一個(gè)有時(shí)限的會(huì)話，其中捕獲的流量保存在“歷史記錄”選項(xiàng)卡的條目中，并可選擇保存到集合中。代理調(diào)試會(huì)話啟動(dòng)后，您可以暫停、重新啟動(dòng)或停止它。在開始會(huì)話之前，您可以選擇要進(jìn)入的流量。

您只能同時(shí)運(yùn)行一個(gè)代理或攔截器調(diào)試會(huì)話。

要啟動(dòng)攔截器會(huì)話，請(qǐng)執(zhí)行以下操作：

1. 轉(zhuǎn)到Capture 請(qǐng)求窗口的Via Interceptor選項(xiàng)卡。
2. 如果您希望在調(diào)試會(huì)話期間除了請(qǐng)求之外還捕獲 cookie，請(qǐng)選擇捕獲 Cookie 。您可以在 Postman 請(qǐng)求中使用這些 cookie。您還可以捕獲 cookie 并將它們同步到 Postman，而無需啟動(dòng)調(diào)試會(huì)話。了解有關(guān)同步 cookie 的更多信息。
3. 默認(rèn)情況下，請(qǐng)求將保存在側(cè)邊欄“歷史記錄”選項(xiàng)卡中的調(diào)試會(huì)話中。要同時(shí)將請(qǐng)求保存到集合，請(qǐng)從將請(qǐng)求保存到集合下的列表中選擇一個(gè)集合。
4. 在URL must contain下，指定一個(gè)字符串或正則表達(dá)式，并且只會(huì)捕獲匹配的 URL。
5. 在Methods下，選擇一種或多種方法以僅捕獲這些方法。
6. 選擇開始捕捉。

運(yùn)行攔截器調(diào)試會(huì)話

當(dāng)您的攔截器會(huì)話正在運(yùn)行時(shí)，攔截器調(diào)試會(huì)話窗口將在您使用 Chrome 瀏覽器時(shí)顯示捕獲的流量。

您可以使用多種控件來限制、組織和調(diào)查捕獲的流量：

• 選擇名稱攔截器調(diào)試會(huì)話并輸入另一個(gè)名稱以更改窗口名稱。
• 窗口頂部的配置傳入請(qǐng)求控件使您能夠限制捕獲的流量。從Methods和URL中選擇項(xiàng)目以限制流量。這些控件類似于您最初設(shè)置的控件，但它們限制捕獲的內(nèi)容而不是通過攔截器的內(nèi)容。
• 選擇捕獲 Cookie以收集 cookie 并將它們同步到攔截器會(huì)話。
• 選擇Requests選項(xiàng)卡以獲取有關(guān)傳入請(qǐng)求和響應(yīng)的信息，或選擇Cookies以獲取有關(guān)捕獲的 cookie 的信息。
• 使用搜索框查找特定請(qǐng)求。
• 選擇請(qǐng)求旁邊的>以展開它以了解更多詳細(xì)信息。
• 在URL列中選擇 URL以在 Postman 中將請(qǐng)求作為新的 API 請(qǐng)求打開。

當(dāng)您從“請(qǐng)求”選項(xiàng)卡上的列表中選擇一個(gè)或多個(gè)請(qǐng)求時(shí)，您可以使用以下控件：

•  刪除- 刪除請(qǐng)求。

當(dāng)您從Cookie選項(xiàng)卡上的列表中選擇一個(gè)或多個(gè) cookie 時(shí)，您可以使用以下控件：

• + 添加到 Cookie Jar - 將請(qǐng)求添加到 Postman cookie jar。
•  刪除- 刪除 cookie。

右下角顯示捕獲會(huì)話的總時(shí)間，以及捕獲流量的總大小。如果您想暫時(shí)停止捕獲會(huì)話，請(qǐng)選擇暫停。要重新啟動(dòng)捕獲會(huì)話，請(qǐng)選擇Resume。

完成調(diào)試會(huì)話后，選擇右下角的停止。這將完成調(diào)試會(huì)話，調(diào)試會(huì)話的結(jié)果將保存在“歷史記錄”選項(xiàng)卡中。

停止會(huì)話后，攔截器仍然連接。在 Postman 頁(yè)腳中選擇  捕獲請(qǐng)求，您可以啟動(dòng)另一個(gè)調(diào)試會(huì)話。

查看攔截器調(diào)試會(huì)話結(jié)果

完成調(diào)試會(huì)話后，它的事務(wù)位于歷史選項(xiàng)卡中，名為Interceptor debug session。

當(dāng)您打開保存的調(diào)試會(huì)話時(shí)，頂部標(biāo)題會(huì)顯示會(huì)話開始時(shí)間、總大小、持續(xù)時(shí)間和來源。

概述顯示會(huì)話中捕獲的流量的摘要圖。您可以選擇按方法、域、數(shù)據(jù)模式或返回狀態(tài)代碼匯總流量的圖表。

Requests和Cookies選項(xiàng)卡顯示請(qǐng)求、響應(yīng)和 cookie ，類似于捕獲會(huì)話期間可用的相同選項(xiàng)卡。與第 4 步中描述的搜索、擴(kuò)展、保存和刪除項(xiàng)目的選項(xiàng)相同。您還可以將選定的請(qǐng)求添加到集合中。使用表格底部的控件來限制每頁(yè)的項(xiàng)目數(shù)并查看結(jié)果頁(yè)面。

您可以通過在窗口頂部選擇名稱并輸入新名稱來重命名攔截器調(diào)試會(huì)話。選擇調(diào)試會(huì)話名稱旁邊的更多操作圖標(biāo)  以重命名或刪除會(huì)話。

怎么運(yùn)行的

攔截器利用 Google Chrome 功能工作，安裝過程因操作系統(tǒng)而異。

Postman 的本機(jī)應(yīng)用程序需要 Chrome 的本機(jī)消息傳遞功能。這需要一個(gè)獨(dú)立的可執(zhí)行文件，并將安裝在您的機(jī)器上。

您的安裝可能包括以下選項(xiàng)：

• [僅限 macOS] 安裝 NodeJS - 如果 Postman 檢測(cè)到您沒有可用的 NodeJS 二進(jìn)制文件，系統(tǒng)將提示您安裝它。然后 Postman 將下載最新的穩(wěn)定版本的 Node。
• [僅限 Windows] 添加注冊(cè)表項(xiàng)- 一個(gè)com.postman.postmanapp項(xiàng)被添加到HKCU\Software\Google\Chrome\NativeMessagingHosts\. 鍵指向 JSON 文件（清單）的位置。
• 添加清單文件- 這是一個(gè) JSON 文件（其結(jié)構(gòu)由Native Messaging定義），它為 Chrome 提供了攔截器擴(kuò)展可以與之通信的可執(zhí)行文件的絕對(duì)路徑。該文件將安裝在取決于您的操作系統(tǒng)的位置：macOS - /Users/<username>/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.postman.postmanapp.json窗戶-%USERPROFILE%\.postman\InterceptorBridge\com.postman.postmanapp.jsonLinux- _~/.config/google-chrome/NativeMessagingHosts/com.postman.postmanapp.json
• 添加可執(zhí)行文件- 這是 Chrome 在攔截器擴(kuò)展需要時(shí)啟動(dòng)的新進(jìn)程。對(duì)于 Windows 和 Linux，這是一個(gè)獨(dú)立的二進(jìn)制文件。對(duì)于 macOS，這是一個(gè) JavaScript 文件。該文件必須是可執(zhí)行的。該可執(zhí)行文件將安裝在取決于您的操作系統(tǒng)的位置：macOS -$HOME/.postman/InterceptorBridge窗戶-%USERPROFILE%/.postman/InterceptorBridgeLinux- _$HOME/.postman/InterceptorBridge

故障排除提示

您可以通過從頁(yè)腳中選擇Capture requests ，然后選擇Via Interceptor來找到您的 Interceptor 集成的當(dāng)前狀態(tài)?？赡艿臓顟B(tài)是：

• 已連接- 您可以繼續(xù)使用攔截器。
• 未連接- 確保攔截器安裝正確。
• 依賴項(xiàng)未安裝- Postman 將引導(dǎo)您完成如何安裝所需的依賴項(xiàng)。

如果您在安裝或下載過程中遇到錯(cuò)誤，請(qǐng)檢查以下步驟來解決這些問題：

• CHROME_NOT_INSTALLED- 檢查是否安裝了 Chrome 以及NativeMessagingHosts文件夾是否存在于以下位置：macOS -~/Library/Application Support/Google/Chrome/NativeMessagingHostsLinux- _ ~/.config/google-chrome/NativeMessagingHosts窗戶-HKEY_CURRENT_USER\SOFTWARE\Google\Chrome\NativeMessagingHosts如果您使用不同風(fēng)格的 Chrome，例如 Chromium、Brave 或 Edge：NativeMessagingHosts在操作系統(tǒng)的正確位置創(chuàng)建目錄。安裝攔截器橋（請(qǐng)參閱安裝攔截器）。復(fù)制InterceptorBridge到NativeMessagingHosts目錄中。
• INTERNET_CONNECTIVITY-檢查您的互聯(lián)網(wǎng)連接。如果您坐在防火墻后面，請(qǐng)檢查您的入站和出站策略。如果您使用的是代理，請(qǐng)檢查其配置是否正確。
• FILE_PERMISSIONS_REQUIRED-確認(rèn)您有權(quán)創(chuàng)建.postman/InterceptorBridge文件夾。確認(rèn)您有權(quán)在路徑中刪除、寫入和執(zhí)行.postman/InterceptorBridge。[僅限 macOS] 確認(rèn)您擁有一個(gè)~/Downloads文件夾并為其寫入權(quán)限。如果這些步驟不成功，請(qǐng)?jiān)谥卦嚢惭b之前關(guān)閉 Chrome 和 Postman。
• [視窗]REGISTRY_ACCESS_NEEDED -確認(rèn)您有權(quán)添加注冊(cè)表項(xiàng)。確認(rèn)它C:\Windows\System32存在于PATH（系統(tǒng)環(huán)境變量）中，以便reg可以執(zhí)行查詢。

如果您在完成引導(dǎo)式安裝后無法使用集成，您需要檢查以下項(xiàng)目：

• [macOS] Node 已正確安裝- Node 已安裝并可用于/usr/local/node或/usr/local/bin/node，或者您設(shè)置了環(huán)境變量NVM_BIN。
• 清單文件位置- 清單文件 ( com.postman.postmanapp.json) 存在，具有正確的擴(kuò)展 ID ( aicmkgpgakddgnaphhhpliifpcfhicfo) 和正確的可執(zhí)行文件路徑。如果缺少，請(qǐng)刪除以下目錄并重新啟動(dòng)安裝過程：macOS / Linux -$HOME/.postman窗戶-%USERPROFILE%\.postman\
• 可執(zhí)行文件- 清單指向的可執(zhí)行文件存在，對(duì)于 Windows/Linux 大約為 40MB，對(duì)于 macOS 大約為 33KB。如果缺少，請(qǐng)刪除以下目錄并重新啟動(dòng)安裝過程：macOS / Linux -$HOME/.postman窗戶-%USERPROFILE%\.postman\

對(duì)于 macOS，NodeJS 下載程序保存到您的~/Downloads目錄中。

對(duì)于 Windows，如果您在 Postman 中遇到安裝錯(cuò)誤，請(qǐng)關(guān)閉 Chrome 并重試，然后再重復(fù)安裝過程。

如果上述故障排除步驟不能解決問題，您可能需要?jiǎng)h除 Interceptor 的所有依賴項(xiàng)（例如清單文件、Interceptor Bridge，對(duì)于 Windows 用戶，還有注冊(cè)表項(xiàng)）。為此，請(qǐng)打開 Postman 并選擇View > Developer > Show DevTools (Current View)。輸入pm.interceptorInstaller.reset()以刪除所有現(xiàn)有的攔截器依賴項(xiàng)。然后您可以從第 3 步繼續(xù)安裝。

如果由于權(quán)限問題無法刪除任何依賴項(xiàng)，系統(tǒng)將提示您手動(dòng)刪除它們。

如果您無法解決INTERNET_CONNECTIVITY錯(cuò)誤，您可以手動(dòng)安裝攔截器：

• macOS/Linux -[僅限 macOS] Node.js (>v6.0.0) 需要在/usr/local/node或 上安裝并可用/usr/local/bin/node，或者您需要設(shè)置環(huán)境變量NVM_BIN。安裝適用于macOS或Linux的網(wǎng)橋。運(yùn)行腳本install_host.sh。執(zhí)行腳本后，檢查以下項(xiàng)目：確認(rèn)InterceptorBridge文件存在于$HOME/.postman.確認(rèn)清單文件com.postman.postmanapp.json存在于~/Library/ApplicationSupport/Google/Chrome/NativeMessagingHostsmacOS 或~/.config/google-chrome/NativeMessagingHostsLinux。檢查它是否具有正確的擴(kuò)展 IDaicmkgpgakddgnaphhhpliifpcfhicfo和正確的$HOME/.postman可執(zhí)行文件路徑InterceptorBridge。
• 窗戶-安裝適用于Windows的網(wǎng)橋。運(yùn)行腳本install_host.bat。執(zhí)行腳本后，檢查以下項(xiàng)目：確認(rèn)InterceptorBridge.exe文件存在于%USERPROFILE%\.postman\。檢查此路徑HKEY_CURRENT_USER\SOFTWARE\Google\Chrome\NativeMessagingHosts是否com.postman.postmanapp.json存在具有正確擴(kuò)展 ID和可執(zhí)行文件的aicmkgpgakddgnaphhhpliifpcfhicfo正確路徑的清單文件。%USERPROFILE%\.postman\InterceptorBridge.exe

要根據(jù)您的操作系統(tǒng)運(yùn)行腳本，您可能需要雙擊或在 shell 中執(zhí)行安裝程序腳本。macOS 或 Windows 用戶可能會(huì)收到安全警告。例如，要覆蓋 macOS 上的安全性，您可能需要右鍵單擊文件并選擇打開。如果您使用 snap 安裝了 Postman（在 Linux 機(jī)器上），Interceptor 將無法連接，您必須在 snap 之外重新安裝 Postman。

安全

Interceptor 和 Postman 之間的通信是自動(dòng)加密的。您可以通過添加自定義加密密鑰使通信更加安全。

在 Postman 中添加自定義加密密鑰

1. 在 Postman 中，選擇 Postman 頁(yè)腳中的 捕獲請(qǐng)求。然后在Capture requests窗口中，選擇Via Interceptor選項(xiàng)卡。
2. 選擇綠色已連接狀態(tài) 旁邊的鎖定圖標(biāo) 。
3. 輸入 10 個(gè)或更多字符的字母數(shù)字密鑰，然后選擇保存密鑰。
4. 打開瀏覽器并選擇攔截器擴(kuò)展。選擇鎖定圖標(biāo)，輸入相同的密鑰，然后選擇保存密鑰。應(yīng)用程序和瀏覽器都將確認(rèn)連接是安全的。

使用 pm API 添加自定義加密密鑰

您還可以使用pm API更新默認(rèn)加密密鑰。為此，請(qǐng)打開 Postman 并選擇View > Developer > Show DevTools (Current View) > Console，然后輸入pm.interceptorBridge.setKey("<your key here>")。

對(duì)于 Interceptor 擴(kuò)展，首先在Chrome 擴(kuò)展中啟用開發(fā)者模式。然后，您可以右鍵單擊瀏覽器中的攔截器圖標(biāo)，選擇Inspect Popup > Console。在這里再次輸入命令。通過此通道的所有通信都將使用您自己的密鑰進(jìn)行加密。pm.interceptorBridge.setKey("<your key here>")

更新攔截器

1. 通過選擇 Chrome 應(yīng)用程序右上角的菜單圖標(biāo) >更多工具 > 擴(kuò)展程序，查看您現(xiàn)有的 Chrome 擴(kuò)展程序。
2. 選擇以打開右上角的開發(fā)人員模式。
3. 選擇左上角的更新以更新您的擴(kuò)展。

將攔截器與 Postman 的 Chrome 應(yīng)用程序一起使用

Postman 的 Chrome 應(yīng)用程序已棄用，不再提供與 Postman 原生功能相同的功能。強(qiáng)烈建議您切換到Postman native。

Postman Chrome 應(yīng)用程序的攔截器用作捕獲 HTTP 和 HTTPS 請(qǐng)求的代理。您可以使用 Interceptor 捕獲 Chrome 瀏覽器發(fā)出的請(qǐng)求并將它們發(fā)送到您的 Postman 歷史記錄中。

您可以根據(jù) URL 過濾請(qǐng)求，方法是在瀏覽器中選擇攔截器圖標(biāo)，然后在Filter requests下應(yīng)用過濾器。

您可以使用 Interceptor 為 Web 應(yīng)用程序創(chuàng)建 Postman 集合或調(diào)試您的 API。您還可以將 Postman Chrome 應(yīng)用程序與攔截器結(jié)合使用來發(fā)出和捕獲請(qǐng)求。

要將攔截器與 Postman Chrome 一起使用，請(qǐng)執(zhí)行以下操作：

1. 從 Chrome 網(wǎng)上應(yīng)用店安裝 Postman 。
2. 從 Chrome 網(wǎng)上應(yīng)用店安裝攔截器。
3. 打開 Postman，選擇工具欄中的 Interceptor 圖標(biāo)，然后選擇On。

然后，您可以瀏覽您的應(yīng)用程序或網(wǎng)站，并在請(qǐng)求流入您的 Postman 歷史記錄時(shí)對(duì)其進(jìn)行監(jiān)控。