La lecture de l'enregistrement échoue

VaultPAM enregistre chaque session relayée par proxy et stocke l'enregistrement dans le stockage objet (MinIO). La lecture est rendue dans le navigateur à l'aide d'un lecteur intégré. Lorsque la lecture échoue, la cause est généralement l'une des quatre suivantes : l'enregistrement est encore en cours de traitement, le backend de stockage est temporairement inaccessible, le navigateur ne prend pas en charge le codec requis, ou la personne qui visionne ne dispose pas de l'autorisation de regarder l'enregistrement.

Symptômes

• Cliquer sur Lecture sur une session dans Sessions → Historique affiche un indicateur de chargement qui ne se termine jamais.
• Une bannière d'erreur apparaît : Recording unavailable, Playback error ou Failed to load recording.
• Le lecteur se charge mais affiche une image vide ou figée sans aucune commande.
• La lecture démarre mais s'arrête en cours de route avec une erreur de codec ou de décodage.
• Vous voyez l'entrée de la session dans la liste mais le bouton Lecture est grisé.

Causes

1. Enregistrement encore en cours de traitement

Les sessions très récentes (terminées au cours des 2 à 5 dernières minutes) peuvent ne pas encore être entièrement ingérées et indexées. Le pipeline d'enregistrement finalise le fichier d'enregistrement, vérifie son intégrité et l'enregistre dans le catalogue avant que la lecture ne soit disponible. Pendant cette fenêtre, le bouton Lecture est grisé ou le lecteur renvoie « Recording unavailable ».

Vérification : Examinez l'horodatage Terminée le de la session. S'il date de moins de 5 minutes, l'enregistrement est probablement encore en cours de traitement.

Solution : Attendez 5 minutes et actualisez la page. Le bouton Lecture devient actif une fois le traitement terminé. Si la session s'est terminée il y a plus de 15 minutes et que la lecture est toujours indisponible, passez à la cause suivante.

2. Stockage MinIO inaccessible

Les enregistrements sont stockés dans MinIO (ou un backend compatible S3). Si le service de stockage est inaccessible — en raison d'une partition réseau, d'un redémarrage de service ou d'une mauvaise configuration — le point de terminaison de lecture ne peut pas récupérer le fichier d'enregistrement et renvoie une erreur.

Vérification pour les opérateurs : Sur l'hôte VaultPAM ou dans le cluster, confirmez que MinIO est en cours d'exécution et accessible :

curl -sv http://<minio-host>:9000/minio/health/live

Une réponse 200 OK confirme que MinIO est sain. Confirmez également que le bucket d'enregistrement existe et que le compte de service VaultPAM dispose d'un accès en lecture.

Solution pour les opérateurs : Restaurez la connectivité à MinIO ou redémarrez le service MinIO. Après récupération, relancez la lecture — les enregistrements sont récupérés à la demande et n'ont pas besoin d'être réingérés.

3. Codec du navigateur non pris en charge

Le lecteur VaultPAM utilise l'encodage vidéo WebM/VP8 ou VP9. Certains navigateurs plus anciens ou certaines versions de navigateur renforcées pour l'entreprise comportent des restrictions de codec qui empêchent la lecture.

Vérification : Essayez la lecture dans un autre navigateur (Chrome ou Firefox sont recommandés). Si la lecture réussit dans un autre navigateur, le navigateur d'origine présente une restriction de codec.

Navigateurs pris en charge pour la lecture des enregistrements :

• Chrome 90+
• Firefox 90+
• Edge 90+ (basé sur Chromium)

Safari présente une prise en charge limitée de VP9 sur les anciennes versions de macOS.

Solution : Utilisez un navigateur pris en charge. Si un navigateur spécifique est imposé par la politique de l'entreprise, demandez à votre administrateur VaultPAM si le format d'enregistrement peut être modifié (il s'agit d'une configuration côté serveur).

4. Autorisations insuffisantes

La lecture est contrôlée par l'appartenance au coffre-fort et les autorisations de rôle. Un utilisateur doit disposer de l'autorisation Voir les enregistrements pour le coffre-fort auquel appartient la session. Les administrateurs et les propriétaires de coffre-fort disposent de cette autorisation par défaut ; les membres ordinaires peuvent ne pas l'avoir.

Vérification : Confirmez que vous êtes membre du coffre-fort auquel appartient la session et que votre rôle inclut l'autorisation Voir les enregistrements. Dans Coffres-forts → sélectionnez le coffre-fort → Membres, recherchez votre utilisateur ou groupe et confirmez que l'autorisation est accordée.

Solution : Demandez à un administrateur de coffre-fort de mettre à jour votre rôle pour y inclure l'autorisation Voir les enregistrements.

Étapes de résolution

1. Vérifiez l'horodatage Terminée le de la session. Si la session s'est terminée il y a moins de 5 minutes, attendez et actualisez la page avant d'enquêter davantage.
2. Essayez d'ouvrir l'enregistrement dans un navigateur pris en charge (Chrome ou Firefox). S'il se lit correctement, le problème est une restriction de codec dans votre navigateur d'origine.
3. Confirmez que vous êtes membre du coffre-fort concerné et que votre rôle inclut l'autorisation Voir les enregistrements. Si ce n'est pas le cas, demandez l'autorisation à un administrateur de coffre-fort.
4. Si aucun des cas ci-dessus ne s'applique et que la lecture échoue toujours, demandez à un opérateur de vérifier que MinIO est sain à l'aide de curl -sv http://<minio-host>:9000/minio/health/live.
5. Après toute solution, relancez la lecture en actualisant la page Sessions → Historique et en cliquant à nouveau sur Lecture.

Procédure d'escalade

Si la lecture échoue toujours après avoir traité les quatre causes :

1. Notez l'identifiant de session (visible dans l'URL lors de la consultation des détails de la session), le message d'erreur exact, ainsi que le navigateur et sa version que vous utilisez.
2. Si vous êtes opérateur, examinez les journaux de l'application VaultPAM à la recherche d'erreurs contenant recording, playback ou minio au moment de la tentative de lecture ayant échoué.
3. Ouvrez un ticket d'assistance comprenant : l'identifiant de session, le message d'erreur, la version du navigateur et le résultat de la vérification de l'état de santé de MinIO si vous avez pu l'exécuter.

Articles connexes

• Ma session RDP se déconnecte de manière inattendue
• Partager un enregistrement