DocumentationInstallation de l'agent SKOOR Windows
Introduction
Le guide suivant présente une vue d'ensemble de l'installation et des fonctionnalités de l'agent Windows SKOOR (WinAgent). Le logiciel peut être téléchargé à partir d'une installation de SKOOR Engine. Ouvrez un navigateur et accédez au répertoire files/agents/windows :
Le programme d'installation
WinAgent peut fonctionner selon deux modes : en tant que service Windows et en tant qu’application « normale ». S’il est installé en tant que service, aucun utilisateur n’a besoin d’être connecté pour qu’il s’exécute. WinAgent s’exécutera en arrière-plan et disposera de tous les droits d’accès aux données pertinentes.
Si WinAgent s’exécute en tant qu’application plutôt qu’en tant que service, un utilisateur doit toujours être connecté. Il s’exécutera alors avec les privilèges de l’utilisateur connecté. Ce mode est utile pour les tâches d’exécution de l’agent qui lancent des applications graphiques ne pouvant pas être démarrées correctement à partir d’un service.
La meilleure pratique est la suivante :
Exécutez WinAgent en tant que service Windows si vous souhaitez surveiller la machine Windows (avec les tâches « Agent Process », « Agent Network », etc.)
Exécutez WinAgent en tant qu’application normale si vous souhaitez lancer des scripts de robot qui interagissent avec l’interface graphique
Sachez que toutes les données de surveillance ne sont pas disponibles lorsque WinAgent est exécuté en tant qu’utilisateur standard. Une tâche de type « Agent Process », par exemple, ne verrait que les processus de l’utilisateur actuel et non l’ensemble des processus système, ce qui pourrait entraîner une confusion et des résultats erronés. Il est toujours possible de lancer WinAgent en tant qu’administrateur (clic droit – Exécuter en tant qu’administrateur) pour lui donner accès à toutes les données. Cependant, il n’est pas possible de configurer le démarrage automatique de WinAgent à la connexion avec des privilèges aussi élevés.
Pour pouvoir installer WinAgent en tant que service Windows, le programme d’installation doit être lancé en tant qu’administrateur en cliquant avec le bouton droit de la souris et en sélectionnant « Exécuter en tant qu’administrateur » :
Le programme d’installation arrête et désinstalle systématiquement le service SKOOR Collector (ainsi que le service SKOOR WinAgent d’une version antérieure du client Windows s’ils existent déjà sur le système cible) avant de lancer l’installation.
Modes multi-utilisateurs
Si le programme d’installation est exécuté avec des privilèges d’administrateur, il est possible de choisir d’installer WinAgent pour tous les utilisateurs (généralement sous C:\Program Files\Junisphere) ou uniquement pour l’utilisateur actuel (généralement sous C:\Users\myuser\AppData\Local\Junisphere) :
Le programme d’installation propose uniquement d’installer WinAgent en tant que service Windows s’il doit être installé pour tous les utilisateurs.
Si le programme d’installation n’est pas lancé en tant qu’administrateur, seul le mode mono-utilisateur est pris en charge et la page permettant de choisir le mode ne s’affiche pas.
Si le client est installé pour tous les utilisateurs dans C:\Program Files\Junisphere, un utilisateur standard ne peut pas modifier sa configuration. Pour pouvoir modifier la configuration, WinAgent doit être lancé en tant qu’administrateur.
Options de ligne de commande
Le programme d'installation prend en charge les options de ligne de commande suivantes :
Option | Description |
|---|---|
/service | Installe le client en tant que service. Si cette option n'est pas spécifiée, le client est installé comme une application normale |
/start | Démarrer le client après l'installation. S'il est installé en tant que service, c'est le service qui est démarré ; sinon, c'est l'application |
/autorun | Enregistrer l'application pour qu'elle s'exécute automatiquement à la connexion d'un utilisateur. Cette option n'a aucun effet si le client est installé en tant que service |
/AllUsers | Installe WinAgent pour tous les utilisateurs dans le répertoire C:\Program Files\Junisphere |
/CurrentUser | Installe WinAgent pour l'utilisateur actuel dans le répertoire C:\Users\myuser\AppData\Local\Junisphere |
Installation silencieuse et sans intervention
Le programme d'installation prend en charge le paramètre de ligne de commande /S (S pour « silencieux ») qui installe WinAgent pour Windows en tant que service, sans aucune intervention de l'utilisateur. Le service SKOOR est toujours lancé après une installation silencieuse.
Cette option silencieuse permet de réaliser facilement des installations et des mises à jour sans intervention à l'aide de systèmes de déploiement logiciel. Les autres options de ligne de commande des programmes d’installation NSIS sont également prises en charge (http://nsis.sourceforge.net/Docs/Chapter3.html#3.2.1 ) pour, par exemple, remplacer le chemin d’installation par défaut (qui est « %ProgramFiles%\Junisphere ») à l’aide de l’option /D.
Le service SKOOR Agent
Le WinAgent SKOOR s’exécute en tant que service sous le nom eRangerService. Dans ce cas, WinAgent.exe n’est qu’une application graphique permettant de contrôler et de configurer le service s’il est lancé en tant qu’administrateur.
Le service peut être contrôlé via l’application WinAgent ou (comme tout autre service) via la console de gestion des services. Pour lancer cette console, appuyez sur Windows+R (pour « Exécuter… ») et tapez services.msc ou cliquez sur Démarrer – Panneau de configuration – Administration – Services.
Le service peut également être démarré ou arrêté depuis la ligne de commande à l'aide de la commande suivante :
C:\> net start eRangerService C:\> net stop eRangerService |
ou
C:\> sc start eRangerService C:\> sc stop eRangerService |
Consultez la documentation de la commande sc pour connaître toutes les options disponibles.