ProxyOverrideRules

Proxy-Außerkraftsetzungsregeln

Unterstützte Versionen

• Windows: ≥ 145
• macOS: ≥ 145
• Android: Nicht unterstützt
• iOS: Nicht unterstützt

Beschreibung

Diese Richtlinie ermöglicht die regelbasierte Proxyauswahl, die anhand der Ziel-URL und aller anderen von Ihnen definierten Bedingungen bestimmt, welchen Proxy Microsoft Edge verwendet.

Wenn diese Richtlinie konfiguriert ist, hat sie Vorrang vor Proxyeinstellungen, die von der ProxySettings-Richtlinie, der Edge.proxy-Erweiterungs-API und manuellen Benutzereinstellungen konfiguriert werden.

Wenn diese Richtlinie deaktiviert oder nicht konfiguriert ist, gelten weiterhin vorhandene Proxyrichtlinien und benutzerdefinierte Einstellungen.

Wenn Edge einen Proxy auswählt, wertet es Einträge in der ProxyOverrideRules-Richtlinie in der richtigen Reihenfolge aus. Eine Regel wird als Übereinstimmung betrachtet, wenn alle folgenden Bedingungen erfüllt sind:

• Mindestens ein URL-Muster in DestinationMatchers wird abgeglichen.
• Es wurde kein URL-Muster in ExcludeDestinationMatchers abgeglichen.
• Wenn Bedingungen angegeben und nicht leer ist, sind alle Bedingungen erfüllt.

Für eine Abgleichsregel wird der in ProxyList angegebene Wert als Proxy verwendet. Wenn keine Regel übereinstimmt, greift die Proxyauswahl auf die von der ProxySettings-Richtlinie definierten Einstellungen zurück.

Die von DestinationMatchers und ExcludeDestinationMatchers unterstützten URL-Muster sind unter Proxyunterstützung in Microsoft Edge dokumentiert. Einträge in ProxyList entsprechen Proxyzeichenfolgen im PAC-Stil, z. B.:

• DIREKTE
• PROXYhost:Port
• HTTPS-Host:Port
• SOCKS4 host:port
• SOCKS5 host:port

Alternativ können Proxyspezifizierer in URL-Form verwendet werden, z. B.:

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

Der erste erreichbare Proxy in der Liste wird verwendet. Ungültige Einträge werden ignoriert.

Das Feld Bedingungen gibt Bedingungen an, die alle erfüllt sein müssen, damit eine Überschreibungsregel angewendet wird, wenn ein Proxy ausgewählt wird. Wenn dieses Feld nicht festgelegt ist, wird die Regel angewendet, wenn mindestens ein Host in DestinationMatchers übereinstimmt.

Die DnsProbe-Bedingung überprüft, ob der angegebene DNS-Host in eine IP-Adresse aufgelöst werden kann. Der Host muss einen Hostnamen (z. B. example.com) enthalten und kann optional ein Schema oder port (z. https://example.comB. , example.com:123 oder https://example.com:123) enthalten. Wenn ein sicheres Schema (z. B. https) angegeben wird, kann die DNS-Suche auch den HTTPS-Eintrag anfordern (siehe RFC 9460).

Wenn Result auf aufgelöst festgelegt ist, ist die Bedingung erfüllt, wenn die Auflösung erfolgreich ist. Wenn auf not_found festgelegt ist, wird die Bedingung nur erfüllt, wenn die Auflösung fehlschlägt.

Unterstützte Features

• Kann zwingend erforderlich sein: Ja
• Kann empfohlen werden: Nein
• Dynamische Richtlinienaktualisierung: Ja
• Profilspezifisch: Ja
• Gilt für ein Profil, das mit einem Microsoft-Konto angemeldet ist: Ja
• Kann nur über eine Cloudrichtlinie im Edge-Verwaltungsdienst konfiguriert werden: Ja

Datentyp

• Dictionary

Windows-Informationen und -Einstellungen

Informationen zur Gruppenrichtlinie (ADMX)

• Eindeutiger GP-Name: ProxyOverrideRules
• GP-Name: Proxy-Außerkraftsetzungsregeln
• GP-Pfad (verpflichtend): Administrative Templates/Microsoft Edge/Proxy server
• GP Pfad (Empfohlen): n.a.
• GP ADMX Dateiname: MSEdge.admx

Beispielwert

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

Registrierungseinstellungen

• Pfad (verpflichtend): SOFTWARE\Policies\Microsoft\Edge
• Pfad (Empfohlen): n.a.
• Wertname: ProxyOverrideRules
• Werttyp: REG_SZ

Beispielregistrierungswert

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

Erweiterter Beispielregistrierungswert

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

Mac – Informationen und Einstellungen

• Einstellung Schlüsselname: ProxyOverrideRules
• Beispielwert:

<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://other.app.org</string>
    </array>
    <key>ProxyList</key>
    <array>
      <string>HTTPS proxy.app:443</string>
      <string>DIRECT</string>
    </array>
  </dict>
  <dict>
    <key>DestinationMatchers</key>
    <array>
      <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>

Weitere Informationen

• Microsoft Edge-Richtlinien