ProxyOverrideRules

プロキシ オーバーライド規則

サポートされているバージョン

  • Windows: ≥ 145
  • macOS: ≥ 145
  • Android: サポートされていません
  • iOS: サポートされていません

説明

このポリシーを使用すると、ルール ベースのプロキシ選択が有効になり、定義した宛先 URL やその他の条件に基づいて Microsoft Edge が使用するプロキシが決定されます。

このポリシーを構成すると、ProxySettings ポリシー、chrome.proxy 拡張機能 API、および手動のユーザー設定で構成されたプロキシ設定よりも優先されます。

このポリシーを無効にするか、構成しない場合、既存のプロキシ ポリシーとユーザー定義の設定が引き続き適用されます。

プロキシを選択すると、Microsoft Edge は ProxyOverrideRules ポリシーのエントリを順番に評価します。 ルールは、次のすべてに当てはまる場合に一致します。

  • DestinationMatchers の少なくとも 1 つの URL パターンが一致します。
  • ExcludeDestinationMatchers に一致する URL パターンはありません。
  • Conditions が指定されていて空でない場合、すべての条件が満たされます。

最初の一致ルールの場合、Microsoft Edge は ProxyList で指定されたプロキシを使用します。 一致するルールがない場合、プロキシの選択は ProxySettings ポリシーで定義された設定にフォールバックします。

DestinationMatchers と ExcludeDestinationMatchers でサポートされている URL パターンについては、 https://learn.microsoft.com/deployedge/configure-microsoft-edge-proxy-support#proxy-config-url-patterns を参照してください。

ProxyList のエントリでは、次のような PAC スタイルのプロキシ文字列が使用されます。

  • 直接購入
  • PROXY host:port
  • HTTPS host:port
  • SOCKS4 host:port
  • SOCKS5 host:port

次に例を挙げると、URL 形式のプロキシ指定子も使用できます。

  • http://host:port
  • https://host:port
  • socks4://host:port
  • socks5://host:port

Microsoft Edge は、一覧内の最初の到達可能なプロキシを使用します。 無効なエントリは無視されます。

[条件] フィールドでは、上書き規則を適用する前にすべて満たす必要がある追加の要件を定義します。 このフィールドが指定されていない場合、宛先が DestinationMatchers と一致するたびにルールが適用されます。

DnsProbe 条件は、指定された DNS ホストを IP アドレスに解決できるかどうかを確認します。 ホストにはホスト名 (example.com など) を含める必要があり、必要に応じてスキームまたはポート ( https://example.com、example.com:123、 https://example.com:123 など) を含めることができます。 セキュリティ スキーム (https など) が指定されている場合、DNS 参照は HTTPS レコードも要求する場合があります (RFC 9460 を参照)。

Result が resolved に設定されている場合、名前解決が成功するとコマンドが実行されます。 not_found に設定した場合、名前解決が失敗した場合にのみ条件が満たされます。

管理対象デバイスでは、このポリシーの適用は、コンピューター レベルの EnableProxyOverrideRulesForAllUsers ポリシーによって制御されます。 既定では、関連付けられていないユーザーで構成されたオーバーライド ルールは適用されません。

サポートされている機能

  • 必須にすることができるか: はい
  • 推奨にすることができるか: いいえ
  • 動的なポリシーの更新: はい
  • プロファイルごと: はい
  • Microsoft アカウントでサインインしているプロファイルに適用: はい
  • Edge 管理サービスでクラウド ポリシーを使用してのみ構成できます: はい

データ型

  • Dictionary

Windows の情報と設定

グループ ポリシー (ADMX) 情報

  • GP 固有の名前: ProxyOverrideRules
  • GP 名: プロキシ オーバーライド規則
  • GP パス (必須): 管理用テンプレート/Microsoft Edge/プロキシ サーバー
  • GP パス (推奨): なし
  • GP ADMX ファイル名: MSEdge.admx

値の例

[{"Conditions": [{"DnsProbe": {"Host": "corp.ads", "Result": "resolved"}}], "DestinationMatchers": ["https://some.app.com", "https://Contoso.com"], "ExcludeDestinationMatchers": ["https://mail.Contoso.com"], "ProxyList": ["HTTPS proxy.app:443", "DIRECT"]}]

レジストリの設定

  • パス (必須): SOFTWARE\Policies\Microsoft\Edge
  • パス (推奨): なし
  • 値の名前: ProxyOverrideRules
  • 値の型: REG_SZ

レジストリ値の例

[{"Conditions": [{"DnsProbe": {"Host": "corp.ads", "Result": "resolved"}}], "DestinationMatchers": ["https://some.app.com", "https://Contoso.com"], "ExcludeDestinationMatchers": ["https://mail.Contoso.com"], "ProxyList": ["HTTPS proxy.app:443", "DIRECT"]}]

拡張されたレジストリ値の例

[
  {
    "Conditions": [
      {
        "DnsProbe": {
          "Host": "corp.ads",
          "Result": "resolved"
        }
      }
    ],
    "DestinationMatchers": [
      "https://some.app.com",
      "https://Contoso.com"
    ],
    "ExcludeDestinationMatchers": [
      "https://mail.Contoso.com"
    ],
    "ProxyList": [
      "HTTPS proxy.app:443",
      "DIRECT"
    ]
  }
]

Mac の情報と設定

  • 基本設定キーの名前: ProxyOverrideRules
  • サンプル値:
<key>ProxyOverrideRules</key>
<array>
  <dict>
    <key>Conditions</key>
    <array>
      <dict>
        <key>DnsProbe</key>
        <dict>
          <key>Host</key>
          <string>corp.ads</string>
          <key>Result</key>
          <string>resolved</string>
        </dict>
      </dict>
    </array>
    <key>DestinationMatchers</key>
    <array>
      <string>https://some.app.com</string>
      <string>https://Contoso.com</string>
    </array>
    <key>ExcludeDestinationMatchers</key>
    <array>
      <string>https://mail.Contoso.com</string>
    </array>
    <key>ProxyList</key>
    <array>
      <string>HTTPS proxy.app:443</string>
      <string>DIRECT</string>
    </array>
  </dict>
</array>

関連項目