Lecteur Web d’enregistrement de session

Généralités

En tant que fonctionnalité expérimentale, le lecteur Web vous permet d’utiliser un navigateur Web pour afficher et lire des enregistrements, ainsi que configurer la mémoire cache pour stocker des enregistrements pendant la lecture. Le lecteur Web vous permet de :

  • 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 de plus amples informations, consultez la section Afficher les enregistrements dans cet article.

  • Afficher et lire des enregistrements actifs et terminés avec des événements marqués répertoriés dans le panneau droit. Pour de plus amples informations, consultez la section Afficher les enregistrements dans cet article.

Remarque :

Internet Explorer et Microsoft Edge ne sont pas 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 <Chemin d’installation du Serveur d’enregistrement de session>\Bin\TestPolicyAdmin.exe -enablewebplayer.

  • Pour désactiver le lecteur Web, démarrez une invite de commandes Windows et exécutez la commande <Chemin d’installation du Serveur d’enregistrement de session>\Bin\TestPolicyAdmin.exe –disablewebplayer.

Ouverture de session et mot de passe

L’URL du site Web du lecteur Web est http(s)://<Nom de domaine complet du Serveur d’enregistrement de session>/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 de plus amples informations, consultez la section Configuration HTTPS dans cet article.

Remarque :

Lors de la connexion au site Web du lecteur Web, les utilisateurs de domaine n’ont pas besoin d’entrer leurs informations d’identification, alors que les utilisateurs n’appartenant pas à un domaine doivent le faire.

Une fois que vous vous êtes connecté au site Web du lecteur Web, tous les enregistrements apparaissent dans la liste. Cliquez sur Tous les enregistrements dans le panneau de navigation de gauche pour actualiser la page et afficher les nouveaux enregistrements.

image de la page Tous les enregistrements

Installation

Comme pour les autres composants d’enregistrement de session, vous pouvez utiliser le programme d’installation Citrix Virtual Apps and Desktops pour installer le lecteur Web.

Lors de l’installation, sélectionnez Administration de l’enregistrement de session sur la page Composants principaux pour installer le lecteur Web sur la même machine que le serveur d’enregistrement de session. Pour plus d’informations sur l’installation de l’enregistrement de session, consultez la section Installer, mettre à niveau et désinstaller.

Une fois le lecteur Web installé, les applications SessionRecordingRestApiService et WebPlayer apparaissent hébergées sur IIS.

image des applications hébergées sur IIS

Configuration HTTPS

Pour utiliser HTTPS pour accéder au site Web du lecteur Web, procédez comme suit :

  1. Ajoutez une liaison SSL sur 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 l’utilisation du nom commun dans une demande de signature de certificat (CSR). Ils appliquent en effet l’utilisation du nom SAN (Autre nom de l’objet) dans tous les certificats approuvés publiquement. Pour utiliser le lecteur Web sur HTTPS (actuellement, le lecteur Web n’est pas pris en charge pour les scénarios d’équilibrage de charge), vous devez procédez comme suit :

      1. Mettez à jour votre serveur d’enregistrement de session pour utiliser un certificat SAN.
      2. Ajoutez localhost comme l’un des autres noms de l’objet dans le certificat. Par exemple, san:dns=<Nom de domaine complet>&dns=<Adresse IP>&ipaddress=<Adresse IP>&dns=localhost. image du certificat SAN
    2. Dans IIS, cliquez avec le bouton droit de la souris sur le site Web et sélectionnez Ajouter des liaisons. La boîte de dialogue Liaisons de sites s’affiche.

      image de la boîte de dialogue Liaisons de sites

    3. Cliquez sur Ajouter dans le coin supérieur droit. La boîte de dialogue Ajouter la liaison de site s’affiche.

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

      image de la sélection https

      image de

    5. Cliquez sur OK.

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

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

      Le fichier de configuration SsRecWebSocketServer.exe.config se trouve généralement dans le dossier <chemin d’installation du serveur d’enregistrement de session>\Bin\.

    2. Activez TLS en modifiant TLSEnable=1 et entrez 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 utilisé par le lecteur Web pour collecter les fichiers d’enregistrement. Dans la capture d’écran suivante, ce champ est défini sur la valeur par défaut (22334).

      image de mise à jour du fichier de configuration du serveur WebSocket

      Pour extraire des fichiers de certificat et de clé distincts utilisés dans la configuration du serveur WebSocket, procédez comme suit :

      1. Assurez-vous que 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 contenant 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]
        

        Entrez 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]
        

        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é à entrer la phrase secrète PEM.

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

        openssl rsa -in [newaSRS2keyWithPassword.pem] -out [newaSRS2key.pem]
        
    3. Enregistrez vos modifications.

    4. Vérifiez les paramètres de 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

Une fois connecté au lecteur Web, tous les enregistrements disponibles sont répertoriés. Vous pouvez faire défiler la page Web vers le bas pour sélectionner des enregistrements à afficher ou utiliser des filtres pour personnaliser vos résultats de recherche. Pour les enregistrements actifs, l’élément Durée affiche l’état Actif et le bouton de lecture s’affiche en vert.

image d'un enregistrement actif

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

Élément Description
Heure de début Heure de début de l’enregistrement. Cliquez sur les flèches vers le haut/vers le bas pour afficher les enregistrements dans l’ordre chronologique.
Utilisateur Utilisateur dont la session a été enregistrée. Cliquez sur les flèches vers le haut/vers le bas pour afficher les enregistrements d’un utilisateur sur la liste et trier les utilisateurs par ordre alphabétique.
Hôte Nom d’hôte du VDA dans lequel la session enregistrée a été hébergée. Cliquez sur les flèches vers le haut/vers le bas pour afficher les noms d’hôtes du VDA par ordre alphabétique.
Client Nom de la machine cliente sur laquelle la session a été exécutée. Cliquez sur les flèches vers le haut/vers le bas pour afficher les noms d’hôte du client par ordre alphabétique.
Événements Nombre d’événements dans l’enregistrement. Cliquez sur les flèches vers le haut/vers le bas pour afficher les enregistrements dans la liste en fonction du nombre d’événements.
Durée Durée de l’enregistrement. Cliquez sur les flèches vers le haut/vers le bas pour afficher les enregistrements dans la liste en fonction de leur durée.

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.

image des filtres d'enregistrement

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 exclure les enregistrements non pertinents et afficher uniquement les enregistrements pertinents.

image de sélection du filtre de nom d'hôte

Vous pouvez passer à un filtre différent en cliquant sur le nom d’hôte sélectionné, comme indiqué dans la capture d’écran suivante. Après avoir cliqué sur Nom d’hôte, tous les filtres disponibles sont répertoriés. Sélectionnez un filtre différent selon vos besoins.

image de tous les filtres répertoriés

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

image du symbole plus

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

image de l'ajout du filtre Heure

Le filtre Heure consiste à enregistrer la date de début, l’heure de début et la durée.

Ouvrir et lire des enregistrements

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

Image des boutons de lecture

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.

image de la page de lecture d'enregistrement

Pour obtenir une description des contrôles du lecteur, consultez le tableau suivant :

Contrôle du lecteur Description
Image du bouton de lecture Lit le fichier d’enregistrement sélectionné.
Image du bouton de pause Suspend la lecture.
image de la barre de progression Vous pouvez faire glisser la barre de progression pendant la lecture.
image de recherche en arrière (7 secondes) Recherche en arrière (7 secondes).
image de la position actuelle de la lecture de l'enregistrement 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.
image de la vitesse de lecture Indique la vitesse actuelle de lecture. Cliquez sur l’icône pour basculer entre les options X0.5, X1, X2 et X4.
image du bouton Plein écran Affiche la lecture en plein écran.
image du bouton Étroit Affiche la lecture dans la page Web.

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

image des événements et autres informations

  • Date et heure sur la machine du lecteur Web. Dans cet exemple JULY 23, 2019 et 19:14:24.
  • Durée de l’enregistrement en lecture. Dans cet exemple, 00:13:41.
  • Nombre d’événements dans l’enregistrement. Dans cet exemple, 9 événements.
  • Nom de l’utilisateur dont la session a été enregistrée.
  • Nom d’hôte du VDA dans lequel la session enregistrée a été hébergée.
  • Nom de la machine cliente sur laquelle la session a été exécutée.
  • Filtres d’événements. Vous pouvez sélectionner plusieurs filtres pour rechercher des événements dans l’enregistrement en cours.

    image des filtres d'événements

    Cliquez sur l’icône pour développer l’affichage des événements.

    image du développement de l'affichage des événements

  • Liste des événements. Lorsque vous cliquez sur un événement dans la liste, vous êtes dirigé vers la position de l’événement dans l’enregistrement.
  • Zone de recherche rapide. La zone de recherche rapide des événements permet de réduire rapidement une liste d’événements dans l’enregistrement en cours.

Configurer la mémoire cache pour stocker des enregistrements lors de la lecture

Sur la page Configuration du lecteur Web, vous pouvez cliquer sur le curseur pour configurer la mémoire cache pour stocker des enregistrements pendant la lecture.

image de configuration de la mémoire cache pour stocker des enregistrements lors de la lecture