Autenticazione

Ultimo aggiornamento: 14/10/2026

QV2QS si autentica a Qlik Cloud tramite contesti qlik-cli. Un contesto è una configurazione di autenticazione denominata che memorizza un URL del tenant di Qlik Cloud e una chiave API. QV2QS viene fornito con qlik-cli integrato nell'eseguibile. QV2QS archivia i contesti nella propria posizione isolata (%LOCALAPPDATA%\QV2QS\qlik-cli\.qlik\contexts.yml), separata dalla configurazione predefinita di qlik-cli. Un'installazione qlik-cli esistente non è interessata.

Metodi di autenticazione

L'autenticazione può essere configurata in tre modi:

• Configurazione interattiva — Esegui QV2QS.exe --setupQlikAuth. QV2QS elenca tutti i contesti esistenti, richiede un nome di contesto (o una selezione), quindi richiede un URL del tenant e una chiave API. L'input della chiave API è nascosto per motivi di sicurezza. QV2QS crea o aggiorna il contesto e convalida la connessione.
• Argomenti CLI — Passa --qlikTenantUrl e --qlikApiKey sulla riga di comando. QV2QS autentica inline senza creare o modificare un file di contesto. Le credenziali vengono iniettate direttamente in ogni chiamata API e non vengono scritte su disco. Questo è il metodo più semplice per pipeline CI/CD e conversioni una tantum. In alternativa, passa --qlikApiKey da solo per aggiornare la chiave nel contesto qlik-cli attivo.
• Interfaccia utente — Immettere l'URL del tenant e la chiave API nel passaggio autenticazione di Qlik Cloud. La procedura guidata convalida la connessione prima di procedere.

Gli argomenti di autenticazione includono --qlikContext, --qlikTenantUrl, --qlikApiKey, e --setupQlikAuth. Per l'elenco completo, vedere Riferimento argomenti.

Aggiornamento di una chiave API scaduta

Le chiavi API di Qlik Cloud scadono dopo il periodo configurato dall'amministratore del tenant. Per sostituire una chiave scaduta, eseguire una delle seguenti operazioni:

• Riesegui QV2QS.exe --setupQlikAuth e inserisci la nuova chiave API quando richiesto.
• Passa --qlikApiKey <NEW_KEY> a qualsiasi comando di conversione (senza --qlikTenantUrl). QV2QS aggiorna automaticamente il contesto memorizzato. Se vengono forniti entrambi --qlikTenantUrl e --qlikApiKey, viene utilizzata l'autenticazione inline e nessun contesto viene aggiornato.
• Impostare la variabile di ambiente QV2QS_QLIK_API_KEY alla nuova chiave.

Scopri di più

• Configurazione dell'accesso a Qlik Cloud
• Distribuzione su Qlik Cloud