# Autenticação

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

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