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

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

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

安裝攔截器

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

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

使用攔截器

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

您只能同時運行一個代理或攔截器調(diào)試會話。

要啟動攔截器會話，請執(zhí)行以下操作：

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

運行攔截器調(diào)試會話

當您的攔截器會話正在運行時，攔截器調(diào)試會話窗口將在您使用 Chrome 瀏覽器時顯示捕獲的流量。

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

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

當您從“請求”選項卡上的列表中選擇一個或多個請求時，您可以使用以下控件：

•  刪除- 刪除請求。

當您從Cookie選項卡上的列表中選擇一個或多個 cookie 時，您可以使用以下控件：

• + 添加到 Cookie Jar - 將請求添加到 Postman cookie jar。
•  刪除- 刪除 cookie。

右下角顯示捕獲會話的總時間，以及捕獲流量的總大小。如果您想暫時停止捕獲會話，請選擇暫停。要重新啟動捕獲會話，請選擇Resume。

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

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

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

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

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

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

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

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

怎么運行的

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

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

您的安裝可能包括以下選項：

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

故障排除提示

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

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

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

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

如果您在完成引導式安裝后無法使用集成，您需要檢查以下項目：

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

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

對于 Windows，如果您在 Postman 中遇到安裝錯誤，請關閉 Chrome 并重試，然后再重復安裝過程。

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

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

如果您無法解決INTERNET_CONNECTIVITY錯誤，您可以手動安裝攔截器：

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

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

安全

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

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

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

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

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

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

更新攔截器

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

將攔截器與 Postman 的 Chrome 應用程序一起使用

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

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

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

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

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

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

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