Autenticação

Última atualização: 14/10/2026

QV2QS autentica-se no Qlik Cloud por meio de contextos qlik-cli. Um contexto é uma configuração de autenticação nomeada que armazena uma URL de locatário do Qlik Cloud e uma chave de API. O QV2QS vem com o qlik-cli empacotado no executável. O QV2QS armazena contextos em sua própria localização isolada (%LOCALAPPDATA%\QV2QS\qlik-cli\.qlik\contexts.yml), separada da configuração padrão do qlik-cli. Uma instalação existente do qlik-cli não é afetada.

Métodos de autenticação

A autenticação pode ser configurada de três maneiras:

• Configuração interativa — Executar QV2QS.exe --setupQlikAuth. QV2QS lista quaisquer contextos existentes, solicita um nome de contexto (ou seleção), então solicita uma URL de locatário e uma chave de API. A entrada da chave da API está oculta por segurança. QV2QS cria ou atualiza o contexto e valida a conexão.
• Argumentos da CLI — Passe --qlikTenantUrl e --qlikApiKey na linha de comando. QV2QS autentica inline sem criar ou modificar um arquivo de contexto. As credenciais são injetadas diretamente em cada chamada de API e não são gravadas em disco. Este é o método mais simples para pipelines de CI/CD e conversões únicas. Alternativamente, passe --qlikApiKey sozinho para atualizar a chave no contexto qlik-cli ativo.
• Interface do usuário — Insira a URL do locatário e a chave da API na etapa de autenticação do Qlik Cloud. O assistente valida a conexão antes de prosseguir.

Os argumentos de autenticação incluem --qlikContext, --qlikTenantUrl, --qlikApiKey e --setupQlikAuth. Para a lista completa, consulte Referência de argumentos.

Atualizando uma chave de API expirada

As chaves de API do Qlik Cloud expiram após o período configurado pelo administrador do locatário. Para substituir uma chave expirada, faça um dos seguintes:

• Execute novamente QV2QS.exe --setupQlikAuth e insira a nova chave de API quando solicitado.
• Passe --qlikApiKey <NEW_KEY> em qualquer comando de conversão (sem --qlikTenantUrl). QV2QS atualiza o contexto armazenado automaticamente. Se ambos --qlikTenantUrl e --qlikApiKey forem fornecidos, a autenticação inline é usada e nenhum contexto é atualizado.
• Defina a QV2QS_QLIK_API_KEY variável de ambiente para a nova chave.

Saiba mais

• Configurando acesso ao Qlik Cloud
• Implantando no Qlik Cloud