# Autenticazione

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](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm).

## 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](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/getting-started/setting-up-qlik-cloud-access.htm)
* [Distribuzione su Qlik Cloud](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)