Verbinden von Qlik NPrinting mit Qlik Sense
Sie müssen Ihre Qlik NPrinting-Installation mit einem oder mehreren Qlik Sense Servern verbinden, wenn Sie Qlik Sense Diagramme in Ihren Berichten nutzen möchten. Sie können einen Qlik Sense Hub zum Erhalten von Qlik NPrinting Berichten bestimmen.
Der Qlik NPrinting Server-Ordner mit den Qlik Sense Zertifikaten (C:\Programme\NPrintingServer\Settings\SenseCertificates) wird bei Upgrades beibehalten, aber gelöscht, wenn Sie Qlik NPrinting deinstallieren.
Voraussetzungen
Informationen zur Versionskompatibilität von Qlik Sense finden Sie unter Qlik Sense-Kompatibilität.
- In der QMC müssen Sie dem Windows-Benutzer, der den Qlik NPrinting Engine Windows-Dienst ausführt, eine RootAdmin-Autorisierung erteilen. Dieser Windows-Benutzer muss gleichzeitig auch ein Domänenbenutzer sein. Informationen dazu finden Sie unter: Benutzerkonten.
- Microsoft Windows NTML -Authentifizierung auf dem Qlik Sense-Proxy. SAML und JWT werden nicht unterstützt. Wenn Ihr virtueller Proxy SAML- oder JWT-Authentifizierung verwendet, müssen Sie einen neuen virtuellen Proxy mit aktiviertem NTLM für Qlik NPrinting Verbindungen hinzufügen. Folgende Komponenten müssen korrekt eingerichtet sein:
-
Ein Qlik Sense Proxy.
-
Ein virtueller Qlik Sense Proxy.
-
Ein Link zwischen den Proxy und dem virtuellen Proxy.
-
Der virtuelle Qlik Sense Proxy muss von Qlik NPrinting Engine Computern erreicht werden können, damit Daten zum Erstellen von Berichten abgerufen werden können. Er muss vom Qlik NPrinting Server erreicht werden können, um im Qlik Sense Hub zu veröffentlichen.
Einschränkungen
- Die Verbindung von zusätzlichen Qlik Sense Servern wirkt sich auf die Qlik NPrinting Server-Systemressourcen aus. Möglicherweise müssen Sie die RAM- und CPU-Nutzung auf Qlik NPrinting Engine- und Qlik NPrinting Server-Computern erhöhen, wenn Sie eine Verbindung zu mehreren Qlik Sense Servern herstellen. Informationen dazu finden Sie unter: Leistung.
- Das Veröffentlichen in mehreren Qlik Sense Hubs wird nicht unterstützt.
- Qlik Sense Desktop wird nicht unterstützt.
Validieren der Verbindung mit Qlik Sense
Qlik NPrinting muss die Verbindung mit Qlik Sense anhand von Zertifikaten validieren.
Auf dem Qlik NPrinting-Planungsdienst Computer müssen Zertifikate installiert werden, um Berichte von Qlik NPrinting an den Qlik Sense Hub zu verteilen. Auf allen Qlik NPrinting Engine Computern müssen zudem Zertifikate installiert werden, um Verbindungen mit Qlik Sense Apps zu erstellen. Wenn der Qlik NPrinting-Planungsdienst und die Qlik NPrinting Engine auf demselben Computer installiert sind, müssen die Zertifikate nur einmal installiert werden.
Exportieren der Zertifikate von der QMC
Gehen Sie folgendermaßen vor:
-
Melden Sie sich bei der QMC als Qlik Sense Administrator oder als Benutzer mit RootAdmin-Berechtigung an.
-
Wählen Sie Zertifikate auf der QMC-Startseite oder aus dem Menü .
Die Seite Export für Zertifikate wird angezeigt.
-
Geben Sie im Feld Computername den vollständigen Computernamen des Qlik NPrinting Server-Computers ein, für den Sie die Zertifikate erstellen: MYMACHINE.mydomain.com oder die IP-Adresse.
-
Lassen Sie das Feld Zertifikatkennwort leer.
-
Wählen Sie das .pfx-Dateiformat in der Dropdown-Liste Exportdateiformat für Zertifikate.
-
Klicken Sie in der Aktionsleiste auf Zertifikate exportieren.
-
Wenn der Export beendet ist, wird das Dialogfeld Exportierte Zertifikate angezeigt. Zertifikate werden an diesen Festplattenspeicherort exportiert zeigt das Zielverzeichnis an.
Der Standardpfad lautet: C:\ProgramData\Qlik\Sense\Repository\Exported Certificates\QlikNPrintingServerName
-
Wechseln Sie zu diesem Verzeichnis. Es sollten drei Dateien vorhanden sein: client.pfx, server.pfx und root.cer. Dies sind die Dateien, die in Ihrer Qlik NPrinting Bereitstellung installiert werden müssen.
Wenn Sie eine Verbindung mit mehreren Qlik Sense Servern herstellen, müssen Sie den Exportprozess für jeden Server wiederholen und die Zertifikatdateien umbenennen.
Installieren von Qlik Sense Clientzertifikaten
Sie benötigen die Datei client.pfx, die während Exportieren der Zertifikate von der QMC exportiert wurde. Wenn Sie Zertifikate von mehreren Qlik Sense Servern installieren, muss die Datei client.pfx mit einem eindeutigen Namen umbenannt werden. Beispiel: YourQlikNPrintingServerName.pfx. Wiederholen Sie den Vorgang für jede Qlik NPrinting Engine. Jede client.pfx muss einen eindeutigen Namen erhalten.
Der Zertifikatexportprozess muss auf jedem Qlik Sense Server wiederholt werden, auf dem Sie eine Verbindung mit Qlik NPrinting Server und Qlik NPrinting Engine herstellen möchten.
Gehen Sie folgendermaßen vor:
-
Erhalten Sie die exportierten und umbenannten Qlik Sense Zertifikate von Ihrem Qlik Sense Systemadministrator.
- Melden Sie sich bei dem Qlik NPrinting Server, der den Qlik NPrinting-Planungsdienst ausführt, als Windows Qlik NPrinting Server-Dienstadministrator an.
-
Fügen Sie die Zertifikate in C:\Programme\NPrintingServer\Settings\SenseCertificates hinzu. Qlik NPrinting identifiziert automatisch das korrekte Zertifikat für jede Verbindung.
InformationshinweisSie sollten nur aktive Qlik Sense-Zertifikate, die von Qlik NPrinting-Verbindungen verwendet werden, im Ordner C:\Programme\NPrintingServer\Settings\SenseCertificates aufbewahren.
Es wird empfohlen, alle nicht verwendeten Zertifikate zu entfernen.
- Wiederholen Sie diesen Prozess auf jeder Qlik NPrinting Engine, die den Qlik NPrinting Engine Dienst ausführt, indem Sie den Windows Qlik NPrinting Engine-Dienstadministrator verwenden.
Eine zusätzliche Zuweisung von Benutzerzugriff in Qlik Sense ist nicht erforderlich, damit Benutzer Berichte im Qlik Sense-Hub anzeigen können.
Konfigurieren der Serverzertifikatvalidierung für Qlik Sense Verbindungen
Durch die Serverzertifikatvalidierung wird gewährleistet, dass Qlik NPrinting nur eine Verbindung mit vertrauenswürdigen Qlik Sense Servern herstellt, um Daten abzurufen (Abruf von Daten oder Bildern von einer Qlik Sense App) und Berichte auf Qlik Sense Hubs zu veröffentlichen. Wenn diese Zertifikate installiert werden, kann Qlik NPrinting die Verbindung mit Qlik Sense validieren.
Voraussetzungen
-
Installationsspeicherorte: Die Qlik Sense Datei root.cer muss auf Qlik NPrinting Server und Qlik NPrinting Engine Computern von einem Benutzer installiert werden, der als der entsprechende Windows Qlik NPrinting Server Dienstadministrator oder Windows Qlik NPrinting Engine Dienstadministrator angemeldet ist (wenn die Zertifikate für den aktuellen Benutzer und nicht für den lokalen Computer installiert werden).
-
Vollqualifizierte Domänennamen (FQDN): Wenn Qlik Sense Serverzertifikatvalidierung anwenden aktiviert ist, können nur vollqualifizierte Domänennamen (FQDN) für die Verbindung mit Qlik Sense genutzt werden, sowohl für den Datenabruf als auch für die Berichtsveröffentlichung.
Alle Qlik Sense Verbindungen und Qlik Sense Hub-Proxy-Adressen müssen die vollständige Adresse enthalten: http(s)://mysenseserver.mydomain.com/with_proxy_prefix_if_used.
Die kürzere Adresse kann nicht verwendet werden: http(s)://mysenseserver/with_proxy_prefix_if_used. Wenn eine Qlik Sense Verbindung keine FQDN-Proxy-Adressen verwendet, muss sie manuell von einem Qlik NPrinting Administrator geändert werden.
Installieren von Serverzertifikaten
Sie benötigen die Datei root.cer, die während Exportieren der Zertifikate von der QMC exportiert wurde. Dies ist die Datei, die auf dem Qlik NPrinting Server und den Qlik NPrinting Engine Computern installiert werden muss. Serverzertifikate müssen auf folgenden Computern installiert werden:
-
Auf dem Qlik NPrinting Server Computer, wenn der Qlik Sense Hub als Ziel für die Berichtsveröffentlichung verwendet wird.
-
Auf jedem Qlik NPrinting Engine Computer, wenn Verbindungen mit Qlik Sense verwendet werden. Die Installation von Zertifikaten auf Engine-Computern ist nicht erforderlich, wenn QlikView ausschließlich zum Abrufen von Daten verwendet wird.
Gehen Sie folgendermaßen vor:
-
Melden Sie sich bei einem Qlik NPrinting Server oder einer Qlik NPrinting Engine mit dem richtigen Dienstadministratorkonto an.
-
Doppelklicken Sie auf die bereits kopierte Datei root.cer und dann auf Zertifikat installieren….
Dadurch wird der Zertifikatimport-Assistent gestartet.
-
Im ersten Dialogfeld wird vorgeschlagen, das Zertifikat nur für den aktuellen Benutzer zu installieren. Dies ist das Windows-Dienstbenutzerkonto, entweder für den Server oder für die Engine. Wenn Sie Lokaler Computer wählen, steht das Zertifikat allen Benutzern zur Verfügung. Klicken Sie auf Weiter.
-
Wählen Sie Alle Zertifikate in folgendem Speicher speichern aus und klicken Sie dann auf Durchsuchen….
-
Wählen Sie Vertrauenswürdige Stammzertifizierungsstellen aus und klicken Sie auf OK. Klicken Sie auf Weiter.
-
Prüfen Sie Ihre Auswahlen. Sie sollten der Abbildung unten entsprechen, insbesondere Vom Benutzer gewählter Zertifikatspeicher: Vertrauenswürdige Stammzertifizierungsstellen.
-
Klicken Sie auf Beenden.
-
Ein Dialogfenster mit einer Sicherheitswarnung kann geöffnet werden. Wenn dies der Fall ist, lesen Sie sie und klicken Sie auf Ja.
Eine Meldung wird angezeigt, die Sie über den erfolgreichen Import informiert. Vergewissern Sie sich, dass alle Qlik NPrinting Verbindungen und ggf. die Qlik Sense Proxy-Adresse für die Veröffentlichung im Hub FQDN verwenden. Weitere Informationen finden Sie unter Voraussetzungen.
Nachdem Sie die Zertifikate auf den erforderlichen Qlik NPrinting Server und Qlik NPrinting Engine Computern installiert haben, können Sie die Funktion manuell aktivieren.
Aktivieren der Serverzertifikatvalidierung
Wenn Sie die Serverzertifikatvalidierung aktivieren und die entsprechenden Qlik Sense root.cer-Zertifikatdateien nicht ordnungsgemäß auf Qlik NPrinting Server und auf jedem Qlik NPrinting Engine Computer installiert wurden, schlagen alle Aufgaben fehl, die eine Qlik Sense Verbindung verwenden.
Gehen Sie folgendermaßen vor:
-
Melden Sie sich bei Qlik NPrinting-Webkonsole als Administrator an.
-
Wechseln Sie im oberen Menü zu Admin > Einstellungen > Aufgabe.
-
Aktivieren Sie unter Sicherheit das Kontrollkästchen Qlik Sense Serverzertifikatvalidierung anwenden.
-
Klicken Sie auf Aktualisieren.
Nach der Aktivierung dieser Funktion wird unten auf jeder Seite der Qlik Sense Verbindung und auf der Zieleinrichtungsseite des Qlik Sense Hub eine Meldung angezeigt.