Н6. Связи

Завершение работы компонента на станции соседнего Сервера Dr.Web

Вызывается при получении события component completed от соседнего Сервера Dr.Web.

База данных

Параметры

Возвращаемое значение

доступна

neighborid — ID соседнего Сервера Dr.Web, от которого получено событие,

neighborname — название соседнего Сервера Dr.Web,

originatorid — ID Сервера Dr.Web, который является источником события,

originatorname — название Сервера Dr.Web, который является источником события,

stationid — ID станции,

stationname — название станции,

eventid — ID события,

component — номер компонента,

pid — ID процесса,

infections — обнаружены угрозы,

errors — обнаружены ошибки доступа,

exitcode — код завершения компонента,

time — время завершения (время станции)

игнорируется

Текст процедуры:

--[[

Called:

 when "component completed" event recived from neighbor server

 

Database:

 available

 

Parameters:

 neighborid         neighbor server ID which the event received from

 neighborname       neighbor server name

 originatorid       ID of the event server originator

 originatorname     name of the event server originator

 stationid          station ID

 stationname        station name

 eventid            event ID

 component          component number

 pid                process ID

 infections         infections found

 errors             access errors detected

 exitcode           component exit code

 time               end time (station time)

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.neighborid, args.neighborname,

                -- args.originatorid, args.originatorname,

                -- args.eventid, args.stationid,

                -- args.stationname, args.time

                -- args.component, args.pid, args.infections

                -- args.errors, args.exitcode

Запуск компонента на станции соседнего Сервера Dr.Web

Вызывается при получении события component started от соседнего Сервера Dr.Web.

База данных

Параметры

Возвращаемое значение

доступна

neighborid — ID соседнего Сервера Dr.Web, от которого получено событие,

neighborname — название соседнего Сервера Dr.Web,

originatorid — ID Сервера Dr.Web, который является источником события,

originatorname — название Сервера Dr.Web, который является источником события,

stationid — ID станции,

stationname — название станции,

eventid — ID события,

component — номер компонента,

pid — ID процесса,

engine — версия поискового движка,

records — количество вирусных записей,

user — имя пользователя и группа владельца процесса,

time — время начала (время станции)

игнорируется

Текст процедуры:

--[[

Called:

 when "component started" event recived from neighbor server

 

Database:

 available

 

Parameters:

 neighborid         neighbor server ID which the event received from

 neighborname       neighbor server name

 originatorid       ID of the event server originator

 originatorname     name of the event server originator

 stationid          station ID

 stationname        station name

 eventid            event ID

 component          component number

 pid                process ID

 engine             virus-finding engine version

 records            virus records number

 user               user name and group (process owner)

 time               start time (station time)

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.neighborid, args.neighborname,

                -- args.originatorid, args.originatorname,

                -- args.eventid, args.stationid,

                -- args.stationname,

                -- args.component, args.pid, args.engine

                -- args.records, args.user, args.time

Изменились координаты соседнего Сервера Dr.Web или станции соседнего Сервера Dr.Web

Вызывается при получении события geolocation от соседнего Сервера Dr.Web.

База данных

Параметры

Возвращаемое значение

доступна

neighborid — ID соседнего Сервера Dr.Web, от которого получено событие,

neighborname — название соседнего Сервера Dr.Web,

originatorid — ID Сервера Dr.Web, который является источником события,

originatorname — название Сервера Dr.Web, который является источником события,

stationid — ID станции,

stationname — название станции,

latitude — широта в формате DD.DDDDDD,

longitude — долгота в формате DD.DDDDDD

игнорируется

Текст процедуры:

--[[

Called:

 when "geolocation" event received from neighbor server

 

Database:

 available

 

Parameters:

 neighborid         neighbor server ID which the event received from

 neighborname       neighbor server name

 originatorid       ID of the event server originator

 originatorname     name of the event server originator

 stationid          station ID

 stationname        station name

 latitude           latitude in DD.DDDDDD format

 longitude          longitude in DD.DDDDDD format

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.neighborid, args.neighborname,

                -- args.originatorid, args.originatorname,

                -- args.eventid, args.stationid,

                -- args.stationname,

                -- args.latidue,args.longitude

                -- ...

Изменились оборудование и программы станции соседнего сервера

Вызывается при получении события environment changed от соседнего Сервера Dr.Web.

База данных

Параметры

Возвращаемое значение

доступна

neighborid — ID соседнего Сервера Dr.Web, от которого получено событие,

neighborname — название соседнего Сервера Dr.Web,

originatorid — ID Сервера Dr.Web, который является источником события,

originatorname — название Сервера Dr.Web, который является источником события,

stationid — ID станции,

stationname — название станции,

eventid — ID события,

group_name — название первичной группы станции,

category — категория объекта окружения

игнорируется

Текст процедуры:

--[[

Called:

 when "environment changed" event recived from neighbor server

 

Database:

 available

 

Parameters:

 neighborid         neighbor server ID which the event received from

 neighborname       neighbor server name

 originatorid       ID of the event server originator

 originatorname     name of the event server originator

 stationid          station ID

 stationname        station name

 eventid            event ID

 group_name         station primary group name

 category           environment category

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.neighborid, args.neighborname,

                -- args.originatorid, args.originatorname,

                -- args.eventid, args.stationid,args.stationname,

                -- args.group_name, args.category

Обнаружена угроза безопасности на станции соседнего Сервера Dr.Web

Вызывается при получении события virus detected от соседнего Сервера Dr.Web.

База данных

Параметры

Возвращаемое значение

доступна

neighborid — ID соседнего Сервера Dr.Web, от которого получено событие,

neighborname — название соседнего Сервера Dr.Web,

originatorid — ID Сервера Dr.Web, который является источником события,

originatorname — название Сервера Dr.Web, который является источником события,

stationid — ID станции,

stationname — название станции,

eventid — ID события,

component — номер компонента,

pid — ID процесса,

time — время наступления события (время станции),

user — имя пользователя и группа владельца процесса,

object — путь к объекту в файловой системе,

owner — имя пользователя и группа владельца объекта,

action — код действия,

objecttype — тип объекта:

-1 неизвестен

0 файл

1 загрузочный сектор

2 блок памяти или процесс

3 вирусная активность

infectiontype — тип угрозы (см. Dr.Web API),

sha1 — хеш SHA-1 обнаруженного объекта,

sha256 — хеш SHA-256 обнаруженного объекта,

hashdb — бюллетень, содержащий хеш

игнорируется

Текст процедуры:

--[[

Called:

 when "" event recived from neighbor server

 

Database:

 available

 

Parameters:

 neighborid         neighbor server ID which the event received from

 neighborname       neighbor server name

 originatorid       ID of the event server originator

 originatorname     name of the event server originator

 stationid          station ID

 stationname        station name

 eventid            event ID

 component          component number

 pid                process ID

 time               event time (station time)

 user               user name and group (process owner)

 object             filesystem object path

 owner              object owner (user name and group)

 action             action code (see Dr.Web API; only errors bit set)

 objecttype         object type

                      -1    unknown

                       0    file

                       1    boot sector

                       2    memory block / process

                       3    virus like activity

 infectiontype      infection type (see Dr.Web API)

 sha1               object SHA-1 hash

 sha256             object SHA-256 hash

 hashdb             hash database containing object

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.neighborid, args.neighborname,

                -- args.originatorid, args.originatorname,

                -- args.eventid, args.stationid,

                -- args.stationname,

                -- args.component, args.pid, args.time, args.user,

                -- args.object, args.owner,

                -- args.action, args.objecttype, args.infectiontype,

                -- args.sha1, args.sha256, args.hashdb

Отчет Превентивной защиты с соседнего Cервера

Вызывается при получении отчета Превентивной защиты для станции от соседнего Сервера Dr.Web.

База данных

Параметры

Возвращаемое значение

доступна

neighborid — ID соседнего Сервера Dr.Web, от которого получено событие,

neighborname — название соседнего Сервера Dr.Web,

originatorid — ID Сервера Dr.Web, который является источником события,

originatorname — название Сервера Dr.Web, который является источником события,

stationid — ID станции,

stationname — название станции,

eventid — ID события,

pid — ID процесса,

path — путь к исполняемому файлу процесса с подозрительной активностью,

target_path — путь к защищаемому объекту, к которому была осуществлена попытка доступа,

hips_type — тип защищаемого объекта (числовое значение),

shell_guard_type — причина блокировки неавторизованного кода (числовое значение),

denied — доступ был запрещен (true | false),

is_user_action — действие было запрошено у пользователя (true | false),

event_count — количество автоматически запрещенных событий (только если для is_user_action значение false),

event_user — пользователь, который запустил процесс с подозрительной активностью,

action_user — пользователь, который задал реакцию на подозрительную активность процесса (только если для is_user_action значение true),

event_time — время появления события на станции,

recv_time — время получения отчета соседним Сервером Dr.Web,

sha1 — хеш SHA-1 обнаруженного объекта,

sha256 — хеш SHA-256 обнаруженного объекта,

hashdb — бюллетень, содержащий хеш

игнорируется

Текст процедуры:

--[[

Called:

 when HIPS event received from neighbor server

 

Database:

 available

 

Parameters:

 neighborid         neighbor server ID which the event received from

 neighborname       neighbor server name

 originatorid       ID of the event server originator

 originatorname     name of the event server originator

 stationid          station ID

 stationname        station name

 eventid            event ID

 pid                numeric,process id

 path               process file path

 target_path        affected resource path

 hips_type          numeric, HIPS type

 shell_guard_type   numeric, Shell Guard event type

 denied             boolean, access was denied

 is_user_action     boolean, user was asked

 event_count        event number (for accumulation period - if is_user_action is false)

 event_user         user which initiated the suspicious activity

 action_user        user which allowed or denied the activity (non-empty only if is_user_action is true)

 event_time         station time

 recv_time          server originator time

 sha1               process file SHA-1 hash

 sha256             process file SHA-256 hash

 hashdb             hash database containing process file

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.neighborid, args.neighborname, args.originatorid, args.originatorname,

                -- args.stationid, args.stationname, args.eventid

                -- args.pid, args.path, args.target_path, args.hips_type, args.shell_guard_type,

                -- args.denied, args.is_user_action, args.event_count, args.event_user, args.action_user

                -- args.event_time, args.recv_time, args.sha1, args.sha256, args.hashdb

Ошибка авторизации на соседнем Сервере Dr.Web

Вызывается после отказа соединения с соседним Сервером Dr.Web вследствие ошибки авторизации.

База данных

Параметры

Возвращаемое значение

доступна

id — ID Сервера Dr.Web,

address — адрес Сервера Dr.Web,

name — название Сервера Dr.Web,

reason — причина сбоя

игнорируется

Текст процедуры:

--[[

Called:

 just after server connection rejected due (authorization) error

 

Database:

 available

 

Parameters:

 id          server ID

 address     server address

 name        server name

 reason      failure reason

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.name, args.reason

Ошибка сканирования на станции соседнего Сервера Dr.Web

Вызывается при получении события scan error от соседнего Сервера Dr.Web.

База данных

Параметры

Возвращаемое значение

доступна

neighborid — ID соседнего Сервера Dr.Web, от которого получено событие,

neighborname — название соседнего Сервера Dr.Web,

originatorid — ID Сервера Dr.Web, который является источником события,

originatorname — название Сервера Dr.Web, который является источником события,

stationid — ID станции,

stationname — название станции,

eventid — ID события,

component — номер компонента,

pid — ID процесса

time — время наступления события (время станции),

user — имя пользователя и группа владельца процесса,

object — путь к объекту в файловой системе,

owner — имя пользователя и группа владельца объекта,

action — код действия,

sha1 — хеш SHA-1 обнаруженного объекта,

sha256 — хеш SHA-256 обнаруженного объекта,

hashdb — бюллетень, содержащий хеш

игнорируется

Текст процедуры:

--[[

Called:

 when "" event recived from neighbor server

 

Database:

 available

 

Parameters:

 neighborid         neighbor server ID which the event received from

 neighborname       neighbor server name

 originatorid       ID of the event server originator

 originatorname     name of the event server originator

 stationid          station ID

 stationname        station name

 eventid            event ID

 component          component number

 pid                process ID

 time               event time (station time)

 user               user name and group (process owner)

 object             filesystem object path

 owner              object owner (user name and group)

 action             action code (error bit(s) set)

 sha1               object SHA-1 hash

 sha256             object SHA-256 hash

 hashdb             hash database containing object

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.neighborid, args.neighborname,

                -- args.originatorid, args.originatorname,

                -- args.eventid, args.stationid,

                -- args.stationname,

                -- args.component, args.pid, args.time, args.user,

                -- args.object, args.owner, args.action,

                -- args.sha1, args.sha256, args.hashdb

Соседний Сервер Dr.Web подключен

Вызывается при соединении с соседним Сервером Dr.Web.

База данных

Параметры

Возвращаемое значение

доступна

id — ID Сервера Dr.Web,

address — адрес Сервера Dr.Web,

name — название Сервера Dr.Web

игнорируется

Текст процедуры:

--[[

Called:

 when server connected

 

Database:

 available

 

Parameters:

 id          server ID

 address     server address

 name        server name

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.name

Состояние станции соседнего Сервера Dr.Web

Вызывается, когда соседний Сервер Dr.Web сообщает состояние станции, включающее состояние компонентов, вирусных баз и некоторые локальные политики (отправка событий, прием обновлений и заданий).

База данных

Параметры

Возвращаемое значение

доступна

neighborid — ID соседнего Сервера Dr.Web, от которого получено событие,

neighborname — название соседнего Сервера Dr.Web,

originatorid — ID Сервера Dr.Web, который является источником события,

originatorname — название Сервера Dr.Web, который является источником события,

stationid — ID станции,

stationname — название станции,

eventid — ID события,

count — количество различных кодов статуса,

state_0 — значение состояния,

number_0 — количество станций в state_0

игнорируется

Текст процедуры:

--[[

Called:

 when "" event recived from neighbor server

 

Database:

 available

 

Parameters:

 neighborid         neighbor server ID which the event received from

 neighborname       neighbor server name

 originatorid       ID of the event server originator

 originatorname     name of the event server originator

 stationid          station ID

 stationname        station name

 eventid            event ID

 count              number of different status code

 state_0            state value

 number_0           number of the stations in 'state_0'

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.neighborid, args.neighborname,

                -- args.originatorid, args.originatorname,

                -- args.eventid, args.stationid,

                -- args.stationname,

                -- args.count,

                -- args.state_0, args.number_0

                -- args.state_1, args.number_1

                -- ...

Станция соседнего Сервера Dr.Web удалена

Вызывается при удалении станции на соседнем Сервере Dr.Web.

База данных

Параметры

Возвращаемое значение

доступна

neighborid — ID соседнего Сервера Dr.Web, от которого получено событие,

neighborname — название соседнего Сервера Dr.Web,

originatorid — ID Сервера Dr.Web, который является источником события,

originatorname — название Сервера Dr.Web, который является источником события,

stationid — ID станции,

stationname — название станции

игнорируется

Текст процедуры:

--[[

Called:

 when station was deleted on neighbor server

 

Database:

 available

 

Parameters:

 neighborid         neighbor server ID which the event received from

 neighborname       neighbor server name

 originatorid       ID of the event server originator

 originatorname     name of the event server originator

 stationid          station ID

 stationname        station name

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.neighborid, args.neighborname,

                -- args.originatorid, args.originatorname,

                -- args.eventid, args.stationid,

                -- args.stationname

                -- ...

Статистика сканирования станции соседнего Сервера Dr.Web

Вызывается при получении события scan statistics от соседнего Сервера Dr.Web.

База данных

Параметры

Возвращаемое значение

доступна

neighborid — ID соседнего Сервера Dr.Web, от которого получено событие,

neighborname — название соседнего Сервера Dr.Web,

originatorid — ID Сервера Dr.Web, который является источником события,

originatorname — название Сервера Dr.Web, который является источником события,

stationid — ID станции,

stationname — название станции,

eventid — ID события,

component — номер компонента,

pid — ID процесса,

user — имя пользователя и группа владельца процесса,

time — время наступления события (время станции),

size — суммарный размер всех просканированных объектов,

elapsedtime — затраченное время,

scanned — количество просканированных объектов,

infected — количество объектов, инфицированных известным вирусом,

modifications — количество объектов, инфицированных модификацией вируса,

suspicious — количество подозрительных объектов,

cured — количество вылеченных файлов,

deleted — количество удаленных файлов,

renamed — количество переименованных файлов,

moved — количество файлов, перемещенных в карантин,

locked — количество заблокированных файлов (только SpIDer Guard),

errors — количество файлов, не просканированных из-за ошибки доступа

игнорируется

Текст процедуры:

--[[

Called:

 when "scan statistics" event received from neighbor server

 

Database:

 available

 

Parameters:

 neighborid         neighbor server ID which the event received from

 neighborname       neighbor server name

 originatorid       ID of the event server originator

 originatorname     name of the event server originator

 stationid          station ID

 stationname        station name

 eventid            event ID

 component          number of component

 pid                process ID

 user               user name and group (process owner)

 time               event time (station time)

 size               summary size of all scanned objects

 elapsedtime        elapsed time

 scanned            number of scanned objects

 infected           number of objects infected by known virus

 modifications      number of objects infected by virus modification

 suspicious         number of suspicious objects

 cured              number of cured files

 deleted            number of deleted files

 renamed            number of renamed files

 moved              number of quarantined files

 locked             number of locked files (SpIDer Guard only)

 errors             number of not scanned files (due access error)

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.neighborid, args.neighborname,

                -- args.originatorid, args.originatorname,

                -- args.eventid, args.stationid,

                -- args.stationname,

                -- args.component, args.pid, args.time, args.user,

                -- args.scanned, args.infected, args.modifications,

                -- args.suspicious, args.cured, args.deleted, args.renamed,

                -- args.moved, args.locked, args.errors, args.size, args.elapsedtime

Установка Агента с соседнего Сервера Dr.Web

Вызывается при получении события installation от соседнего Сервера Dr.Web.

База данных

Параметры

Возвращаемое значение

доступна

neighborid — ID соседнего Сервера Dr.Web, от которого получено событие,

neighborname — название соседнего Сервера Dr.Web,

originatorid — ID Сервера Dr.Web, который является источником события,

originatorname — название Сервера Dr.Web, который является источником события,

stationid — ID станции,

stationname — название станции,

eventid — ID события,

event — тип события:

0установка началась,

1установка успешно завершена,

2отказ,

3время истекло,

4неуспешно,

5не завершено

message — сообщение об ошибке (или пустое, если не было ошибки),

address — адрес станции,

begtime — время начала,

endtime — время окончания

игнорируется

Текст процедуры:

--[[

Called:

 when "installation" event recived from neighbor server

 

Parameters:

 neighborid         neighbor server ID which the event received from

 neighborname       neighbor server name

 originatorid       ID of the event server originator

 originatorname     name of the event server originator

 stationid          station ID

 stationname        station name

 eventid            event ID

 event              event type:

                      0   installation begin

                      1   successully completed

                      2   rejected

                      3   timed out

                      4   failed

                      5   incomplete

 message            error message (or empty if there is no error)

 address            station address

 begtime            begin time

 endtime            end time

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.neighborid, args.neighborname,

                -- args.originatorid, args.originatorname,

                -- args.eventid, args.stationid,

                -- args.stationname,

                -- args.event, args.message, args.address

                -- args.begtime, args.endtime