Definir configurações de proxy para o gateway de dados local

  • Artigo

Seu ambiente de trabalho pode exigir que você passe por um proxy para acessar a internet. Esse requisito pode impedir que o gateway de dados local da Microsoft se conecte ao serviço.

A seguinte postagem no superuser.com discute como você pode tentar determinar se você tem um proxy em sua rede: Como sei qual servidor proxy estou usando? (SuperUser.com).

Embora a maioria das definições de configuração de gateway possa ser alterada usando o aplicativo de gateway de dados local, as informações de proxy são configuradas em um arquivo de configuração .NET. O local e os nomes dos arquivos são diferentes, dependendo do gateway que você está usando.

Há três arquivos de configuração associados ao uso de um proxy com o gateway de dados local. Os dois arquivos de configuração principais a seguir se aplicam ao gateway e seu processo de configuração.

  • O primeiro arquivo é para as telas de configuração que realmente configuram o gateway. Se você estiver tendo problemas para configurar o gateway, examine o seguinte arquivo: C: \Program Files\On-premises data gateway\enterprisegatewayconfigurator.exe.config. No gateway de dados local (modo pessoal), o arquivo correspondente é %LocalAppData%\Microsoft\On-premises data gateway (modo pessoal)\PersonalGatewayConfigurator.exe.config.
  • O segundo arquivo é para o serviço real do Windows que interage com o serviço de nuvem usando o gateway. Esse arquivo lida com as solicitações: C: \Arquivos de Programas\Gateway de dados local\Microsoft.PowerBI.EnterpriseGateway.exe.config. No gateway de dados local (modo pessoal), o arquivo correspondente é %LocalAppData%\Microsoft\On-premises data gateway (modo pessoal)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config.

Se você vai fazer alterações na configuração de proxy, esses arquivos devem ser editados para que as configurações de proxy sejam exatamente as mesmas em ambos os arquivos.

O terceiro arquivo de configuração precisa ser editado para que o gateway se conecte a fontes de dados na nuvem por meio de um proxy.

  • C:\Arquivos de Programas\Gateway de dados local\m\Microsoft.Mashup.Container.NetFX45.exe.config

No gateway de dados local (modo pessoal), o arquivo correspondente é %LocalAppData%\Microsoft\On-premises data gateway (modo pessoal)\m\Microsoft.Mashup.Container.NetFX45.exe.config.

A seção a seguir descreve como editar esses arquivos.

Definir configurações de proxy

O exemplo a seguir mostra a configuração de proxy padrão encontrada em ambos os dois arquivos de configuração principais.

<system.net>
    <defaultProxy useDefaultCredentials="true" />
</system.net>

A configuração padrão funciona com a autenticação do Windows. Se o proxy usar outra forma de autenticação, você deverá alterar as configurações. Se não tiver a certeza, contacte o administrador da rede.

Não recomendamos a autenticação básica de proxy. O uso da autenticação de proxy básica pode causar erros de autenticação de proxy que resultam na configuração incorreta do gateway. Use um mecanismo de autenticação de proxy mais forte para resolver.

Além de usar credenciais padrão, você pode adicionar um <proxy> elemento para definir as configurações do servidor proxy com mais detalhes. Por exemplo, você pode especificar que seu gateway de dados local sempre deve usar o proxy, mesmo para recursos locais, definindo o parâmetro bypassonlocal como false. Essa configuração pode ajudar na solução de problemas de situações para rastrear todas as solicitações HTTPS originadas de um gateway nos arquivos de log de proxy. A configuração de exemplo a seguir especifica que todas as solicitações devem passar por um proxy específico com o endereço IP 192.168.1.10.

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

Você também precisa editar o arquivo Microsoft.Mashup.Container.NetFX45.exe.config se quiser que o gateway se conecte a fontes de dados na nuvem por meio de um gateway.

No arquivo, expanda a <configurations> seção para incluir o seguinte conteúdo e atualize o proxyaddress atributo com suas informações de proxy. O exemplo a seguir roteia todas as solicitações de nuvem por meio de um proxy específico com o endereço IP 192.168.1.10.

<configuration>
    <system.net>
        <defaultProxy useDefaultCredentials="true" enabled="true">
        <proxy proxyaddress="http://192.168.1.10:3128" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>

A configuração deste terceiro arquivo pode ser necessária se o seu proxy for um requisito para toda a comunicação pela Internet, especialmente para uso corporativo, onde as redes são seguras e bloqueadas. Se um proxy for necessário para comunicação de gateway, provavelmente também será necessário para qualquer tráfego de internet de contêineres. Nesse caso, o gateway pode parecer estar operando com êxito até que qualquer contêiner faça qualquer consulta externa (internet). Esse problema é especialmente aplicável a fluxos de dados, que tentam enviar por push a consulta resultante de dados locais para o Armazenamento do Azure Data Lake. Mas também se aplica quando uma consulta de gateway mescla um modelo semântico local com um modelo semântico vinculado à Internet.

Para saber mais sobre a configuração dos elementos proxy para arquivos de configuração .NET, vá para defaultProxy Element (Network settings).

Configurar gateway para destinos de saída

Além disso, para usar o gateway com destinos de saída, o gateway pode precisar ser configurado para poder passar por um firewall ou proxy para chegar à fonte de dados de destino. Se você estiver usando um servidor proxy, essa passagem pode exigir a ativação de URLs de listagem para destinos apropriados, por exemplo, *.datawarehouse.pbidedicated.windows.net para LakeHouse, *.dfs.core.windows.net para Data Lake e assim por diante.

Nota

Se você estiver usando destinos LakeHouse, você deve estar executando pelo menos a versão de maio de 2023 do gateway. O conector Lakehouse não está disponível em versões de gateway anteriores a esta versão.

Alterar a conta de serviço de gateway para um usuário de domínio

Como explicado anteriormente, quando você define as configurações de proxy para usar credenciais padrão, você pode se deparar com problemas de autenticação com seu proxy. Essa situação ocorre quando a conta de serviço padrão é o SID de serviço e não um usuário de domínio autenticado. Se o proxy em sua organização exigir uma conta de domínio para autenticar a solicitação, você poderá alterar a conta de serviço do gateway para uma conta de serviço de domínio. Esta alteração permite a autenticação adequada com o seu proxy. Para obter mais informações sobre como alterar a conta de serviço de gateway, vá para Alterar a conta de serviço de gateway de dados local.

Nota

Recomendamos que você use uma conta de serviço gerenciado para evitar ter que redefinir senhas. Saiba como criar uma conta de serviço gerenciado no Ative Directory.

Próximos passos