証明書ピンニングや mTLS を使うアプリが SWG 検査下で失敗する理由
MDM がルート CA を信頼していても、macOS 上で TLS 証明書ピンニングや相互 TLS(mTLS)を使用するアプリが企業の SWG HTTPS Break-and-Inspect 環境で失敗する仕組みを解説します。
SWG bar · 更新日
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 で証明書を再署名すると、次のことが起こります。
- macOS キーチェーンは、その SWG 証明書を有効と判断します。
- ピンニングされたアプリは、SWG 証明書の公開鍵フィンガープリントを組み込み済みのピンと比較します。
- フィンガープリントが一致しないため、アプリは中間者攻撃による傍受を防ぐために即座に TLS ハンドシェイクを中断します。
Break-and-Inspect により相互 TLS(mTLS)が壊れる理由
**相互 TLS(mTLS)**では、双方が認証を行います。アクセスが許可される前に、クライアントがオリジンサーバーへクライアント証明書を提示します(銀行系 API、B2B エンドポイント、ゼロトラスト API、ハードウェア紐付けの開発者サービスなどで一般的です)。
途中に SWG が介在して HTTP ペイロードを復号するために TLS 接続を終端してしまうと、オリジンサーバーには Mac 側のクライアント TLS ハンドシェイクではなく SWG からの接続が見えるため、ゲートウェイが暗号化パススルーとして動作するか該当ホストが除外されない限り、エンドツーエンドのクライアント証明書検証が失敗します。
Mac 上でどのホスト名が傍受されているか診断する
IT 部門へゲートウェイルールの設定を依頼したりローカルルールを構成したりする前に、ピンニングまたは mTLS を使用するアプリが接続している正確なホスト名を特定します。
- SWG bar を開き、対象アプリで接続エラーを再現させます。
- SWG bar → ドメインを確認する(または
swgbar domains list --status confirmedを実行する)ことで、そのアプリが通信している正確な API、CDN、またはアップデート用ホスト名を見つけます。 - ドメインの詳細と証明書タブを調べ、そのホストに対して企業の SWG ルート CA が TLS を終端しているかどうかを確認します。
アプリの API やアップデート用ホスト名が SWG bar の検査用 CA クラスター配下に表示されているか確認できます。
状況に応じた適切な解決策を選ぶ
- 本番環境・管理下の企業ワークフロー:TLS ピンニングを壊さずにゲートウェイ経由のルーティングを維持できるよう、IT またはセキュリティ管理者に対してピンニング/mTLS ホスト名の **TLS 検査除外(復号しないルール)**を依頼してください。詳しくは SWG 回避と TLS 検査の除外設定の違いをご覧ください。
- 許可されたローカル検証および開発:自身が管理するネットワークやテストを許可された環境では、ドメイン画面または
swgbar bypass enable <domain>からドメイン単位の SWG 回避を使い、該当ホスト名だけをゲートウェイ復号なしで接続できます。 - CLI や AI ランタイムの CA ストアエラー:厳格なピンニングではなく、
git、npm、Python、Claude Code、Cursorが macOS キーチェーンを参照していないことが原因の場合は、Mac の CLI・AI ツールにおける SWG TLS/SSL 証明書エラーを解決する方法の手順に従ってください。