Webplayer für die Sitzungsaufzeichnung
Übersicht
Der Webplayer ermöglicht es Ihnen, einen Webbrowser zum Anzeigen und Wiedergeben von Aufzeichnungen zu verwenden. Mit dem Webplayer können Sie:
-
Aufzeichnungen mithilfe von Filtern suchen, darunter Hostname, Clientname, Benutzername, Anwendung, Client-IP-Adresse, Ereignistext, Ereignistyp und Uhrzeit.
-
Sowohl Live- als auch abgeschlossene Aufzeichnungen mit markierten Ereignissen im rechten Bereich anzeigen und wiedergeben.
-
Cache-Speicher für die Speicherung von Aufzeichnungen während der Wiedergabe konfigurieren.
-
Inaktive Ereignisse aufzeichnen und inaktive Zeiträume hervorheben.
-
Kommentare zu einer Aufzeichnung hinterlassen und die Schweregrade der Kommentare festlegen.
-
URLs von Aufzeichnungen teilen.
Hinweis:
Zu den unterstützten Browsern gehören Internet Explorer, Google Chrome, Microsoft Edge und Firefox.
Webplayer aktivieren
Der Webplayer ist standardmäßig aktiviert.
-
Um den Webplayer zu deaktivieren, starten Sie eine Windows-Eingabeaufforderung und führen Sie den Befehl
<Session Recording Server installation path>\Bin\SsRecUtils.exe –disablewebplayeraus. -
Um den Webplayer zu aktivieren, starten Sie eine Windows-Eingabeaufforderung und führen Sie den Befehl
<Session Recording Server installation path>\Bin\SsRecUtils.exe -enablewebplayeraus.
Anmeldung und Kennwort
Die URL der Webplayer-Website ist http(s)://<FQDN of Session Recording Server>/WebPlayer. Um die Verwendung von HTTPS sicherzustellen, fügen Sie in IIS eine SSL-Bindung zur Website hinzu und aktualisieren Sie die Konfigurationsdatei SsRecWebSocketServer.config. Weitere Informationen finden Sie im Abschnitt HTTPS-Konfiguration in diesem Artikel.
Hinweis:
Bei der Anmeldung an der Webplayer-Website müssen Domänenbenutzer keine Anmeldeinformationen eingeben, Nicht-Domänenbenutzer jedoch schon.
Installation
Wie bei den anderen Session Recording-Komponenten können Sie den Citrix Virtual Apps and Desktops™-Installer verwenden, um den Webplayer zu installieren.
Bei der Installation wird durch Auswahl von Session Recording Administration auf der Seite Core Components der Webplayer auf demselben Computer wie der Session Recording-Server installiert. Weitere Informationen zur Installation von Session Recording finden Sie unter Installieren, Aktualisieren und Deinstallieren.
Ab Version 2103 migriert Session Recording den WebSocket-Server zu IIS. Wenn der Webplayer installiert ist, werden die Anwendungen SessionRecordingRestApiService, SessionRecordingWebStreaming und WebPlayer in IIS angezeigt.

Eine Neuinstallation von Session Recording 2103 und höher verbindet Ihren Webbrowser mit dem in IIS gehosteten WebSocket-Server, wenn Sie auf die Webplayer-Website zugreifen. Der in IIS gehostete WebSocket-Server hat die Version 2.0, wie durch den Registrierungswert WebSocketServerVersion unter dem Registrierungsschlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server angegeben.

Eine Upgrade-Installation von einer früheren Version auf Session Recording 2103 und höher verbindet Ihren Webbrowser mit dem Python-basierten WebSocket-Server. Um eine Verbindung zum in IIS gehosteten WebSocket-Server herzustellen, führen Sie den Befehl <Installationspfad des Session Recording-Servers>\Bin\SsRecUtils.exe -enablestreamingservice aus. Um die Verbindung zum Python-basierten WebSocket-Server wiederherzustellen, führen Sie den Befehl <Installationspfad des Session Recording-Servers>\Bin\SsRecUtils.exe - disablestreamingservice aus. Der Python-basierte WebSocket-Server hat die Version 1.0.
HTTPS-Konfiguration
So verwenden Sie HTTPS für den Zugriff auf die Webplayer-Website:
-
Fügen Sie in IIS eine SSL-Bindung hinzu.
-
Beziehen Sie ein SSL-Zertifikat im PEM-Format von einer vertrauenswürdigen Zertifizierungsstelle (CA).
Hinweis:
Die meisten gängigen Browser wie Google Chrome und Firefox unterstützen den allgemeinen Namen in einer Zertifikatsignieranforderung (CSR) nicht mehr. Sie erzwingen den Subject Alternative Name (SAN) in allen öffentlich vertrauenswürdigen Zertifikaten. Um den Webplayer über HTTPS zu verwenden, führen Sie die folgenden Schritte aus:
-
Wenn ein einzelner Session Recording-Server verwendet wird, aktualisieren Sie das Zertifikat des Session Recording-Servers auf ein SAN-Zertifikat.

-
Wenn Lastenausgleich verwendet wird, stellen Sie sicher, dass ein SAN-Zertifikat sowohl auf Citrix ADC als auch auf jedem Session Recording-Server verfügbar ist.

-
-
Klicken Sie in IIS mit der rechten Maustaste auf die Website und wählen Sie Bindungen hinzufügen. Das Dialogfeld Sitebindungen wird angezeigt.

-
Klicken Sie oben rechts auf Hinzufügen. Das Dialogfeld Sitebindung hinzufügen wird angezeigt.
-
Wählen Sie https aus der Liste Typ und wählen Sie Ihr SSL-Zertifikat aus.


-
Klicken Sie auf OK.
-
-
Aktualisieren Sie die Konfigurationsdatei
SsRecWebSocketServer.config.-
Suchen und öffnen Sie die Konfigurationsdatei
SsRecWebSocketServer.config.Die Konfigurationsdatei
SsRecWebSocketServer.configbefindet sich normalerweise im Ordner<Session Recording Server installation path>\Bin\. -
(Optional) Für Session Recording 2103 und höher, die den WebSocket-Server in IIS hosten, aktivieren Sie TLS, indem Sie TLSEnable=1 bearbeiten und die Felder ServerPort, SSLCert und SSLKey ignorieren.
-
(Optional) Für Session Recording 2012 und früher aktivieren Sie TLS, indem Sie TLSEnable=1 bearbeiten und die Pfade zum SSL-Zertifikat bzw. dessen Schlüssel eingeben.
Hinweis:
Es wird nur das PEM-Format von SSL-Zertifikaten und Schlüsseldateien unterstützt. Das Feld ServerPort gibt die Portnummer an, die der Webplayer zum Sammeln von Aufzeichnungsdateien verwendet. Im folgenden Screenshot ist sie auf den Standardwert (22334) eingestellt.

So extrahieren Sie die separaten Zertifikats- und Schlüsseldateien, die in der WebSocket-Serverkonfiguration verwendet werden:
-
Stellen Sie sicher, dass OpenSSL auf Ihrem Session Recording-Server installiert ist, der das SSL-Zertifikat enthält.
-
Exportieren Sie das SSL-Zertifikat als .pfx-Datei. Die .pfx-Datei enthält sowohl das Zertifikat als auch den privaten Schlüssel.
-
Öffnen Sie die Eingabeaufforderung und wechseln Sie zu dem Ordner, der die .pfx-Datei enthält.
-
Starten Sie OpenSSL aus dem Ordner OpenSSL\bin.
-
Führen Sie den folgenden Befehl aus, um das Zertifikat zu extrahieren:
openssl pkcs12 -in [yourfile.pfx] -clcerts -nokeys -out [aSRS2.pem] <!--NeedCopy-->Geben Sie das Importkennwort ein, das Sie beim Exportieren der .pfx-Datei erstellt haben.
-
Führen Sie den folgenden Befehl aus, um den privaten Schlüssel zu extrahieren:
openssl pkcs12 -in [yourfile.pfx] -nocerts -out [newaSRS2keyWithPassword.pem] <!--NeedCopy-->Geben Sie das Importkennwort ein, das Sie beim Exportieren der .pfx-Datei erstellt haben. Geben Sie ein neues Kennwort zum Schutz Ihrer Schlüsseldatei ein, wenn Sie zur Eingabe der PEM-Passphrase aufgefordert werden.
-
Führen Sie den folgenden Befehl aus, um den privaten Schlüssel zu entschlüsseln:
openssl rsa -in [newaSRS2keyWithPassword.pem] -out [newaSRS2key.pem] <!--NeedCopy-->
-
-
Speichern Sie Ihre Änderungen.
-
Überprüfen Sie Ihre Firewall-Einstellungen. Erlauben Sie SsRecWebSocketServer.exe die Verwendung des TCP-Ports (standardmäßig 22334) und den Zugriff auf die Webplayer-URL.
-
Führen Sie den Befehl
SsRecUtils –stopwebsocketserveraus.
-
Aufzeichnungen anzeigen
Nach der Anmeldung kann die Webplayer-Startseite Inhalte ausblenden oder anzeigen, je nachdem, ob die folgende Option in den Sitzungsaufzeichnungsserver-Eigenschaften ausgewählt ist.

-
Wenn die Option ausgewählt ist, blendet die Webplayer-Startseite alle Inhalte aus. Aufzeichnungen können nur über ihre URLs aufgerufen werden. Aufzeichnungs-URLs werden in E-Mail-Benachrichtigungen bereitgestellt, die an bestimmte Empfänger gesendet werden. Informationen zu E-Mail-Benachrichtigungen finden Sie unter E-Mail-Benachrichtigungsrichtlinien. Sie können Aufzeichnungs-URLs auch über das Steuerelement Aktuelle Wiedergabe freigeben auf den Aufzeichnungswiedergabeseiten teilen. Beschreibungen finden Sie später in diesem Artikel.

-
Wenn die Option nicht ausgewählt ist, zeigt die Webplayer-Startseite Inhalte an, die dem folgenden Screenshot ähneln. Klicken Sie in der linken Navigation auf Alle Aufzeichnungen, um die Seite zu aktualisieren und neue Aufzeichnungen anzuzeigen, falls vorhanden. Scrollen Sie auf der Webseite nach unten, um Aufzeichnungen zur Anzeige auszuwählen, oder verwenden Sie Filter, um Ihre Suchergebnisse anzupassen. Bei Live-Aufzeichnungen zeigt die Spalte Dauer den Wert Live an, und die Wiedergabeschaltfläche wird grün angezeigt.

Um alle Aufzeichnungsdateien einer aufgezeichneten Sitzung anzuzeigen, wählen Sie eine Aufzeichnung in der Liste aus und klicken Sie auf das Symbol Nachverfolgen. Das Symbol Nachverfolgen ist nur verfügbar, wenn eine Aufzeichnung ausgewählt ist.
![]()
Eine Beschreibung der Aufzeichnungselemente finden Sie in der folgenden Tabelle.
| Element | Beschreibung |
|---|---|
| Startzeit | Die Startzeit der Aufzeichnung. Klicken Sie auf die Auf- und Abwärtspfeile, um Aufzeichnungen in chronologischer Reihenfolge aufzulisten. |
| Benutzer | Der Benutzer, dessen Sitzung aufgezeichnet wurde. Klicken Sie auf die Auf- und Abwärtspfeile, um die Aufzeichnungen eines Benutzers in der Liste zu konzentrieren und die Benutzer in alphabetischer Reihenfolge anzuordnen. |
| Host | Der Hostname des VDA, auf dem die aufgezeichnete Sitzung gehostet wurde. Klicken Sie auf die Auf- und Abwärtspfeile, um die VDA-Hostnamen in alphabetischer Reihenfolge anzuordnen. |
| Client | Der Name des Clientgeräts, auf dem die Sitzung ausgeführt wurde. Klicken Sie auf die Auf- und Abwärtspfeile, um die Client-Hostnamen in alphabetischer Reihenfolge anzuordnen. |
| Ereignisse | Die Anzahl der Ereignisse in der Aufzeichnung. Klicken Sie auf die Auf- und Abwärtspfeile, um Aufzeichnungen in der Liste nach Ereignisanzahl anzuordnen. |
| Dauer | Die Zeitdauer der Aufzeichnung. Klicken Sie auf die Auf- und Abwärtspfeile, um Aufzeichnungen in der Liste nach Zeitdauer anzuordnen. |
Aufzeichnungen mithilfe von Filtern suchen
Sie können Aufzeichnungen mithilfe von Filtern suchen. Die verfügbaren Filter umfassen Hostname, Clientname, Benutzername, Anwendung, Client-IP-Adresse, Ereignistext, Ereignistyp und Uhrzeit.

Wenn Sie beispielsweise den Hostnamenfilter auswählen, wird das folgende Dialogfeld angezeigt. Geben Sie den Hostnamen (des VDA, auf dem aufgezeichnete Sitzungen gehostet werden) ein und klicken Sie auf Suchen, um irrelevante Aufzeichnungen herauszufiltern und nur die relevanten anzuzeigen.

Sie können zu einem anderen Filter wechseln, indem Sie auf den aktuell ausgewählten Hostnamen klicken, wie im folgenden Screenshot gezeigt. Alle Filter werden aufgelistet, nachdem Sie auf Hostname geklickt haben. Wählen Sie bei Bedarf einen anderen Filter aus.

Sie können auch auf das Symbol + klicken, um Filter hinzuzufügen.

Sie können beispielsweise den Filter Uhrzeit hinzufügen, wie im folgenden Bildschirm gezeigt.

Der Filter Uhrzeit besteht aus Aufzeichnungsstartdatum, Startzeit und Dauer.
Aufzeichnungen öffnen und wiedergeben
Auf der Seite für Aufzeichnungen hat jede Aufzeichnung rechts neben dem Element Dauer eine Wiedergabeschaltfläche.

Klicken Sie auf die Wiedergabeschaltfläche. Die Wiedergabeseite wird angezeigt. Die Wiedergabe beginnt nach dem Caching im Speicher.

Eine Beschreibung der Player-Steuerelemente finden Sie in der folgenden Tabelle:
| Player-Steuerelement | Beschreibung |
|---|---|
![]() |
Spielt die ausgewählte Aufzeichnungsdatei ab. |
![]() |
Hält die Wiedergabe an. |
![]() |
Sie können den Fortschrittsbalken während der Wiedergabe ziehen. Leerlaufzeiten aufgezeichneter Sitzungen werden während der Wiedergabe hervorgehoben. |
![]() |
Spult 7 Sekunden zurück. |
![]() |
Zeigt die aktuelle Position der Aufzeichnungswiedergabe und die gesamte Aufzeichnungsdauer an. Das Zeitformat ist HH:MM:SS. |
| Ermöglicht es Ihnen, einen Kommentar zur abgespielten Aufzeichnung zu hinterlassen. | |
![]() |
Ermöglicht es Ihnen, die URL der aktuellen Aufzeichnung anzuklicken und in die Zwischenablage zu kopieren. |
![]() |
Zeigt die aktuelle Wiedergabegeschwindigkeit an. Klicken Sie auf das Symbol, um zwischen den Optionen X0.5, X1, X2 und X4 zu wechseln. |
![]() |
Zeigt die Wiedergabe im Vollbildmodus an. |
![]() |
Zeigt die Wiedergabe innerhalb der Webseite an. |
Im rechten Bereich der Wiedergabeseite sind die folgenden Aufzeichnungsdaten, Ereignisfilter und das Schnellsuchfeld verfügbar:

- Datum und Uhrzeit auf dem Webplayer-Computer. In diesem Beispiel: 23. Februar 2021 und 11:10:58.
- Die Dauer der Aufzeichnung in der Wiedergabe. In diesem Beispiel: 00:07:32.
- Die Anzahl der Ereignisse in der Aufzeichnung. In diesem Beispiel: 11 EREIGNISSE.
- Der Name des Benutzers, dessen Sitzung aufgezeichnet wurde.
- Der Hostname des VDA, auf dem die aufgezeichnete Sitzung gehostet wurde.
- Der Name des Clientgeräts, auf dem die Sitzung ausgeführt wurde.
- Optionen zum Sortieren von Suchergebnissen: Wählen Sie zum Sortieren der Suchergebnisse Nach allen Kategorien sortieren, Nach Ereignissen sortieren oder Nach Kommentaren sortieren.
-
Ereignisfilter. Sie können mehrere Filter auswählen, um in der aktuellen Aufzeichnung nach Ereignissen zu suchen.
Ereignisfilter(/de-de/session-recording/2103/media/event-filters.png)
Klicken Sie auf das Symbol, um zusammengeklappte Ereignisanzeigen zu erweitern.
erweitern zusammengeklappte Ereignisanzeigen(/de-de/session-recording/2103/media/expanding-folded-displays-of-events2.png)
- Ereignisliste. Wenn Sie auf ein Ereignis in der Liste klicken, gelangen Sie zur Position des Ereignisses in der Aufzeichnung.
- Schnellsuchfeld. Das Schnellsuchfeld Ereignisse suchen hilft, eine Liste von Ereignissen in der aktuellen Aufzeichnung schnell einzugrenzen.
Cache-Speicher für die Speicherung von Aufzeichnungen während der Wiedergabe konfigurieren
Klicken Sie auf der Seite Konfiguration des Webplayers auf den Schieberegler, um den Cache-Speicher für die Speicherung von Aufzeichnungen während der Wiedergabe einzurichten.
Tipp:
Sie können direkt über http(s)://<FQDN of Session Recording Server>/WebPlayer/#/configuration/cache auf die Seite Konfiguration zugreifen.
Cache-Speicher für die Speicherung von Aufzeichnungen während der Wiedergabe konfigurieren(/de-de/session-recording/2103/media/cache-memory-while-playing.png)
Leerlaufereignisse aufzeichnen und Leerlaufzeiten hervorheben
Die Sitzungsaufzeichnung kann Leerlaufereignisse aufzeichnen und Leerlaufzeiten im Webplayer für die Sitzungsaufzeichnung hervorheben. Leerlaufereignisse sind im Sitzungsaufzeichnungsplayer nicht sichtbar, da sie in der Sitzungsaufzeichnungsdatenbank, aber nicht in den relevanten Aufzeichnungsdateien (.icl-Dateien) gespeichert werden.
Um die Funktion für Leerlaufereignisse anzupassen, legen Sie die folgenden Registrierungsschlüssel nach Bedarf fest. Die Registrierungsschlüssel befinden sich unter HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\SessionEvents.
| Registrierungsschlüssel | Standardwert | Beschreibung |
|---|---|---|
| DisableIdleEvent | 0 | Um die Funktion für Leerlaufereignisse zu deaktivieren, setzen Sie den Wert auf 1. Um die Funktion für Leerlaufereignisse zu aktivieren, setzen Sie den Wert auf 0. |
| IdleEventThrottle | 120 Sekunden | Wenn keine Benutzeraktivität (einschließlich Grafikänderungen und Tastatur-/Mauseingaben) länger als der durch den Registrierungsschlüssel festgelegte Zeitschwellenwert vorliegt, wird ein Leerlaufereignis aufgezeichnet. Die Leerlaufzeit wird hervorgehoben, wenn die aufgezeichnete Sitzung im Webplayer für die Sitzungsaufzeichnung wiedergegeben wird. |
| IdleEventActiveThrottle | 30 Sekunden | Nur eine bestimmte Anzahl von Grafikänderungen innerhalb eines bestimmten Zeitraums gilt als Benutzeraktivität. Standardmäßig können mindestens drei Pakete innerhalb von 30 Sekunden als Benutzeraktivitäten gelten. |
| IdleEventActivePktNumThrottle | 3 Pakete | Nur eine bestimmte Anzahl von Grafikänderungen innerhalb eines bestimmten Zeitraums gilt als Benutzeraktivität. Standardmäßig können mindestens drei Pakete innerhalb von 30 Sekunden als Benutzeraktivitäten gelten. |
| IdleEventActivePktSizeThrottle | 100 Bytes | Grafikpakete, die kleiner als der Schlüsselwert sind, werden ignoriert, und die entsprechende Zeitdauer wird als inaktiv betrachtet. |
Kommentare zu Aufzeichnungen
Während eine aufgezeichnete Sitzung wiedergegeben wird, können Sie auf das Player-Steuerelement Kommentare klicken, um Kommentare zu hinterlassen und deren Schweregrade festzulegen. Kommentare unterschiedlicher Schweregrade werden im rechten Ereignislistenfeld in verschiedenen Farben angezeigt. Die Schweregrade umfassen Normal, Mittel und Schwerwiegend. Während der Sitzungswiedergabe können Sie alle Kommentare zu einer Aufzeichnung anzeigen und Kommentare aus der Ereignisliste löschen. Aktualisieren Sie die Webseite, bevor Sie einen gerade hinterlassenen Kommentar löschen können.

Wenn Sie in der Ereignisliste auf einen Kommentar klicken, gelangen Sie zu der Stelle, an der der Kommentar abgegeben wurde. Wenn Sie auf das Kommentarsymbol in der oberen linken Ecke klicken, werden Sie zur Seite Meine Kommentare weitergeleitet, auf der alle Ihre Kommentare angezeigt werden.

Hinweis:
Damit die Kommentarfunktion wie erwartet funktioniert, deaktivieren Sie das Kontrollkästchen WebDAV-Veröffentlichung im Assistenten zum Hinzufügen von Rollen und Features des Server-Managers auf dem Session Recording-Server.

URLs von Aufzeichnungen teilen
Wenn Sie auf der Wiedergabeseite einer Aufzeichnung auf Aktuelle Wiedergabe teilen klicken, wird die URL der Aufzeichnung in die Zwischenablage kopiert. Sie können die URL mit anderen Benutzern teilen, damit diese direkt auf die Aufzeichnung zugreifen können, ohne in allen Aufzeichnungen suchen zu müssen.

Nachdem Sie auf Aktuelle Wiedergabe teilen geklickt haben, wird eine der folgenden Meldungen angezeigt, die einen erfolgreichen bzw. fehlgeschlagenen Vorgang angibt:
-
Die URL zur freigegebenen Aufzeichnung wurde in die Zwischenablage kopiert
-
Freigabe der Aufzeichnungs-URL fehlgeschlagen
Wenn Sie die freigegebene URL in die Adressleiste einfügen, gelangen Sie direkt zu der Stelle, an der die URL kopiert wurde.
Für eine sichere Freigabe legen Sie die folgenden Registrierungswerte unter HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server fest:
| Registrierungswert | Beschreibung | Standardwert | Anmerkungen |
|---|---|---|---|
| LinkExpire | Zeitspanne, nach der eine freigegebene URL abläuft. Gezählt als Zeit-Ticks in der Einheit von 10 Mikrosekunden. | 1.728.000.000.000 (Der Standardwert entspricht 2 Tagen.) | - |
| LinkSalt | Eine Sicherheitsmethode zum Schutz der vorhergehenden URL-Ablaufzeit | Kk2od974 | Ändern Sie den Standardwert in eine beliebige Zeichenfolge, die vorzugsweise mit Ziffern endet. |
Administratorprotokollierung in den Webplayer integriert
Der Webplayer integriert die Webseite für die Administratorprotokollierung. Ein Administrator, der sowohl den Rollen LoggingReader als auch Player zugewiesen ist, kann die Administratoraktivitätsprotokolle im Webplayer anzeigen.
Hinweis:
Die für den Webplayer-Browser eingestellte Sprache muss mit der Sprache übereinstimmen, die Sie bei der Installation der Session Recording-Verwaltungskomponenten ausgewählt haben.
-
Konfigurationsprotokollierung:

-
Protokollierung des Aufzeichnungsgrunds:

Stellen Sie sicher, dass Ihre SessionRecordingLoggingWebApplication-Site in IIS und der Webplayer dieselben SSL-Einstellungen haben. Andernfalls treten 403-Fehler auf, wenn Sie versuchen, auf die Administratoraktivitätsprotokolle zuzugreifen.









