macOS で HTTPS・TLS 検査を回避する方法(Break-and-Inspect ガイド)
SWG bar を使い macOS で HTTPS・TLS Break-and-Inspect 復号をドメイン単位で回避する方法を解説。TLS 終端が HTTP/2・QUIC・ピンニングを壊す仕組みと CLI 検証手順も紹介します。
SWG bar · 更新日
セキュリティクライアント全体を無効化せずに、macOS 上の特定ドメインに対する HTTPS または TLS 検査(Break-and-Inspect)を回避するには、SWG bar → ドメインを開いてホスト名を選択し、SWG を回避を有効にします(または swgbar bypass enable <domain> を実行します)。その行に回避中と表示されるまで待ってから、ブラウザーのタブ、IDE、または CLI セッションを再起動すると、Mac の物理(物理)IPv4 インターフェース経由で新しい TLS ハンドシェイクが確立されます。
企業向けのセキュア Web ゲートウェイ(SWG)や次世代ファイアウォールは、信頼された中間者(Man-in-the-Middle)として振る舞うことで HTTPS 通信を検査します。Mac からの外向き TLS 1.2/1.3 ハンドシェイクを終端して復号済みの HTTP ペイロードを検査し、オリジンサーバーへ向けて再暗号化します。ブラウザーは MDM でインストールされたゲートウェイのルート CA を自動的に信頼しますが、最新のプロトコルや厳格な開発者クライアントは TLS 再署名の下で頻繁に動作不良を起こします。
HTTPS・TLS Break-and-Inspect が Mac 上で実際に壊すもの
Mac のキーチェーンが企業のルート証明書を信頼していても、インライン TLS 終端は macOS のよくある 4 つのワークフローを妨げます。
- 証明書ピンニングと相互 TLS(mTLS):オリジンサーバーの公開鍵を固定しているアプリやクライアント証明書を提示するアプリは、ゲートウェイが独自のリーフ証明書に差し替えた瞬間にハンドシェイクを中断します。詳細は SWG 検査下での証明書ピンニングと mTLSをご覧ください。
- HTTP/3(QUIC)および長時間持続する HTTP/2・WebSocket ストリーム:TLS 接続をダウングレードまたはプロキシするゲートウェイは、UDP の QUIC ストリームを破棄したり、LLM のストリーミング応答を停滞させたり、IDE や WebSocket の永続チャネルを切断したりすることがよくあります。
- 独立した CLI・言語別 CA ストア:
Node.js、Python、Git、Homebrew、Docker、Claude Code、Cursorなどのランタイムは独自のルート CA ストアを同梱しており、CERTIFICATE_VERIFY_FAILEDやUNABLE_TO_GET_ISSUER_CERT_LOCALLYで失敗します。 - レイテンシーに敏感な開発者向け API:すべての TLS ハンドシェイクを遠隔地のクラウド SWG PoP に迂回させると、パッケージのインストール、
git fetch、リアルタイムコード補完に往復遅延が上乗せされます。
ドメイン単位の TLS 回避 vs. ローカルプロキシ設定 vs. ゲートウェイ除外
| 観点 | ドメイン単位の回避(SWG bar) |
管理者による TLS 検査除外(Do Not Decrypt) |
ローカルプロキシ編集(システム設定 → プロキシ) |
|---|---|---|---|
| 動作レイヤー | macOS NetworkExtension によるホスト名単位の物理 IPv4 ルーティング | 中央の SWG/ファイアウォール復号ポリシー | OS の明示的 HTTP/HTTPS プロキシ設定欄のみ |
| 透過型 SWG に対して機能するか? | はい(物理 IPv4 経路へ到達可能な場合) | はい(IT 部門が設定) | いいえ(utun や透過型 SWG エージェントにより無視または上書きされる) |
| IT 管理コンソールが必要か? | いいえ(権限のある Mac 上でローカル制御) | はい(Zscaler、Netskope、Cloudflare、Palo Alto の管理ポータル) | いいえ |
| デバイスポスチャ/SSO を維持できるか? | はい(企業のエンドポイントエージェントは稼働したまま) | はい | 企業の PAC ルーティングを壊すことが多い |
経路変更とゲートウェイ側の復号除外をアーキテクチャ面から詳しく比較したい場合は、SWG 回避と TLS 検査の除外設定の違いをご覧ください。
macOS で特定ドメインの HTTPS・TLS 検査を回避する
- 検査されているホスト名をすべて特定する:SWG bar → ドメインを開くか、CLI で
swgbar domains list --status confirmedを実行します。example.com、auth.example.com、api.example.comは別々のホスト名である点に注意してください。 - ドメイン単位の回避を有効にする:対象ドメインの SWG を回避行でオンをクリックするか、次のコマンドを実行します。
swgbar bypass enable api.example.com
swgbar bypass status
- プール済みの TLS および HTTP/3 接続を閉じる:ブラウザーのタブを 1 回更新するだけでは、検査済み経路上の既存の HTTP/2 または QUIC ソケットが再利用される場合があります。SWG bar のネイティブ回避は新しい接続で HTTP/3 を TCP 上の HTTPS にフォールバックするため、回避中と表示された後にタブを再読み込みするか、対象アプリを終了して開き直してください。
- 新しい証明書チェーンを検証する:
swgbar probe api.example.com(またはopenssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null)を実行し、オリジンサーバーの公開発行者が返されていることを確かめます。
回避中ではなく復旧中や一時停止が表示された場合は、macOS で「復旧中」「一時停止」などの回避状態をトラブルシューティングするを確認してください。
回避をオフにする、または必要に応じて CA 信頼設定へ切り替える
有効になっている SWG を回避コントロールをもう一度クリックするか、swgbar bypass disable <domain> を実行すると、そのホスト名は即座に通常のゲートウェイ経路へ戻ります。SWG bar を終了した場合も実行中の回避は直ちに停止しますが、保存されたホスト名選択は次回起動時のために記憶されます。
ネットワークのファイアウォールが直接の外向き IPv4 通信をブロックしている場合は、回避を無効化し、CLI・AI ツールの CA 信頼による解決策を利用するか、該当ホスト名に対する管理者の Do Not Decrypt ルールを申請してください。