Guide pas à pas sur la configuration de vos paramètres de proxy

Article
05/06/2024

Si votre environnement de travail nécessite que la passerelle de données Microsoft locale passe par un serveur proxy pour la connexion au service, suivez les étapes ci-dessous pour configurer les paramètres du proxy.

Configuration des paramètres de proxy

Créez votre élément de définition de proxy. Pour en savoir plus sur la configuration des éléments de proxy pour les fichiers de configuration .NET, accédez à Élément defaultProxy (Paramètres réseau).

L’exemple suivant achemine toutes les requêtes via un proxy spécifique avec l’adresse IP 192.168.0.1 sur le port 8888 :
```
<defaultProxy useDefaultCredentials="true">
    <proxy  
        autoDetect="false"  
        proxyaddress="http://192.168.0.1:8888"
        bypassonlocal="false"
        usesystemdefault="false"
    />
</defaultProxy>
```
Parcourez le dossier d’installation de la passerelle de données locale, par exemple *C:\Fichiers du programme\Passerelle de données locale*.
Ouvrez le premier fichier utilisé pour les écrans de configuration qui configurent la passerelle, autrement dit, EnterpriseGatewayConfigurator.exe.config.
Recherchez l’élément defaultProxy et remplacez-le par votre configuration de proxy créée à l’étape 1 ci-dessus, puis enregistrez vos modifications dans le fichier.
Ouvrez le deuxième fichier utilisé pour le service Windows réel qui interagit avec le service cloud à l’aide de la passerelle et gère les requêtes, c’est-à-dire, Microsoft.PowerBI.EnterpriseGateway.exe.config et répétez l’étape 4.
Pour le troisième fichier de configuration qui est utilisé pour que la passerelle se connecte aux sources de données (généralement des sources de données cloud), ouvrez le sous-dossier m dans le dossier d’installation, puis le fichier Microsoft.Mashup.Container.NetFX45.exe.config. Répétez l’étape 4 pour insérer la configuration du proxy dans ce fichier.

Si le fichier est dans l’état par défaut, vous devez ajouter la balise system.net, ainsi que la définition du proxy, comme dans l’exemple suivant :
```
<system.net>
    <defaultProxy useDefaultCredentials="true">
        <proxy  
            autoDetect="false"  
            proxyaddress="http://192.168.0.1:8888"
            bypassonlocal="false"
            usesystemdefault="false"
        />
    </defaultProxy>
</system.net>
```
Ouvrez l’application de passerelle de données locale, accédez à l’onglet Paramètres du service, puis sélectionnez Redémarrer maintenant pour redémarrer le service de passerelle et appliquer les nouveaux paramètres de proxy.

Vérifiez la configuration de proxy cohérente

Vérifiez que vous exécutez la version de septembre 2022 ou une version ultérieure.
Ouvrez l’application de passerelle de données locale.
Accédez à l’onglet Diagnostics.
Sous Test des ports réseau, sélectionnez Démarrer un nouveau test.
Une fois le test des ports réseau terminé, sélectionnez Ouvrir les derniers résultats de test terminés.
Si votre configuration de proxy est cohérente dans les trois fichiers de configuration requis, un message Proxy configuration : Proxy settings match for all Gateway process configurations. s’affiche.

Sinon, si la configuration du proxy n’est pas cohérente, les informations suivantes s’affichent :

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.

Lors de l’exécution de la vérification de cohérence de la configuration du proxy à partir d’une passerelle de données locale (mode personnel), les fichiers de configuration suivants sont vérifiés :

%LocalAppData%\Microsoft\On-premises data gateway (personal mode)\PersonalGatewayConfigurator.exe.config %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\Microsoft.PowerBI.DataMovement.PersonalGateway.exe.config %LocalAppData%\Microsoft\On-premises data gateway (personal mode)\m\Microsoft.Mashup.Container.NetFX45.exe.config

Comportements de configuration de proxy incohérents ou manquants

Si la définition du proxy est manquante ou incohérente, vous pouvez rencontrer différents comportements avec votre passerelle de données locale. Voici quelques exemples :

Un modèle sémantique ou un échec d’actualisation du flux de données, exemple de message d’erreur : Error: Unable to connect to the remote server.
Lors du lancement de la passerelle de données locale, vous ne parvenez pas à vous connecter, l’invite de connexion s’affiche, mais son contenu ne peut pas être affiché ou une page de message d’erreur s’affiche.
Les résultats des tests de port réseau signalent les échecs de connexion aux serveurs.

Étapes suivantes

Informations sur le pare-feu

Share via