プロキシ設定の構成に関するステップバイステップガイド

[アーティクル]
05/06/2024

作業環境で Microsoft オンプレミスデータゲートウェイがプロキシサーバーを経由してサービスに接続する必要がある場合は、次の手順に従ってプロキシ設定を構成してください。

プロキシ設定の構成

プロキシ定義要素を作成します。 .NET 構成ファイルのプロキシ要素の構成について詳しくは、「defaultProxy 要素 (ネットワーク設定)」をご覧ください。

次の例では、ポート 8888 の IP アドレス 192.168.0.1 を持つ特定のプロキシ経由ですべての要求をルーティングしています。
```
<defaultProxy useDefaultCredentials="true">
    <proxy  
        autoDetect="false"  
        proxyaddress="http://192.168.0.1:8888"
        bypassonlocal="false"
        usesystemdefault="false"
    />
</defaultProxy>
```
オンプレミスデータゲートウェイのインストールフォルダー (例: *C:\Program Files\オンプレミスデータゲートウェイ*) を参照します。
ゲートウェイを構成する構成画面 (EnterpriseGatewayConfigurator.exe.config) に使用される最初のファイルを開きます。
defaultProxy 要素を見つけて、上記の手順 1 で作成したプロキシ構成に置き換え、変更をファイルに保存します。
ゲートウェイを使用してクラウドサービスと対話し、要求を処理する実際の Windows サービスに使用される 2 番目のファイル (Microsoft.PowerBI.EnterpriseGateway.exe.config) を開き、手順 4 を繰り返します。
ゲートウェイがデータソース (通常はクラウドデータソース) に接続するために使用する 3 番目の構成ファイルでは、インストールフォルダーのサブフォルダー m を開き、次にファイル Microsoft.Mashup.Container.NetFX45.exe.config を開きます。手順 4. を繰り返して、プロキシ構成をこのファイルに挿入します。

ファイルが既定の状態の場合は、次の例のように、プロキシ定義と共に system.net タグを追加する必要があります。
```
<system.net>
    <defaultProxy useDefaultCredentials="true">
        <proxy  
            autoDetect="false"  
            proxyaddress="http://192.168.0.1:8888"
            bypassonlocal="false"
            usesystemdefault="false"
        />
    </defaultProxy>
</system.net>
```
オンプレミスデータゲートウェイアプリケーションを開き、[サービスの設定] タブに移動し、[今すぐ再起動] を選択してゲートウェイサービスを再起動し、新しいプロキシ設定を適用します。

一貫性のあるプロキシ構成を確認する

2022 年 9 月以降のバージョンを使用していることを確認します。
オンプレミスデータゲートウェイのアプリを開きます。
[診断] タブに移動します。
[ネットワークポートテスト]の下で、[新しいテストを開始]を選択します。
ネットワークポートのテストが完了したら、[最後に完了したテスト結果を開く] を選択します。
プロキシ構成が必要な 3 つの構成ファイル間で一貫している場合は、Proxy configuration : Proxy settings match for all Gateway process configurations. メッセージが表示されます。

それ以外の場合、プロキシ構成が一貫してなければ、次の情報が表示されます。

Proxy configuration : Proxy settings are not consistent. Please ensure that the proxy configuration matches across the files listed below:
C:\Program Files\On-premises data gateway\EnterpriseGatewayConfigurator.exe.config
C:\Program Files\On-premises data gateway\Microsoft.PowerBI.EnterpriseGateway.exe.config
C:\Program Files\On-premises data gateway\m\Microsoft.Mashup.Container.NetFX45.exe.config
Review <https://docs.microsoft.com/data-integration/gateway/service-gateway-proxy>  for additional information about configuring proxies for the Gateway.

オンプレミスデータゲートウェイ (個人用モード) からプロキシ構成の整合性検証を実行する場合、次の構成ファイルが検証されます。

%LocalAppData%\Microsoft\オンプレミスデータゲートウェイ (個人用モード)\PersonalGatewayConfigurator.exe.config %LocalAppData%\Microsoft\オンプレミスデータゲートウェイ (個人用モード)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config %LocalAppData%\Microsoft\オンプレミスデータゲートウェイ (個人用モード)\m\Microsoft.Mashup.Container.NetFX45.exe.config

プロキシ構成の動作に一貫性がない、または欠落している

プロキシ定義が欠落しているか一貫性がない場合は、オンプレミスデータゲートウェイでさまざまな動作が発生する可能性があります。具体例をいくつか紹介します。

セマンティックモデルまたはデータフローの更新エラー、エラーメッセージの例: Error: Unable to connect to the remote server。
オンプレミスデータゲートウェイを起動しているときに、サインインに失敗したり、サインインプロンプトが表示されていても内容が表示されていなかったり、エラーメッセージページが表示されたりします。
ネットワークポートのテスト結果は、サーバーへの接続エラーを報告します。

次のステップ

ファイアウォール情報

次の方法で共有

プロキシ設定の構成に関するステップバイステップガイド