会话录制 Web 播放器

概述

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

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

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

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

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

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

• 共享录制件的 URL。

注意：

支持的浏览器包括谷歌浏览器、微软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 网站时，域用户无需输入凭据，而非域用户则必须输入。

安装说明

As with the other Session Recording components, you can use the Citrix Virtual Apps and Desktops™ installer to install the web player.

在安装过程中，在核心组件页面上选择 Session Recording Administration 会将 Web 播放器与 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.

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 configuration

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

1. 在 IIS 中添加 SSL 绑定。

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

      注意：

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

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

        

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

        

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

      

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

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

      

      

   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 服务器配置文件的图像(/zh-cn/session-recording/2106/media/update-websocket-server-config2.png)

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

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

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

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

      4. 从 OpenSSL 的二进制文件目录启动 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 地址、事件文本、事件类型和时间。

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

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

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

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

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

打开并播放录制文件

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

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

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

录制文件播放页面(/zh-cn/session-recording/2106/media/playback-page.png)

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

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

回放页面的右侧窗格(/zh-cn/session-recording/2106/media/event-details.png)

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

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

  

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

  

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

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

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

提示：

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

配置缓存内存以在播放时存储录制内容(/zh-cn/session-recording/2106/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.

评论录制内容

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

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

注意：

为了使评论功能按预期工作，请在会话录制服务器上的服务器管理器中的“添加角色和功能”向导中清除“WebDAV 发布”复选框。

服务器管理器中的配置图像(/zh-cn/session-recording/2106/media/configuration-in-server-manager.png)

共享录制件的 URL

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

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

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

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

• 共享录制件 URL 失败

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

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

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

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

注意：

Web 播放器浏览器设置的语言必须与您安装会话录制管理组件时选择的语言一致。

• 配置日志记录：

  

• 录制原因日志记录：

  

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