将 Qlik NPrinting 连接到 Qlik Sense

如果您在自己的报表中需要 Qlik Sense 图表，您必须将自己的 Qlik NPrinting 安装连接至一个或多个 Qlik Sense 服务器。您可指定一个 Qlik Sense 应用中心来接收 Qlik NPrinting 报表。

升级期间会保留具有 Qlik Sense 证书的 Qlik NPrinting Server 文件夹 (C:\Program Files\NPrintingServer\Settings\SenseCertificates)，但是在您卸载 Qlik NPrinting 时会被删除掉。

要求

对于 Qlik Sense 版本兼容性，请参阅Qlik Sense 兼容性 （仅提供英文版本）。

• 在 QMC 中，您必须向运行 Qlik NPrinting Engine Windows 服务的 Windows 用户提供 RootAdmin 授权。该 Windows 用户必须同时是域用户。请参阅：用户帐户 （仅提供英文版本）。
• Microsoft WindowsQlik Sense 代理上的 NTML 身份验证。不支持 SAML 和 JWT。如果虚拟代理使用 SAML 或 JWT 身份验证，则您需要在为 Qlik NPrinting 连接启用 NTLM 的情况下新增虚拟代理。必须正确设置以下项：

• Qlik Sense 代理。

• Qlik Sense 虚拟代理。

• 代理和虚拟代理之间的链接。

• Qlik Sense 虚拟代理必须可从 Qlik NPrinting Engine 计算机访问，才能检索数据以创建报告。它必须可从 Qlik NPrinting Server 读取以发布至 Qlik Sense 应用中心。

限制

• 连接额外的 Qlik Sense 服务器将对 Qlik NPrinting Server 系统资源产生影响。如果您连接至多个 Qlik Sense 服务器，可能需要增大 Qlik NPrinting Engine 和 Qlik NPrinting Server 计算机上的 RAM 和 CPU 使用量。请参阅：性能 （仅提供英文版本）。
• 发布至其不受支持的 Qlik Sense 应用中心。
• 不支持 Qlik Sense Desktop。

验证 Qlik Sense 的连接

Qlik NPrinting 必须使用证书验证到 Qlik Sense 的连接。

必须在 Qlik NPrinting 调度服务 计算机上安装证书以从 Qlik NPrinting 到 Qlik Sense 应用中心分发报表。证书还必须安装在所有 Qlik NPrinting Engine 计算机上以创建指向 Qlik Sense 应用程序的连接。当 Qlik NPrinting 调度服务 和 Qlik NPrinting Engine 安装于同一计算机上时，证书只需安装一次。

从 QMC 导出证书

进行以下操作：

1. 以 Qlik Sense 管理员或具有 RootAdmin 访问权限的用户身份登录 QMC。

2. 在 QMC 开始页面或从 菜单选择证书。

   即会显示证书的导出页面。

3. 在计算机名称框中，键入您为之创建证书的 Qlik NPrinting Server 计算机的完整计算机名称。MYMACHINE.mydomain.com 或 IP 地址。

4. 将证书密码框留空。

5. 在证书的导出文件格式下拉列表中，选择 .pfx 文件格式。

6. 在操作栏中单击导出证书。

7. 当导出完成时，会显示对话框导出的证书。证书将导出至该磁盘位置会显示目标目录。

   默认设置为：C:\ProgramData\Qlik\Sense\Repository\Exported Certificates\QlikNPrintingServerName

8. 转到该目录。您应当看到三个文件：client.pfx、server.pfx 和 root.cer。这些是需要在 Qlik NPrinting 部署中安装的文件。

   

如果要连接到多个 Qlik Sense 服务器，则需要对每个服务器重复导出过程，并重命名证书文件。

安装 Qlik Sense 客户端证书

您需要在 从 QMC 导出证书 期间导出的 client.pfx 文件。如果您从多个 Qlik Sense 服务器安装证书，则必须用唯一名称重命名 client.pfx 文件。例如：YourQlikNPrintingServerName.pfx. 为每个 Qlik NPrinting Engine 重复该过程。必须向每个不同的 client.pfx 提供唯一名称。

必须在要连接到 Qlik NPrinting Server 和 Qlik NPrinting Engine 的每台服 Qlik Sense 务器上重复证书导出过程。

进行以下操作：

1. 从您的 Qlik Sense 系统管理员接收导出和重命名的 Qlik Sense 证书。

2. 以 Windows Qlik NPrinting Server 服务管理员身份登录运行 Qlik NPrinting 调度服务 的 Qlik NPrinting Server。

3. 将证书添加至 C:\Program Files\NPrintingServer\Settings\SenseCertificates。Qlik NPrinting 将自动确定要用于每个连接的正确证书。

   信息注释

   您应该只在 C:\Program Files\NPrintingServer\Settings\SenseCertificates 文件夹中保留由 Qlik NPrinting 连接使用的活动 Qlik Sense 证书。

   我们建议您删除所有未使用的证书。

4. 使用 Windows Qlik NPrinting Engine 服务管理员身份，在运行 Qlik NPrinting Engine 服务的每个 Qlik NPrinting Engine 上重复该过程。

无需在 Qlik Sense 中分配额外用户权限，即可使用户查看 Qlik Sense 应用中心内的报表。

为 Qlik Sense 连接配置服务器证书验证

服务器证书验证确保 Qlik NPrinting 仅连接到受信任的 Qlik Sense 服务器进行数据检索（从 Qlik Sense 应用程序获取数据或图像）和向 Qlik Sense 应用中心发布报告。安装这些证书可以让 Qlik NPrinting 验证与 Qlik Sense 的连接。

要求

• 安装位置：Qlik Sense root.cer 文件必须由以相应 Windows Qlik NPrinting Server 服务管理员或 Windows Qlik NPrinting Engine 服务管理员身份登录的人安装在 Qlik NPrinting Server 和 Qlik NPrinting Engine 计算机上（如果证书是为当前用户而不是本地计算机安装的）。

• 完全限定域名 (FQDN)：启用应用 Qlik Sense 服务器证书验证后，只能使用完全限定域名 (FQDN) 连接到用于数据检索和报告发布的 Qlik Sense 服务器。

  所有 Qlik Sense 连接和 Qlik Sense 应用中心代理地址必须包含完整地址：http(s)://mysenseserver.mydomain.com/with_proxy_prefix_if_used。

  无法使用较短的地址：http(s)://mysenseserver/with_proxy_prefix_if_used。如果 Qlik Sense 连接不使用 FQDN 代理地址，则必须由 Qlik NPrinting 管理员手动更改。

安装服务器证书

您需要在 从 QMC 导出证书 期间导出的 root.cer 文件。这是您需要在 Qlik NPrinting Server 和 Qlik NPrinting Engine 计算机上安装的文件。服务器证书必须安装在：

• Qlik Sense 应用中心用作报表发布目的地时的 Qlik NPrinting Server 计算机。

• 如果使用到 Qlik Sense 的连接，则为每台 Qlik NPrinting Engine 计算机。如果 QlikView 仅用于获取数据，则不需要在引擎计算机上安装证书

进行以下操作：

1. 使用正确的服务管理员帐户登录 Qlik NPrinting Server 或 Qlik NPrinting Engine。

2. 双击已复制的 root.cer 文件，然后单击安装证书…。

   这将启动证书导入向导。

3. 第一个对话框将建议您仅为当前用户安装证书。这是服务器或引擎 Windows 服务用户帐户。如果选择本地计算机，则所有用户都可以使用该证书。单击下一步。

   

4. 选择将所有证书放入以下存储中，然后单击浏览…。

5. 选择受信任根证书颁发机构，然后单击确定。单击下一步。

6. 查看您的选择项。它们应该与下图相匹配，尤其是用户选择的证书存储：受信任根证书颁发机构。

   

7. 单击完成。

8. 可能会出现安全警告对话框。如果出现，请阅读并单击是。

您将看到一条消息，通知您导入成功。确保所有 Qlik NPrinting 连接以及发布到应用中心代理地址的 Qlik Sense（如果使用）都使用 FQDN。有关更多信息，请参阅要求。

在所需的 Qlik NPrinting Server 和 Qlik NPrinting Engine 计算机上安装证书后，即可手动启用该功能。

打开服务器证书验证

启用服务器证书验证后，如果未在 Qlik NPrinting Server 和每台 Qlik NPrinting Engine 计算机上正确安装相应的 Qlik Sense root.cer 证书文件，则任何使用 Qlik Sense 连接的配置任务在执行时都将失败。

进行以下操作：

1. 以管理员身份登录 Qlik NPrinting web 控制台。

2. 在顶部菜单中，转到管理员 > 设置 > 任务。

3. 在安全部分中，单击应用 Qlik Sense 服务器证书验证复选框。

4. 单击更新按钮。

启用此功能后，每个 Qlik Sense 连接页面和 Qlik Sense 应用中心目的地设置页面的底部都会显示一条消息。