Freigeben über

Konfigurieren von Proxyeinstellungen für das lokale Datengateway

Ihre Arbeitsumgebung erfordert möglicherweise, dass Sie einen Proxy durchlaufen, um auf das Internet zuzugreifen. Diese Anforderung könnte verhindern, dass das lokale Microsoft-Datengateway eine Verbindung mit dem Dienst herstellt.

Im folgenden Beitrag zu superuser.com wird erläutert, wie Sie ermitteln können, ob Sie über einen Proxy in Ihrem Netzwerk verfügen: Wie weiß ich, welchen Proxyserver ich verwende? (SuperUser.com).

Obwohl die meisten Gatewaykonfigurationseinstellungen mithilfe der lokalen Datengateway-App geändert werden können, werden Proxyinformationen in einer .NET-Konfigurationsdatei konfiguriert. Der Speicherort und die Dateinamen unterscheiden sich je nach dem verwendeten Gateway.

Es gibt vier Konfigurationsdateien, die in Verbindung mit der Nutzung eines Proxys im lokalen Datengateway stehen. Die folgenden beiden Hauptkonfigurationsdateien gelten für das Gateway und den zugehörigen Konfigurationsprozess.

  • Die erste Datei richtet sich an die Konfigurationsbildschirme, die das Gateway tatsächlich konfigurieren. Wenn beim Konfigurieren des Gateways Probleme auftreten, sehen Sie sich die folgende Datei an: C:\Program Files\On-premises data gateway\enterprisegatewayconfigurator.exe.config. Im lokalen Datengateway (persönlicher Modus) ist die entsprechende Datei %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\PersonalGatewayConfigurator.exe.config.
  • Die zweite Datei gilt für den tatsächlichen Windows-Dienst, der mit dem Clouddienst über das Gateway interagiert. Diese Datei verarbeitet die Anforderungen: C:\Program Files\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config. Im lokalen Datengateway (persönlicher Modus) ist die entsprechende Datei %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config.

Wenn Sie Änderungen an der Proxykonfiguration vornehmen möchten, müssen diese Dateien bearbeitet werden, damit Proxykonfigurationen in beiden Dateien identisch sind.

Die dritte Konfigurationsdatei muss für das Gateway bearbeitet werden, um über einen Proxy eine Verbindung mit Clouddatenquellen herzustellen.

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

Im lokalen Datengateway (persönlicher Modus) wird die entsprechende Datei %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\m\Microsoft.Mashup.Container.NetFX45.exe.config.

Die vierte Konfigurationsdatei muss für das Gateway bearbeitet werden, um über einen Proxy eine Verbindung mit Fabric Pipelines-Diensten herzustellen. Seit der Februar 2025-Version (3000.258) wird die Konfigurationsdatei umbenannt in:

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

Wenn Sie eine frühere Version verwenden, lautet die Konfigurationsdatei:

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

Im folgenden Abschnitt wird beschrieben, wie Sie diese Dateien bearbeiten.

Konfigurieren von Proxyeinstellungen

Das folgende Beispiel zeigt die Standardproxykonfiguration in beiden Hauptkonfigurationsdateien.

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

Die Standardkonfiguration funktioniert mit der Windows-Authentifizierung. Wenn Ihr Proxy eine andere Authentifizierungsform verwendet, müssen Sie die Einstellungen ändern. Wenn Sie nicht sicher sind, wenden Sie sich an Ihren Netzwerkadministrator.

Wir empfehlen keine grundlegende Proxyauthentifizierung. Die Verwendung der Standardproxyauthentifizierung kann zu Proxyauthentifizierungsfehlern führen, die dazu führen, dass das Gateway nicht ordnungsgemäß konfiguriert ist. Verwenden Sie einen stärkeren Mechanismus zur Proxyauthentifizierung, um das Problem zu beheben.

Zusätzlich zur Verwendung von Standardanmeldeinformationen können Sie ein <proxy> Element hinzufügen, um Proxyservereinstellungen ausführlicher zu definieren. Sie können z. B. angeben, dass Ihr lokales Datengateway immer den Proxy verwenden soll, auch für lokale Ressourcen, indem Sie den Parameter bypassonlocal auf "false" festlegen. Diese Einstellung kann bei der Problembehandlung helfen, um alle HTTPS-Anforderungen zu verfolgen, die von einem Gateway in den Proxyprotokolldateien stammen. Die folgende Beispielkonfiguration gibt an, dass alle Anforderungen einen bestimmten Proxy mit der IP-Adresse 192.168.1.10 durchlaufen müssen.

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

Sie müssen auch die Microsoft.Mashup.Container.NetFX45.exe.config Datei bearbeiten, wenn das Gateway über ein Gateway eine Verbindung mit Clouddatenquellen herstellen soll.

Erweitern Sie in der Datei den <configurations> Abschnitt, um den folgenden Inhalt einzuschließen, und aktualisieren Sie das proxyaddress Attribut mit Ihren Proxyinformationen. Im folgenden Beispiel werden alle Cloudanforderungen über einen bestimmten Proxy mit der IP-Adresse 192.168.1.10 weitergeleitet.

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

Die Konfiguration dieser dritten Datei ist möglicherweise erforderlich, wenn Ihr Proxy eine Anforderung für alle Internetkommunikation ist, insbesondere für die Unternehmensnutzung, bei der Netzwerke sicher und gesperrt sind. Wenn ein Proxy für die Gatewaykommunikation erforderlich ist, ist er wahrscheinlich auch für jeden Internetdatenverkehr von Containern erforderlich. In diesem Fall scheint das Gateway erfolgreich zu arbeiten, bis ein Container eine externe Abfrage (Internet) durchführt. Dieses Problem gilt insbesondere für Datenflüsse, die versuchen, die resultierende Abfrage lokaler Daten an Azure Data Lake Storage zu übertragen. Es gilt jedoch auch, wenn eine Gatewayabfrage ein lokales Semantikmodell mit einem internetgebundenen Semantikmodell zusammenführt.

Weitere Informationen zur Konfiguration der Proxyelemente für .NET-Konfigurationsdateien finden Sie unter defaultProxy Element (Netzwerkeinstellungen).

Konfigurieren des Gateways für Ausgabeziele

Um das Gateway für Ausgabeziele zu verwenden, muss das Gateway möglicherweise so konfiguriert werden, dass es eine Firewall oder einen Proxy passieren kann, um die Zieldatenquelle zu erreichen. Wenn Sie einen Proxyserver verwenden, ist für diese Passthrough u. U. eine Aktivierungsauflistung von URLs für geeignete Ziele erforderlich, z. B. *.datawarehouse.pbidedicated.windows.net für LakeHouse, *.dfs.core.windows.net für Data Lake usw.

Hinweis

Wenn Sie LakeHouse-Ziele verwenden, müssen Sie mindestens die Version vom Mai 2023 des Gateways ausführen. Der Lakehouse-Connector ist in Gatewayversionen vor dieser Version nicht verfügbar.

Ändern des Gatewaydienstkontos in einen Domänenbenutzer

Wie weiter oben erläutert, treten beim Konfigurieren der Proxyeinstellungen für die Verwendung von Standardanmeldeinformationen möglicherweise Authentifizierungsprobleme mit Ihrem Proxy auf. Diese Situation tritt auf, wenn das Standarddienstkonto die Dienst-SID und kein authentifizierter Domänenbenutzer ist. Wenn der Proxy in Ihrer Organisation ein Domänenkonto erfordert, um die Anforderung zu authentifizieren, können Sie das Dienstkonto des Gateways in ein Domänendienstkonto ändern. Diese Änderung ermöglicht die ordnungsgemäße Authentifizierung mit Ihrem Proxy. Weitere Informationen zum Ändern des Gatewaydienstkontos erfahren Sie unter "Ändern des lokalen Datengatewaydienstkontos".

Hinweis

Es wird empfohlen, ein verwaltetes Dienstkonto zu verwenden, um zu vermeiden, dass Kennwörter zurückgesetzt werden müssen. Erfahren Sie, wie Sie ein verwaltetes Dienstkonto in Active Directory erstellen.

Verwandte Inhalte