Criando uma conexão com o Qlik Sense Client-Managed

Esta página explica como criar uma conexão de origem com um ambiente do Qlik Sense Client-Managed usando a Qlik Analytics Migration Tool. Essa conexão permite a migração de conteúdo de um ambiente do Qlik Sense auto-hospedado para o Qlik Cloud.

Dois métodos estão disponíveis:

• Método 1 — Use um proxy virtual existente já configurado com autenticação JWT.
• Método 2 — Use a Qlik Analytics Migration Tool para criar automaticamente um novo proxy virtual.

Método 1: Usar um proxy virtual existente

Esse método é aplicável quando um proxy virtual habilitado para JWT já está configurado no ambiente do Qlik Sense Client-Managed.

Etapas

Faça o seguinte:

1. Navegue para a guia Connections e selecione Qlik Sense Client-Managed.
2. Clique em Create New.
3. Na guia Connection Setup, forneça o seguinte:
   • Connection Name — um nome de referência para identificar a conexão.
   • Qlik Sense Virtual Proxy URL: a URL completa do proxy virtual configurado (por exemplo, https://qliksense.domain.com/proxy-name).
   • API Key / JWT: o JWT associado ao proxy virtual configurado. Esse valor será mascarado quando inserido.
4. Clique em Test Connection para validar a configuração.
   • Uma notificação de sucesso confirma que a conexão é válida.
   • Se o teste falhar, verifique a URL e o token. A mensagem de erro pode fornecer detalhes adicionais.
5. Clique em Create Connection.
6. Uma mensagem de confirmação indicará que a criação foi bem-sucedida, e a conexão aparecerá na lista.

Método 2: Criar um proxy virtual usando a ferramenta

Esse método permite que a Qlik Analytics Migration Tool crie um novo proxy virtual e um JWT associado, sem exigir que um exista previamente.

Etapas

Faça o seguinte:

1. Navegue para a guia Connections e selecione Qlik Sense Client-Managed.
2. Clique em Create New.
3. Na guia Virtual Proxy Setup – Guide, reveja as instruções (opcional).
4. Alterne para a guia Virtual Proxy Setup.
5. No campo Qlik Server URL, insira a URL de login do ambiente do Qlik Sense Client-Managed.
6. Clique em Login to Qlik. Uma nova guia será aberta solicitando a autenticação.
7. Após o login, abra o Developer Tools (F12 ou fn + F12) no navegador Web.
8. Acesse a guia Application, depois:
   1. Expanda a seção Cookies.
   2. Selecione o domínio do Qlik Sense.
   3. Copie o Cookie Name. Na Qlik Analytics Migration Tool, cole-o no campo Qlik Session Cookie (Cookie Name).
   4. Copie o Cookie Value. Na Qlik Analytics Migration Tool, cole-o no campo Qlik Session Cookie (Cookie Value).
9. Clique em Retrieve users and proxies from Qlik.
   • Isso busca todos os usuários do RootAdmin e os proxies disponíveis.
   • Se a chamada falhar, verifique os campos de cookie e autentique novamente, se necessário.
10. No menu suspenso Select Service User, selecione um usuário RootAdmin para associar ao proxy virtual.
11. No menu suspenso Select Proxy Service, selecione o serviço de proxy (normalmente Central).
12. Opcionalmente, defina um Virtual Proxy Name (não são permitidos espaços).
13. Clique em Create Virtual Proxy.
    • Uma notificação de sucesso confirma que o proxy foi criado.
    • Se não for bem-sucedido, verifique todos os campos de entrada e revise todas as mensagens de erro.
14. Após a criação do proxy, um token JWT será exibido (é opcional salvar).
15. Clique em Go to Connection Setup.
    • Todos os campos de conexão serão preenchidos automaticamente usando as informações do proxy.
16. Clique em Test Connection para validar a configuração.
17. Clique em Create Connection.
18. Uma mensagem de confirmação será exibida e a conexão será adicionada à lista.

Tópicos relacionados

• Gerenciando conexões
• Criando uma conexão com o Qlik Sense Client-Managed
• Criando um plano de migração