Mac の Zscaler SSL 検査:ドメイン単位での確認と回避方法

Zscaler Client Connector が Mac で HTTPS を復号しているか確認する方法、Tamper Protection 下で ZCC を停止できない理由、ドメイン単位の回避や CLI CA 信頼設定を解説します。

SWG bar · 更新日

**Zscaler(ZIA / Zscaler Client Connector)**が Mac 上の HTTPS 通信を復号しているかどうかを確認するには、SWG bar → 概要を開き(または swgbar overview を実行し)、ドメイン通信の傍受率が 0% を超えていて、中間者証明書に Zscaler Root CA または企業の中間 CA が表示されているかを確認します。権限のある Mac で支障が出ている単一のホスト名について Zscaler の SSL 検査を回避するには、SWG bar → ドメインを開き、対象ホスト名を選択して SWG を回避を有効にします(または swgbar bypass enable <domain> を実行します)。

Zscaler を回避する方法を紹介するネット上のガイドの多くは、Zscaler Admin Portal(ZIA)へのログイン権限があることを前提としています。Jamf、Kandji、Intune で管理された会社支給の MacBook では、開発者や社員が管理ポータルへアクセスできることはほとんどありません。それにもかかわらず、Zscaler の Z-Tunnel 2.0(NetworkExtension / utun トンネル)と Zscaler Root CA は、証明書ピンニングアプリ、Homebrew、npm、git、Python、Docker、Claude Code、Cursor を頻繁に動作不能にします。

1. Zscaler が Mac で HTTPS を実際に検査しているか確認する

MDM が Zscaler Root CA をあらかじめ macOS キーチェーンにインストールして信頼設定しているため、Zscaler が HTTPS Break-and-Inspect を行っていても Safari や Chrome には通常の鍵アイコンが表示されます。次のいずれかの方法で、ドメイン単位の復号を確認してください。

  • SWG bar による継続的な確認:SWG bar をインストール(Apple シリコン搭載 Mac・macOS 14 以降、14 使用日間の無料トライアル)して対象サイトへアクセスします。SWG bar → ドメインまたは証明書を開く(あるいは swgbar probe <domain> を実行する)ことで、そのドメインが Zscaler Root CA(または自社の Zscaler 中間 CA)による傍受として確認済みか、それとも公開の信頼パスで通過しているかを確認できます。
  • ターミナルで 1 ドメインをスポット確認する:
openssl s_client -connect api.github.com:443 -servername api.github.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject

issuer= に公開 CA(DigiCert、Let’s Encrypt、Google Trust Services など)ではなく Zscaler や組織独自の Zscaler 中間 CA が表示される場合、そのホスト名で Zscaler の SSL 検査が有効です。SHA-256 フィンガープリントの照合方法は OpenSSL と security verify-cert で TLS 証明書を検証するをご覧ください。

2. Zscaler Client Connector のログアウトやアンロードが失敗する理由

管理対象の Mac で Zscaler を全体的に無効化しようとすると、ほとんどの場合逆効果になります。

  • Tamper Protection(改ざん防止):多くの企業向け ZCC App Profile では、ログアウトや Internet Security(ZIA)の無効化に IT 部門のワンタイムパスワードが必要であり、sudo launchctl bootout system /Library/LaunchDaemons/com.zscaler.* はブロックされるか直ちに再起動されます。
  • Z-Tunnel 2.0 はシステムプロキシ設定をバイパスする:macOS のシステム設定で Wi-Fi の HTTP/HTTPS プロキシトグルをオフにしても、Z-Tunnel 2.0 のパケット制御には影響しません。
  • 社内アクセスが壊れる:仮に ZCC を停止できたとしても、ZPA(Zscaler Private Access)経由の社内アプリや、デバイスポスチャ連動の SSO(Okta、Entra ID)が動作しなくなります。

3. macOS で Zscaler SSL 検査に対処する 3 つの実践的な方法

アプローチ 管理主体 ZCC と社内 SSO を維持できるか? 最適なユースケース
ドメイン単位の SWG 回避(SWG bar) ローカルの Mac ユーザー(権限のあるネットワーク上) はい — 選択したホスト名のみ Mac の物理 物理 IPv4 インターフェース経由でルーティング ZCC を止めずに、ピンニングアプリ・WebSocket・動作しない開発者 API をホスト名単位で即座に復旧させたい場合(Mac で SWG を回避する方法)
Zscaler Admin Portal の除外設定(Do Not Inspect / App Profile) 企業 IT/セキュリティチーム はい Policy → SSL Inspection → Do Not Inspect や macOS App Profiles → Hostname/IP Bypass での組織全体向け恒久除外(SWG 回避と TLS 検査の除外設定の違い)
Zscaler Root CA を書き出して CLI ツールで信頼する ローカルの開発者 はい(通信は引き続き検査される) 企業ポリシー上復号経路の維持が必須で、git、npm、brew、Python、Claude Code、Cursor が unable to get local issuer certificate で失敗する場合

4. ドメイン単位の回避を有効化するか、CLI ツール向けに Zscaler Root CA を設定する

方法 A:SWG bar でドメイン単位の回避を行う(権限がある場合)

  1. SWG bar → ドメインを開き、失敗している正確なホスト名を見つけて(ログイン、API、CDN は別ホスト名である点に注意 — マルチドメインの SSO、API、CDN 向け SWG 回避を参照)、SWG を回避の横にあるオンをクリックします(または swgbar bypass enable <domain> を実行します)。
  2. 回避中と表示されるのを待ってから、ブラウザーのタブ、IDE、または CLI セッションを再起動し、プール済み接続を直接の 物理 IPv4 経路で開き直します。
  3. swgbar probe <domain> を実行し、オリジンサーバーの公開証明書チェーンが返されていることを確認します。ファイアウォールが直接の外向き接続をブロックしている場合は、swgbar bypass disable <domain> を実行して即座に通常の Zscaler 経路へ戻してください。

方法 B:CLI・AI ツールに Zscaler Root CA を信頼させる

ネットワークポリシー上 Zscaler による復号を維持する必要がある場合は、キーチェーンアクセスから Zscaler Root CA の PEM バンドルを書き出す(または IT 部門から PEM ファイルを入手する)ことで、SSL 検証を無効にせず各ランタイムへ設定します。

# Node.js, npm, Claude Code, Cursor
export NODE_EXTRA_CA_CERTS="$HOME/.certs/zscaler-root.pem"

# Python (pip, requests), OpenSSL, Homebrew curl
export SSL_CERT_FILE="$HOME/.certs/zscaler-root.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"
export CURL_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"

# Git
git config --global http.sslCAInfo "$HOME/.certs/zscaler-root.pem"

Homebrew、Docker Desktop、Python、Node.js、Claude Code、Cursor を網羅した詳細な設定手順は、Homebrew、Docker、Python、Node.js の CA 信頼設定および macOS で Claude Code・Cursor の証明書エラーを解決する方法をご覧ください。