Lecteur web d’enregistrement de session

Présentation

Le lecteur web vous permet d’utiliser un navigateur web pour afficher et lire les enregistrements, et de configurer la mémoire cache pour stocker les enregistrements pendant la lecture. À 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. Pour plus d’informations, consultez la section Afficher les enregistrements de cet article.

• Afficher et lire les enregistrements en direct et terminés avec les événements balisés répertoriés dans le volet droit. Pour plus d’informations, consultez la section Afficher les enregistrements de cet article.

Remarque :

Internet Explorer, Google Chrome et Firefox sont pris en charge.

Activer le lecteur web

Le lecteur web est désactivé par défaut.

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

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

Ouverture de session 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 sur IIS et mettez à jour le fichier de configuration SsRecWebSocketServer.exe.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.

Après vous être connecté au site web du lecteur web, tous les enregistrements apparaissent, listés. Cliquer sur Tous les enregistrements dans la navigation de gauche actualise la page et affiche les nouveaux enregistrements s’il y en a.

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.

Pendant 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.

Une fois le lecteur web installé, les applications SessionRecordingRestApiService et WebPlayer apparaissent sur IIS.

Configuration HTTPS

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

1. Ajoutez une liaison SSL sur IIS.

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

      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 fiables. Pour utiliser le lecteur web via HTTPS, effectuez les actions suivantes en conséquence :

      • Lorsqu’un seul serveur Session Recording est utilisé, mettez à jour le certificat du serveur Session Recording 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. Sur 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 SsRecWebSocketServer.exe.config fichier de configuration.

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

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

   2. 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és 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 d’enregistrement de session 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-->
         

         Saisissez 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-->
         

   3. Enregistrez vos modifications.

   4. 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.

   5. Exécutez la commande TestPolicyAdmin –stopwebsocketserver.

Afficher les enregistrements

Après vous être connecté au lecteur web, tous les enregistrements disponibles sont répertoriés. Vous pouvez faire défiler la page web pour sélectionner les enregistrements à afficher ou utiliser des filtres pour personnaliser vos résultats de recherche. Pour les enregistrements en direct, l’élément Durée affiche En direct et le bouton de lecture apparaît en vert.

Image d’un enregistrement en direct(/fr-fr/session-recording/1912-ltsr/media/a-live-recording3.png)

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.

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

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.

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

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

Le filtre Heure comprend la date de début de l’enregistrement, l’heure de début et 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.

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

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

Contrôle 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.
	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.
	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 JUILLET 2019 et 19:14:24.
• La durée de l’enregistrement en lecture. Dans cet exemple, 00:13:41.
• Le nombre d’événements dans l’enregistrement. Dans cet exemple, 9 É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 exécutée.

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

  Image des filtres d’événements(/fr-fr/session-recording/1912-ltsr/media/event-filters2.png)

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

  Image de l’extension des affichages d’événements réduits(/fr-fr/session-recording/1912-ltsr/media/expanding-folded-displays-of-events2.png)

• Liste des événements. Cliquer sur un événement de 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, vous pouvez cliquer sur le curseur pour configurer la mémoire cache pour le stockage des enregistrements pendant la lecture.

Image de la configuration de la mémoire cache pour le stockage des enregistrements pendant la lecture(/fr-fr/session-recording/1912-ltsr/media/cache-memory-while-playing.png)