e-Agent

e-Agent jest oprogramowaniem instalowanym / uruchamianym na skanowanych komputerach. Zadaniem oprogramowania jest zebranie danych z komputera w celu przekazania ich do dalszego przetwarzania. Właściwa konfiguracja e-Agenta jest kluczem do wydajnego i efektywnego skanowania całego systemu.

Od wersji 2.4 wprowadzono ustalanie priorytetu pracy e-Agenta. Predefiniowane priorytety: REALTIME, HIGH, ABOVE_NORMAL, BELOW_NORMAL, IDLE, NORMAL.

Domyślnie procesy systemowe są uruchamiane z priorytetem NORMAL. Ze względu na bezpieczeństwo ustawienie priorytetu REALTIME jest redukowane do HIGH.

Zmiana priorytetu pracy e-Agenta umożliwia wyższą elastyczność e-Agenta w stosunku do środowiska systemu operacyjnego. Definiowanie priorytetu możliwe jest wyłącznie w pliku konfiguracyjnym (eagent.ini) e-Agenta. Domyślnie e-Agent instaluje się z Priorytetem = BELOW_NORMAL

e-Agent od wersji 3.0 wyposażony został w możliwość odtwarzania dźwięków. Aktualnie odtwarzane są one tylko przy otrzymywaniu wiadomości od administratora.

Za konfigurację e-Agenta odpowiada plik eagent.ini. Poniżej struktura parametrów pliku eagent.ini wraz z opisem:

[Scan Schedule]
Start at=2006.04.23 20:00	Oznacza czas pierwszego skanowania
Frequency=DAY	Częstotliwość skanowania Wartości: DAY, QUARTER, MONTH, WEEK
Type=HARDWARE;REGISTRY; TRACKING;FILES	Typ skanowania Wartości /dowolna kombinacja/: HARDWARE;REGISTRY; TRACKING;FILES;opcje skanowania. Przykłady: Type=HARDWARE;REGISTRY;FILES Type=HARDWARE;REGISTRY;FILES;TRACKING Type=HARDWARE;REGISTRY;TRACKING Type=HARDWARE;REGISTRY Type=HARDWARE;FILES Type=REGISTRY;TRACKING Type=HARDWARE;TRACKING Type=FILES
Maximum history entries=10	Maksymalna ilość przechowywanych wyników skanowania. Aktualnie nie obsługiwane.
Output to=DISK	Cel zapisu danych. Aktualnie każde wyniki przed wysłaniem zapisywane są na dysk.
Scan id=0	Identyfikator skanowania
Service scan delay=180000	Opóźnienie rozpoczęcia skanowania. Oznacza czas (wyrażony w milisekundach), który musi upłynąć od uruchomienia usługi, by rozpoczęło się skanowanie.
Config check interval=30000	Oznacza czas (wyrażony w milisekundach), co jaki e-Agent sprawdza czy jest dostępna nowa konfiguracja.
Update check interval=86400000	Oznacza czas (wyrażony w milisekundach), co jaki e-Agent sprawdza czy jest dostępna dla niego aktualizacja.
FilesStoreTime=180	Maksymalny czas przechowywania wyników skanowania w dniach
Abandoned=Z:\Old	Miejsce docelowe przenoszenia wyników skanowania po przekroczeniu parametru FilesStoreTime
[File Scanner]
Scan Compressed Files=0	Określa, czy skanowana będzie zawartość plików skompresowanych. Wartości: 0 - skanowanie wyłączone, 1- skanowanie włączone
Compressed Files Nesting=2	Określa poziom zagnieżdżenia, tj. jak głęboko w plikach skompresowanych mogą znajdować się pliki skompresowane, by skanowanie odbyło się wewnąrz nich
Exclude directories=	Rozdzielona średnikiem lista katalogów wykluczonych ze skanowania.
Scan Network Drives=0	Określa, czy skanowane będą dyski sieciowe. Wartości: 0 - skanowanie wyłączone, 1 - skanowanie włączone
Scan Removable Drives=0	Określa, czy skanowane będą dyski wymienne. Wartości: 0 - skanowanie wyłączone, 1 - skanowanie włączone
[File Types]
.exe=0;0;1980.01.01 01:00; 2030.12.31 23:59 .com=0;0;1980.01.01 01:00; 2030.12.31 23:59	Tutaj zawarte są maski plików wraz z ich restrykcjami w postaci: maska=min_rozmiar; max_rozmiar; min_data; max_data Daty podawane są w postaci datetime. np. .mp3=1;2;1980.01.01 01:00;2030.12.31 23:59 Skanuje pliki .mp3 o rozmiarze między 1 i 2 bajty, o dacie między godziną 01:00 1 stycznia 1980 do 31 grudnia 2030 do godziny 23:59.
[Registry Scanner]
Software key=SOFTWARE\Microsoft\ Windows\CurrentVersion\Uninstall	Oznacza klucz rejestru, gdzie znajdują się dane o zainstalowanych aplikacjach.
[Tracking]
Accuracy=3000	Częstotliwość próbkowania stanu uruchomienia procesów w milisekundach.
Delivery interval=300000	Częstotliwość dostarczania wyników trackingu do serwera w milisekundach.
Dropoff time=120000	Oznacza czas (wyrażony w milisekundach) co jaki pomocnicze pliki z wynikami trackingu są zapisywane na dysku
Exclude processes=notepad.exe;Calc.exe	Rozdzielona średnikiem lista procesów wykluczonych z monitorowania uruchomionych aplikacji; np.: notepad i kalkulator
Exclude processes case sensitive=1	Parametr ten określa, czy rozpoznawanie nazw procesów ma uwzględniać wielkość liter (1 – włączone, 0 – wyłączone). Domyślnie opcja jest wyłączona.
Max entries in bunch	Określa maksymalną liczbę wpisów w pliku z wynikami trackingu.
[Print Monitor]
Enabled=1	Określa, czy monitorować wydruki, czy nie. 1- monitorowanie włączone, 0 - wyłączone
Printers= #Printers=PDF995;hp deskjet 3320 series;Microsoft Office Document Image Writer	Rozdzielona średnikami lista drukarek, które podlegać będą monitoringowi. Dopuszcza się użycie znaku '*', dla oznaczenia dowolnego ciągu znaków.
Exclude Printers= #Exclude Printers=lexmark;PDF995;hp deskjet 3320 series;Microsoft Office Document Image Writer	Rozdzielona średnikami lista drukarek wyłączonych z monitorowania. Dopuszcza się użycie znaku '*', dla oznaczenia dowolnego ciągu znaków.
Delivery interval = 28800000	Określa jak często dostarczać wyniki do serwera (w milisekundach). Wartość domyślna: 10000
#ScanAllPrintouts=0 #skanowanie tylko lokalnej maszyny, domyślne	Określa zakres skanowania, 0 - tylko wydruki pochodzące z lokalnego komputera, 1 - wszystkie wydruki z dostępnych kolejek drukarkowych. Standardowo wartość winna wynosić 0.
Spooling accuracy=100	Częstotliwość odpytywania bufora wydruku, w milisekundach
[User Messages]
Enabled=1	Określa, czy wysyłanie wiadomości jest włączone. 1- włączone, 0 - wyłączone
Sound="D:\Uzytki\Sound\Wave\Dzwonki\Jazzy.wav"	Dźwięk odtwarzany przy odebraniu nowej wiadomości (może być pusty).
AlertSound="D:\Uzytki\Sound\Wave\Dzwonki\Warcry.wav"	Dźwięk odtwarzany przy odebraniu nowej wiadomości o wysokiej ważności (może być pusty).
NumberStoredAlerts=20	Maksymalna liczba przechowywanych wiadomości. Nieobsługiwane.
AlertLifetime=14	Maksymalny czas życia wiadomości w dniach (starsze będą automatycznie usuwane). Nieobsługiwane.
[Hardware Scanner]
Win32_1394Controller= Win32_BaseBoard= Win32_Battery= Win32_BIOS= Win32_Bus= Win32_CacheMemory= Win32_CDROMDrive= Win32_ComputerSystem= Win32_DesktopMonitor= Win32_DeviceMemoryAddress= Win32_DiskDrive= Win32_DiskDrivePhysicalMedia= Win32_DisplayConfiguration= Win32_DMAChannel= Win32_Fan= Win32_FloppyDrive= Win32_Group= Win32_IRQResource= Win32_Keyboard= Win32_LogicalDisk= Win32_LogicalMemoryConfiguration= Win32_MemoryDevice= Win32_NetworkAdapter= Win32_NetworkAdapterConfiguration= Win32_NetworkConnection= Win32_NTDomain= Win32_OnBoardDevice= Win32_OperatingSystem= Win32_OperatingSystem Win32_ParallelPort= Win32_PCMCIAController= Win32_PhysicalMemory= Win32_PhysicalMemoryArray= Win32_PnPEntity= Win32_PnPSignedDriver= Win32_PointingDevice= Win32_PortConnector= Win32_POTSModem= Win32_Printer= Win32_PrinterConfiguration= Win32_PrinterDriver= Win32_Process= Win32_Processor= Win32_SerialPort= Win32_SerialPortConfiguration= Win32_Share= Win32_SoundDevice= Win32_SystemDriver= Win32_SystemEnclosure= Win32_SystemSlot= Win32_TCPIPPrinterPort= Win32_USBHub= Win32_UserAccount= Win32_VideoController= Win32_VoltageProbe= Win32_PnPSignedDriver= Win32_PnPEntity= Win32_FloppyDrive= Win32_USBController= Win32_OperatingSystem= Win32_TimeZone= Win32_Fan= Win32_SerialPortConfiguration= Win32_SystemEnclosure= Win32_SystemDriver= Win32_Share=	Lista klas WMI do zeskanowania. Możliwe jest wskazanie wszystkich (ok 280) klas WMI. Można, za pomocą składni SQL-a dokonać wyboru parametru (wartości) poszczególnej klasy, np.:po znaku = można podać klauzulę SELECT wraz z warunkiem WHERE, np: a)Win32_PrinterDriver= SELECT Name FROM Win32_PrinterDriver b)Win32_Battery= Tak zdefiniowane zapytanie zwraca: a)wartość Name z klasy Win32_PrinterDriver b)wszystkie wartości z klasy Win32_Battery Program jest odporny na „nadmiarowe” spacje po znaku równości.
[SPD]
Enabled=1	Określa czy mają być zbierane informacje o kościach pamięci przy pomocy Serial presence detect (SPD). Wartości: 0 - zbieranie danych z SPD wyłączone; 1 - włączone. Jeśli e-Agent wykryje problemy z dostępem do SPD na danej maszynie, automatycznie ustawi te wartość na 0.
[USB]
BlockUSB=0	Domyślna wartość to 0, co oznacza, że użycie napędów USB nie będzie blokowane. Ustawienie parametru na 1 oznacza blokadę.
StartDelay=15	Opóźnienie (w minutach) startu blokowania USB
[Miscellaneous]
Reconnect heartbits=100	Określa liczbę 6-sekundowych okresów wyznaczającą okres, co ile dany Agent podejmuje próbę połączenia się z serwerem
Serialization mode=TXT	Tryb serializowania danych. Dozwolone wartości: TXT.
Message sound=c:\Program Files\Messenger\newemail.wav	Wskazanie ścieżki do pliku dźwiękowego. Wyłączenie dźwięku: Message sound=NONE (W przypadku nieznalezienia pliku lub problemów z jego odczytaniem odtworzony zostanie dźwięk zarejestrowny w panelu sterowania jako "system default")
Execute=	Oznacza aplikację /polecenie/, która zostanie uruchomiona po zakończeniu skanowania. Przykładowa składnia: cmd "/K "dir c:\*.exe"" Polecenie EXECUTE jest wykonywane po każdym skanowaniu.
Language=Polish	Wersja językowa. Dozwolone wartości: Polish
Server=192.168.0.1	Adres IP serwera z modułem e-Server. Od wersji 3.3 e-Agenta wartość zastąpiona poprzez MainServer. (Server jest nadal obsługiwany, ale wartość MainServer ma wyżzszy priorytet).
Port=8895	Port e-Servera. Od wersji 3.3 e-Agenta wartość zastąpiona poprzez MainServer. (Port jest nadal obsługiwany, ale wartość w MainServer ma wyżzszy priorytet).
Mainserver=192.168.0.2:8895	Wartość obsługiwana od wersji 3.3 e-Agenta. Oznacza adres oraz port głównego e-Servera.
AlternativeServers=192.168.0.2:8895;eaudytor:8895;eserver.btc.local:8895	Lista serwerów alternatywnych, z którymi e-Agent próbuje nawiązac połączenie w przypadku jego braku z głównym e-Serverem. Lista składa się z maksymalnie 5 serwerów w zapisie adres:port, posczególne elementy listy są rozdzielone średnikami. Wartość obsługiwana od wersji 3.3 e-Agenta.
Timeout=15000	Timeout w milisekundach.
Connection frequency=30000	Częstotliwość prób łączenia z serwerem w milisekundach.
Priority=BELOW_NORMAL	Dostępne priorytety pracy e-Agenta: REALTIME - niezalecany (system Windows automatycznie zmieni priorytet na HIGH), HIGH, ABOVE_NORMAL, BELOW_NORMAL,IDLE
Task execution timeout=3600000	Określa czas (wyrażony w milisekundach), po którym zadanie (proces) uruchomione przez eAgenta jest kończone, jeśli wcześniej samo się nie zakończyło. Wartość domyślna: 3600000
[AgentId]
Prefix=	Nazwa wykorzystwana przy tworzeniu AgentId
ID=	Wzorzec na podstawie, którego generowany jest identyfikator e-Agenta. Wpis nie może zawierać spacji, innych białych znaków oraz znaków, których nie można użyć w nazwie pliku (/ \: * ? " < > \|). Przy definiowaniu tej wartości można użyć następujących zmiennych: %PREFIX% - prefix zdefiniowany w innym miejscu pliku konfiguracyjnego %COMPUTERNAME% - wartość zmiennej środowiskowej %COMPUTERNAME% %AUTOGUID% - losowo wygenerowany GUID %SYSTEMUUID% - wartosć UUID %SYSTEMSN% - numer seryjny komputera %BIOSMANUFACTURER% - producent BIOS Wartość domyślna: %AUTOGUID%
[Webtracking]
Enabled=1	Określa, czy mają być monitorowane uruchamiane strony internetowe. Dozwolone wartości: 1- monitorowanie włączone, 0 - wyłączone
Delivery interval=60000	Częstotliwość dostarczania wyników monitoringu WWW do serwera w milisekundach.
Level=1	Określa poziom dokładności śledzonych adresów. Poprzez „poziom” rozumie się głębokość raportowanych lokalizacji na serwerze. Level przyjmuje wartości z przedziału 1-10. Przykład: Dla adresu: http://www.e-audytor.com/support/v.2/index.html Poszczególne wartości Level zwracają następujące wyniki: 1 http://www.e-audytor.com 2 http://www.e-audytor.com/support/ 3 http://www.e-audytor.com/support/v.2/ 4-10 http://www.e-audytor.com/support/v.2/index.html
Timeout=1000	Maksymalny czas oczekiwania w milisekundach
[WebEnabled]
*	Lista adresów stron internetowych, które będą podlegać monitoringowi. Poszczególne pozycje znajdują się w nowych liniach. Dopuszcza się użycie znaku '*', dla oznaczenia dowolnego ciągu znaków.
[WebExcludeWebLock]
http://www.btc.com.pl/* http://www.e-audytor.com/*	Lista adresów stron internetowych, które zostały wyłączone z blokowania. Poszczególne pozycje znajdują się w nowych liniach. Dopuszcza się użycie znaku '*', dla oznaczenia dowolnego ciągu znaków.
[WebExcludeWebMonit]	Lista adresów stron internetowych, które zostały wyłączone z monitorowania.
http://www.btc.com.pl/*
[WebDisable]
sex	Lista adresów stron internetowych, których przeglądanie zostało zablokowane. Poszczególne pozycje znajdują się w nowych liniach. Dopuszcza się użycie znaku '*', dla oznaczenia dowolnego ciągu znaków.
[Registry Property]
Identyfikator\|HKLM\HARDWARE\DESCRIPTION\System\CentralProcessor\0=Identifier	Lista wartości z rejestru systemowego, które mają zostać odczytane przez e-Agenta. Wartości te widoczne są w e-Console w widoku Zmienne. Każdy wpis znajduje się w nowej lini. Wpisy mają postać: NazwaZmiennej\|LokalizacjaWRejestrze=KluczRejestru Aby odczytać wartość Identyfier z klucza KEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\CentralProcessor\0\ i przypisać go do zmiennej Identyfikator (pod tą nazwą będzie występować w e-Console) należy zdefiniować następujący wpis: Identyfikator\|HKLM\HARDWARE\DESCRIPTION\System\CentralProcessor\0=Identifier
[Registry Key]
	Lista definicji kluczy produktowych. W tym miejscu są zdefiniowane klucze rejestru, z których odczytywane są klucze produktowe aplikacji. Każdy wpis znajduje się w nowej linii.

Po uruchomieniu e-Agenta obliczany jest czas rozpoczęcia kolejnego skanowania, a e-Agent przechodzi w tryb oczekiwania. Po zakończeniu skanowania pliki z wynikami zapisywane są na dysku. W międzyczasie, e-Agent periodycznie próbuje nawiązać połączenie z serwerem, aby wysłać do niego wyniki.

Każdy e-Agent ma swój unikatowy identyfikator tworzony na podstawie wzorca określonego w pliku konfiguracyjnym (wartość ID= w sekcji [AgentID]). Wpis nie może zawierać spacji, innych białych znaków oraz znaków, których nie można użyć w nazwie pliku (/ \: * ? " < > |). Możliwa jest parametryzacja AgentId za pomocą wstawienia do niego następujących znaczników (oraz ich kombinacji):

%PREFIX% - prefix zdefiniowany w innym miejscu pliku konfiguracyjnego
%COMPUTERNAME% - wartość zmiennej środowiskowej %COMPUTERNAME%
%AUTOGUID% - losowo wygenerowany GUID
%SYSTEMUUID% - wartosć UUID
%SYSTEMSN% - numer seryjny komputera
%BIOSMANUFACTURER% - producent BIOS

Domyślnie identyfikator e-Agenta tworzony jest losowo wg standardu GUID (Globally Unique Identifier) - %AUTOGUID%.

Identyfikator e-Agenta powinien być zachowywany w takim katalogu aby uniemożliwić jego przypadkowe usunięcie bądź zmianę przez użytkownika. W przypadku utraty identyfikatora można go uzyskać w e-Consoli.

Od wersji 3.3.1 możliwe jest stworzenie dowolnego AgentID. Należy zachować szczególną ostrożność, gdyż stworzenie identyfikatora nie unikatowego prowadzi do błędnego rozpoznawania hostów.

Uruchamiany e-Agent (niezależnie od sposobu uruchomienia) korzysta z pliku konfiguracyjnego params.ini znajdującego się w katalogu BIN.

Jeżeli e-Agent jest uruchamiany z linią parametrów to są one ważniejsze niż te zdefiniowane w pliku konfiguracyjnym

Parametryzacja e-Agenta następuje poprzez wywołanie programu eAgent.exe z odpowiednimi wartościami. Dzieki parametrom mamy możliwość przekazania do programu informacji na jakich nam zależy np. w celu odpalenia e-Agenta jednorazowo z innymi ustawieniami niż zdefiniowane w pliku konfiguracyjnym.

eAgent.exe -c "c:\audytor2\bin\agent\config" -o "c:\audytor2\bin\agent\output" -n "c:\audytor2\bin\agent\Id\AgentId.file" -i "c:\audytor2\bin\agent\config" -d -h

eAgent.exe -c "%systemroot%" -o "c:\audytor2\bin\agent\output" -n "%systemroot%\AgentId.file" -i "%systemroot%"

eAgent.exe -c "..\config" -o "..\output" -n "..\id\AgentId.file" -i "..\internaldata"

-n - (number) Wskazuje na PLIK z identyfikatorem e-Agenta - domyślnie "AgentId.FILE" (w przypadku braku pliku zostanie on utworzony)

-i - (internal) wskazuje na KATALOG zawierający plik z danymi wewnętrznymi e-Agenta. Nazwa pliku ma postać: "{%AgentID}.dat"

Przełączniki dodatkowe do ustalenia trybu pracy e-Agenta jako Usługi (tryb testowy):

Jako parametrów można używać skrótów ścieżek oraz ścieżek względnych, np. -n "%systemroot%\eAgentID.file" -i "%systemroot%" -c "..\config"

Wszystkie pliki binarne e-Agenta znajdują się w jednym katalogu. Umiejscowienie pozostałych jest konfigurowalne za pomocą przełączników. Dopuszcza się możliwość zmiany katalogów.

Agent komunikuje się z serwerem za pomocą protokołu TCP/IP. Próba łączenia następuje automatycznie, w ściśle określonych odstępach czasu. Gdy połączenie zostanie nawiązane, wszystkie zaległe oraz bieżące wyniki skanowania wysyłane są natychmiastowo. Częstotliwość nawiązywania komunikacji z e-Serverem określona jest w pliki konfiguracyjnym e-Agenta.

Firewall powinien zostać skonfigurowany tak, aby przepuszczać ruch do serwera na porcie określonym w pliku konfiguracyjnym (domyślnie: 8895).

e-Agent pozwala na blokowanie urządzeń przenośnych USB podłączanych do komputerów, jednak e-Agent korzysta z systemowego mechanizmu konfiguracji sterownika i usługi USBSTORE, co wiąże się z następującymi komplikacjami:

Następujące linie pliku konfiguracyjnego służą do konfiguracji blokowania użycia napędów przenośnych: