ProxyOverrideRules

Regras de substituição de proxy

Versões com suporte

• Windows: ≥ 145
• macOS: ≥ 145
• Android: sem suporte
• iOS: sem suporte

Descrição

Essa política permite a seleção de proxy com base em regras que determina qual proxy o Microsoft Edge usa com base na URL de destino e em quaisquer outras condições que você definir.

Quando essa política é configurada, ela tem precedência sobre as configurações de proxy definidas pela política ProxySettings, a API de extensão Edge.proxy e quaisquer configurações manuais de usuário.

Se essa política estiver desabilitada ou não configurada, as políticas de proxy existentes e as configurações definidas pelo usuário continuarão a ser aplicadas.

Quando o Edge seleciona um proxy, ele avalia as entradas na política ProxyOverrideRules em ordem. Uma regra será considerada uma correspondência quando todas as seguintes condições forem atendidas:

• Pelo menos um padrão de URL em DestinationMatchers é correspondido.
• Nenhum padrão de URL em ExcludeDestinationMatchers é correspondido.
• Se Conditions for especificado e não vazio, todas as condições serão satisfeitas.

Para uma regra de correspondência, o valor especificado em ProxyList é usado como proxy. Se nenhuma regra corresponder, a seleção de proxy retornará às configurações definidas pela política ProxySettings.

Os padrões de URL com suporte por DestinationMatchers e ExcludeDestinationMatchers são documentados no Suporte de Proxy no Microsoft Edge . As entradas em ProxyList correspondem a cadeias de caracteres de proxy no estilo PAC, como:

• DIRETO
• PROXY host:port
• HTTPS host:port
• SOCKS4 host:port
• SOCKS5 host:port

Como alternativa, especificadores de proxy de formulário de URL podem ser usados, por exemplo:

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

O primeiro proxy alcançável na lista é usado. As entradas inválidas são ignoradas.

O campo Condições especifica as condições que devem ser atendidas para que uma regra de substituição seja aplicada ao selecionar um proxy. Se este campo não estiver definido, a regra será aplicada quando pelo menos um host em DestinationMatchers corresponder.

A condição DnsProbe verifica se o host DNS especificado pode ser resolvido para um endereço IP. O host deve incluir um nome de host (por exemplo, example.com) e pode, opcionalmente, incluir um esquema ou porta (por exemplo, https://example.com, example.com:123 ou https://example.com:123). Quando um esquema seguro (por exemplo, https) é especificado, a pesquisa de DNS também pode solicitar o registro HTTPS (consulte RFC 9460).

Se Result for definido como resolved, a condição será atendida quando a resolução for bem-sucedida. Se definido como not_found, a condição será atendida somente quando a resolução falhar.

Recursos com suporte

• Pode ser obrigatório: Sim
• Pode ser recomendável: não
• Atualização dinâmica das políticas: Sim
• Por perfil: Sim
• Aplica-se a um perfil conectado com uma conta Microsoft: Sim
• Só pode ser configurado por meio da política de nuvem no serviço de gerenciamento do Edge: Sim

Tipo de dados

• Dictionary

Informações e configurações do Windows

Informações da Política de Grupo (ADMX)

• Nome Exclusivo da Política de Grupo: ProxyOverrideRules
• Nome da Política de Grupo: Regras de substituição de proxy
• Caminho da Política de Grupo: Administrative Templates/Microsoft Edge/Proxy server
• Caminho da Política de Grupo (recomendado): N/A
• Nome do arquivo ADMX da Política de Grupo: MSEdge.admx

Valor de exemplo

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

Configurações do registro

• Caminho (obrigatório): SOFTWARE\Policies\Microsoft\Edge
• Caminho (recomendado): N/A
• Nome do valor: ProxyOverrideRules
• Tipo do valor: REG_SZ

Exemplo de valor do Registro

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

Valor do Registro de exemplo expandido

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

Informações e configurações do Mac

• Nome da chave de preferência: ProxyOverrideRules
• Valor de exemplo:

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

Consulte também

• Microsoft Edge - Políticas