Delen via

Proxy-instellingen voor de on-premises gegevensgateway configureren

Uw werkomgeving vereist mogelijk dat u via een proxy toegang krijgt tot internet. Deze vereiste kan verhinderen dat de on-premises gegevensgateway van Microsoft verbinding maakt met de service.

In het volgende bericht op superuser.com wordt besproken hoe u kunt proberen te bepalen of u een proxy in uw netwerk hebt: Hoe weet ik welke proxyserver ik gebruik? (SuperUser.com).

Hoewel de meeste gatewayconfiguratie-instellingen kunnen worden gewijzigd met behulp van de on-premises gegevensgateway-app, worden proxygegevens geconfigureerd in een .NET-configuratiebestand. De locatie- en bestandsnamen verschillen, afhankelijk van de gateway die u gebruikt.

Er zijn vier configuratiebestanden gekoppeld aan het gebruik van een proxy met de on-premises gegevensgateway. De volgende twee hoofdconfiguratiebestanden zijn van toepassing op de gateway en het configuratieproces.

  • Het eerste bestand is bedoeld voor de configuratieschermen waarmee de gateway daadwerkelijk wordt geconfigureerd. Als u problemen ondervindt met het configureren van de gateway, bekijkt u het volgende bestand: C:\Program Files\On-premises data gateway\enterprisegatewayconfigurator.exe.config. Op de on-premises gegevensgateway (persoonlijke modus) wordt het bijbehorende bestand %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\PersonalGatewayConfigurator.exe.config.
  • Het tweede bestand is bedoeld voor de werkelijke Windows-service die communiceert met de cloudservice met behulp van de gateway. Dit bestand verwerkt de aanvragen: C:\Program Files\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config. Op de on-premises gegevensgateway (persoonlijke modus) wordt het bijbehorende bestand %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config.

Als u wijzigingen wilt aanbrengen in de proxyconfiguratie, moeten deze bestanden worden bewerkt, zodat proxyconfiguraties exact hetzelfde zijn in beide bestanden.

Het derde configuratiebestand moet worden bewerkt voor de gateway om via een proxy verbinding te maken met cloudgegevensbronnen.

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

Op de on-premises data-gateway (persoonlijke modus) is het bijbehorende bestand %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\m\Microsoft.Mashup.Container.NetFX45.exe.config.

Het vierde configuratiebestand moet worden bewerkt voor de gateway om verbinding te maken met Fabric Pipelines-services via een proxy. Sinds de versie van februari 2025 (3000.258) is de naam van het configuratiebestand gewijzigd in:

  • C:\Program Files\On-premises data gateway\FabricIntegrationRuntime\5.0\Shared\FabricPipelineworker.exe.config.

Als u een eerdere versie gebruikt, is het configuratiebestand:

  • C:\Program Files\On-premises data gateway\FabricIntegrationRuntime\5.0\Shared\Fabricworker.exe.config.

In de volgende sectie wordt beschreven hoe u deze bestanden bewerkt.

Proxy-instellingen configureren

In het volgende voorbeeld ziet u de standaardproxyconfiguratie in beide hoofdconfiguratiebestanden.

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

De standaardconfiguratie werkt met Windows-verificatie. Als uw proxy een andere vorm van verificatie gebruikt, moet u de instellingen wijzigen. Als u het niet zeker weet, neemt u contact op met de netwerkbeheerder.

We raden basis proxy-authenticatie niet aan. Het gebruik van basisproxyverificatie kan leiden tot proxyverificatiefouten die ertoe leiden dat de gateway niet correct wordt geconfigureerd. Gebruik een sterker verificatiemechanisme voor proxy's om dit op te lossen.

Naast het gebruik van standaardreferenties kunt u een <proxy> element toevoegen om proxyserverinstellingen in meer detail te definiëren. U kunt bijvoorbeeld opgeven dat uw on-premises gegevensgateway altijd de proxy moet gebruiken, zelfs voor lokale resources, door de bypassonlocal-parameter in te stellen op false. Deze instelling kan helpen bij het oplossen van problemen om alle HTTPS-aanvragen bij te houden die afkomstig zijn van een gateway in de proxylogboekbestanden. De volgende voorbeeldconfiguratie geeft aan dat alle aanvragen een specifieke proxy moeten doorlopen met het IP-adres 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>

U moet ook het Microsoft.Mashup.Container.NetFX45.exe.config-bestand bewerken als u wilt dat de gateway via een gateway verbinding maakt met cloudgegevensbronnen.

Vouw in het bestand de <configurations> sectie uit om de volgende inhoud op te nemen en werk het proxyaddress kenmerk bij met uw proxygegevens. In het volgende voorbeeld worden alle cloudaanvragen via een specifieke proxy gerouteerd met het IP-adres 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>

Het configureren van dit derde bestand kan nodig zijn als uw proxy een vereiste is voor alle internetcommunicatie, met name voor zakelijk gebruik waarbij netwerken veilig en vergrendeld zijn. Als een proxy is vereist voor gatewaycommunicatie, is dit waarschijnlijk ook nodig voor internetverkeer van containers. In dit geval lijkt de gateway mogelijk goed te werken totdat een container een externe (internet)-query uitvoert. Dit probleem is met name van toepassing op gegevensstromen, die proberen de resulterende query van on-premises gegevens naar Azure Data Lake Storage te pushen. Maar dit geldt ook wanneer een gatewayquery een lokaal semantisch model samenvoegt met een semantisch model dat via internet toegankelijk is.

Ga naar defaultProxy-element (netwerkinstellingen) voor meer informatie over de configuratie van de proxy-elementen voor .NET-configuratiebestanden.

Gateway configureren voor uitvoerbestemmingen

Naast het gebruiken van de gateway met uitvoerbestemmingen, moet de gateway mogelijk worden geconfigureerd om door een firewall of proxy heen te gaan en de doelgegevensbron te kunnen bereiken. Als u een proxyserver gebruikt, is voor deze passthrough mogelijk inschakelen van URL's vereist voor de juiste bestemmingen, bijvoorbeeld *.datawarehouse.pbidedicated.windows.net voor LakeHouse, *.dfs.core.windows.net voor Data Lake, enzovoort.

Opmerking

Als u LakeHouse-bestemmingen gebruikt, moet u ten minste de release van mei 2023 van de gateway uitvoeren. De Lakehouse-connector is niet beschikbaar in gatewayversies vóór deze release.

Het gatewayserviceaccount wijzigen in een domeingebruiker

Zoals eerder is uitgelegd, kunt u, wanneer u de proxy-instellingen configureert voor het gebruik van standaardreferenties, verificatieproblemen met uw proxy tegenkomen. Deze situatie treedt op wanneer het standaardserviceaccount de service-SID is en geen geverifieerde domeingebruiker. Als voor de proxy in uw organisatie een domeinaccount is vereist om de aanvraag te verifiëren, kunt u het serviceaccount van de gateway wijzigen in een domeinserviceaccount. Met deze wijziging kunt u de juiste verificatie met uw proxy uitvoeren. Voor meer informatie over het wijzigen van het serviceaccount voor de gateway, gaat u naar Het serviceaccount voor de on-premises data gateway wijzigen.

Opmerking

U wordt aangeraden een beheerd serviceaccount te gebruiken om te voorkomen dat u wachtwoorden opnieuw moet instellen. Informatie over het maken van een beheerd serviceaccount in Active Directory.

Volgende stappen