会话录制 Web 播放器

概述

Web 播放器允许您使用 Web 浏览器查看和播放录制件。使用 Web 播放器，您可以：

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

• 查看和播放实时和已完成的录制件，其中标记的事件列在右侧窗格中。

• 配置缓存内存以在播放时存储录制件。

• 记录空闲事件并突出显示空闲时段。

• 对录制件发表评论并设置评论严重性。

• 共享录制件的 URL。

注意：

支持的浏览器包括 IE 浏览器、谷歌浏览器、微软 Edge 浏览器和火狐浏览器。

启用 Web 播放器

Web 播放器默认处于启用状态。

• 要禁用 Web 播放器，请启动 Windows 命令提示符并运行 <Session Recording Server installation path>\Bin\SsRecUtils.exe –disablewebplayer 命令。

• 要启用 Web 播放器，请启动 Windows 命令提示符并运行 <Session Recording Server installation path>\Bin\SsRecUtils.exe -enablewebplayer 命令。

登录和密码

Web Player 网站的 URL 为 http(s)://<FQDN of Session Recording Server>/WebPlayer。为确保使用 HTTPS，请在 IIS 中为该网站添加 SSL 绑定，并更新 SsRecWebSocketServer.config 配置文件。有关详细信息，请参阅本文中的 HTTPS 配置 部分。

注意：

登录 Web Player 网站时，域用户无需输入凭据，而非域用户则必须输入。

安装说明

与其他会话录制组件一样，您可以使用 Citrix Virtual Apps and Desktops™ 安装程序安装 Web 播放器。

在安装过程中，在“核心组件”页面上选择“Session Recording 管理”会将 Web Player 安装在与 Session Recording Server 相同的计算机上。有关安装 Session Recording 的详细信息，请参阅安装、升级和卸载。

Starting from Version 2103, Session Recording migrates the WebSocket server to IIS. With the web player installed, the SessionRecordingRestApiService, SessionRecordingWebStreaming, and WebPlayer applications appear in IIS.

A fresh installation of Session Recording 2103 and later connects your web browser to the WebSocket server hosted in IIS when you access the web player website. The WebSocket server hosted in IIS is versioned 2.0, as indicated by the registry value WebSocketServerVersion under the registry key at HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server.

Web 套接字服务器版本(/zh-cn/session-recording/2103/media/websocket-server-version.png)

An upgrade installation from an earlier version to Session Recording 2103 and later connects your web browser to the Python-based WebSocket server. To connect to the WebSocket server hosted in IIS, run the <Session Recording Server installation path>\Bin\SsRecUtils.exe -enablestreamingservice command. To connect back to the Python-based WebSocket server, run the <Session Recording Server installation path>\Bin\SsRecUtils.exe - disablestreamingservice command. The Python-based WebSocket server is versioned 1.0.

HTTPS 协议配置

要使用 HTTPS 访问 Web Player 网站，请执行以下操作：

1. 在 IIS 中添加 SSL 绑定。

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

      注意：

      大多数常用浏览器（例如 Google Chrome 和 Firefox）不再支持证书签名请求 (CSR) 中的公用名。它们在所有公共信任证书中强制执行主题备用名称 (SAN)。要在 HTTPS 上使用 Web 播放器，请相应地执行以下操作：

      • 当使用单个会话录制服务器时，将会话录制服务器的证书更新为 SAN 证书。

        正在使用单个会话录制服务器(/zh-cn/session-recording/2103/media/single-server-in-use.png)

      • 当使用负载平衡时，请确保 Citrix ADC 和每个会话录制服务器上都提供了 SAN 证书。

        正在使用负载平衡(/zh-cn/session-recording/2103/media/load-balancing-in-use2.png)

   2. 在 IIS 上，右键单击网站并选择 添加绑定。将显示 站点绑定 对话框。

      站点绑定对话框(/zh-cn/session-recording/2103/media/site-bindings.png)

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

   4. 从 类型 列表中选择 https，然后选择您的 SSL 证书。

      选择 HTTPS 选项(/zh-cn/session-recording/2103/media/selecting-https.png)

      选择您的 SSL 证书(/zh-cn/session-recording/2103/media/select-ssl-certificate.png)

   5. 单击 确定。

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

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

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

   2. (Optional) For Session Recording 2103 and later that host the WebSocket server in IIS, enable TLS by editing TLSEnable=1 and ignore the ServerPort, SSLCert, and SSLKey fields.

   3. （可选）对于 Session Recording 2012 及更早版本，通过编辑 TLSEnable=1 启用 TLS，并分别填写 SSL 证书及其密钥的路径。

      注意：

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

      

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

      1. 确保在您的会话录制服务器上安装了 OpenSSL，该服务器包含 SSL 证书。

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

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

      4. 从 OpenSSL 安装目录下的 bin 文件夹启动 OpenSSL。

      5. 您需要执行以下命令来提取证书：

         openssl pkcs12 -in [yourfile.pfx] -clcerts -nokeys -out [aSRS2.pem]
         <!--NeedCopy-->
         

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

      6. 您需要执行以下命令来提取私钥：

         openssl pkcs12 -in [yourfile.pfx] -nocerts -out [newaSRS2keyWithPassword.pem]
         <!--NeedCopy-->
         

         输入在导出 .pfx 文件时创建的导入密码。当系统提示输入 PEM 密码短语时，提供一个新密码来保护您的密钥文件。

      7. 请运行以下命令，以便解密私钥：

         openssl rsa -in [newaSRS2keyWithPassword.pem] -out [newaSRS2key.pem]
         <!--NeedCopy-->
         

   4. 保存您的更改。

   5. 检查您的防火墙设置。允许 SsRecWebSocketServer.exe 使用 TCP 端口（默认为 22334），并允许访问 Web 播放器 URL。

   6. 运行 SsRecUtils –stopwebsocketserver 命令。

查看录制件

登录后，Web 播放器主页可能会根据在 会话录制服务器属性 中是否选中以下选项来隐藏或显示内容。

• 选中该选项后，Web 播放器主页会隐藏所有内容。只能通过录制件的 URL 访问录制件。录制件 URL 在发送给指定收件人的电子邮件警报中提供。有关电子邮件警报的信息，请参阅电子邮件警报策略。您还可以通过录制件播放页面上的 共享当前播放 控件共享录制件 URL。有关说明，请参阅本文后面的内容。

  

• 如果未选中该选项，Web 播放器主页将显示类似于以下屏幕截图的内容。单击左侧导航栏中的 所有录制件 以刷新页面并显示新录制件（如果有）。向下滚动网页以选择要查看的录制件，或使用筛选器自定义搜索结果。对于实时录制件，持续时间 列显示 实时，播放按钮显示为绿色。

  

要显示录制会话的所有录制文件，请在列表中选择一个录制件，然后单击 跟进 图标。跟进 图标仅在选中录制件时可用。

对于录制项目的描述，请查阅以下表格。

使用筛选器搜索录制内容

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

录制件搜索筛选器(/zh-cn/session-recording/2103/media/recording-search-filters.png)

例如，选择主机名筛选器后，将显示以下对话框。键入主机名（托管录制会话的 VDA 的主机名），然后单击搜索以筛选掉不相关的录制件并仅显示相关的录制件。

主机名筛选器(/zh-cn/session-recording/2103/media/host-name-filter-selecteD.png)

您可以通过单击当前选定的主机名来更改为其他筛选器，如以下屏幕截图所示。单击主机名后，将列出所有筛选器。根据需要选择其他筛选器。

列出的所有筛选器(/zh-cn/session-recording/2103/media/all-filters-listed1.png)

您还可以单击+符号来添加筛选器。

加号符号(/zh-cn/session-recording/2103/media/plus-symbol-1.png)

例如，您可以添加时间筛选器，如以下屏幕所示。

添加时间筛选器(/zh-cn/session-recording/2103/media/time-filter-added-new.png)

时间筛选器包含录制开始日期、开始时间和持续时间。

打开并播放录制件

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

播放按钮(/zh-cn/session-recording/2103/media/play-buttons2.png)

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

有关播放器控件的说明，请参阅下表：

播放器控件	详细描述
	播放选定的录制文件。
	暂停播放。
	您可以在播放期间拖动进度条。录制会话的空闲时段在播放期间会突出显示。
	回退 7 秒。
	指示录制回放的当前位置和总录制时长。时间格式为 HH:MM:SS。
	允许您点击并对正在播放的录制内容发表评论。
	允许您点击并将当前录制的 URL 复制到剪贴板。
	指示当前的播放速度。单击该图标可在 X0.5、X1、X2 和 X4 等选项之间切换。
	以全屏显示播放内容。
	在网页内显示播放内容。

在播放页面的右侧窗格中，提供以下录制数据、事件过滤器和快速搜索框：

• Web 播放器计算机上的日期和时间。在此示例中，为 2021 年 2 月 23 日和 11:10:58。
• 播放中录制的持续时间。在此示例中，为 00:07:32。
• 录制中的事件数。在此示例中，为 11 个事件。
• 录制了其会话的用户的名称。
• 录制会话所在 VDA 的主机名。
• 会话运行所在的客户端设备的名称。
• 搜索结果排序选项：选择按所有类别排序、按事件排序或按评论排序以对搜索结果进行排序。

• 事件筛选器。您可以选择多个筛选器以在当前录制中搜索事件。

  事件筛选器(/zh-cn/session-recording/2103/media/event-filters.png)

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

  展开折叠的事件显示(/zh-cn/session-recording/2103/media/expanding-folded-displays-of-events2.png)

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

配置用于在播放时存储录制的缓存内存

在 Web 播放器的配置页面上，单击滑块以设置用于在播放时存储录制的缓存内存。

提示：

You can access the Configuration page directly through http(s)://<FQDN of Session Recording Server>/WebPlayer/#/configuration/cache.

配置用于在播放时存储录制的缓存内存(/zh-cn/session-recording/2103/media/cache-memory-while-playing.png)

录制空闲事件并突出显示空闲时段

会话录音可以在会话录音 Web 播放器中记录空闲事件并突出显示空闲时段。空闲事件在会话录音播放器中不可见，因为空闲事件保存在会话录音数据库中，而不是保存在相关录音文件 (.icl 文件) 中。

To customize the idle event feature, set the following registry keys as required. The registry keys are located at HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\SessionEvents.

对录制内容进行评论

播放录制会话时，您可以单击“评论”播放器控件以留下评论并设置评论严重性。不同严重性的评论在右侧事件列表面板中以不同颜色显示。严重性包括“正常”、“中等”和“严重”。在会话播放期间，您可以查看有关录制件的所有评论并从事件列表中删除评论。刷新网页后才能删除您刚刚留下的评论。

单击事件列表中的评论可让您跳转到给出评论的位置。单击左上角的评论图标会将您重定向到“我的评论”页面，其中显示了您的所有评论。

注意：

要使评论功能按预期工作，请清除 Session Recording Server 上的 Server Manager 的“添加角色和功能”向导中的“WebDAV 发布”复选框。

共享录制件的 URL

在录制件的播放页面上单击“共享当前播放”会将录制件 URL 复制到剪贴板。您可以与其他用户共享该 URL，以便他们直接访问录制件，而无需在所有录制件中进行搜索。

共享当前播放(/zh-cn/session-recording/2103/media/share-playack-url.png)

单击 共享当前播放 后，将显示以下消息之一，分别指示操作成功或失败：

• 共享录制的 URL 已复制到剪贴板

• 共享录制 URL 失败

将共享 URL 粘贴到地址栏中可让您跳转到复制该 URL 的位置。

为了安全共享，请在 HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server 下设置以下注册表值：

与 Web 播放器集成的管理员日志记录

Web 播放器集成了管理员日志记录网页。被分配了 LoggingReader 和 Player 两个角色的管理员可以在 Web 播放器中查看管理员活动日志。

注意：

为 Web 播放器浏览器设置的语言必须与您在安装 Session Recording 管理组件时选择的语言匹配。

• 配置日志记录：

  

• 录制原因日志记录：

  

确保 IIS 中的 SessionRecordingLoggingWebApplication 站点和 Web 播放器具有相同的 SSL 设置。否则，当您请求访问管理员活动日志时，将发生 403 错误。