Proxy-instellingen configureren voor de on-premises gegevensgateway

  • Artikel

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 kan ik weten 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 drie 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 configuratiecontroles 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 gegevensgateway\enterprisegatewayconfigurator.exe.config. Op de on-premises gegevensgateway (persoonlijke modus) is het bijbehorende bestand %LocalAppData%\Microsoft\On-premises gegevensgateway (persoonlijke modus)\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 gegevensgateway\Microsoft.PowerBI.EnterpriseGateway.exe.config. Op de on-premises gegevensgateway (persoonlijke modus) is het bijbehorende bestand %LocalAppData%\Microsoft\On-premises gegevensgateway (persoonlijke modus)\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 gegevensgateway\m\Microsoft.Mashup.Container.NetFX45.exe.config

Op de on-premises gegevensgateway (persoonlijke modus) is het bijbehorende bestand %LocalAppData%\Microsoft\On-premises gegevensgateway (persoonlijke modus)\m\Microsoft.Mashup.Container.NetFX45.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 geen basisproxyverificatie 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 bestand Microsoft.Mashup.Container.NetFX45.exe.config bewerken als u wilt dat de gateway verbinding maakt met cloudgegevensbronnen via een gateway.

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 on-premises semantisch model samenvoegt met een semantisch internetmodel.

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

Gateway configureren voor uitvoerbestemmingen

Als u de gateway met uitvoerbestemmingen wilt gebruiken, moet de gateway mogelijk worden geconfigureerd om een firewall of proxy door te kunnen geven om de doelgegevensbron te 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.

Notitie

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. Ga naar Het serviceaccount voor de on-premises gegevensgateway wijzigen voor meer informatie over het wijzigen van het gatewayserviceaccount.

Notitie

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