Mac 上的 Netskope SSL 檢查:偵測解密與單網域繞過指南

檢查 Mac 上 Netskope Client 是否正在解密 HTTPS(*.goskope.com CA),對比 SWG bar 單網域繞過與 Do Not Decrypt 政策,並設定 nscacert_combined.pem。

SWG bar · 更新日期

要確認 Netskope Client 是否正在你的 Mac 上執行 SSL/TLS 解密,請開啟 SWG bar → 概覽(或執行 swgbar overview),查看網域劫持比例是否大於 0%,以及中間人憑證清單中是否出現 Netskope 或 *.goskope.com 租戶憑證。若在經授權的 Mac 上需要為特定主機名稱繞過 Netskope SSL 檢查,請開啟 SWG bar → 網域,選取目標主機名稱並在繞過 SWG列按一下開啟(或執行 swgbar bypass enable <domain>)。

Netskope 安全 Web 閘道在企業 macOS 裝置中廣泛採用 NetworkExtension 流量轉導用戶端與租戶專屬中繼 CA。由於 MDM 會將 Netskope 根憑證派發至 macOS 鑰匙圈,瀏覽器會顯示正常的有效安全圖示,而 CLI 執行時期(pip、npm、AWS CLI、git、Docker、Claude Code)及憑證固定桌面應用程式卻常因拒收重簽憑證而報出 CERTIFICATE_VERIFY_FAILED 或 UNABLE_TO_GET_ISSUER_CERT_LOCALLY。

1. 驗證 Netskope 是否正在解密你 Mac 上的特定網域

同時檢查系統整體攔截狀況與個別主機名稱:

  • 透過 SWG bar 在選單列與 Chrome 即時查看:安裝 SWG bar(macOS 14+ Apple 晶片,14 個使用日免費試用)並瀏覽目標網站或重現指令。開啟 SWG bar → 網域或執行 swgbar domains list --status confirmed,即可列出所有被 Netskope 租戶 CA(常見命名如 ca.<tenant>.goskope.com 或企業自訂 CA)重簽憑證的主機名稱;搭配免費的 SWG bar Chrome 擴充功能,亦可在瀏覽器工具列直接檢視狀態。
  • 在終端機檢查 Netskope 憑證與即時簽發者:
# 檢查 macOS 系統鑰匙圈是否已安裝 Netskope CA
security find-certificate -c "Netskope" /Library/Keychains/System.keychain

# 檢視特定主機名稱實際回傳的即時憑證簽發者
openssl s_client -connect registry.npmjs.org:443 -servername registry.npmjs.org </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject

請留意 Netskope 政策常針對部分 SaaS 或程式碼託管網域執行解密,對另一些網域則僅轉導而不解密,因此務必測試真正發生故障的確切主機名稱。

2. 為什麼直接關閉 Netskope Client 通常無效

在啟用 Protect Client configuration and resources 防竄改政策的受管環境下,Netskope 選單列圖示中的 Disable 選項會被停用或要求密碼解鎖,強行卸載守護行程則會直接中斷系統網路路由。清除 macOS Wi-Fi 代理設定同樣毫無作用,因為 Netskope 是在 macOS NetworkExtension 層級攔截流量。

3. 在 macOS 上選擇合適的 Netskope 解決方案

方案 是否停止 Netskope 解密? 需要 Netskope 租戶管理員? 最適合的情境
單網域 SWG 繞過(SWG bar) 是,針對所選主機名稱走實體硬體網卡 IPv4 否(經授權 Mac 本機控制) 憑證固定應用、WebSocket 或開發端點在 Netskope 解密下異常,且具備可用實體 IPv4 直連路徑(如何在 Mac 上繞過 SWG)
Netskope 租戶 Do Not Decrypt / 憑證固定應用例外 是,全受管 Mac 統一排除 是(Policies → SSL Decryption → Do Not Decrypt 或 Steering Configuration → Exceptions) 團隊共用開發端點或企業級憑證固定桌面應用全面異常(SWG 繞過與 TLS 例外對比)
CLI 工具組合憑證鏈(nscacert_combined.pem) 否(流量仍維持檢查) 否 企業政策要求流量繼續經 Netskope 解密,僅需讓 CLI/AI 工具信任 Netskope CA 鏈

4. 套用單網域繞過或設定 Netskope CLI CA 信任

方案 A:經授權時透過 SWG bar 開啟單網域繞過

  1. 開啟 SWG bar → 網域,選取受檢查的確切主機名稱(例如 api.anthropic.com 或 pypi.org),在繞過 SWG列按一下開啟,或執行 swgbar bypass enable <domain>。
  2. 等待狀態顯示繞過中後,重啟瀏覽器分頁、終端機工具或 IDE,使既有的 TLS/HTTP/3 連線池切換至實體硬體網卡 IPv4 介面重新連線。
  3. 執行 swgbar probe <domain> 確認已收到來源伺服器的公開憑證鏈;若需立即還原,點擊已啟用控制項或執行 swgbar bypass disable <domain>。

方案 B:為 Netskope 環境下的 CLI 工具建立組合 PEM 憑證檔

若流量必須維持由 Netskope 檢查,可從 macOS 信任存放區匯出組合 PEM 檔案(或直接使用 IT 提供的 nscacert_combined.pem),並在 ~/.zshrc 中指向該檔案:

security find-certificate -a -p \
  /System/Library/Keychains/SystemRootCertificates.keychain \
  /Library/Keychains/System.keychain > "$HOME/.certs/nscacert_combined.pem"

export NODE_EXTRA_CA_CERTS="$HOME/.certs/nscacert_combined.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
export SSL_CERT_FILE="$HOME/.certs/nscacert_combined.pem"
export AWS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"

更多工具設定請參閱修復 Mac 終端機 CLI 與 AI 工具中的 SWG TLS/SSL 憑證錯誤與 Homebrew、Docker、Python 與 Node.js 的 CA 信任設定。