# Configuração do acesso ao Qlik Cloud

Antes de implantar no Qlik Cloud, o administrador do locatário deve habilitar a geração de chave de API e atribuir as funções corretas à conta de usuário.

## Habilitando o acesso por chave de API

Faça o seguinte:

1. No centro de atividades de Administração, vá para Gerenciar usuários > Permissões.
2. Crie uma função personalizada (por exemplo, Gerenciador de Chaves de API).
3. Expandir Recursos e Ações > Desenvolvedor e defina Gerenciar chaves de API para `Allowed`.
4. Salvar a função.
5. Vá para Usuários e atribua a função aos usuários que precisam de acesso à API.
6. Se os usuários tiverem a função obsoleta Developer, remova a função.

Após a função ser atribuída, cada usuário pode gerar uma chave de API.

Para gerar uma chave de API, vá para Perfil > Chaves de API e clique em Gerar nova chave. Copie e armazene a chave com segurança. A chave é exibida apenas uma vez.

## Habilitando a criação de aplicativo em espaços pessoais

Para criar aplicativos no espaço pessoal, é necessária a função de Criador de Conteúdo de Análise Privada.

Faça o seguinte:

1. No console de gerenciamento, vá para Usuários.
2. Atribua a função de Criador de Conteúdo de Análise Privada ao usuário.

Ao implantar em um espaço compartilhado em vez de um espaço pessoal, o usuário deve ter a Pode editar permissão no espaço de destino.

## Autenticação em linha

Quando ambos `--qlikTenantUrl` e `--qlikApiKey` são fornecidos (ou as variáveis de ambiente equivalentes `QV2QS_QLIK_TENANT_URL` e `QV2QS_QLIK_API_KEY`), o QV2QS autentica-se diretamente sem criar ou ler um arquivo de contexto qlik-cli. A chave da API é injetada como um token de portador em cada chamada do qlik-cli e não é gravada em disco.

Esta abordagem é recomendada para:

* Pipelines de CI/CD onde a pré-criação de um contexto adiciona uma etapa extra.
* Automação multi-locatário onde múltiplas invocações simultâneas visam locatários diferentes. Cada processo carrega suas próprias credenciais na memória, portanto, não há arquivos de contexto compartilhados para entrar em conflito.
* Integrações de parceiros que chamam QV2QS programaticamente com credenciais variáveis por solicitação.

```
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output ^
  --qlikTenantUrl https://my-tenant.us.qlikcloud.com ^
  --qlikApiKey eyJhbG... ^
  --qsAppName "Sales" --autoBinary --reload --plain
```

Nota informativa

A `--setupQlikAuth` flag não é necessária quando ambos `--qlikTenantUrl` e `--qlikApiKey` são fornecidos.

## Saiba mais

* [Autenticação](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/getting-started/authentication.htm)
* [Implantando no Qlik Cloud](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)
* [Segmentação de espaço](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/space-targeting.htm)
* [Fluxos de trabalho comuns — Uso programático](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/command-line-interface/common-workflows.htm#programmatic-usage-cicd)