Installer l'agent

Introduction

L’agent Gward est un binaire ultra-léger développé en Go (~10 Mo RAM, ~10 Mo binaire). Il fonctionne en mode stateless et reprend automatiquement après une reconnexion.

Prérequis

Droits d’administration sur la machine cible
Accès réseau sortant vers la plateforme Gward

Étapes

1. Télécharger l’agent

Depuis la plateforme Gward, dans Paramètres → Agents, téléchargez l’archive adaptée à votre OS. Elle contient le binaire de l’agent et son fichier de configuration config-sonde.json, propre à votre plateforme.

Gardez les deux fichiers dans le même dossier : l’agent y lit sa configuration et y enregistre son identité au premier démarrage.

2. Installation sur Linux

sudo mkdir -p /opt/gward-agent
sudo unzip <archive téléchargée> -d /opt/gward-agent
sudo chmod +x /opt/gward-agent/agent

Créez un service systemd pour démarrer l’agent automatiquement :

[Unit]
Description=Gward Agent
After=network.target

[Service]
ExecStart=/opt/gward-agent/agent
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl enable gward-agent
sudo systemctl start gward-agent

3. Installation sur Windows

Décompressez l’archive dans un dossier dédié, par exemple C:\gward-agent, puis lancez agent.exe en tant qu’administrateur. Pour un démarrage automatique, enregistrez-le comme service Windows en gardant config-sonde.json à côté de agent.exe.

4. Installation sur macOS

sudo mkdir -p /opt/gward-agent
sudo unzip <archive téléchargée> -d /opt/gward-agent
sudo /opt/gward-agent/agent

5. Vérifier que l’agent est connecté

L’agent apparaît dans la liste des agents de la plateforme avec le statut online dans les quelques secondes suivant le démarrage.

Résultat attendu

L’agent est démarré, connecté à la plateforme et visible dans la liste des agents.