Mac でマルチドメインの Web アプリ、SSO、CDN、API 向けに SWG を回避する

ルートドメイン 1 つだけを回避しても現代のアプリでは不十分な理由と、SWG bar でログイン・CDN・API のホスト名を特定し Keep-Alive 接続を確実にリセットする方法を解説します。

SWG bar · 更新日

macOS で SWG を回避を有効にした際によくある意外な現象として、メインの Web ページ自体は再読み込みできるのに、サインインのリダイレクト、画像、パッケージのダウンロード、API 呼び出しが引き続き HTTPS 検査に当たったり失敗したりすることがあります。SWG bar は正確なホスト名単位で回避ルールを適用するため、マルチドメイン構成の Web アプリや開発ツールでは複数の別ホストが関係します。

単一ホスト名の回避がサブドメインを含まない理由

app.example.com で回避を有効にしても、対象になるのは app.example.com のみです。次のホストは自動的には回避されません。

  • シングルサインオン(SSO)および OAuth プロバイダー:login.example.com、auth.example.com、sso.company.com、またはサードパーティの ID ホスト(accounts.google.com、login.microsoftonline.com など)。
  • API および AI エンドポイント:api.example.com、graphql.example.com、または独立したテレメトリ/ストリーミング用サブドメイン。
  • 静的アセットおよびレジストリ:cdn.example.net、assets.example.com、またはオブジェクトストレージバケット(*.s3.amazonaws.com、objects.githubusercontent.com など)。

なお、識別不能なホスト名や暗号化 SNI(ECH)を用いたホスト名は、ドメイン単位の回避ルールで照合できません。

アプリが使用するすべての検査対象ホスト名を見つける

  1. SWG bar で監視を実行した状態で、対象のウェブサイトを開くか、エラーになる開発者ワークフローを一度実行します。
  2. SWG bar → ドメインを開き、確認済み/疑いありで並べ替えや絞り込みを行ってキーワード(例:example や auth)で検索するか、CLI から照会します。
swgbar domains list --status confirmed --search example
swgbar domains list --bypass active
  1. ワークフローに必要な各検査対象ホスト名について、詳細を開いて SWG を回避を有効にするか、swgbar bypass enable <hostname> を実行します。
  2. 許可されたネットワーク上で 1 つの認証ドメインや API ドメインを回避したからといって、無関係なすべてのドメインを回避する必要はありません。ルールは本当に必要な特定のホスト名だけに限定して設定してください。

Keep-Alive 接続を閉じて Chrome の状態を確認する

回避中と表示された後でも、ブラウザーやバックグラウンドデーモンは、古い検査経由の経路で確立された既存の HTTP/2、HTTP/3、または TLS Keep-Alive ソケットを再利用することがあります。

  • Web ブラウザー:影響を受けるタブをスーパーリロード(Cmd + Shift + R)するか、サイトが長寿命の WebSocket や HTTP/3 接続を使用している場合はブラウザーウィンドウを閉じて開き直します。Chrome 拡張機能を使えば現在のタブで表示されたアクティブなホスト名を確認できますが、この拡張機能は Chrome のライブソケットを検査するのではなく、SWG bar に記録された観測結果を表示する点にご留意ください。
  • ターミナルおよび IDE:長時間実行されているプロセス(npm、Claude Code デーモン、IDE の言語サーバー、git 認証情報ヘルパーなど)を再起動し、物理インターフェース経由で新しい TCP/TLS 接続を開かせます。

各ホスト名を個別に検証する

ルールを更新したら、ドメインを開く(または swgbar domains detail <hostname> を実行する)ことで、ブラウザーのアドレスバーに表示されているトップレベル URL だけでなく、ワークフロー内のすべてのホスト名で新しいプローブが公開信頼を確認していることを確かめてください。組織全体の SaaS や SSO ドメインがチーム全員に影響している場合は、管理者のポリシー除外の方が適しているかどうかを SWG 回避と TLS 検査の除外設定の違いで比較してください。