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 開啟單網域繞過
- 開啟 SWG bar → 網域,選取受檢查的確切主機名稱(例如
api.anthropic.com或pypi.org),在繞過 SWG列按一下開啟,或執行swgbar bypass enable <domain>。 - 等待狀態顯示繞過中後,重啟瀏覽器分頁、終端機工具或 IDE,使既有的 TLS/HTTP/3 連線池切換至實體硬體網卡 IPv4 介面重新連線。
- 執行
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 信任設定。