M6. Liaisons

Arrêt d’un composant sur le poste du Serveur Dr.Web voisin

Appelé lorsque l’événement component completed est reçu du Serveur Dr.Web voisin.

Base de données

Paramètres

Valeur retournée

disponible

 neighborid : ID du Serveur Dr.Web voisin depuis lequel l’événement est reçu,

neighborname : nom du Serveur Dr.Web voisin,

originatorid : ID du Serveur Dr.Web source de l’événement,

originatorname : nom du Serveur Dr.Web source de l’événement,

stationid : ID du poste,

stationname : nom du poste,

eventid : ID de l’événement,

component : numéro du composant,

pid : ID du processus,

infections : menaces détectées,

errors : erreurs d’accès détectées,

exitcode : code de fin du composant,

time : heure de la fin (heure du poste)

ignoré

Texte de la procédure :

--[[

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

Lancement d’un composant sur le poste du Serveur voisin Dr.Web

Appelé lorsque l’événement component started est reçu du Serveur voisin Dr.Web.

Base de données

Paramètres

Valeur retournée

disponible

 neighborid : ID du Serveur Dr.Web voisin depuis lequel l’événement est reçu,

neighborname : nom du Serveur Dr.Web voisin,

originatorid : ID du Serveur Dr.Web source de l’événement,

originatorname : nom du Serveur Dr.Web source de l’événement,

stationid : ID du poste,

stationname : nom du poste,

eventid : ID de l’événement,

component : numéro du composant,

pid : ID du processus,

engine : version du moteur de recherche,

records : total d’entrées virales,

user : nom de l’utilisateur et groupe du propriétaire du processus,

time : heure du début (heure du poste)

ignoré

Texte de la procédure :

--[[

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

Les coordonnées du Serveur Dr.Web voisin ou du poste du Serveur Dr.Web voisin sont changées

Appelé lorsque l’événement geolocation est reçu du Serveur voisin Dr.Web.

Base de données

Paramètres

Valeur retournée

disponible

 neighborid : ID du Serveur Dr.Web voisin depuis lequel l’événement est reçu,

neighborname : nom du Serveur Dr.Web voisin,

originatorid : ID du Serveur Dr.Web source de l’événement,

originatorname : nom du Serveur Dr.Web source de l’événement,

stationid : ID du poste,

stationname : nom du poste,

latitude : latitude au format DD.DDDDDD,

longitude : longitude au format DD.DDDDDD

ignoré

Texte de la procédure :

--[[

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

                -- ...

Le matériel et les logiciels du serveur voisin sont modifiés

Appelé lorsque l’événement environment changed est reçu du Serveur voisin Dr.Web.

Base de données

Paramètres

Valeur retournée

disponible

 neighborid : ID du Serveur Dr.Web voisin depuis lequel l’événement est reçu,

neighborname : nom du Serveur Dr.Web voisin,

originatorid : ID du Serveur Dr.Web source de l’événement,

originatorname : nom du Serveur Dr.Web source de l’événement,

stationid : ID du poste,

stationname : nom du poste,

eventid : ID de l’événement,

group_name : nom du groupe primaire du poste,

category : catégorie de l’objet d’environnement

ignoré

Texte de la procédure :

--[[

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

Une menace est détectée sur le poste du Serveur Dr.Web voisin

Appelé lorsque l’événement virus detected est reçu du Serveur voisin Dr.Web.

Base de données

Paramètres

Valeur retournée

disponible

 neighborid : ID du Serveur Dr.Web voisin depuis lequel l’événement est reçu,

neighborname : nom du Serveur Dr.Web voisin,

originatorid : ID du Serveur Dr.Web source de l’événement,

originatorname : nom du Serveur Dr.Web source de l’événement,

stationid : ID du poste,

stationname : nom du poste,

eventid : ID de l’événement,

component : numéro du composant,

pid : ID du processus,

time : heure de l’événement (heure du poste),

user : nom de l’utilisateur et groupe du propriétaire du processus,

object : chemin d’accès au fichier dans le système de fichiers,

owner : nom d’utilisateur et groupe du propriétaire de l’objet,

action : code d’action,

objecttype : type d’objet:

-1 inconnu

0 fichier

1 :secteur d’amorçage,

2 bloc de mémoire ou processus

3 activité virale

infectiontype : type de menace (voir Dr.Web API),

sha1 : hash SHA-1 de l’objet trouvé,

sha256 : hash SHA-256 de l’objet détecté,

hashdb : bulletin contenant le hash

ignoré

Texte de la procédure :

--[[

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

Rapport de la Protection préventive du Serveur voisin

Appelé lors de la réception du rapport de la Protection préventive pour le poste depuis le Serveur voisin Dr.Web.

Base de données

Paramètres

Valeur retournée

disponible

 neighborid : ID du Serveur Dr.Web voisin depuis lequel l’événement est reçu,

neighborname : nom du Serveur Dr.Web voisin,

originatorid : ID du Serveur Dr.Web source de l’événement,

originatorname : nom du Serveur Dr.Web source de l’événement,

stationid : ID du poste,

stationname : nom du poste,

eventid : ID de l’événement,

pid : ID du processus,

path : chemin d’accès au fichier exécutable du processus ayant une activité suspecte

target_path : chemin d’accès à l’objet protégé auquel une tentative d’accès a été faite,

hips_type : type de l’objet protégé (valeur numérique),

shell_guard_type : raison de blocage du code non autorisé (valeur numérique),

denied : l’accès a été interdit (true | false),

is_user_action : l’action a été demandée auprès de l’utilisateur (true | false),

event_count : nombre d’événements interdits automatiquement (uniquement si la valeur false est spécifiée pour is_user_action),

event_user : l’utilisateur qui a lancé un processus ayant une activité suspecte

action_user : l’utilisateur qui a spécifié la réaction à l’activité suspecte du processus (seulement si la valeur true est spécifiée pour is_user_action),

event_time : l’heure de l’apparition de l’événement sur le poste,

recv_time : délai de réception du rapport par le Serveur Dr.Web voisin

sha1 : hash SHA-1 de l’objet trouvé,

sha256 : hash SHA-256 de l’objet détecté,

hashdb : bulletin contenant le hash

ignoré

Texte de la procédure :

--[[

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

Erreur d’authentification sur le Serveur Dr.Web voisin

Appelé après le refus de connexion au Serveur voisin Dr.Web à cause d’une erreur d’authentification.

Base de données

Paramètres

Valeur retournée

disponible

id : ID du Serveur Dr.Web,

address : adresse du Serveur Dr.Web,

name : nom du Serveur Dr.Web

reason : cause de l’échec

ignoré

Texte de la procédure :

--[[

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

Erreur de scan sur le poste du Serveur Dr.Web voisin

Appelé lorsque l’événement scan error est reçu du Serveur voisin Dr.Web

Base de données

Paramètres

Valeur retournée

disponible

 neighborid : ID du Serveur Dr.Web voisin depuis lequel l’événement est reçu,

neighborname : nom du Serveur Dr.Web voisin,

originatorid : ID du Serveur Dr.Web source de l’événement,

originatorname : nom du Serveur Dr.Web source de l’événement,

stationid : ID du poste,

stationname : nom du poste,

eventid : ID de l’événement,

component : numéro du composant,

pid : ID du processus,

time : heure de l’événement (heure du poste),

user : nom de l’utilisateur et groupe du propriétaire du processus,

object : chemin d’accès au fichier dans le système de fichiers,

owner : nom d’utilisateur et groupe du propriétaire de l’objet,

action : code d’action,

sha1 : hash SHA-1 de l’objet trouvé,

sha256 : hash SHA-256 de l’objet détecté,

hashdb : bulletin contenant le hash

ignoré

Texte de la procédure :

--[[

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

Le Serveur Dr.Web voisin est connecté

Appelé lors de la connexion au Serveur voisin Dr.Web.

Base de données

Paramètres

Valeur retournée

disponible

id : ID du Serveur Dr.Web,

address : adresse du Serveur Dr.Web,

name : nom du Serveur Dr.Web

ignoré

Texte de la procédure :

--[[

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

Statut du poste du Serveur Dr.Web voisin

Appelé lorsque le Serveur Dr.Web voisin communique le statut du poste y compris le statut des composants et des bases virales ainsi que certaines politiques locales (l’envoi des événements, la réception des mises à jour et des tâches)

Base de données

Paramètres

Valeur retournée

disponible

 neighborid : ID du Serveur Dr.Web voisin depuis lequel l’événement est reçu,

neighborname : nom du Serveur Dr.Web voisin,

originatorid : ID du Serveur Dr.Web source de l’événement,

originatorname : nom du Serveur Dr.Web source de l’événement,

stationid : ID du poste,

stationname : nom du poste,

eventid : ID de l’événement,

count : nombre de codes de statut différents

state_0 : valeur du statut,

number_0 : nombre de postes dans  state_0

ignoré

Texte de la procédure :

--[[

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

                -- ...

Le poste du Serveur Dr.Web voisin a été supprimé

Appelé lors de la suppression du poste sur le Serveur voisin Dr.Web

Base de données

Paramètres

Valeur retournée

disponible

 neighborid : ID du Serveur Dr.Web voisin depuis lequel l’événement est reçu,

neighborname : nom du Serveur Dr.Web voisin,

originatorid : ID du Serveur Dr.Web source de l’événement,

originatorname : nom du Serveur Dr.Web source de l’événement,

stationid : ID du poste,

stationname : nom du poste

ignoré

Texte de la procédure :

--[[

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

                -- ...

Statistiques de scan du poste du Serveur Dr.Web voisin

Appelé lorsque l’événement scan statistics est reçu du Serveur voisin Dr.Web.

Base de données

Paramètres

Valeur retournée

disponible

 neighborid : ID du Serveur Dr.Web voisin depuis lequel l’événement est reçu,

neighborname : nom du Serveur Dr.Web voisin,

originatorid : ID du Serveur Dr.Web source de l’événement,

originatorname : nom du Serveur Dr.Web source de l’événement,

stationid : ID du poste,

stationname : nom du poste,

eventid : ID de l’événement,

component : numéro du composant,

pid : ID du processus,

user : nom de l’utilisateur et groupe du propriétaire du processus,

time : heure de l’événement (heure du poste),

size  : taille sommaire de tous les objets scannés,

elapsedtime : temps écoulé,

scanned : nombre d’objets scannés,

infected : nombre d’objets contaminés par un virus connu,

modifications : nombre d’objets contaminés par une modification de virus,

suspicious : nombre de fichiers suspects,

cured : nombre de fichiers désinfectés,

deleted : nombre de fichiers supprimés,

renamed : nombre de fichiers renommés,

moved : nombre des fichiers déplacés en quarantaine,

locked : nombre de fichiers bloqués (uniquement par SpIDer Guard),

errors : nombre des fichiers non scannés à cause d’une erreur d’accès

ignoré

Texte de la procédure :

--[[

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

Installation de l’Agent depuis le Serveur voisin Dr.Web

Appelé lorsque l’événement installation est reçu du Serveur voisin Dr.Web.

Base de données

Paramètres

Valeur retournée

disponible

 neighborid : ID du Serveur Dr.Web voisin depuis lequel l’événement est reçu,

neighborname : nom du Serveur Dr.Web voisin,

originatorid : ID du Serveur Dr.Web source de l’événement,

originatorname : nom du Serveur Dr.Web source de l’événement,

stationid : ID du poste,

stationname : nom du poste,

eventid : ID de l’événement,

event : type de l’événement:

0 : installation en cours,

1 : l’installation est terminée avec succès,

2 : refusé,

3 :délai expiré,

4 : échoué,

5 : inaccompli

message : message d’erreur (ou message vide si aucune erreur n’est survenue),

address : adresse du poste,

begtime : heure du début,

endtime : heure de la fin

ignoré

Texte de la procédure :

--[[

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