Lecteur web d’enregistrement de session

Vue d’ensemble

Le lecteur web vous permet d’utiliser un navigateur web pour afficher et lire les enregistrements. À l’aide du lecteur web, vous pouvez :

• Rechercher des enregistrements à l’aide de filtres, notamment le nom d’hôte, le nom du client, le nom d’utilisateur, l’application, l’adresse IP du client, le texte de l’événement, le type d’événement et l’heure.

• Afficher et lire les enregistrements en direct et terminés avec les événements balisés répertoriés dans le volet droit.

• configurer la mémoire cache pour stocker les enregistrements pendant la lecture.

• Enregistrer les événements d’inactivité et mettre en évidence les périodes d’inactivité.

• Laisser des commentaires sur un enregistrement et définir les niveaux de gravité des commentaires.

• Partager les URL des enregistrements.

Remarque :

Les navigateurs pris en charge incluent Internet Explorer, Google Chrome, Microsoft Edge et Firefox.

Activer le lecteur web

Le lecteur web est activé par défaut.

• Pour désactiver le lecteur web, démarrez une invite de commandes Windows et exécutez la commande <Session Recording Server installation path>\Bin\SsRecUtils.exe –disablewebplayer.

• Pour activer le lecteur web, démarrez une invite de commandes Windows et exécutez la commande <Session Recording Server installation path>\Bin\SsRecUtils.exe -enablewebplayer.

Connexion et mot de passe

L’URL du site web du lecteur web est http(s)://<FQDN of Session Recording Server>/WebPlayer. Pour garantir l’utilisation de HTTPS, ajoutez une liaison SSL au site web dans IIS et mettez à jour le fichier de configuration SsRecWebSocketServer.config. Pour plus d’informations, consultez la section Configuration HTTPS de cet article.

Remarque :

Lors de la connexion au site web du lecteur web, les utilisateurs de domaine n’ont pas besoin de saisir leurs informations d’identification, contrairement aux utilisateurs hors domaine.

Installation

Comme pour les autres composants de Session Recording, vous pouvez utiliser le programme d’installation de Citrix Virtual Apps and Desktops™ pour installer le lecteur web.

Lors de l’installation, la sélection de Session Recording Administration sur la page Composants principaux installe le lecteur web sur la même machine que le serveur Session Recording. Pour plus d’informations sur l’installation de Session Recording, consultez Installer, mettre à niveau et désinstaller.

À partir de la version 2103, Session Recording migre le serveur WebSocket vers IIS. Une fois le lecteur web installé, les applications SessionRecordingRestApiService, SessionRecordingWebStreaming et WebPlayer apparaissent dans IIS.

Une nouvelle installation de Session Recording 2103 et versions ultérieures connecte votre navigateur web au serveur WebSocket hébergé dans IIS lorsque vous accédez au site web du lecteur web. Le serveur WebSocket hébergé dans IIS est en version 2.0, comme l’indique la valeur de registre WebSocketServerVersion sous la clé de registre HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server.

Une installation de mise à niveau d’une version antérieure vers Session Recording 2103 et versions ultérieures connecte votre navigateur web au serveur WebSocket basé sur Python. Pour vous connecter au serveur WebSocket hébergé dans IIS, exécutez la commande <Session Recording Server installation path>\Bin\SsRecUtils.exe -enablestreamingservice. Pour vous reconnecter au serveur WebSocket basé sur Python, exécutez la commande <Session Recording Server installation path>\Bin\SsRecUtils.exe - disablestreamingservice. Le serveur WebSocket basé sur Python est en version 1.0.

Configuration HTTPS

Pour utiliser HTTPS pour accéder au site web du lecteur web :

1. Ajoutez une liaison SSL dans IIS.

   1. Obtenez un certificat SSL au format PEM auprès d’une autorité de certification (CA) de confiance.

      Remarque :

      La plupart des navigateurs populaires tels que Google Chrome et Firefox ne prennent plus en charge le nom commun dans une demande de signature de certificat (CSR). Ils imposent le nom alternatif du sujet (SAN) dans tous les certificats publiquement approuvés. Pour utiliser le lecteur web via HTTPS, effectuez les actions suivantes en conséquence :

      • Lorsqu’un seul serveur d’enregistrement de session est utilisé, mettez à jour le certificat du serveur d’enregistrement de session vers un certificat SAN.

        

      • Lorsque l’équilibrage de charge est utilisé, assurez-vous qu’un certificat SAN est disponible à la fois sur Citrix ADC et sur chaque serveur d’enregistrement de session.

        

   2. Dans IIS, cliquez avec le bouton droit sur le site web et sélectionnez Ajouter des liaisons. La boîte de dialogue Liaisons de site apparaît.

      

   3. Cliquez sur Ajouter dans le coin supérieur droit. La boîte de dialogue Ajouter une liaison de site apparaît.

   4. Sélectionnez https dans la liste Type et sélectionnez votre certificat SSL.

      

      

   5. Cliquez sur OK.

2. Mettez à jour le fichier de configuration SsRecWebSocketServer.config.

   1. Localisez et ouvrez le fichier de configuration SsRecWebSocketServer.config.

      Le fichier de configuration SsRecWebSocketServer.config se trouve généralement dans le dossier <Session Recording Server installation path>\Bin\.

   2. (Facultatif) Pour Session Recording 2103 et versions ultérieures qui hébergent le serveur WebSocket dans IIS, activez TLS en modifiant TLSEnable=1 et ignorez les champs ServerPort, SSLCert et SSLKey.

   3. (Facultatif) Pour Session Recording 2012 et versions antérieures, activez TLS en modifiant TLSEnable=1, et renseignez les chemins d’accès au certificat SSL et à sa clé, respectivement.

      Remarque :

      Seul le format PEM des certificats SSL et des fichiers de clé est pris en charge. Le champ ServerPort indique le numéro de port que le lecteur Web utilise pour collecter les fichiers d’enregistrement. Dans la capture d’écran suivante, il est défini sur la valeur par défaut (22334).

      

      Pour extraire les fichiers de certificat et de clé distincts utilisés dans la configuration du serveur WebSocket :

      1. Assurez-vous qu’OpenSSL est installé sur votre serveur Session Recording qui contient le certificat SSL.

      2. Exportez le certificat SSL en tant que fichier .pfx. Le fichier .pfx inclut à la fois le certificat et la clé privée.

      3. Ouvrez l’invite de commandes et accédez au dossier qui contient le fichier .pfx.

      4. Démarrez OpenSSL à partir du dossier OpenSSL\bin.

      5. Exécutez la commande suivante pour extraire le certificat :

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

         Saisissez le mot de passe d’importation que vous avez créé lors de l’exportation du fichier .pfx.

      6. Exécutez la commande suivante pour extraire la clé privée :

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

         Entrez le mot de passe d’importation que vous avez créé lors de l’exportation du fichier .pfx. Fournissez un nouveau mot de passe pour protéger votre fichier de clé lorsque vous êtes invité à saisir la phrase secrète PEM.

      7. Exécutez la commande suivante pour déchiffrer la clé privée :

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

   4. Enregistrez vos modifications.

   5. Vérifiez les paramètres de votre pare-feu. Autorisez SsRecWebSocketServer.exe à utiliser le port TCP (22334 par défaut) et autorisez l’accès à l’URL du lecteur web.

   6. Exécutez la commande SsRecUtils –stopwebsocketserver.

Afficher les enregistrements

Après vous être connecté, la page d’accueil du lecteur web peut masquer ou afficher du contenu selon que l’option suivante est sélectionnée dans Propriétés du serveur d’enregistrement de session.

• Lorsque l’option est sélectionnée, la page d’accueil du lecteur web masque tout le contenu. Les enregistrements ne sont accessibles que via leurs URL. Les URL d’enregistrement sont fournies dans les alertes par e-mail envoyées aux destinataires spécifiés. Pour plus d’informations sur les alertes par e-mail, consultez Stratégies d’alerte par e-mail.Vous pouvez également partager les URL d’enregistrement via le contrôle Partager la lecture actuelle sur les pages de lecture d’enregistrement. Voir les descriptions plus loin dans cet article.

  

• Lorsque l’option n’est pas sélectionnée, la page d’accueil du lecteur web affiche un contenu similaire à la capture d’écran suivante. Cliquez sur Tous les enregistrements dans la navigation de gauche pour actualiser la page et afficher les nouveaux enregistrements, le cas échéant. Faites défiler la page web pour sélectionner les enregistrements à afficher ou utilisez des filtres pour personnaliser vos résultats de recherche. Pour les enregistrements en direct, la colonne Durée affiche En direct et le bouton de lecture apparaît en vert.

  

Pour afficher tous les fichiers d’enregistrement d’une session enregistrée, sélectionnez un enregistrement dans la liste et cliquez sur l’icône Suivi. L’icône Suivi n’est disponible que lorsqu’un enregistrement est sélectionné.

Pour une description des éléments d’enregistrement, consultez le tableau suivant.

Rechercher des enregistrements à l’aide de filtres

Vous pouvez rechercher des enregistrements à l’aide de filtres. Les filtres disponibles incluent le nom d’hôte, le nom du client, le nom d’utilisateur, l’application, l’adresse IP du client, le texte de l’événement, le type d’événement et l’heure.

Filtres de recherche d’enregistrement(/fr-fr/session-recording/2103/media/recording-search-filters.png)

Par exemple, après avoir sélectionné le filtre de nom d’hôte, la boîte de dialogue suivante apparaît. Saisissez le nom d’hôte (du VDA où les sessions enregistrées sont hébergées) et cliquez sur Rechercher pour filtrer les enregistrements non pertinents et afficher uniquement ceux qui sont pertinents.

Le filtre de nom d’hôte(/fr-fr/session-recording/2103/media/host-name-filter-selecteD.png)

Vous pouvez passer à un autre filtre en cliquant sur le Nom d’hôte actuellement sélectionné, comme illustré dans la capture d’écran suivante. Tous les filtres sont répertoriés après avoir cliqué sur Nom d’hôte. Sélectionnez un filtre différent si nécessaire.

Tous les filtres répertoriés(/fr-fr/session-recording/2103/media/all-filters-listed1.png)

Vous pouvez également cliquer sur le symbole + pour ajouter des filtres.

Le symbole plus(/fr-fr/session-recording/2103/media/plus-symbol-1.png)

Par exemple, vous pouvez ajouter le filtre Heure comme indiqué dans l’écran suivant.

Ajouter le filtre d’heure(/fr-fr/session-recording/2103/media/time-filter-added-new.png)

Le filtre Heure se compose de la date de début d’enregistrement, de l’heure de début et de la durée.

Ouvrir et lire les enregistrements

Sur la page des enregistrements, chaque enregistrement dispose d’un bouton de lecture sur le côté droit, à côté de l’élément Durée.

Bouton de lecture(/fr-fr/session-recording/2103/media/play-buttons2.png)

Cliquez sur le bouton de lecture. La page de lecture apparaît. La lecture démarre après la mise en cache de la mémoire.

Pour une description des commandes du lecteur, consultez le tableau suivant :

Commande du lecteur	Description
	Lit le fichier d’enregistrement sélectionné.
	Met la lecture en pause.
	Vous pouvez faire glisser la barre de progression pendant la lecture. Les périodes d’inactivité des sessions enregistrées sont mises en évidence pendant la lecture.
	Recule de 7 secondes.
	Indique la position actuelle de la lecture de l’enregistrement et la durée totale de l’enregistrement. Le format de l’heure est HH:MM:SS.
	Permet de cliquer et de laisser un commentaire sur l’enregistrement en cours de lecture.
	Permet de cliquer et de copier l’URL de l’enregistrement actuel dans le presse-papiers.
	Indique la vitesse de lecture actuelle. Cliquez sur l’icône pour basculer entre les options, notamment X0.5, X1, X2 et X4.
	Affiche la lecture en plein écran.
	Affiche la lecture dans la page web.

Dans le volet droit de la page de lecture, les données d’enregistrement, les filtres d’événements et la zone de recherche rapide suivants sont disponibles :

• La date et l’heure sur la machine du lecteur web. Dans cet exemple, le 23 février 2021 et 11:10:58.
• La durée de l’enregistrement en lecture. Dans cet exemple, 00:07:32.
• Le nombre d’événements dans l’enregistrement. Dans cet exemple, 11 ÉVÉNEMENTS.
• Le nom de l’utilisateur dont la session a été enregistrée.
• Le nom d’hôte du VDA où la session enregistrée a été hébergée.
• Le nom du périphérique client sur lequel la session était en cours d’exécution.
• Options de tri des résultats de recherche : Sélectionnez Trier par toutes les catégories, Trier par événements ou Trier par commentaires pour trier les résultats de recherche.

• Filtres d’événements. Vous pouvez sélectionner plusieurs filtres pour rechercher des événements dans l’enregistrement actuel.

  

  Cliquez sur l’icône pour développer les affichages d’événements repliés.

  

• Liste des événements. Cliquer sur un événement dans la liste vous amène à la position de l’événement dans l’enregistrement.
• Zone de recherche rapide. La zone de recherche rapide rechercher des événements permet de réduire rapidement une liste d’événements dans l’enregistrement actuel.

Configurer la mémoire cache pour le stockage des enregistrements pendant la lecture

Sur la page Configuration du lecteur web, cliquez sur le curseur pour configurer la mémoire cache pour le stockage des enregistrements pendant la lecture.

Conseil :

Vous pouvez accéder directement à la page Configuration via http(s)://<FQDN of Session Recording Server>/WebPlayer/#/configuration/cache.

Enregistrer les événements d’inactivité et mettre en évidence les périodes d’inactivité

L’enregistrement de session peut enregistrer les événements d’inactivité et mettre en surbrillance les périodes d’inactivité dans le lecteur web d’enregistrement de session. Les événements d’inactivité ne sont pas visibles dans le Lecteur d’enregistrement de session car ils sont enregistrés dans la base de données d’enregistrement de session mais pas dans les fichiers d’enregistrement pertinents (fichiers .icl).

Pour personnaliser la fonctionnalité d’événement d’inactivité, définissez les clés de registre suivantes selon vos besoins. Les clés de registre se trouvent à l’emplacement HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\SessionEvents.

Commenter les enregistrements

Lors de la lecture d’une session enregistrée, vous pouvez cliquer sur la commande du lecteur Commentaires pour laisser des commentaires et définir leur gravité. Les commentaires de différentes gravités sont affichés dans des couleurs différentes dans le panneau de liste d’événements de droite. Les gravités incluent Normal, Moyen et Grave. Pendant la lecture de la session, vous pouvez afficher tous les commentaires concernant un enregistrement et supprimer des commentaires de la liste d’événements. Actualisez la page Web avant de pouvoir supprimer un commentaire que vous venez de laisser.

Cliquer sur un commentaire dans la liste d’événements vous permet d’accéder à l’emplacement où le commentaire a été ajouté. Cliquer sur l’icône de commentaire dans le coin supérieur gauche vous redirige vers la page Mes commentaires où tous vos commentaires sont présentés.

Remarque :

Pour que la fonctionnalité de commentaire fonctionne comme prévu, désactivez la case à cocher Publication WebDAV dans l’assistant Ajouter des rôles et des fonctionnalités du Gestionnaire de serveur sur le serveur d’enregistrement de session.

Partager les URL des enregistrements

Cliquer sur Partager la lecture actuelle sur la page de lecture d’un enregistrement copie l’URL de l’enregistrement dans le presse-papiers. Vous pouvez partager l’URL avec d’autres utilisateurs afin qu’ils accèdent directement à l’enregistrement sans avoir à le rechercher parmi tous les enregistrements.

Après avoir cliqué sur Partager la lecture actuelle, l’un des messages suivants apparaît, indiquant respectivement une opération réussie ou échouée :

• L’URL de l’enregistrement partagé a été copiée dans le presse-papiers

• Le partage de l’URL de l’enregistrement a échoué

Coller l’URL partagée dans la barre d’adresse vous permet d’accéder à l’emplacement où l’URL a été copiée.

Pour un partage sécurisé, définissez les valeurs de registre suivantes sous HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server :

Journalisation de l’administrateur intégrée au lecteur web

Le lecteur web intègre la page web de journalisation de l’administrateur. Un administrateur affecté aux rôles LoggingReader et Player peut consulter les journaux d’activité de l’administrateur dans le lecteur web.

Remarque :

La langue définie pour le navigateur du lecteur web doit correspondre à la langue que vous avez sélectionnée lors de l’installation des composants d’administration de l’enregistrement de session.

• Journalisation de la configuration :

  

• Journalisation des motifs d’enregistrement :

  

Assurez-vous que votre site SessionRecordingLoggingWebApplication dans IIS et le lecteur web ont les mêmes paramètres SSL. Sinon, des erreurs 403 se produisent lorsque vous demandez l’accès aux journaux d’activité de l’administrateur.