Session Recording Web 播放器

概述

作为一项实验性功能,Web 播放器允许您使用 Web 浏览器查看和播放录制件,并配置缓存内存以便在播放时存储录制件。使用 Web 播放器,可以执行以下操作:

  • 使用过滤器搜索录制件,包括主机名、客户端名称、用户名、应用程序、客户端 IP 地址、事件文本、事件类型和时间。有关详细信息,请参阅本文中的查看录制

  • 查看和播放在右侧窗格中列出的带标记事件的实时录制件和已完成的录制件。有关详细信息,请参阅本文中的查看录制

注意:

不支持 Internet Explorer 和 Microsoft Edge。

启用 Web 播放器

默认情况下,Web 播放器处于禁用状态。

  • 要启用 Web 播放器,请启动 Windows 命令提示符并运行 <Session Recording Server 安装路径>\Bin\TestPolicyAdmin.exe -enablewebplayer 命令。

  • 要禁用 Web 播放器,请启动 Windows 命令提示符并运行 <Session Recording Server 安装路径>\Bin\TestPolicyAdmin.exe –disablewebplayer 命令。

登录和密码

Web 播放器 Web 站点的 URL 为http(s)://<FQDN of Session Recording Server>/WebPlayer。要确保使用 HTTPS,请将 SSL 绑定添加到 IIS 上的 Web 站点并更新 SsRecWebSocketServer.exe.config 配置文件。有关详细信息,请参阅本文中的 HTTPS 配置

注意:

登录 Web 播放器 Web 站点时,域用户不需要输入凭据,而非域用户必须输入凭据。

登录到 Web 播放器 Web 站点后,将列出所有录制件。单击左侧导航中的所有录制件将刷新页面并显示新录制件(如果存在)。

所有录制件页面示意图

安装

与其他 Session Recording 组件一样,您可以使用 Citrix Virtual Apps and Desktops 安装程序安装 Web 播放器。

在安装过程中,选择核心组件页面上的 Session Recording Administration 将 Web 播放器安装在安装了 Session Recording Server 的同一台计算机上。有关安装 Session Recording 的详细信息,请参阅安装、升级和卸载

安装 Web 播放器后,SessionRecordingRestApiServiceWebPlayer 应用程序将显示为托管在 IIS 上。

IIS 上托管的应用程序的示意图

HTTPS 配置

要使用 HTTPS 访问 Web 播放器 Web 站点,请执行以下操作:

  1. 在 IIS 上添加 SSL 绑定。

    1. 从可信证书颁发机构 (CA) 获取 PEM 格式的 SSL 证书。

      注意:

      Google Chrome 和 Firefox 等大多数流行的浏览器不再支持证书签名请求 (CSR) 中的公用名。这些浏览器在所有公开信任的证书中强制执行使用者备用名称 (SAN)。要通过 HTTPS 使用 Web 播放器(目前,负载平衡方案不支持 Web 播放器),您必须:

      1. 更新 Session Recording Server 以使用 SAN 证书。
      2. 在证书中添加 localhost 作为使用者备用名称之一。例如,san:dns=<FQDN>&dns=<IP address>&ipaddress=<IP address>&dns=localhostSAN 证书示意图
    2. 在 IIS 上,右键单击 Web 站点,然后选择添加绑定。此时将显示站点绑定对话框。

      站点绑定对话框示意图

    3. 单击右上角的添加。此时将显示添加站点绑定对话框。

    4. 类型列表中选择 https ,然后选择 SSL 证书。

      选择 https 示意图

      示意图

    5. 单击确定。

  2. 更新 SsRecWebSocketServer.exe.config 配置文件。

    1. 找到并打开 SsRecWebSocketServer.exe.config 配置文件。

      SsRecWebSocketServer.exe.config 配置文件通常位于 <Session Recording Server installation path>\Bin\ 文件夹中。

    2. 通过编辑 TLSEnable=1 启用 TLS,并分别填写 SSL 证书及其密钥的路径。

      注意:

      仅支持 PEM 格式的 SSL 证书和密钥文件。
      ServerPort 字段指示 Web 播放器用于收集录制文件的端口号。在以下屏幕截图中,该字段设置为默认值 (22334)。

      更新 websocket 服务器配置文件的示意图

      要提取 WebSocket 服务器配置中使用的单独证书和密钥文件,请执行以下操作:

      1. 确保在包含 SSL 证书的 Session Recording Server 上安装了 OpenSSL。

      2. 将 SSL 证书导出为 .pfx 文件。.pfx 文件包括证书和私钥。

      3. 打开命令提示符并转到包含 .pfx 文件的文件夹。

      4. 从 OpenSSL\bin 文件夹启动 OpenSSL。

      5. 运行以下命令以提取证书:

        openssl pkcs12 -in [yourfile.pfx] -clcerts -nokeys -out [aSRS2.pem]
        

        输入您在导出 .pfx 文件时创建的导入密码。

      6. 运行以下命令以提取私钥:

        openssl pkcs12 -in [yourfile.pfx] -nocerts -out [newaSRS2keyWithPassword.pem]
        

        输入您在导出 .pfx 文件时创建的导入密码。提示输入 PEM 密码短语时,请提供用于保护密钥文件的新密码。

      7. 运行以下命令以解密私钥:

        openssl rsa -in [newaSRS2keyWithPassword.pem] -out [newaSRS2key.pem]
        
    3. 保存所做的更改。

    4. 检查您的防火墙设置。允许 SsRecWebSocketServer.exe 使用 TCP 端口(默认情况下为 22334),并允许访问 Web 播放器 URL。

    5. 运行 TestPolicyAdmin –stopwebsocketserver 命令。

查看录制

登录到 Web 播放器后,将列出所有可用的录制件。可以向下滚动 Web 页面以选择要查看的录制件,或者使用过滤器自定义您的搜索结果。对于实时录制件,持续时间项目显示实时,播放按钮显示为绿色。

实时录制件示意图

有关录制项目的说明,请参见下表。

项目 说明
开始时间 录制开始时间。单击上箭头和下箭头按时间顺序列出录制件。
用户 录制其会话的用户。单击上箭头和下箭头将用户的录制件集中到列表中,并按字母顺序排列用户。
主机 托管录制的会话的 VDA 的主机名。单击上箭头和下箭头以按字母顺序排列 VDA 主机名。
客户端 运行会话的客户端设备的名称。单击上箭头和下箭头以按字母顺序排列客户端主机名。
事件 录制件中的事件数量。单击上箭头和下箭头以按事件数量排列列表中的录制件。
持续时间 录制件的时间长度。单击上箭头和下箭头以按时间长度排列列表中的录制件。

使用过滤器搜索录制件

可以使用过滤器搜索录制件。可用过滤器包括主机名、客户端名称、用户名、应用程序、客户端 IP 地址、事件文本、事件类型和时间。

录制件过滤器示意图

例如,选择主机名过滤器后,将显示以下对话框。可以键入(托管录制的会话的 VDA 的)主机名,然后单击搜索以筛选出不相关的录制件并仅显示相关录制件。

选择主机名过滤器示意图

可以通过单击当前选定的主机名更改为其他过滤器,如以下屏幕截图中所示。单击主机名后,所有过滤器都将在下面列出。根据需要选择其他过滤器。

列出所有过滤器示意图

也可以单击 + 符号以添加过滤器。

加号示意图

例如,可以添加时间过滤器,如下面的屏幕中所示。

添加时间过滤器示意图

时间过滤器包括录制件开始日期、开始时间和持续时间。

打开和播放录制件

在录制件页面上,每个录制件的右侧的持续时间项旁边都有一个播放按钮。

播放按钮示意图

单击播放按钮。此时将显示播放页面。内存缓存后开始播放。

录制件播放页面示意图

有关播放器控件的说明,请参见下表:

播放器控件 说明
播放按钮的图像 播放选定的录制文件。
暂停按钮示意图 暂停播放。
进度条示意图 可以在播放过程中拖动进度条。
向后搜寻 7 秒示意图 向后搜寻 7 秒。
录制件播放的当前位置示意图 指示录制件播放的当前位置和总录制持续时间。时间格式为 HH:MM:SS。
播放速度示意图 指示当前播放速度。单击图标可在包括 X0.5、X1、X2 和 X4 的选项之间切换。
全屏按钮示意图 全屏显示播放。
窄按钮示意图 在 Web 页面内显示播放。

在播放页面的右侧窗格中,可以使用以下录制数据、事件过滤器和快速搜索框:

事件和其他信息示意图

  • Web 播放器计算机上的日期和时间。在此示例中为 JULY 23, 201919:14:24
  • 播放中录制件的持续时间。在此示例中为 00:13:41
  • 录制件中的事件数量。在此示例中为 9 个事件
  • 录制其会话的用户的名称。
  • 托管录制的会话的 VDA 的主机名。
  • 运行会话的客户端设备的名称。
  • 事件过滤器。可以选择多个过滤器以搜索当前录制件中的事件。

    事件过滤器示意图

    单击图标可展开折叠的事件显示。

    展开事件的折叠显示的示意图

  • 事件列表。单击列表中的某个事件将转到录制件中该事件的位置。
  • 快速搜索框。搜索事件快速搜索框有助于快速缩小当前录制件中的事件列表。

配置缓存内存,以便在播放时存储录制件

在 Web 播放器的配置页面上,可以单击滑块以设置缓存内存,以便在播放时存储录制件。

配置缓存内存以便在播放时存储录制件的示意图

Session Recording Web 播放器