Connexion de Qlik NPrinting à Qlik Sense

Vous devez connecter votre installation Qlik NPrinting à un ou plusieurs serveurs Qlik Sense si vous voulez utiliser des graphiques Qlik Sense dans vos rapports. Vous pouvez désigner un hub Qlik Sense pour la réception des rapports Qlik NPrinting.

Le dossier Qlik NPrinting Server contenant les certificats Qlik Sense (C:\Program Files\NPrintingServer\Settings\SenseCertificates) est conservé pendant les mises à niveau, mais il est supprimé si vous désinstallez Qlik NPrinting.

Conditions requises

Pour la compatibilité des versions Qlik Sense, voir Compatibilité de Qlik Sense (uniquement en anglais).

• Dans la QMC, vous devez donner l'autorisation RootAdmin à l'utilisateur Windows qui exécute le service Qlik NPrinting Engine Windows. Cet utilisateur Windows doit également être un utilisateur de domaine. Voir : Comptes d'utilisateurs (uniquement en anglais).
• Microsoft Windows NTML authentification sur le proxy Qlik Sense. SAML et JWT ne sont pas pris en charge. Si votre proxy virtuel utilise l'authentification SAML ou JWT, vous devez ajouter un nouveau proxy virtuel avec NTLM activé pour les connexions Qlik NPrinting. Les éléments suivants doivent être correctement configurés :

• Un proxy Qlik Sense.

• Un proxy virtuel Qlik Sense.

• Une connexion entre le proxy et le proxy virtuel.

• Le proxy virtuel Qlik Sense doit pouvoir être accessible via les postes Qlik NPrinting Engine pour pouvoir récupérer les données afin de créer des rapports. Il doit être accessible via Qlik NPrinting Server pour pouvoir publier des rapports dans le hub Qlik Sense.

Limitations

• La connexion de serveurs Qlik Sense supplémentaires aura un impact sur les ressources système de Qlik NPrinting Server. Il peut s'avérer nécessaire d'allouer davantage de RAM et de capacité de processeur aux ordinateurs Qlik NPrinting Engine et Qlik NPrinting Server pour pouvoir se connecter à plusieurs serveurs Qlik Sense. Voir : Performances (uniquement en anglais).
• La publication sur plusieurs hubs Qlik Sense n'est pas prise en charge.
• Qlik Sense Desktop n'est pas pris en charge.

Validation de la connexion à Qlik Sense

Qlik NPrinting doit valider la connexion à Qlik Sense via des certificats.

Les certificats doivent être installés sur l'ordinateur Service de planification Qlik NPrinting pour qu'il puisse distribuer des rapports de Qlik NPrinting dans le hub Qlik Sense. Les certificats doivent également être installés sur tous les ordinateurs Qlik NPrinting Engine pour qu'ils puissent créer des connexions à des applications Qlik Sense. Si Service de planification Qlik NPrinting et Qlik NPrinting Engine sont installés sur le même ordinateur, les certificats ne doivent être installés qu'une seule fois.

Exportation de certificats à partir de QMC

Procédez comme suit :

1. Connectez-vous à la QMC en tant qu'administrateur Qlik Sense ou en tant qu'utilisateur disposant d'un accès RootAdmin.

2. Sélectionnez Certificates sur la page d'accueil de QMC ou dans le menu .

   La page Export (Exporter) associée à l'option Certificates (Certificats) s'affiche.

3. Dans la zone Machine name (Nom de la machine), saisissez le nom complet de l'ordinateur Qlik NPrinting Server pour lequel vous créez les certificats : MACHINE.domaine.com ou l'adresse IP.

4. Laissez la zone Certificate password (Mot de passe du certificat) vide.

5. Sélectionnez le format de fichier .pfx dans la liste déroulante Export file format for certificates (Format de fichier d'exportation des certificats).

6. Cliquez sur Export certificates (Exporter les certificats) sur la barre d'action.

7. Une fois l'exportation terminée, la boîte de dialogue Certificates exported (Certificats exportés) s'affiche. L'option Certificates will be exported to this disk location (Les certificats seront exportés à cet emplacement sur le disque) indique le répertoire cible.

   Le répertoire par défaut est le suivant : C:\ProgramData\Qlik\Sense\Repository\Exported Certificates\QlikNPrintingServerName

8. Accédez à ce répertoire. Trois fichiers devraient être visibles : client.pfx, server.pfx et root.cer. Il s'agit des fichiers à installer dans votre déploiement Qlik NPrinting.

   

Si vous vous connectez à plusieurs serveurs Qlik Sense, vous devrez répéter la procédure d'exportation pour chaque serveur et renommer les fichiers de certificat.

Installation des certificats client Qlik Sense

Vous avez besoin du fichier client.pfx exporté lors de Exportation de certificats à partir de QMC. Si vous installez des certificats à partir de plusieurs serveurs Qlik Sense, le fichier client.pfx doit être renommé à l'aide d'un nom unique. Par exemple : YourQlikNPrintingServerName.pfx. Répétez cette procédure pour chaque instance de Qlik NPrinting Engine. Un nom unique doit être attribué à chaque fichier client.pfx.

La procédure d'exportation de certificats doit être répétée sur chaque serveur Qlik Sense à connecter à Qlik NPrinting Server et à Qlik NPrinting Engine.

Procédez comme suit :

1. Procurez-vous les certificats Qlik Sense exportés et renommés auprès de l'administrateur système de Qlik Sense.

2. Connectez-vous à l'instance de Qlik NPrinting Server qui exécute Service de planification Qlik NPrinting en tant qu'administrateur des services Windows Qlik NPrinting Server.

3. Ajoutez les certificats au dossier C:\Program Files\NPrintingServer\Settings\SenseCertificates. Qlik NPrinting identifiera automatiquement le certificat approprié à utiliser pour chaque connexion.

   Note Informations

   Conservez uniquement les certificats Qlik Sense actifs utilisés par des connexions Qlik NPrinting dans le dossier C:\Program Files\NPrintingServer\Settings\SenseCertificates.

   Nous vous recommandons de supprimer tous les autres certificats non utilisés.

4. Répétez cette procédure sur chaque instance de Qlik NPrinting Engine qui exécute le service Qlik NPrinting Engine en tant qu'administrateur des services Windows Qlik NPrinting Engine.

L'utilisateur ne requiert pas d'allocation d'accès supplémentaire dans Qlik Sense pour afficher les rapports dans le hub Qlik Sense.

Configuration de la validation de certificats du serveur pour les connexions Qlik Sense

La validation de certificats du serveur garantit que Qlik NPrinting se connecte uniquement à des serveurs Qlik Sense fiables pour récupérer des données (obtenir des données ou des images auprès d'une application Qlik Sense) et publier des rapports dans des hubs Qlik Sense. L'installation de ces certificats permet à Qlik NPrinting de valider la connexion à Qlik Sense.

Conditions requises

• Emplacements d'installation : Le fichier Qlik Sense root.cer doit être installé sur les postes Qlik NPrinting Server et Qlik NPrinting Engine par une personne connectée en tant qu'administrateur des services Windows Qlik NPrinting Server ou en tant qu'administrateur des services Windows Qlik NPrinting Engine correspondants (si des certificats sont installés pour l'Utilisateur actuel et non pour l'Ordinateur local).

• Noms de domaine complets (FQDN) : Lorsque Appliquer la validation de certificats du serveur Qlik Sense est activé, seuls des noms de domaine complets (FQDN) peuvent être utilisés pour se connecter à des serveurs Qlik Sense pour la récupération de données et la publication de rapports.

  L'ensemble des connexions Qlik Sense et des adresses proxy du hub Qlik Sense doivent contenir l'adresse complète : http(s)://mysenseserver.mydomain.com/with_proxy_prefix_if_used.

  L'adresse plus courte ne peut pas être utilisée : http(s)://mysenseserver/with_proxy_prefix_if_used. Si une connexion Qlik Sense n'utilise pas d'adresses proxy FQDN, elle doit être modifiée manuellement par un administrateur Qlik NPrinting.

Installation de certificats du serveur

Vous avez besoin du fichier root.cer exporté lors de Exportation de certificats à partir de QMC. C'est ce fichier que vous devez installer sur Qlik NPrinting Server et sur vos postes Qlik NPrinting Engine. Les certificats du serveur doivent être installés sur :

• l'ordinateur Qlik NPrinting Server lorsque le hub Qlik Sense est utilisé comme destination de publication des rapports ;

• chaque poste Qlik NPrinting Engine si des connexions à Qlik Sense sont utilisées. L'installation de certificats sur les postes Engine n'est pas nécessaire si QlikView est utilisé exclusivement pour récupérer des données.

Procédez comme suit :

1. Connectez-vous à un Qlik NPrinting Server ou à un Qlik NPrinting Engine via le compte d'administrateur de services approprié.

2. Double-cliquez sur le fichier root.cer que vous avez déjà copié et cliquez sur Installer le certificat….

   Cette opération démarre l'assistant d'importation de certificats.

3. La première boîte de dialogue vous suggère d'installer le certificat uniquement pour l'Utilisateur actuel. Il s'agit du compte d'utilisateur des services Windows Server ou Engine. Si vous sélectionnez Ordinateur local, le certificat sera disponible pour tous les utilisateurs. Cliquez sur Suivant.

   

4. Sélectionnez Placer tous les certificats dans le magasin suivant, puis cliquez sur Parcourir….

5. Sélectionnez Autorités de certification racines de confiance, puis cliquez sur OK. Cliquez sur Suivant.

6. Vérifiez vos sélections. Elles doivent correspondre à l'image ci-dessous, en particulier Magasin de certificats sélectionné par l’utilisateur : Autorités de certification racines de confiance.

   

7. Cliquez sur Terminer.

8. Il se peut qu'une boîte de dialogue Avertissement de sécurité apparaisse. Si c'est le cas, lisez-la et cliquez sur Oui.

Un message s'affiche pour vous informer que l'importation s'est effectuée correctement. Vérifiez que l'ensemble des connexions Qlik NPrinting et, le cas échéant, l'adresse proxy de publication dans le hub Qlik Sense, utilisent FQDN. Pour plus d'informations, voir Conditions requises.

Une fois que vous avez installé les certificats sur les postes Qlik NPrinting Server et Qlik NPrinting Engine nécessaires, vous pouvez activer manuellement la fonction.

Activation de la validation de certificats du serveur

Après avoir activé la validation de certificats du serveur, si les fichiers de certificat Qlik Sense root.cer correspondants n'ont pas été correctement installés sur Qlik NPrinting Server et sur chaque poste Qlik NPrinting Engine, toute tâche configurée qui utilise une connexion Qlik Sense échouera lors de son exécution.

Procédez comme suit :

1. Connectez-vous à Console Web Qlik NPrinting en tant qu'administrateur.

2. Dans le menu supérieur, accédez à Admin > Paramètres > Tâche.

3. Dans la section Sécurité, cochez la case Appliquer la validation de certificats du serveur Qlik Sense.

4. Cliquez sur le bouton Mettre à jour.

Une fois cette fonction activée, un message apparaît au bas de chaque page de connexion Qlik Sense et de chaque page de configuration de la destination dans le hub Qlik Sense.