Configuration de l'agent Windows SKOOR
Configuration
Tous les paramètres de configuration d'exécution nécessaires au collecteur SKOOR sont contenus dans le fichier eRangerAgent.ini. Il n'existe aucune autre option de configuration dans le Registre (à l'exception de l'enregistrement du programme lui-même dans Windows). Il suffit de copier le fichier eRangerAgent.ini d'un WinAgent vers un autre pour répliquer tous les paramètres de configuration.
Le fichier de configuration doit être conservé dans le même répertoire que les exécutables.
WinAgent peut également être démarré sans aucun fichier de configuration. Dans ce cas, les valeurs par défaut (comme lors d'une nouvelle installation) sont utilisées.
Configuration de l'interface graphique de WinAgent
La manière la plus simple de configurer le SKOOR WinAgent est d'utiliser l'interface graphique Windows. Cliquez sur le bouton de configuration dans la barre d'outils ou sélectionnez « Configuration… » dans le menu Fichier.
Les noms en italique à la fin des descriptions d'options ci-dessous correspondent aux noms utilisés dans le fichier de configuration eRangerAgent.ini.
Paramètres réseau
Paramètre | Description |
|---|---|
Listen on port | Port sur lequel WinAgent écoute les connexions entrantes (52998 par défaut) |
Username | Si un nom d'utilisateur est spécifié, il est utilisé pour l'authentification. Cela signifie que le collecteur SKOOR doit fournir des identifiants valides pour envoyer des requêtes à l'agent avec succès. |
Password | Mot de passe utilisé pour l'authentification |
SSL | Si cette option est activée, la communication est chiffrée avec SSL |
Keep-alive | Si cette option est activée, les connexions TCP provenant du collecteur ne sont pas fermées après la réception de la requête par l'agent. L'agent peut réutiliser la même connexion TCP pour plusieurs requêtes. Si la connexion est interrompue, l'agent ouvre une nouvelle connexion sans perte de données. |
Hôtes autorisés
Seuls les collecteurs SKOOR (hôtes) dont l'adresse IP figure dans cette liste sont autorisés à se connecter. Si cette liste est vide, toutes les adresses IP sont autorisées à se connecter.
authorized_host (plusieurs valeurs possibles)
Paramètres de journalisation
Ces paramètres configurent la journalisation du service eRanger.
Paramètre | Description |
|---|---|
Write logfile | Active/désactive la journalisation |
Logfile path | Chemin du fichier journal. Si WinAgent ne s'exécute pas en tant que service, l'utilisateur qui exécute WinAgent doit disposer des droits d'écriture à cet emplacement (ce qui n'est pas toujours le cas pour le chemin par défaut C:\Program Files\Junisphere…). |
Loglevel | Définit le niveau de journalisation (Debug > Info > Warning > Error) |
Truncate at size | Si la taille du fichier dépasse cette valeur, le fichier est tronqué. |
Options de transfert de fichiers
Cet onglet définit les autorisations pour envoyer (Agent fetchfile) et recevoir (Agent putfile) des fichiers vers/depuis l'agent.
Paramètre | Description |
|---|---|
Allow files to be received | Les fichiers peuvent être reçus via des tâches Client Putfile |
Allowed targets | Les fichiers reçus des agents peuvent être enregistrés dans ces emplacements cibles. Les caractères génériques * et ? peuvent être utilisés. |
Allow files to be sent | Les fichiers peuvent être envoyés via des tâches Client Fetchfile. |
File allowed to be sent | Les fichiers situés dans ces emplacements peuvent être récupérés par l'agent. Les caractères génériques * et ? peuvent être utilisés. |
N'oubliez pas d'ajouter une entrée à la liste à l'aide du bouton .
Si vous tentez de récupérer ou de déposer un fichier qui ne figure pas dans la liste ou si la fonctionnalité d'envoi/réception est entièrement désactivée, un message d'erreur est envoyé à l'agent et affiché dans SKOOR.
Exécution de programmes
Ces paramètres contrôlent si des programmes peuvent être exécutés sur l'agent et lesquels.
Paramètre | Description |
|---|---|
Allow to run programs | Activez cette option pour autoriser l'exécution de programmes. |
Programs allowed | Les programmes figurant dans cette liste peuvent être exécutés par l'agent. Les caractères génériques * et ? peuvent être utilisés. |
Local Windows User | Si WinAgent s'exécute en tant que service, tous les programmes sont exécutés sous cet utilisateur Windows. Le nom d'utilisateur peut être indiqué au format UPN s'il doit contenir la partie domaine (user@domain). Si le nom d'utilisateur est laissé vide, les programmes sont exécutés dans le contexte du propriétaire du service sous lequel WinAgent s'exécute. Il s'agit normalement du compte LocalSystem. Les applications utilisant une interface graphique peuvent ne pas fonctionner comme prévu (voir également le chapitre 5.2). |
Password | Mot de passe de l'utilisateur. Le mot de passe est stocké sous forme chiffrée dans le fichier de configuration. |
Default Process timeout | Les processus démarrés sont arrêtés après le délai d'expiration indiqué (en secondes) s'ils sont toujours en cours d'exécution. Cette valeur peut être remplacée en définissant un délai d'expiration dans la tâche d'exécution. |
N'oubliez pas d'ajouter une entrée à la liste à l'aide du bouton .
Si vous tentez d'exécuter un programme qui ne figure pas dans la liste ou si l'exécution est entièrement désactivée, un message d'erreur est envoyé à l'agent et affiché dans SKOOR.
Contrôle du service et du démarrage automatique
Cet onglet permet d'installer, de désinstaller et de démarrer/arrêter le service du collecteur SKOOR. Toutes ces opérations peuvent également être effectuées dans le contrôle des services (voir le chapitre 3). WinAgent doit être démarré en tant qu'administrateur pour pouvoir contrôler le service.
Si la case Start the eRanger WinAgent after login (all users) est cochée, WinAgent.exe est enregistré en tant que programme de démarrage automatique pour tous les utilisateurs dans le Registre sous :
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Run
Cette option est visible si WinAgent a été installé pour tous les utilisateurs et démarré en tant qu'administrateur. Si WinAgent est démarré en tant qu'utilisateur normal, la case est intitulée Start the eRangerWinAgent after login (current user). Si elle est cochée, WinAgent est enregistré en tant que programme de démarrage automatique sous :
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run
Avec ces deux options, WinAgent est alors démarré à l'ouverture de session et s'exécute en arrière-plan.
Problèmes
Privilèges d'administrateur
Le SKOOR WinAgent nécessite des privilèges d'administrateur pour lire toutes les données de performance du système d'exploitation (par exemple pour voir tous les processus de tous les utilisateurs, etc.). Si des données de surveillance fiables doivent être collectées et que le client ne peut pas être démarré en tant que service (ce qui est recommandé pour ce cas d'utilisation), l'utilisateur doit démarrer WinAgent en tant qu'administrateur (clic droit – Exécuter en tant qu'administrateur).
Si le client est installé en tant que service, WinAgent doit être démarré en tant qu'administrateur pour pouvoir contrôler le service. Sinon, utilisez le contrôle des services intégré de Windows.
Si l'application est installée pour tous les utilisateurs dans C:\Program Files\Junisphere, un utilisateur normal ne peut pas modifier la configuration car il ne dispose pas des droits d'écriture sur le fichier C:\Program Files\Junisphere\eRangerAgent.ini). Pour pouvoir modifier la configuration, WinAgent doit être démarré en tant qu'administrateur.
Démarrage d'applications graphiques depuis l'agent
Les services ne sont pas autorisés à utiliser l'interface graphique dans Windows. Si des applications graphiques (telles que des scripts de robot EEM) doivent être démarrées par le SKOOR WinAgent sous Windows, l'agent doit être démarré en tant qu'application normale et non en tant que service. Pour vous assurer que WinAgent s'exécute en tant qu'application, désinstallez le service (s'il est installé).







