ProxyOverrideRules

Reglas de invalidación de proxy

Versiones compatibles

• Windows: ≥ 145
• macOS: ≥ 145
• Android: no compatible
• iOS: no compatible

Descripción

Esta directiva permite la selección de proxy basada en reglas que determina qué proxy usa Microsoft Edge en función de la dirección URL de destino y otras condiciones que defina.

Cuando configura esta directiva, tiene prioridad sobre la configuración de proxy configurada por la directiva ProxySettings, la API de extensión chrome.proxy y cualquier configuración manual de usuario.

Si deshabilita esta directiva o no la configura, las directivas de proxy existentes y la configuración definida por el usuario seguirán aplicándose.

Al seleccionar un proxy, Microsoft Edge evalúa las entradas de la directiva ProxyOverrideRules en orden. Una regla coincide cuando se cumplen todas las siguientes condiciones:

• Al menos un patrón de URL en DestinationMatchers coincide.
• No hay coincidencias de patrones de dirección URL en ExcludeDestinationMatchers.
• Si se especifica Condiciones y no está vacío, se cumplirán todas las condiciones.

Para la primera regla coincidente, Microsoft Edge usa el proxy especificado en ProxyList. Si no coincide ninguna regla, la selección del proxy vuelve a la configuración definida por la directiva ProxySettings.

Los patrones de dirección URL admitidos por DestinationMatchers y ExcludeDestinationMatchers se documentan en https://learn.microsoft.com/deployedge/configure-microsoft-edge-proxy-support#proxy-config-url-patterns.

Las entradas de ProxyList usan cadenas de proxy de estilo PAC, por ejemplo:

• DIRECTO
• PROXY host:puerto
• HTTPS host:puerto
• SOCKS4 host:port
• SOCKS5 host:port

También puede usar especificadores de proxy de formulario de dirección URL, por ejemplo:

• http://host:port
• https://host:port
• calcetines4://host:port
• calcetines5://host:port

Microsoft Edge usa el primer proxy accesible de la lista. Las entradas no válidas se omiten.

El campo Condiciones define requisitos adicionales que deben cumplirse antes de aplicar una regla de invalidación. Si no se especifica este campo, la regla se aplica siempre que un destino coincida con DestinationMatchers.

La condición DnsProbe comprueba si el host DNS especificado se puede resolver en una dirección IP. El host debe incluir un nombre de host (por ejemplo, example.com) y, opcionalmente, puede incluir un esquema o un puerto (por ejemplo, https://example.com, example.com:123 o https://example.com:123). Si se especifica un esquema seguro (por ejemplo, https), la búsqueda DNS también podría solicitar el registro HTTPS (consulte RFC 9460).

Si Resultado se establece en resuelto, la condición se cumplirá cuando la resolución de nombres se realice correctamente. Si se establece en not_found, la condición solo se cumple cuando se produce un error en la resolución de nombres.

En los dispositivos administrados, la aplicación de esta directiva se controla mediante la directiva EnableProxyOverrideRulesForAllUsers de nivel de equipo. De forma predeterminada, no se aplican las reglas de invalidación configuradas por usuarios no afiliados.

Características admitidas

• Puede ser obligatorio: sí
• Puede ser recomendable: no
• Actualización de directiva dinámica: sí
• Por perfil: Sí
• Se aplica a un perfil que ha iniciado sesión con una cuenta de Microsoft: Sí
• Solo se puede configurar a través de la directiva de nube en el servicio de administración de Edge Edge: Sí

Tipo de datos

• Diccionario

Información y configuración de Windows

Información de directiva de grupo (ADMX)

• Nombre único de GP: ProxyOverrideRules
• Nombre de GP: reglas de invalidación de proxy
• Ruta de acceso GP: Plantillas administrativas/Microsoft Edge Update/Servidor proxy
• Ruta de acceso de GP (recomendado): N/D
• Nombre de archivo de ADMX GP: MSEdge.admx

Valor de ejemplo

[{"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"]}]

Configuración del Registro

• Ruta de acceso (obligatoria): SOFTWARE\Policies\Microsoft\Edge
• Ruta de acceso (recomendado): N/D
• Nombre del valor: ProxyOverrideRules
• Tipo de valor: REG_SZ

Ejemplo de valor del Registro

[{"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"]}]

Ejemplo expandido de valor del Registro

[
  {
    "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"
    ]
  }
]

Información y configuración de Mac

• Nombre clave de la preferencia: ProxyOverrideRules
• Valor de ejemplo:

<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>

Consulte también

• Microsoft Edge: directivas