Source: https://swgbar.com/ja/guides/bypass-https-tls-inspection-mac/
Language: ja

# macOS で HTTPS・TLS 検査を回避する方法（Break-and-Inspect ガイド）

SWG bar を使い macOS で HTTPS・TLS Break-and-Inspect 復号をドメイン単位で回避する方法を解説。TLS 終端が HTTP/2・QUIC・ピンニングを壊す仕組みと CLI 検証手順も紹介します。

SWG bar · 更新日 2026年11月19日

セキュリティクライアント全体を無効化せずに、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 つのワークフローを妨げます。

1.  **証明書ピンニングと相互 TLS（mTLS）**：オリジンサーバーの公開鍵を固定しているアプリやクライアント証明書を提示するアプリは、ゲートウェイが独自のリーフ証明書に差し替えた瞬間にハンドシェイクを中断します。詳細は [SWG 検査下での証明書ピンニングと mTLS](<https://swgbar.com/ja/guides/certificate-pinning-mtls-swg-inspection-macos/>)をご覧ください。
2.  **HTTP/3（QUIC）および長時間持続する HTTP/2・WebSocket ストリーム**：TLS 接続をダウングレードまたはプロキシするゲートウェイは、UDP の QUIC ストリームを破棄したり、LLM のストリーミング応答を停滞させたり、IDE や WebSocket の永続チャネルを切断したりすることがよくあります。
3.  **独立した CLI・言語別 CA ストア**：`Node.js`、`Python`、`Git`、`Homebrew`、`Docker`、`Claude Code`、`Cursor` などのランタイムは独自のルート CA ストアを同梱しており、`CERTIFICATE_VERIFY_FAILED` や `UNABLE_TO_GET_ISSUER_CERT_LOCALLY` で失敗します。
4.  **レイテンシーに敏感な開発者向け 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 検査の除外設定の違い](<https://swgbar.com/ja/guides/swg-bypass-vs-tls-exception/>)をご覧ください。

## macOS で特定ドメインの HTTPS・TLS 検査を回避する

1.  **検査されているホスト名をすべて特定する**：**SWG bar → ドメイン**を開くか、[CLI](<https://swgbar.com/ja/cli/>) で `swgbar domains list --status confirmed` を実行します。`example.com`、`auth.example.com`、`api.example.com` は別々のホスト名である点に注意してください。
2.  **ドメイン単位の回避を有効にする**：対象ドメインの **SWG を回避**行で**オン**をクリックするか、次のコマンドを実行します。

```
swgbar bypass enable api.example.com
swgbar bypass status
```

3.  **プール済みの TLS および HTTP/3 接続を閉じる**：ブラウザーのタブを 1 回更新するだけでは、検査済み経路上の既存の HTTP/2 または QUIC ソケットが再利用される場合があります。SWG bar のネイティブ回避は新しい接続で HTTP/3 を TCP 上の HTTPS にフォールバックするため、**回避中**と表示された後にタブを再読み込みするか、対象アプリを終了して開き直してください。
4.  **新しい証明書チェーンを検証する**：`swgbar probe api.example.com`（または `openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null`）を実行し、オリジンサーバーの公開発行者が返されていることを確かめます。

**回避中**ではなく**復旧中**や**一時停止**が表示された場合は、[macOS で「復旧中」「一時停止」などの回避状態をトラブルシューティングする](<https://swgbar.com/ja/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)を確認してください。

## 回避をオフにする、または必要に応じて CA 信頼設定へ切り替える

有効になっている **SWG を回避**コントロールをもう一度クリックするか、`swgbar bypass disable <domain>` を実行すると、そのホスト名は即座に通常のゲートウェイ経路へ戻ります。SWG bar を終了した場合も実行中の回避は直ちに停止しますが、保存されたホスト名選択は次回起動時のために記憶されます。

ネットワークのファイアウォールが直接の外向き IPv4 通信をブロックしている場合は、回避を無効化し、[CLI・AI ツールの CA 信頼による解決策](<https://swgbar.com/ja/guides/swg-tls-certificate-errors-macos/>)を利用するか、該当ホスト名に対する管理者の **Do Not Decrypt** ルールを申請してください。

## 関連ガイド

*   [Mac で SWG を回避する方法（ドメイン単位のワンクリック回避と CLI）](<https://swgbar.com/ja/guides/how-to-bypass-swg/>)
*   [Mac で SSL 検査を回避する方法（企業 SWG とドメイン単位の解決策）](<https://swgbar.com/ja/guides/bypass-ssl-inspection-mac/>)
*   [Mac で企業プロキシと SWG の SSL 検査を回避する方法](<https://swgbar.com/ja/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Mac が SWG に傍受されているか確認する方法（HTTPS・SSL 検査の検出）](<https://swgbar.com/ja/guides/detect-https-inspection/>)
*   [会社・勤務先の Mac が HTTPS 通信を傍受（SSL 検査）しているか確認する方法](<https://swgbar.com/ja/guides/check-if-work-mac-intercepting-https/>)
*   [Mac 用 SSL 検査チェッカー：HTTPS 傍受を検出するメニューバーツール](<https://swgbar.com/ja/guides/ssl-inspection-checker-mac/>)
*   [Mac の Zscaler SSL 検査：ドメイン単位での確認と回避方法](<https://swgbar.com/ja/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Mac の Netskope SSL 検査：復号の確認とドメイン単位の回避方法](<https://swgbar.com/ja/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac の Cloudflare WARP と Zero Trust TLS 検査：検出と回避方法](<https://swgbar.com/ja/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar における HTTPS 検査の「確認済み」と「疑いあり」の違い](<https://swgbar.com/ja/guides/confirmed-vs-suspected-https-inspection/>)
*   [SWG bar で中間者（MITM）ルート証明書と発行者を検査する](<https://swgbar.com/ja/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac における企業向け SWG と MDM の HTTPS 検査（インスペクション）](<https://swgbar.com/ja/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 回避と TLS 検査の除外設定（Break-and-Inspect）の違い](<https://swgbar.com/ja/guides/swg-bypass-vs-tls-exception/>)
*   [Mac でマルチドメインの Web アプリ、SSO、CDN、API 向けに SWG を回避する](<https://swgbar.com/ja/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Mac で SWG 回避の「復旧中」「一時停止」や接続エラーを解決する](<https://swgbar.com/ja/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS の VPN 仮想インターフェースと SWG の HTTPS 検査の違い](<https://swgbar.com/ja/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [証明書ピンニングや mTLS を使うアプリが SWG 検査下で失敗する理由](<https://swgbar.com/ja/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Mac の CLI・AI ツールにおける SWG TLS/SSL 証明書エラーを解決する方法](<https://swgbar.com/ja/guides/swg-tls-certificate-errors-macos/>)
*   [Mac の SWG 配下における Homebrew、Docker、Python、Node.js の CA 信頼設定](<https://swgbar.com/ja/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Mac で Claude Code・Cursor の「unable to get local issuer certificate」を解決する方法（SWG・MCP）](<https://swgbar.com/ja/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Mac で openssl と security verify-cert を使い TLS 証明書を検証する](<https://swgbar.com/ja/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar の権限、ローカルプライバシーと TLS プローブ上限](<https://swgbar.com/ja/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar による HTTPS 検査の仕組み](<https://swgbar.com/ja/how-it-works/>)
*   [Mac 用 SWG bar のダウンロードとインストール（macOS 14 以降）](<https://swgbar.com/ja/install/>)
*   [SSL・HTTPS 検査を検出する Chrome 拡張機能（SWG Bar コンパニオン）](<https://swgbar.com/ja/chrome-extension/>)
*   [SWG bar CLI ガイド](<https://swgbar.com/ja/cli/>)
*   [SWG bar MCP ガイド](<https://swgbar.com/ja/mcp/>)
*   [SWG bar のリリース情報](<https://swgbar.com/ja/releases/>)
*   [SWG bar について](<https://swgbar.com/ja/about/>)
