Compartilhar via

Guia passo a passo sobre como definir as configurações de proxy

Se o ambiente de trabalho exigir que um gateway de dados local da Microsoft passe por um Servidor Proxy para se conectar ao serviço, use as etapas a seguir para definir as configurações de proxy.

Definir configurações de proxy

  1. Crie seu elemento de definição de proxy. Para saber mais sobre a configuração dos elementos de proxy para arquivos de configuração do .NET, vá para o elemento defaultProxy (configurações de rede).

    O exemplo a seguir roteia todas as solicitações por meio de um proxy específico com o endereço IP 192.168.0.1 na porta 8888:

    <defaultProxy useDefaultCredentials="true">
    <proxy  
        autoDetect="false"  
        proxyaddress="http://192.168.0.1:8888"
        bypassonlocal="false"
        usesystemdefault="false"
    />
</defaultProxy>

  2. Procure a pasta de instalação do gateway de dados local, por exemplo, *C:\Arquivos de Programas\Gateway de dados local*.

  3. Abra o primeiro arquivo usado para as telas de configuração que configuram o gateway, ou seja, EnterpriseGatewayConfigurator.exe.config.

  4. Localize o defaultProxy elemento e substitua-o pela configuração de proxy criada na etapa 1 e salve as alterações no arquivo.

  5. Abra o segundo arquivo usado para o serviço Windows real que interage com o serviço de nuvem usando o gateway e lida com as solicitações, ou seja, Microsoft.PowerBI.EnterpriseGateway.exe.config e repita a etapa 4.

  6. Para o terceiro arquivo de configuração usado para o gateway se conectar às fontes de dados, normalmente fontes de dados na nuvem, abra a subpasta m na pasta de instalação e, em seguida, o arquivo Microsoft.Mashup.Container.NetFX45.exe.config. Repita a etapa 4 para inserir a configuração de proxy nesse arquivo.

    Se o arquivo estiver no estado padrão, você precisará adicionar a tag system.net juntamente com a definição de proxy, como no exemplo a seguir:

    <system.net>
    <defaultProxy useDefaultCredentials="true">
        <proxy  
            autoDetect="false"  
            proxyaddress="http://192.168.0.1:8888"
            bypassonlocal="false"
            usesystemdefault="false"
        />
    </defaultProxy>
</system.net>

  7. Abra o aplicativo de gateway de dados local, navegue até a guia Configurações de Serviço e selecione Reiniciar agora para reiniciar o serviço de gateway e aplicar as novas configurações de proxy.

Verificar a configuração de proxy consistente

  1. Verifique se você está executando a versão de setembro de 2022 ou superior.

  2. Abra o aplicativo de gateway de dados local.

  3. Navegue até a guia Diagnóstico .

  4. Em Teste de portas de rede, selecione Iniciar novo teste.

  5. Depois que o teste de portas de rede for concluído, selecione Abrir os últimos resultados do teste concluído.

  6. Se a configuração do proxy for consistente entre os três arquivos de configuração necessários, uma Proxy configuration : Proxy settings match for all Gateway process configurations. mensagem será exibida.

  7. Caso contrário, se a configuração de proxy não for consistente, as seguintes informações serão exibidas:

    Proxy configuration : Proxy settings are not consistent. Please ensure that the proxy configuration matches across the files listed below:
C:\Program Files\On-premises data gateway\EnterpriseGatewayConfigurator.exe.config
C:\Program Files\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config
C:\Program Files\On-premises data gateway\m\Microsoft.Mashup.Container.NetFX45.exe.config
Review <https://docs.microsoft.com/data-integration/gateway/service-gateway-proxy>  for additional information about configuring proxies for the Gateway.

Quando você executa a verificação de consistência de configuração de proxy de um gateway de dados local (modo pessoal), os seguintes arquivos de configuração são verificados:

%LocalAppData%\Microsoft\On-premises data gateway (personal mode)\PersonalGatewayConfigurator.exe.config %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\m\Microsoft.Mashup.Container.NetFX45.exe.config

Comportamentos de configuração de proxy inconsistentes ou ausentes

Se a definição de proxy estiver ausente ou inconsistente, você poderá experimentar comportamentos diferentes com o gateway de dados local. Alguns exemplos são:

  • Um modelo semântico ou uma falha de atualização de fluxo de dados, exemplo de mensagem de erro: Error: Unable to connect to the remote server.
  • Ao iniciar o gateway de dados instalado no local, você não consegue fazer login, a janela de login é exibida, mas seu conteúdo não pode ser exibido ou uma página de mensagem de erro é exibida.
  • Os resultados do teste da Porta de Rede relatam falhas ao se conectar aos servidores.

Conteúdo relacionado

  • Last updated on