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.
auth_username (Nom)

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.
L'activation de cette option peut être utile si l'établissement d'une nouvelle connexion TCP est très coûteux ou lent (c'est-à-dire si WinAgent se trouve sur Internet ou sur une ligne très lente). En temps normal, cette option n'a pas besoin d'être activée.
keep_alive (0 | 1)

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…).
log_file_path (chemin absolu)

Loglevel

Définit le niveau de journalisation (Debug > Info > Warning > Error)
log_level (0 | 1 | 2 | 3)

Truncate at size

Si la taille du fichier dépasse cette valeur, le fichier est tronqué.
max_log_size (taille en Ko)

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.
receive_file (chemin absolu, plusieurs valeurs possibles)

Allow files to be sent

Les fichiers peuvent être envoyés via des tâches Client Fetchfile.
allow_file_sending (0 | 1)

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.
send_file (chemin absolu, plusieurs valeurs possibles)


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.
allow_program_execution (0 | 1)

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.
executable_program (chemin absolu, plusieurs valeurs possibles)

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).
local_windows_user (nom d'utilisateur)

Password

Mot de passe de l'utilisateur. Le mot de passe est stocké sous forme chiffrée dans le fichier de configuration.
local_windows_user_pwd (mot de passe chiffré)

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.
default_execute_timeout (nombre en secondes). Si cette valeur est 0, le processus n'est jamais arrêté


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é).