Authentification
Dernière mise à jour : 14/10/2026QV2QS s'authentifie auprès de Qlik Cloud via les contextes qlik-cli. Un contexte est une configuration d'authentification nommée qui stocke une URL de client Qlik Cloud et une clé d'API. QV2QS est livré avec qlik-cli intégré dans l'exécutable. QV2QS stocke les contextes dans son propre emplacement isolé (%LOCALAPPDATA%\QV2QS\qlik-cli\.qlik\contexts.yml), séparément de la configuration qlik-cli par défaut. Une installation qlik-cli existante n'est pas affectée.
Méthodes d'authentification
L'authentification peut être configurée de trois manières :
- Configuration interactive — Exécuter
QV2QS.exe --setupQlikAuth. QV2QS liste tous les contextes existants, demande un nom de contexte (ou une sélection), puis demande une URL de client et une clé d'API. Le champ de saisie de la clé API est masqué pour des raisons de sécurité. QV2QS crée ou met à jour le contexte et valide la connexion. - Arguments CLI — Passez
--qlikTenantUrlet--qlikApiKeysur la ligne de commande. QV2QS s'authentifie inline sans créer ni modifier de fichier de contexte. Les informations d'identification sont injectées directement dans chaque appel API et ne sont pas écrites sur le disque. C'est la méthode la plus simple pour les pipelines CI/CD et les conversions ponctuelles. Sinon, passez--qlikApiKeyseul pour mettre à jour la clé dans le contexte qlik-cli actif. - Interface utilisateur — Saisissez l'URL du client et la clé API à l'étape authentification Qlik Cloud. L'assistant valide la connexion avant de continuer.
Les arguments d'authentification incluent --qlikContext, --qlikTenantUrl, --qlikApiKey, et --setupQlikAuth. Pour la liste complète, voir Référence des arguments.
Mise à jour d'une clé API expirée
Les clés d'API Qlik Cloud expirent après la période configurée par l'administrateur du client. Pour remplacer une clé expirée, effectuez l'une des opérations suivantes :
- Relancez
QV2QS.exe --setupQlikAuthet saisissez la nouvelle clé API lorsque vous y êtes invité. - Passez
--qlikApiKey <NEW_KEY>sur toute commande de conversion (sans--qlikTenantUrl). QV2QS met à jour le contexte stocké automatiquement. Si les deux--qlikTenantUrlet--qlikApiKeysont fournis, l'authentification inline est utilisée et aucun contexte n'est mis à jour. - Définissez la
QV2QS_QLIK_API_KEYvariable d'environnement à la nouvelle clé.