Ir para conteúdo principal Pular para conteúdo complementar

Conectando o Qlik NPrinting com o Qlik Sense

Você deve conectar sua instalação do Qlik NPrinting a um ou mais servidores do Qlik Sense se deseja gráficos do Qlik Sense em seus relatórios. Você pode designar um hub do Qlik Sense para receber relatórios do Qlik NPrinting.

A pasta Qlik NPrinting Server com os certificados do Qlik Sense (C:\Program Files\NPrintingServer\Settings\SenseCertificates) é mantida durante os upgrades, mas será excluída se você desinstalar o Qlik NPrinting.

Nota informativaEssa página descreve como se conectar a um servidor do Qlik Sense. Para conectar aplicativos do Qlik Sense específicos ao Qlik NPrinting para criar relatórios, consulte: Conectando-se a aplicativos do Qlik Sense (somente em inglês).

Requisitos

Para compatibilidade de versão do Qlik Sense, consulte Compatibilidade do Qlik Sense (somente em inglês).

  • No QMC, você deve dar a autorização RootAdmin para o usuário do Windows que executa o Serviço do Windows Qlik NPrinting Engine. Esse usuário do Windows também deve ser um usuário de domínio. Consulte: Contas de usuário (somente em inglês).
  • Autenticação NTML do Microsoft Windows no proxy do Qlik Sense. Não há suporte para SAML e JWT. Se o proxy virtual usar a autenticação SAML ou JWT, você precisará adicionar um novo proxy virtual com o  NTLM habilitado para conexões com o Qlik NPrinting. O seguinte deve ser configurado corretamente:
    • Um proxy do Qlik Sense.

    • Um proxy virtual do Qlik Sense.

    • Um link entre o proxy e o proxy virtual.

    • O proxy virtual do Qlik Sense deve estar acessível nas máquinas do Qlik NPrinting Engine para recuperar dados para criar relatórios. Ele deve estar acessível no Qlik NPrinting Server para publicação no hub do Qlik Sense.

Limitações

  • A conexão de servidores adicionais do Qlik Sense terá um impacto nos recursos do sistema do Qlik NPrinting Server. Pode ser necessário aumentar o uso de RAM e CPU em computadores Qlik NPrinting Engine e Qlik NPrinting Server se você se conectar a vários servidores Qlik Sense. Consulte: Desempenho (somente em inglês).
  • Não há suporte para a publicação em vários hubs do Qlik Sense.
  • A Qlik Sense Desktop não é compatível.

Validando a conexão com o Qlik Sense

O Qlik NPrinting deve validar a conexão com o Qlik Sense usando certificados.

Os certificados devem ser instalados no computador Serviço de Agendador do Qlik NPrinting para distribuir relatórios do Qlik NPrinting para o hub do Qlik Sense. Os certificados devem ser instalados em todos os computadores Qlik NPrinting Engine para criar conexões com os aplicativos Qlik Sense. Se o Serviço de Agendador do Qlik NPrinting e o Qlik NPrinting Engine estiverem instalados no mesmo computador, será necessário instalar os certificados apenas uma vez.

Exportando os certificados do QMC

Faça o seguinte:

  1. Faça login no QMC como um administrador Qlik Sense ou um usuário com acesso RootAdmin.

  2. Selecione Certificados na QMC página inicial ou no menu Seta para baixo.

    A página Exportar de Certificados é exibida.

  3. Na caixa Nome da máquina, digite o nome completo do computador do Qlik NPrinting Server para o qual você está criando os certificados: MYMACHINE.mydomain.com ou o endereço IP.

  4. Deixe a caixa Senha do certificado vazia.

  5. Selecione o formato de arquivo .pfx na lista suspensa Exportar formato de arquivo para certificados.

  6. Clique em Exportar certificados na barra de ação.

  7. Quando a exportação for concluída, a caixa de diálogo Certificados exportados será exibida. Os certificados serão exportados para este local do disco exibe o diretório de destino.

    O padrão é: C:\ProgramData\Qlik\Sense\Repository\Exported Certificates\QlikNPrintingServerName

  8. Vá para este diretório. Você deve ver três arquivos: client.pfx, server.pfx e root.cer. Estes são os arquivos que precisam ser instalados na sua implementação do Qlik NPrinting.

    Windows Explorer mostrando uma pasta com três arquivos de certificado

Se você estiver se conectando a vários servidores Qlik Sense, será necessário repetir o processo de exportação para cada servidor e renomear os arquivos de certificado.

Instalando certificados de cliente Qlik Sense

Nota informativaEsse processo é obrigatório para todas as implementações do Qlik NPrinting que se conectam a hubs ou dados do Qlik Sense.

Você precisa do arquivo client.pfx que foi exportado durante Exportando os certificados do QMC. Se você estiver instalando certificados de vários servidores Qlik Sense, o arquivo client.pfx deverá ser renomeado com um nome exclusivo. Por exemplo: YourQlikNPrintingServerName.pfx. Repita o processo para o Qlik NPrinting Engine. Cada client.pfx diferente deve receber um nome exclusivo.

O processo de exportação do certificado deve ser repetido em cada servidor Qlik Sense que você deseja conectar ao Qlik NPrinting Server e ao Qlik NPrinting Engine.

Faça o seguinte:

  1. Receba os certificados do Qlik Sense exportados e renomeados do administrador do sistema do Qlik Sense.

  2. Faça login no Qlik NPrinting Server executando o Serviço de Agendador do Qlik NPrinting, como o administrador de serviços do Windows Qlik NPrinting Server.
  3. Adicione os certificados ao C:\Program Files\NPrintingServer\Settings\SenseCertificates. O Qlik NPrinting identificará automaticamente o correto a ser usado para cada conexão.

    Nota informativa

    Você apenas deve manter certificados ativos do Qlik Sense usados por conexões do Qlik NPrinting na pasta C:\Program Files\NPrintingServer\Settings\SenseCertificates.

    Recomendamos que você remova quaisquer certificados que não estejam em uso.

  4. Repita esse processo em cada Qlik NPrinting Engine executando o serviço Qlik NPrinting Engine, usando o administrador de serviços do Windows Qlik NPrinting Engine.

Alocação de acesso do usuário adicional no Qlik Sense não é necessária para que um usuário visualize relatórios no hub do Qlik Sense.

Configurando a validação do certificado do servidor para conexões do Qlik Sense

Nota informativaEsse processo é obrigatório se você estiver Ativando a validação do certificado do servidor A ativação da validação do certificado do servidor é opcional, mas recomendada.

A validação do certificado do servidor garante que o Qlik NPrinting apenas se conecte a servidores Qlik Sense confiáveis para recuperação de dados (obter dados ou imagens de um aplicativo Qlik Sense) e publicação de relatório em hubs Qlik Sense. A instalação desses certificados permite que o Qlik NPrinting valide a conexão com o Qlik Sense.

Nota informativaA validação do certificado do servidor é ativada por padrão para novas instalações do Qlik NPrinting. Se você fizer upgrade de versões anteriores do Qlik NPrinting, esse recurso estará desativado por padrão para evitar a interrupção de qualquer tarefa Qlik Sense anteriormente configurada. Nesse caso, a validação do certificado do servidor deve ser habilitada manualmente.

Requisitos

  • Locais de instalação: O arquivo Qlik Sense root.cer deve ser instalado em máquinas Qlik NPrinting Server e Qlik NPrinting Engine, por alguém conectado como o administrador de serviço do Windows Qlik NPrinting Server ou o administrador do serviço Windows Qlik NPrinting Engine correspondente (se os certificados estiverem sendo instalados para o Usuário atual e não para a Máquina local).

  • Nomes de domínio totalmente qualificados (FQDN): Quando a opção Aplicar validação do certificado do servidor Qlik Sense estiver habilitada, somente nomes de domínio totalmente qualificados (FQDN) poderão ser usados para conectar-se a servidores Qlik Sense para recuperação de dados e publicação de relatórios.

    Todas as conexões do Qlik Sense e endereços de proxy do hub Qlik Sense devem conter o endereço completo: http(s)://mysenseserver.mydomain.com/with_proxy_prefix_if_used.

    O endereço mais curto não pode ser usado: http(s)://mysenseserver/with_proxy_prefix_if_used. Se uma conexão Qlik Sense não usar endereços de proxy FQDN, ela deverá ser alterada manualmente por um administrador do Qlik NPrinting.

Instalando certificados de servidor

Você precisa do arquivo root.cer que foi exportado durante Exportando os certificados do QMC. Este é o arquivo que você precisa instalar nas suas máquinas Qlik NPrinting Server e Qlik NPrinting Engine. Os certificados do servidor devem ser instalados em:

  • O computador Qlik NPrinting Server quando o hub Qlik Sense é usado como um destino de publicação de relatórios.

  • Todas as máquinas Qlik NPrinting Engine se conexões com o Qlik Sense forem usadas. A instalação de certificados nas máquinas do mecanismo não será necessária se o QlikView for usado exclusivamente para obter dados

Nota informativaSe você estiver instalando os certificados em um Qlik NPrinting Server, deverá estar conectado como um administrador do serviço Windows Qlik NPrinting Server. Se você estiver instalando os certificados em uma máquina Qlik NPrinting Engine, deverá estar conectado como um administrador do serviço Windows Qlik NPrinting Engine.

Faça o seguinte:

  1. Faça login em um Qlik NPrinting Server ou Qlik NPrinting Engine com a conta de administrador de serviços correta.

  2. Clique duas vezes no arquivo root.cer que você já copiou e clique em Instalar certificado....

    Isso inicia o Assistente para importação de certificados.

  3. A primeira caixa de diálogo sugerirá que você instale o certificado apenas para o Usuário atual. Esta é a conta de usuário do serviço Server ou Engine Windows. Se você escolher Máquina local, o certificado estará disponível para todos os usuários. Clique em Avançar.

    Assistente de importação de certificado

  4. Escolha Coloque todos os certificados no seguinte armazenamento e depois clique em Navegar….

  5. Selecione Autoridades de certificação raiz confiáveis e depois clique em OK. Clique em Avançar.

  6. Revise suas seleções. Eles devem corresponder à imagem abaixo, especialmente Armazenamento de certificados selecionado pelo usuário: Autoridades de certificação raiz confiáveis.

    Tela de revisão do assistente de importação de certificado

  7. Clique em Terminar.

  8. O diálogo Aviso de segurança pode aparecer. Se sim, leia e clique em Sim.

Você verá uma mensagem informando que a importação foi bem-sucedida. Certifique-se de que todas as conexões com o Qlik NPrinting e, se usada, o endereço proxy de publicação do Qlik Sense no hub, usem o FQDN. Para obter mais informações, consulte Requisitos.

Depois de instalar os certificados nas máquinas Qlik NPrinting Server e Qlik NPrinting Engine necessárias, você estará pronto para habilitar manualmente o recurso.

Ativando a validação do certificado do servidor

Nota informativaSe você estiver instalando o Qlik NPrinting pela primeira vez, você poderá pular essa seção, porque a validação do certificado do servidor será ativada por padrão.

Depois de ativar a validação do certificado do servidor, se os arquivos de certificado Qlik Sense root.cer correspondentes não foram instalados corretamente no Qlik NPrinting Server e em cada máquina Qlik NPrinting Engine, qualquer tarefa configurada que use uma conexão com o Qlik Sense falhará quando for executada.

Faça o seguinte:

  1. Faça login no Console da Web do Qlik NPrinting como administrador.

  2. No menu superior, acesse Administrador > Configurações > Tarefa.

  3. Na seção Segurança, clique na caixa de seleção Aplicar validação do certificado do servidor Qlik Sense.

  4. Clique no botão Atualizar.

Quando esse recurso estiver ativado, uma mensagem aparecerá na parte inferior de cada página de conexão do Qlik Sense e página de configuração de destino de hub do Qlik Sense.

Página de configuração de destino de hub do Sense com uma observação na parte inferior explicando que a validação do certificado do servidor será aplicada.

Caixa de diálogo da página de configuração de destino de hub do Sense com uma observação na parte inferior explicando que a validação do certificado do servidor será aplicada.

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!