Configuración de los valores del proxy para la puerta de enlace de datos local

El entorno de trabajo podría requerir que pasase por un proxy para acceder a Internet. Este requisito puede impedir que la puerta de enlace de datos local de Microsoft se conecte al servicio.

En la siguiente publicación de superuser.com se discute cómo puede intentar determinar si tiene un proxy en su red: ¿Cómo sé qué servidor proxy estoy usando? (SuperUser.com).

Aunque la mayoría de los ajustes de configuración de la puerta de enlace se pueden cambiar mediante la aplicación de puerta de enlace de datos local, la información del proxy se configura en un archivo de configuración .NET. La ubicación y los nombres de archivo serán diferentes dependiendo de la puerta de enlace que esté usando.

Hay tres archivos de configuración asociados con el uso de un proxy con la puerta de enlace de datos local. Los siguientes dos archivos de configuración principales se aplican a la puerta de enlace y su proceso de configuración.

  • El primero es para las pantallas de configuración, que en realidad configuran la puerta de enlace. Si tiene problemas para configurar la puerta de enlace, consulte el siguiente archivo: C:\Program Files\On-premises data gateway\enterprisegatewayconfigurator.exe.config. En la puerta de enlace de datos local (modo personal), el archivo correspondiente es %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\PersonalGatewayConfigurator.exe.config.
  • El segundo archivo es para el servicio real de Windows que interactúa con el servicio en la nube utilizando la puerta de enlace. Este archivo administra las solicitudes: C:\Program Files\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config. En la puerta de enlace de datos local (modo personal), el archivo correspondiente es %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config.

Si va a realizar cambios en la configuración del proxy, estos archivos deben editarse para que las configuraciones del proxy sean exactamente las mismas en ambos archivos.

El tercer archivo de configuración debe editarse para que la puerta de enlace se conecte a las fuentes de datos en la nube a través de un proxy.

  • C:\Program Files\On-premises data gateway\m\Microsoft.Mashup.Container.NetFX45.exe.config

En la puerta de enlace de datos local (modo personal), el archivo correspondiente es %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\m\Microsoft.Mashup.Container.NetFX45.exe.config.

La siguiente sección describe cómo editar estos archivos.

Configuración de los valores de proxy

El siguiente ejemplo muestra la configuración de proxy predeterminada que se encuentra en los dos archivos de configuración principales.

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

La configuración predeterminada funciona con la autenticación de Windows. Si el proxy usa otra forma de autenticación, debe cambiar la configuración. Si no está seguro, póngase en contacto con el administrador de la red.

No recomendamos la autenticación básica de proxy. El uso de la autenticación básica de proxy puede provocar errores de autenticación del proxy que hagan que la puerta de enlace no se configure correctamente. Use un mecanismo de autenticación de proxy más seguro para resolver.

Además de usar las credenciales predeterminadas, puede agregar un elemento <proxy> para definir la configuración del servidor proxy con más detalle. Por ejemplo, puede especificar que la puerta de enlace de datos local use siempre el proxy incluso para los recursos locales estableciendo el parámetro bypassonlocal en false. Esta configuración ayudar a solucionar situaciones para realizar un seguimiento de todas las solicitudes HTTPS que se originan en una puerta de enlace en los archivos de registro de proxy. La configuración del ejemplo siguiente especifica que todas las solicitudes deben pasar por un proxy específico con la dirección 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>

También debe editar el archivo Microsoft.Mashup.Container.NetFX45.exe.config si desea que la puerta de enlace se conecte a los orígenes de datos en la nube a través de una puerta de enlace.

En el archivo, expanda la sección <configurations> para incluir el contenido siguiente y actualice el atributo proxyaddress con la información del servidor proxy. En el siguiente ejemplo se enrutan todas las solicitudes de la nube a través de un proxy específico con la dirección 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>

La configuración de este tercer archivo puede ser necesaria si su proxy es un requisito para todas las comunicaciones por Internet, especialmente para uso corporativo donde las redes son seguras y bloqueadas. Si se requiere un proxy para la comunicación de la puerta de enlace, es probable que también sea necesario para el tráfico de Internet de los contenedores. En este caso, la puerta de enlace puede parecer que funciona correctamente hasta que cualquier contenedor realice una consulta externa (Internet). Este problema es especialmente aplicable a los flujos de datos, que intentan enviar la consulta resultante de los datos local a Azure Data Lake Storage. No obstante, también se aplica cuando una consulta de puerta de enlace combina un modelo semántico local con un modelo semántico vinculado a Internet.

Para más información acerca de la configuración de los elementos de proxy para los archivos de configuración de .NET, vaya a defaultProxy (Elemento, Configuración de red).

Configuración de la puerta de enlace para destinos de salida

Además, para usar la puerta de enlace con destinos de salida, es posible que sea necesario configurarla para poder pasar a través de un firewall o proxy para llegar al origen de datos de destino. Si usa un servidor proxy, este paso podría requerir direcciones URL de habilitación para enumerar los destinos adecuados, por ejemplo *.datawarehouse.pbidedicated.windows.net para Lakehouse, *.dfs.core.windows.net para Data Lake, etc.

Nota:

Si usa destinos de Lakehouse, debe ejecutar al menos la versión de mayo de 2023 de la puerta de enlace. El conector de Lakehouse no está disponible en las versiones de puerta de enlace anteriores a esta versión.

Cambiar la cuenta de servicio de la puerta de enlace de un usuario de dominio

Como se ha explicado antes, al configurar los ajustes de proxy para utilizar las credenciales predeterminadas, pueden producirse problemas de autenticación con el proxy. Esta situación se produce cuando la cuenta de servicio predeterminada es el servicio SID y no un usuario de dominio autenticado. Si el proxy de la organización requiere una cuenta de dominio para autenticar la solicitud, puede cambiar la cuenta de servicio de la puerta de enlace a una cuenta de servicio de dominio. Este cambio permite la autenticación adecuada con el proxy. Para obtener más información sobre cómo cambiar la cuenta del servicio de puerta de enlace, vaya a Cambiar la cuenta de servicio de puerta de enlace de datos local.

Nota:

Recomendamos que use una cuenta de servicio administrada para evitar tener que restablecer las contraseñas. Obtenga información acerca de cómo crear una cuenta de servicio administrada dentro de Active Directory.

Pasos siguientes