# Gestion du serveur Passerelle de données Qlik - Accès direct

Cette section décrit les différentes options de connectivité et de gestion disponibles une fois que vous avez installé Passerelle de données Qlik - Accès direct.

## Connexion à Qlik Cloud via un serveur proxy

Si, lors de la configuration initiale, vous n'avez pas configuré de connectivité proxy, vous pouvez le faire ultérieurement en exécutant les commandes décrites ci-dessous. Vous pouvez également exécuter les mêmes commandes pour modifier les paramètres de serveur proxy existants.

### Limitations et considérations générales

* Seuls les schémas proxy HTTP sont supportés.

* Les serveurs proxy configurés pour intercepter les connexions SSL (à des fins d'inspection du contenu ou pour d'autres raisons de sécurité) ne sont pas supportés.

* Outre HTTPS, la passerelle Accès direct utilise également le protocole WSS (WebSocket Secure). Par conséquent, assurez-vous que votre pare-feu et votre serveur proxy (si vous prévoyez d'en utiliser un) sont configurés de sorte à autoriser les connexions WSS sortantes.

### Activation de la connectivité de serveur proxy

Vous pouvez activer ou modifier la connectivité de serveur proxy comme suit :

1. Effectuez l’une des opérations suivantes, selon le flux de travail d’installation :

   * Installation sur un serveur Windows :

     Ouvrez une invite de commande en tant qu'administrateur et définissez le répertoire de travail sur le sous-dossier ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent avec une installation par défaut).

   * Installation conteneurisée :

     Ouvrez une console à l’intérieur du conteneur direct-access-agent.

2. Exécutez la commande suivante :

   * Installation sur un serveur Windows :

     * Syntaxe :connectoragent qcs set\_config --proxy\_url http://host:port --proxy\_username username --proxy\_password password

     * Exemple : connectoragent qcs set\_config --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

   * Installation conteneurisée :

     * Syntaxe :dotnet ConnectorAgent.dll qcs set\_config --proxy\_url http://host:port --proxy\_username username --proxy\_password password

     * Exemple : dotnet ConnectorAgent.dll qcs set\_config --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

3. Effectuez l’une des opérations suivantes, selon le flux de travail d’installation :

   * Installation sur un serveur Windows :

     Redémarrez le service Passerelle de données Qlik - Accès direct comme décrit dans [Gestion du service Passerelle de données Qlik - Accès direct](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing).

   * Installation conteneurisée :

     Redémarrez le conteneur direct-access-agent.

### Désactivation de la connectivité de serveur proxy

Vous pouvez désactiver la connectivité de serveur proxy comme suit :

1. Ouvrez une invite de commande en tant qu'administrateur et définissez le répertoire de travail sur le sous-dossier ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent avec une installation par défaut).

2. Effectuez l’une des opérations suivantes, selon le flux de travail d’installation :

   * Installation sur un serveur Windows :

     Ouvrez une invite de commande en tant qu'administrateur et définissez le répertoire de travail sur le sous-dossier ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent avec une installation par défaut).

   * Installation conteneurisée :

     Ouvrez une console à l’intérieur du conteneur direct-access-agent.

3. Exécutez la commande suivante :

   connectoragent qcs set\_config --proxy\_url ""

   * Installation sur un serveur Windows :

     connectoragent qcs set\_config --proxy\_url ""

   * Installation conteneurisée :

     dotnet ConnectorAgent.dll qcs set\_config --proxy\_url ""

4. Effectuez l’une des opérations suivantes, selon le flux de travail d’installation :

   * Installation sur un serveur Windows :

     Redémarrez le service Passerelle de données Qlik - Accès direct comme décrit dans [Gestion du service Passerelle de données Qlik - Accès direct](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing).

   * Installation conteneurisée :

     Redémarrez le conteneur direct-access-agent.

## Mise à jour de l'URL du client Qlik Cloud

Vous pouvez modifier l'URL du client Qlik Cloud, si nécessaire.

Pour effectuer cette action :

1. Sur le serveur de la passerelle Accès direct, ouvrez une invite de commande et définissez le répertoire de travail sur le sous-dossier ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent avec une installation par défaut).

2. Exécutez l’une des commandes suivantes en fonction de votre flux de travail d’installation :

   * Installation sur un serveur Windows :

     * Syntaxe :connectoragent qcs set\_config --tenant\_url URL

     * Exemple : connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

   * Installation conteneurisée :

     * Syntaxe :dotnet ConnectorAgent.dll qcs set\_config --tenant\_url URL

     * Exemple : dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

3. Redémarrez le service Passerelle de données Qlik - Accès direct comme décrit dans [Gestion du service Passerelle de données Qlik - Accès direct](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing).

Note InformationsLa mise à jour de l’URL du clientQlik Cloud nécessite également que vous génériez une nouvelle clé d’inscription, comme décrit dans [Étape deux : Installer ou déployer Direct Access gateway](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Install2) (et que vous l’enregistriez, comme décrit dans [Étape quatre : Enregistrer la passerelle de données](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Stage4)).

## Affichage des paramètres actifs du serveur de la passerelle Accès direct

Vous pouvez afficher les paramètres actifs du serveur Direct Access gateway.

Pour effectuer cette action :

1. Effectuez l’une des opérations suivantes, selon votre flux de travail d’installation :

   * Installation sur un serveur Windows :

     Sur le serveur de la passerelle Accès direct, ouvrez une invite de commande et définissez le répertoire de travail sur le sous-dossier ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent avec une installation par défaut).

   * Installation conteneurisée :

     Ouvrez une console à l’intérieur du conteneur direct-access-agent.

2. Exécutez l’une des commandes suivantes en fonction de votre flux de travail d’installation :

   * Installation sur un serveur Windows :

     connectoragent qcs set\_config --tenant\_url URL

   * Installation conteneurisée :

     dotnet ConnectorAgent.dll qcs set\_config --tenant\_url URL

   Vos paramètres actifs s'afficheront.

   ```
   connector-agent starting....
   --tenant_url "elastic.example"
   --proxy_url ""
   --proxy_username ""
   DirectAccessAgent Control Program completed successfully.
   ```

## Gestion du service Passerelle de données Qlik - Accès direct

Note InformationsS’applique uniquement aux installations sur un serveur Windows.

Après avoir modifié un paramètre du serveur de la passerelle Accès direct, vous devez redémarrer le service Passerelle de données Qlik - Accès direct. Vous pouvez également exécuter le service sous un autre compte.

### Démarrage, arrêt ou redémarrage du service

Sur le serveur de la passerelle Accès direct, effectuez l'une des opérations suivantes pour arrêter, démarrer ou redémarrer le service :

* Ouvrez la console Services Windows et arrêtez, démarrez ou redémarrez le service Passerelle de données Qlik - Accès direct, selon les besoins.

* Ouvrez une invite de commande en tant qu'administrateur et définissez le répertoire de travail sur le sous-dossier ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent avec une installation par défaut). Ensuite, exécutez les commandes suivantes :

  connectoragent service stop

  Une confirmation que le service s'est correctement arrêté s'affiche.

  connectoragent service start

  Une confirmation que le service a correctement démarré s'affiche.

### Exécution du service sous un autre compte

Par défaut, le service Passerelle de données Qlik - Accès direct est exécuté sous le compte Système local. Pour exécuter le service sous un autre compte, cliquez avec le bouton droit de la souris sur Passerelle de données Qlik - Accès direct dans la console Services Windows et sélectionnez l'onglet Se connecter. Sélectionnez ensuite Ce compte et saisissez les détails du compte. Une fois terminé, enregistrez vos paramètres et redémarrez le service.

## Catégories de commandes disponibles

Pour afficher une liste des catégories de commandes disponibles :

1. Effectuez l’une des opérations suivantes, selon votre flux de travail d’installation :

   * Installation sur un serveur Windows :

     Ouvrez une invite de commande en tant qu’administrateur et remplacez le répertoire de travail par le sous-dossier ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent avec une installation par défaut).

   * Installation conteneurisée :

     Ouvrez une console à l’intérieur du conteneur direct-access-agent.

2. Exécutez l’une des commandes suivantes en fonction de votre flux de travail d’installation :

   * Installation sur un serveur Windows :

     connectoragent help

   * Installation conteneurisée :

     dotnet ConnectorAgent.dll help

La liste suivante s'affiche :

* service - Consultez Gestion du service Passerelle de données Qlik - Accès direct ci-dessus.

* qcs - Doit précéder toutes les commandes documentées, sauf les commandes de service.

  Exemple (installation sur un serveur Windows) :

  connectoragent qcs show\_config

  Exemple (installation conteneurisée) :

  dotnet ConnectorAgent.dll qcs show\_config

* setup - Destiné au support uniquement.

* repository - Destiné au support uniquement.

* configuration - Destiné au support uniquement.