Source: https://swgbar.com/ja/guides/certificate-pinning-mtls-swg-inspection-macos/
Language: ja

# 証明書ピンニングや mTLS を使うアプリが SWG 検査下で失敗する理由

MDM がルート CA を信頼していても、macOS 上で TLS 証明書ピンニングや相互 TLS（mTLS）を使用するアプリが企業の SWG HTTPS Break-and-Inspect 環境で失敗する仕組みを解説します。

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

MDM で管理された Mac を利用する社員は、通常のウェブサイトは企業のセキュア Web ゲートウェイ（SWG）配下でも問題なく開くのに、特定のデスクトップアプリ、セキュリティアップデーター、モバイル SDK、開発者 API だけがただちに TLS ハンドシェイクで失敗する現象によく直面します。多くの場合、その原因は**証明書ピンニング**または\*\*相互 TLS（mTLS）\*\*が SWG の **HTTPS/SSL Break-and-Inspect** と衝突していることにあります。

## MDM のルート信頼では証明書ピンニングを解決できない理由

通常の HTTPS ブラウジングでは、Safari や Chrome は **macOS キーチェーン**内の認証局（MDM によって配布された企業のルート CA を含む）に連なる有効な証明書チェーンであればすべて信頼します。

しかし、\*\*TLS 証明書ピンニング（HPKP / SPKI ピンニング）\*\*を実装したアプリはもう一歩踏み込んでおり、想定される公開鍵ハッシュ（SPKI）やリーフ／中間証明書をアプリケーションバイナリ内に直接埋め込んでいます。企業の SWG が TLS を終端し、独自の企業ルート CA で証明書を再署名すると、次のことが起こります。

1.  macOS キーチェーンは、その SWG 証明書を有効と判断します。
2.  ピンニングされたアプリは、SWG 証明書の公開鍵フィンガープリントを組み込み済みのピンと比較します。
3.  フィンガープリントが一致しないため、アプリは中間者攻撃による傍受を防ぐために即座に TLS ハンドシェイクを中断します。

## Break-and-Inspect により相互 TLS（mTLS）が壊れる理由

\*\*相互 TLS（mTLS）\*\*では、双方が認証を行います。アクセスが許可される前に、クライアントがオリジンサーバーへクライアント証明書を提示します（銀行系 API、B2B エンドポイント、ゼロトラスト API、ハードウェア紐付けの開発者サービスなどで一般的です）。

途中に SWG が介在して HTTP ペイロードを復号するために TLS 接続を終端してしまうと、オリジンサーバーには Mac 側のクライアント TLS ハンドシェイクではなく SWG からの接続が見えるため、ゲートウェイが暗号化パススルーとして動作するか該当ホストが除外されない限り、エンドツーエンドのクライアント証明書検証が失敗します。

## Mac 上でどのホスト名が傍受されているか診断する

IT 部門へゲートウェイルールの設定を依頼したりローカルルールを構成したりする前に、ピンニングまたは mTLS を使用するアプリが接続している正確なホスト名を特定します。

1.  [SWG bar](<https://swgbar.com/ja/install/>) を開き、対象アプリで接続エラーを再現させます。
2.  **SWG bar → ドメイン**を確認する（または `swgbar domains list --status confirmed` を実行する）ことで、そのアプリが通信している正確な API、CDN、またはアップデート用ホスト名を見つけます。
3.  ドメインの詳細と**証明書**タブを調べ、そのホストに対して企業の SWG ルート CA が TLS を終端しているかどうかを確認します。

![ルート CA と関連ドメイン数を表示する SWG bar の証明書タブの例示プレビュー。](<https://swgbar.com/optimized/panel-native-certificates-four-tabs-720.webp>)

_アプリの API やアップデート用ホスト名が SWG bar の検査用 CA クラスター配下に表示されているか確認できます。_

## 状況に応じた適切な解決策を選ぶ

*   **本番環境・管理下の企業ワークフロー**：TLS ピンニングを壊さずにゲートウェイ経由のルーティングを維持できるよう、IT またはセキュリティ管理者に対してピンニング／mTLS ホスト名の \*\*TLS 検査除外（復号しないルール）\*\*を依頼してください。詳しくは [SWG 回避と TLS 検査の除外設定の違い](<https://swgbar.com/ja/guides/swg-bypass-vs-tls-exception/>)をご覧ください。
*   **許可されたローカル検証および開発**：自身が管理するネットワークやテストを許可された環境では、**ドメイン**画面または `swgbar bypass enable <domain>` から[ドメイン単位の SWG 回避](<https://swgbar.com/ja/guides/how-to-bypass-swg/>)を使い、該当ホスト名だけをゲートウェイ復号なしで接続できます。
*   **CLI や AI ランタイムの CA ストアエラー**：厳格なピンニングではなく、`git`、`npm`、`Python`、`Claude Code`、`Cursor` が macOS キーチェーンを参照していないことが原因の場合は、[Mac の CLI・AI ツールにおける SWG TLS/SSL 証明書エラーを解決する方法](<https://swgbar.com/ja/guides/swg-tls-certificate-errors-macos/>)の手順に従ってください。

## 関連ガイド

*   [Mac で SWG を回避する方法（ドメイン単位のワンクリック回避と CLI）](<https://swgbar.com/ja/guides/how-to-bypass-swg/>)
*   [Mac で SSL 検査を回避する方法（企業 SWG とドメイン単位の解決策）](<https://swgbar.com/ja/guides/bypass-ssl-inspection-mac/>)
*   [macOS で HTTPS・TLS 検査を回避する方法（Break-and-Inspect ガイド）](<https://swgbar.com/ja/guides/bypass-https-tls-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/>)
*   [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/>)
