M6. Relazioni

Arresto del componente su postazione di Server Dr.Web adiacente

Viene invocata alla ricezione dell'evento component completed dal Server Dr.Web adiacente.

Database

Parametri

Valore restituito

è disponibile

neighborid — ID del Server Dr.Web adiacente da cui è stato ricevuto l'evento,

neighborname — nome del Server Dr.Web adiacente,

originatorid — ID del Server Dr.Web che è la fonte dell'evento,

originatorname — nome del Server Dr.Web che è la fonte dell'evento,

stationid — ID della postazione,

stationname — nome della postazione,

eventid — ID dell'evento,

component — numero del componente,

pid — ID del processo,

infections — sono state rilevate minacce,

errors — sono stati rilevati errori di accesso,

exitcode — codice di uscita del componente,

time — ora di fine (ora della postazione)

viene ignorato

Testo della procedura personalizzata:

--[[

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

Avvio del componente su postazione di Server Dr.Web adiacente

Viene invocata alla ricezione dell'evento component started dal Server Dr.Web adiacente.

Database

Parametri

Valore restituito

è disponibile

neighborid — ID del Server Dr.Web adiacente da cui è stato ricevuto l'evento,

neighborname — nome del Server Dr.Web adiacente,

originatorid — ID del Server Dr.Web che è la fonte dell'evento,

originatorname — nome del Server Dr.Web che è la fonte dell'evento,

stationid — ID della postazione,

stationname — nome della postazione,

eventid — ID dell'evento,

component — numero del componente,

pid — ID del processo,

engine — versione del motore di ricerca,

records — numero di record dei virus,

user — nome utente e gruppo del proprietario del processo,

time — ora di inizio (ora della postazione)

viene ignorato

Testo della procedura personalizzata:

--[[

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

Sono cambiate le coordinate di Server Dr.Web adiacente o di una postazione di Server Dr.Web adiacente

Viene invocata alla ricezione dell'evento geolocation dal Server Dr.Web adiacente.

Database

Parametri

Valore restituito

è disponibile

neighborid — ID del Server Dr.Web adiacente da cui è stato ricevuto l'evento,

neighborname — nome del Server Dr.Web adiacente,

originatorid — ID del Server Dr.Web che è la fonte dell'evento,

originatorname — nome del Server Dr.Web che è la fonte dell'evento,

stationid — ID della postazione,

stationname — nome della postazione,

latitude — latitudine in formato DD.DDDDDD,

longitude — longitudine in formato DD.DDDDDD

viene ignorato

Testo della procedura personalizzata:

--[[

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

                -- ...

Sono cambiati hardware e software su postazione di server adiacente

Viene invocata alla ricezione dell'evento environment changed dal Server Dr.Web adiacente.

Database

Parametri

Valore restituito

è disponibile

neighborid — ID del Server Dr.Web adiacente da cui è stato ricevuto l'evento,

neighborname — nome del Server Dr.Web adiacente,

originatorid — ID del Server Dr.Web che è la fonte dell'evento,

originatorname — nome del Server Dr.Web che è la fonte dell'evento,

stationid — ID della postazione,

stationname — nome della postazione,

eventid — ID dell'evento,

group_name — nome del gruppo primario della postazione,

category — categoria di oggetto dell'ambiente

viene ignorato

Testo della procedura personalizzata:

--[[

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

Rilevata una minaccia alla sicurezza su una postazione di Server Dr.Web adiacente

Viene invocata alla ricezione dell'evento virus detected dal Server Dr.Web adiacente.

Database

Parametri

Valore restituito

è disponibile

neighborid — ID del Server Dr.Web adiacente da cui è stato ricevuto l'evento,

neighborname — nome del Server Dr.Web adiacente,

originatorid — ID del Server Dr.Web che è la fonte dell'evento,

originatorname — nome del Server Dr.Web che è la fonte dell'evento,

stationid — ID della postazione,

stationname — nome della postazione,

eventid — ID dell'evento,

component — numero del componente,

pid — ID del processo,

time — ora del verificarsi dell'evento (ora della postazione),

user — nome utente e gruppo del proprietario del processo,

object — percorso dell'oggetto nel file system,

owner — nome utente e gruppo del proprietario dell'oggetto,

action — codice dell'operazione,

objecttype — tipo di oggetto:

-1 sconosciuto

0 file

1 settore di avvio

2 blocco di memoria o processo

3 attività dei virus

infectiontype — tipo di minaccia (v. Dr.Web API),

sha1 — hash SHA-1 dell'oggetto rilevato,

sha256 — hash SHA-256 dell'oggetto rilevato,

hashdb — bollettino contenente l'hash

viene ignorato

Testo della procedura personalizzata:

--[[

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

Report di Protezione preventiva dal Server adiacente

Viene invocata quando viene ricevuto un report di Protezione preventiva per la postazione dal Server Dr.Web adiacente.

Database

Parametri

Valore restituito

è disponibile

neighborid — ID del Server Dr.Web adiacente da cui è stato ricevuto l'evento,

neighborname — nome del Server Dr.Web adiacente,

originatorid — ID del Server Dr.Web che è la fonte dell'evento,

originatorname — nome del Server Dr.Web che è la fonte dell'evento,

stationid — ID della postazione,

stationname — nome della postazione,

eventid — ID dell'evento,

pid — ID del processo,

path — percorso del file eseguibile del processo con un'attività sospetta,

target_path — percorso dell'oggetto protetto a cui è stato effettuato un tentativo di accesso,

hips_type — tipo di oggetto protetto (valore numerico),

shell_guard_type — motivo di blocco del codice non autorizzato (valore numerico),

denied — vietato accesso (true | false),

is_user_action — azione chiesta all'utente (true | false),

event_count — numero di eventi automaticamente vietati (solo se per is_user_action il valore è false),

event_user — utente che ha avviato il processo con un'attività sospetta,

action_user — utente che ha impostato una reazione a un'attività sospetta del processo (solo se per is_user_action il valore è true),

event_time — ora di comparsa dell'evento sulla postazione,

recv_time — ora di ricezione del report da parte del Server Dr.Web adiacente,

sha1 — hash SHA-1 dell'oggetto rilevato,

sha256 — hash SHA-256 dell'oggetto rilevato,

hashdb — bollettino contenente l'hash

viene ignorato

Testo della procedura personalizzata:

--[[

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

Errore di autenticazione sul Server Dr.Web adiacente

Viene invocata dopo che la connessione al Server Dr.Web adiacente è stata rifiutata a causa di errore di autenticazione.

Database

Parametri

Valore restituito

è disponibile

id — ID del Server Dr.Web,

address — indirizzo del Server Dr.Web,

name — nome del Server Dr.Web,

reason — causa di fallimento

viene ignorato

Testo della procedura personalizzata:

--[[

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

Errore di scansione su postazione di Server Dr.Web adiacente

Viene invocata alla ricezione dell'evento scan error dal Server Dr.Web adiacente.

Database

Parametri

Valore restituito

è disponibile

neighborid — ID del Server Dr.Web adiacente da cui è stato ricevuto l'evento,

neighborname — nome del Server Dr.Web adiacente,

originatorid — ID del Server Dr.Web che è la fonte dell'evento,

originatorname — nome del Server Dr.Web che è la fonte dell'evento,

stationid — ID della postazione,

stationname — nome della postazione,

eventid — ID dell'evento,

component — numero del componente,

pid — ID del processo,

time — ora del verificarsi dell'evento (ora della postazione),

user — nome utente e gruppo del proprietario del processo,

object — percorso dell'oggetto nel file system,

owner — nome utente e gruppo del proprietario dell'oggetto,

action — codice dell'operazione,

sha1 — hash SHA-1 dell'oggetto rilevato,

sha256 — hash SHA-256 dell'oggetto rilevato,

hashdb — bollettino contenente l'hash

viene ignorato

Testo della procedura personalizzata:

--[[

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

Il Server Dr.Web adiacente è connesso

Viene invocata alla connessione al Server Dr.Web adiacente.

Database

Parametri

Valore restituito

è disponibile

id — ID del Server Dr.Web,

address — indirizzo del Server Dr.Web,

name — nome del Server Dr.Web

viene ignorato

Testo della procedura personalizzata:

--[[

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

Stato della postazione di Server Dr.Web adiacente

Viene invocata quando il Server Dr.Web adiacente comunica lo stato della postazione che include lo stato dei componenti, dei database dei virus e alcuni criteri locali (invio di eventi, ricezione di aggiornamenti e task).

Database

Parametri

Valore restituito

è disponibile

neighborid — ID del Server Dr.Web adiacente da cui è stato ricevuto l'evento,

neighborname — nome del Server Dr.Web adiacente,

originatorid — ID del Server Dr.Web che è la fonte dell'evento,

originatorname — nome del Server Dr.Web che è la fonte dell'evento,

stationid — ID della postazione,

stationname — nome della postazione,

eventid — ID dell'evento,

count — numero di diversi codici di stato,

state_0 — valore dello stato,

number_0 — numero di postazioni in state_0

viene ignorato

Testo della procedura personalizzata:

--[[

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

                -- ...

È stata rimossa una postazione di Server Dr.Web adiacente

Viene invocata quando viene rimossa una postazione sul Server Dr.Web adiacente.

Database

Parametri

Valore restituito

è disponibile

neighborid — ID del Server Dr.Web adiacente da cui è stato ricevuto l'evento,

neighborname — nome del Server Dr.Web adiacente,

originatorid — ID del Server Dr.Web che è la fonte dell'evento,

originatorname — nome del Server Dr.Web che è la fonte dell'evento,

stationid — ID della postazione,

stationname — nome della postazione

viene ignorato

Testo della procedura personalizzata:

--[[

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

                -- ...

Statistiche di scansione su postazione di Server Dr.Web adiacente

Viene invocata alla ricezione dell'evento scan statistics dal Server Dr.Web adiacente.

Database

Parametri

Valore restituito

è disponibile

neighborid — ID del Server Dr.Web adiacente da cui è stato ricevuto l'evento,

neighborname — nome del Server Dr.Web adiacente,

originatorid — ID del Server Dr.Web che è la fonte dell'evento,

originatorname — nome del Server Dr.Web che è la fonte dell'evento,

stationid — ID della postazione,

stationname — nome della postazione,

eventid — ID dell'evento,

component — numero del componente,

pid — ID del processo,

user — nome utente e gruppo del proprietario del processo,

time — ora del verificarsi dell'evento (ora della postazione),

size — dimensione totale di tutti gli oggetti scansionati,

elapsedtime — tempo impiegato,

scanned — numero di oggetti scansionati,

infected — numero di oggetti infettati da un virus conosciuto,

modifications — numero di oggetti infettati da una variante di virus,

suspicious — numero di oggetti sospetti,

cured — numero di file curati,

deleted — numero di file eliminati,

renamed — numero di file rinominati,

moved — numero di file trasferiti in quarantena,

locked — numero di file bloccati (solo SpIDer Guard),

errors — numero di file non scansionati a causa di errore di accesso

viene ignorato

Testo della procedura personalizzata:

--[[

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

Installazione di Agent dal Server Dr.Web adiacente

Viene invocata alla ricezione dell'evento installation dal Server Dr.Web adiacente.

Database

Parametri

Valore restituito

è disponibile

neighborid — ID del Server Dr.Web adiacente da cui è stato ricevuto l'evento,

neighborname — nome del Server Dr.Web adiacente,

originatorid — ID del Server Dr.Web che è la fonte dell'evento,

originatorname — nome del Server Dr.Web che è la fonte dell'evento,

stationid — ID della postazione,

stationname — nome della postazione,

eventid — ID dell'evento,

event — tipo di evento:

0l'installazione è iniziata,

1l'installazione è stata completata con successo,

2rifiuto,

3il tempo è scaduto,

4fallito,

5non completato

message — messaggio di errore (o vuoto se non è occorso nessun errore),

address — indirizzo della postazione,

begtime — ora di inizio (ora della postazione),

endtime — ora di fine

viene ignorato

Testo della procedura personalizzata:

--[[

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