Configurare le impostazioni proxy per il gateway dati locale

  • Articolo

L'ambiente di lavoro potrebbe richiedere l'accesso a Internet tramite l’uso di un proxy. Questo requisito potrebbe impedire al gateway dati locale di Microsoft di connettersi al servizio.

Il post seguente su superuser.com illustra come provare a determinare se si dispone di un proxy nella rete: Ricerca per categorie sapere quale server proxy si sta usando? (SuperUser.com).

Anche se la maggior parte delle impostazioni di configurazione del gateway può essere modificata usando l'app gateway dati locale, le informazioni proxy sono configurate all'interno di un file di configurazione .NET. Il percorso e i nomi di file sono diversi, a seconda del gateway in uso.

Esistono tre file di configurazione associati all'uso di un proxy con il gateway dati locale. I due file di configurazione principali seguenti si applicano al gateway e al relativo processo di configurazione.

  • Il primo file riguarda le schermate di configurazione che configurano effettivamente il gateway. Se si verificano problemi durante la configurazione del gateway, esaminare il file seguente: C:\Programmi\Gateway dati locale\enterprisegatewayconfigurator.exe.config. Nel gateway dati locale (modalità personale), il file corrispondente è %LocalAppData%\Microsoft\On-premises data gateway (modalità personale)\PersonalGatewayConfigurator.exe.config.
  • Il secondo file riguarda il servizio Windows effettivo che interagisce con il servizio cloud usando il gateway. Questo file gestisce le richieste: C:\Programmi\Gateway dati locale\Microsoft.PowerBI.EnterpriseGateway.exe.config. Nel gateway dati locale (modalità personale) il file corrispondente è %LocalAppData%\Microsoft\On-premises data gateway (modalità personale)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config.

Se si intende apportare modifiche alla configurazione del proxy, questi file devono essere modificati in modo che le configurazioni proxy siano esattamente le stesse in entrambi i file.

Il terzo file di configurazione deve essere modificato per consentire al gateway di connettersi alle origini dati cloud tramite un proxy.

  • C:\Programmi\Gateway dati locale\m\Microsoft.Mashup.Container.NetFX45.exe.config

Nel gateway dati locale (modalità personale), il file corrispondente è %LocalAppData%\Microsoft\On-premises data gateway (modalità personale)\m\Microsoft.Mashup.Container.NetFX45.exe.config.

Nella sezione seguente viene descritto come modificare questi file.

Configurare impostazioni del proxy

L'esempio seguente mostra la configurazione proxy predefinita disponibile in entrambi i due file di configurazione principali.

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

La configurazione predefinita funziona con autenticazione di Windows. Se il proxy usa un'altra forma di autenticazione, è necessario modificare le impostazioni. Se non si è certi, contattare l'amministratore di rete.

Non è consigliabile l'autenticazione proxy di base. L'uso dell'autenticazione proxy di base potrebbe causare errori di autenticazione proxy che causano la mancata configurazione del gateway. Usare un meccanismo di autenticazione proxy più efficace per risolvere il problema.

Oltre a usare le credenziali predefinite, è possibile aggiungere un <proxy> elemento per definire le impostazioni del server proxy in modo più dettagliato. Ad esempio, è possibile specificare che il gateway dati locale deve usare sempre il proxy, anche per le risorse locali, impostando il parametro bypassonlocal su false. Questa impostazione consente di risolvere i problemi in situazioni in cui tenere traccia di tutte le richieste HTTPS provenienti da un gateway nei file di log del proxy. La configurazione di esempio seguente specifica che tutte le richieste devono passare attraverso un proxy specifico con l'indirizzo IP 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>

È anche necessario modificare il file Microsoft.Mashup.Container.NetFX45.exe.config se si vuole che il gateway si connetta alle origini dati cloud tramite un gateway.

Nel file espandere la <configurations> sezione per includere il contenuto seguente e aggiornare l'attributo con le proxyaddress informazioni del proxy. L'esempio seguente indirizza tutte le richieste cloud tramite un proxy specifico con l'indirizzo IP 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>

La configurazione di questo terzo file potrebbe essere necessaria se il proxy è un requisito per tutte le comunicazioni Internet, soprattutto per l'utilizzo aziendale in cui le reti sono protette e bloccate. Se è necessario un proxy per la comunicazione del gateway, è probabile che sia necessario anche per qualsiasi traffico Internet dai contenitori. In questo caso, il gateway potrebbe sembrare funzionare correttamente fino a quando qualsiasi contenitore esegue una query esterna (Internet). Questo problema è particolarmente applicabile ai flussi di dati, che tentano di eseguire il push della query risultante dei dati locali in Azure Data Lake Archiviazione. Ma si applica anche quando una query gateway unisce un modello semantico locale a un modello semantico associato a Internet.

Per altre informazioni sulla configurazione degli elementi proxy per i file di configurazione .NET, vedere Elemento defaultProxy (impostazioni di rete).

Configurare il gateway per le destinazioni di output

Inoltre, per usare il gateway con destinazioni di output, potrebbe essere necessario configurare il gateway per poter passare attraverso un firewall o un proxy per raggiungere l'origine dati di destinazione. Se si usa un server proxy, questo pass-through potrebbe richiedere URL di elenco di abilitazione per le destinazioni appropriate, ad esempio *.datawarehouse.pbidedicated.windows.net per LakeHouse, *.dfs.core.windows.net per Data Lake e così via.

Nota

Se si usano destinazioni LakeHouse, è necessario eseguire almeno la versione di maggio 2023 del gateway. Il connettore Lakehouse non è disponibile nelle versioni del gateway precedenti a questa versione.

Modificare l'account del servizio gateway in un utente di dominio

Come spiegato in precedenza, quando si configurano le impostazioni proxy per l'uso delle credenziali predefinite, potrebbero verificarsi problemi di autenticazione con il proxy. Questa situazione si verifica quando l'account del servizio predefinito è il SID del servizio e non un utente di dominio autenticato. Se il proxy nell'organizzazione richiede un account di dominio per autenticare la richiesta, è possibile modificare l'account del servizio del gateway in un account del servizio di dominio. Questa modifica consente l'autenticazione corretta con il proxy. Per altre informazioni su come modificare l'account del servizio gateway, vedere Modificare l'account del servizio gateway dati locale.

Nota

È consigliabile usare un account del servizio gestito per evitare di dover reimpostare le password. Informazioni su come creare un account del servizio gestito in Active Directory.

Passaggi successivi