Guida dettagliata alla configurazione delle impostazioni proxy

Articolo
05/06/2024

Se l'ambiente di lavoro richiede che il gateway dati locale Microsoft passi attraverso un server proxy per la connessione al servizio, seguire questa procedura per configurare le impostazioni proxy.

Configurare impostazioni del proxy

Creare l'elemento di definizione del proxy. Per altre informazioni sulla configurazione degli elementi proxy per i file di configurazione .NET, vedere Elemento defaultProxy (impostazioni di rete).

L'esempio seguente indirizza tutte le richieste tramite un proxy specifico con l'indirizzo IP 192.168.0.1 sulla porta 8888:
```
<defaultProxy useDefaultCredentials="true">
    <proxy  
        autoDetect="false"  
        proxyaddress="http://192.168.0.1:8888"
        bypassonlocal="false"
        usesystemdefault="false"
    />
</defaultProxy>
```
Esplorare la cartella di installazione per il gateway dati locale, ad esempio *C:\Programmi\Gateway dati locale*.
Aprire il primo file usato per le schermate di configurazione che configurano il gateway, ovvero EnterpriseGatewayConfigurator.exe.config.
Individuare l'elemento defaultProxy e sostituirlo con la configurazione proxy creata nel passaggio 1 precedente e quindi salvare le modifiche apportate al file.
Aprire il secondo file usato per il servizio Windows effettivo che interagisce con il servizio cloud usando il gateway e gestisce le richieste, ovvero Microsoft.PowerBI.EnterpriseGateway.exe.config e ripetere il passaggio 4.
Per il terzo file di configurazione usato per la connessione del gateway alle origini dati, in genere origini dati cloud, aprire la sottocartella m nella cartella di installazione e quindi il file Microsoft.Mashup.Container.NetFX45.exe.config. Ripetere il passaggio 4 per inserire la configurazione del proxy in questo file.

Se il file si trova nello stato predefinito, è necessario aggiungere il system.net tag, insieme alla definizione del proxy, come nell'esempio seguente:
```
<system.net>
    <defaultProxy useDefaultCredentials="true">
        <proxy  
            autoDetect="false"  
            proxyaddress="http://192.168.0.1:8888"
            bypassonlocal="false"
            usesystemdefault="false"
        />
    </defaultProxy>
</system.net>
```
Aprire l'applicazione gateway dati locale, passare alla scheda Servizio Impostazioni e selezionare Riavvia ora per riavviare il servizio Gateway e applicare le nuove impostazioni proxy.

Verificare la configurazione coerente del proxy

Assicurarsi di eseguire la versione di settembre 2022 o successiva.
Aprire l'applicazione gateway dati locale.
Passare alla scheda Diagnostica .
In Test porte di rete selezionare Avvia nuovo test.
Al termine del test delle porte di rete, selezionare Apri i risultati dell'ultimo test completato.
Se la configurazione del proxy è coerente tra i tre file di configurazione necessari, viene visualizzato un Proxy configuration : Proxy settings match for all Gateway process configurations. messaggio.

In caso contrario, se la configurazione del proxy non è coerente, vengono visualizzate le informazioni seguenti:

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.

Quando si esegue la verifica della coerenza della configurazione proxy da un gateway dati locale (modalità personale), verranno verificati i file di configurazione seguenti:

%LocalAppData%\Microsoft\Gateway dati locale (modalità personale)\PersonalGatewayConfigurator.exe.config %LocalAppData%\Microsoft\On-premises data gateway (modalità personale)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config %LocalAppData%\Microsoft\On-premises data gateway (modalità personale)\m\Microsoft.Mashup.Container.NetFX45.exe.config

Comportamenti di configurazione proxy incoerenti o mancanti

Se la definizione del proxy è mancante o incoerente, è possibile riscontrare comportamenti diversi con il gateway dati locale. Ecco alcuni esempi:

Un modello semantico o un errore di aggiornamento del flusso di dati, esempio di messaggio di errore: Error: Unable to connect to the remote server.
Durante l'avvio del gateway dati locale, non è possibile accedere, viene visualizzata la richiesta di accesso, ma il relativo contenuto non può essere visualizzato o viene visualizzata una pagina di messaggio di errore.
I risultati del test della porta di rete segnalano errori di connessione ai server.

Passaggi successivi

Informazioni sul firewall

Condividi tramite