Gestion du serveur Passerelle de données Qlik - Accès direct | Aide Qlik Cloud
Accéder au contenu principal Passer au contenu complémentaire

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

Dernière mise à jour : 30/09/2026

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 :

    • 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).

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

  2. Exécutez la commande suivante :

      • 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@

      • 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 :

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 :

    • 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).

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

  3. Exécutez la commande suivante :

    connectoragent qcs set_config --proxy_url ""

    • connectoragent qcs set_config --proxy_url ""

    • dotnet ConnectorAgent.dll qcs set_config --proxy_url ""

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

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 :

      • Syntaxe :connectoragent qcs set_config --tenant_url URL

      • Exemple : connectoragent qcs set_config --tenant_url mytenant.us.qlikcloud.com

      • 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.

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 (et que vous l’enregistriez, comme décrit dans Étape quatre : Enregistrer la passerelle de données).

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 :

    • 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).

    • 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 :

    • connectoragent qcs set_config --tenant_url URL

    • 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 :

    • 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).

    • 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 :

    • connectoragent help

    • 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.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.