Utiliser LiveControl
Introduction
Section titled “Introduction”LiveControl est l’interface d’accès distant intégrée à Gward. Elle permet d’exécuter des commandes shell et de gérer les fichiers d’un agent directement depuis le navigateur, sans client SSH ni VPN.
Deux modes d’ouverture coexistent :
| Mode | Description |
|---|---|
| Page dédiée | Affichage plein écran via /agents/:id/live-control |
| Fenêtre flottante | Ouverte depuis la ContextBar, superposée à la navigation |
Prérequis
Section titled “Prérequis”- Un agent connecté et actif (statut en ligne)
- Rôle Opérateur ou supérieur sur le compte Gward
Accéder à LiveControl
Section titled “Accéder à LiveControl”Depuis la fiche agent (page dédiée)
Section titled “Depuis la fiche agent (page dédiée)”Ouvrez la fiche d’un agent puis cliquez sur le bouton LiveControl. L’interface s’affiche en plein écran avec le nom de l’agent cliquable en haut à gauche (retour vers la fiche).
Depuis la ContextBar (fenêtre flottante)
Section titled “Depuis la ContextBar (fenêtre flottante)”La ContextBar est la barre persistante en bas de l’écran. Elle permet d’ouvrir LiveControl sous forme de fenêtre flottante superposée à la navigation, sans quitter la page courante.
- Cliquez sur le bouton LiveControl depuis la fiche de l’agent pour ouvrir une fenêtre flottante.
- Chaque agent ouvre une fenêtre indépendante — il n’y a pas de doublon : si la fenêtre d’un agent est déjà ouverte, elle est ramenée au premier plan.
- Plusieurs fenêtres peuvent coexister simultanément (multi-agents).
Actions disponibles sur chaque fenêtre :
| Action | Description |
|---|---|
| Déplacer | Glisser la barre de titre pour repositionner la fenêtre |
| Redimensionner | Tirer les bords ou coins de la fenêtre |
| Minimiser | Réduit la fenêtre dans la ContextBar, cliquer dessus la restaure |
| Maximiser | Étend la fenêtre en plein écran |
| Fermer | Ferme la session LiveControl de cet agent |
Interface LiveControl
Section titled “Interface LiveControl”Bandeau de déconnexion
Section titled “Bandeau de déconnexion”Si l’agent n’est pas connecté en direct, un bandeau rouge s’affiche en haut de l’interface :
La sonde n’est pas connectée en direct. Les interactions sont indisponibles.
Dans cet état, l’envoi de commandes et les opérations sur les fichiers sont bloqués.
Restriction hors-horaire
Section titled “Restriction hors-horaire”Si une action est tentée en dehors des heures d’activité configurées pour l’agent, une notification d’erreur s’affiche :
Vous ne pouvez pas agir en dehors des heures d’activité.
Terminal
Section titled “Terminal”Le terminal occupe la partie principale de l’interface. Il affiche en temps réel les commandes envoyées et les réponses de l’agent.
Envoyer une commande
Section titled “Envoyer une commande”- Cliquez dans le champ de saisie en bas du terminal.
- Tapez la commande shell souhaitée.
- Appuyez sur Entrée ou cliquez sur le bouton Envoyer (icône avion en papier).
Historique local de session
Section titled “Historique local de session”Utilisez la touche ↑ (flèche haut) pour naviguer dans les commandes envoyées pendant la session en cours. La commande s’insère dans le champ de saisie et le curseur se positionne en fin de ligne.
Coloration syntaxique des sorties
Section titled “Coloration syntaxique des sorties”Les réponses de l’agent sont automatiquement colorées :
- Vert : mots-clés positifs (
OK,Success,Connected,Active,Healthy,Up,Enabled…) - Rouge : mots-clés d’erreur (
Error,Failed,Disconnected,Timeout,Critical,Down,Ko…)
Actions du terminal
Section titled “Actions du terminal”| Bouton | Action |
|---|---|
| Envoyer | Exécute la commande saisie |
| Vider | Efface l’affichage du terminal (l’historique serveur reste conservé) |
| Plein écran | Bascule le terminal en mode plein écran navigateur |
Historique des commandes
Section titled “Historique des commandes”Cliquez sur le bouton Historique (icône horloge) dans l’en-tête pour ouvrir le panneau latéral d’historique. Ce panneau affiche l’historique persistant des commandes passées sur l’agent, toutes sessions confondues.
Cliquez à nouveau sur Historique ou sur la flèche de fermeture pour masquer le panneau.
Explorateur de fichiers
Section titled “Explorateur de fichiers”L’explorateur est affiché à gauche du terminal. Il permet de naviguer dans le système de fichiers de l’agent et d’effectuer des opérations.
Navigation
Section titled “Navigation”| Action | Description |
|---|---|
| Clic simple | Sélectionne l’élément (fichier ou dossier) |
| Double-clic | Ouvre un dossier et affiche son contenu |
| Retour arrière | Remonte d’un niveau dans l’arborescence |
| Racine | Revient directement à / |
| Rafraîchir | Recharge le contenu du dossier courant |
Si un dossier est vide, le message « Dossier vide » s’affiche.
Opérations sur les fichiers
Section titled “Opérations sur les fichiers”| Bouton | Action |
|---|---|
| Créer un fichier | Ouvre une modale pour saisir le nom du fichier à créer dans le dossier courant |
| Créer un dossier | Ouvre une modale pour saisir le nom du dossier à créer dans le dossier courant |
| Envoyer un fichier | Ouvre le sélecteur de fichier local et transfère le fichier vers le dossier courant de l’agent |
| Télécharger | Télécharge le fichier sélectionné (visible uniquement si un fichier est sélectionné, pas un dossier) |
Multi-sessions
Section titled “Multi-sessions”Plusieurs utilisateurs peuvent ouvrir simultanément une session LiveControl sur le même agent. Chaque session est indépendante : les commandes et l’affichage terminal ne sont pas partagés entre les sessions. L’historique des commandes, lui, est commun et persistent.