M6. 隣接

隣接Dr.Web Serverの端末でコンポーネント停止

隣接Dr.Web Serverから component completed イベントを受信した場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•neighborid - イベントを受信した隣接Dr.Web ServerのID

•neighborname - 隣接Dr.Web Server名

•originatorid - イベントを発信したDr.Web ServerのID

•originatorname - イベントを発信したDr.Web Server名

•stationid - 端末ID

•stationname - 端末名

•eventid - イベントID

•component - コンポーネント数

•pid - 親プロセスID

•infections - 脅威を検出

•errors - アクセスエラーを検知

•exitcode - コンポーネント終了コード

•time - 終了時間（端末時間）

ignored

プロシージャテキスト

--[[

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 Serverの端末でコンポーネント起動

隣接Dr.Web Serverから component started イベントを受信した場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•neighborid - イベントを受信した隣接Dr.Web ServerのID

•neighborname - 隣接Dr.Web Server名

•originatorid - イベントを発信したDr.Web ServerのID

•originatorname - イベントを発信したDr.Web Server名

•stationid - 端末ID

•stationname - 端末名

•eventid - イベントID

•component - コンポーネント数

•pid - 親プロセスID

•engine - virus-findingエンジンバージョン

•records - ウイルスレコード数

•user - プロセス所有者のユーザー名とグループ

•time - 開始時間（端末時間）

ignored

プロシージャテキスト

--[[

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 Server、または隣接Dr.Web Serverの端末の位置情報が変更

隣接Dr.Web Serverから geolocation イベントを受信した場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•neighborid - イベントを受信した隣接Dr.Web ServerのID

•neighborname - 隣接Dr.Web Server名

•originatorid - イベントを発信したDr.Web ServerのID

•originatorname - イベントを発信したDr.Web Server名

•stationid - 端末ID

•stationname         - 端末名

•latitude - 緯度（DD.DDDDDDフォーマット）

•longitude - 経度（DD.DDDDDDフォーマット）

ignored

プロシージャテキスト

--[[

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

                -- ...

隣接Dr.Web Serverの端末でハードウェアとソフトウェアが変更

隣接Dr.Web Serverから environment changed イベントを受信した場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•neighborid - イベントを受信した隣接Dr.Web ServerのID

•neighborname - 隣接Dr.Web Server名

•originatorid - イベントを発信したDr.Web ServerのID

•originatorname - イベントを発信したDr.Web Server名

•stationid - 端末ID

•stationname - 端末名

•eventid - イベントID

•group_name - 端末プライマリグループの名前

•category - 環境カテゴリー

ignored

プロシージャテキスト

--[[

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 Serverの端末でセキュリティ脅威を検知

隣接Dr.Web Serverから virus detected イベントを受信した場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•neighborid - イベントを受信した隣接Dr.Web ServerのID

•neighborname - 隣接Dr.Web Server名

•originatorid - イベントを発信したDr.Web ServerのID

•originatorname - イベントを発信したDr.Web Server名

•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ハッシュ

ignored

プロシージャテキスト

--[[

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

隣接Dr.Web Serverからの予防的保護のレポート

隣接Dr.Web Serverから端末の予防的保護レポートを受信した場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•neighborid - イベントを受信した隣接Dr.Web ServerのID

•neighborname - 隣接Dr.Web Server名

•originatorid - イベントを発信したDr.Web ServerのID

•originatorname - イベントを発信したDr.Web Server名

•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 Serverがレポートを受信した時間

•sha1 - 検出されたオブジェクトのSHA-1ハッシュ

•sha256 - 検出されたオブジェクトのSHA-256ハッシュ

•hashdb - ハッシュが含まれているBulletin

ignored

プロシージャテキスト

--[[

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 Serverで認証エラー

認証エラーにより隣接Dr.Web Serverとの接続が拒否された後に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•id - Dr.Web ServerのID

•address - Dr.Web Serverアドレス

•name - Dr.Web Server名

•reason - 失敗理由

ignored

プロシージャテキスト

--[[

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 Serverの端末でスキャンエラー

隣接Dr.Web Serverから scan error イベントを受信した場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•neighborid - イベントを受信した隣接Dr.Web ServerのID

•neighborname - 隣接Dr.Web Server名

•originatorid - イベントを発信したDr.Web ServerのID

•originatorname -        イベントを発信したDr.Web Server名

•stationid - 端末ID

•stationname - 端末名

•eventid - イベントID

•component - コンポーネント数

•pid - プロセスID

•time - イベント発生時間（端末時間）

•user - プロセス所有者のユーザー名とグループ

•object - ファイルシステム内のオブジェクトへのパス

•owner - オブジェクト所有者のユーザー名とグループ

•action - アクションコード

•sha1 - 検出されたオブジェクトのSHA-1ハッシュ

•sha256 - 検出されたオブジェクトのSHA-256ハッシュ

•hashdb - ハッシュが含まれているBulletin

ignored

プロシージャテキスト

--[[

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 Serverが接続

隣接Dr.Web Serverが接続された場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•id - Dr.Web ServerのID

•address - Dr.Web Serverアドレス

•name - Dr.Web Server名

ignored

プロシージャテキスト

--[[

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 Serverからの端末ステータス

隣接Dr.Web Serverがコンポーネントのステータス、ウイルスベース、一部のローカルポリシーを含む、端末のステータスをレポートする（イベント送信、更新とタスクの受信）場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•neighborid - イベントを受信した隣接Dr.Web ServerのID

•neighborname - 隣接Dr.Web Server名

•originatorid - イベントを発信したDr.Web ServerのID

•originatorname - イベントを発信したDr.Web Server名

•stationid - 端末ID

•stationname - 端末名

•eventid - イベントID

•count - 異なるステータスコードの数

•state_0 - ステータス値

•number_0 - state_0 の端末数

ignored

プロシージャテキスト

--[[

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 Serverの端末が削除

隣接Dr.Web Serverの端末が削除された場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•neighborid - イベントを受信した隣接Dr.Web ServerのID

•neighborname - 隣接Dr.Web Server名

•originatorid - イベントを発信したDr.Web ServerのID

•originatorname - イベントを発信したDr.Web Server名

•stationid - 端末ID

•stationname - 端末名

ignored

プロシージャテキスト

--[[

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 Serverの端末のスキャン統計

隣接Dr.Web Serverから scan statistics イベントを受信した場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•neighborid - イベントを受信した隣接Dr.Web ServerのID

•neighborname - 隣接Dr.Web Server名

•originatorid - イベントを発信したDr.Web ServerのID

•originatorname - イベントを発信したDr.Web Server名

•stationid - 端末ID

•stationname - 端末名

•eventid - イベントID

•component - コンポーネント数

•pid - 親プロセスID

•user - プロセス所有者のユーザー名とグループ

•time - イベント発生時間（端末時間）

•size - スキャンされたすべてのオブジェクトのサイズのサマリ

•elapsedtime - 経過時間

•scanned - スキャンされたオブジェクトの数

•infected - 既知のウイルスに感染しているオブジェクトの数

•modifications - ウイルスの亜種に感染しているオブジェクトの数

•suspicious - 疑わしいオブジェクトの数

•cured - 修復されたファイルの数

•deleted - 削除されたファイルの数

•renamed - 名前変更されたファイルの数

•moved - 隔離されたファイルの数

•locked - ロックされたファイルの数（SpIDer Guardのみ）

•errors - アクセスエラーによってスキャンされなかった数

ignored

プロシージャテキスト

--[[

Called:

 when "scan statistics" 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          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 ServerからのAgentインストール

隣接Dr.Web Serverから installation イベントを受信した場合に呼び出されます。

データベース

パラメータ

戻り値

使用可能

•neighborid - イベントを受信した隣接Dr.Web ServerのID

•neighborname - 隣接Dr.Web Server名

•originatorid - イベントを発信したDr.Web ServerのID

•originatorname - イベントを発信したDr.Web Server名

•stationid - 端末ID

•stationname - 端末名

•eventid - イベントID

•event - イベントタイプ：

▫0 stationname - インストール開始

▫1 - インストール正常完了

▫2 - 拒否

▫3 - タイムアウト

▫4 - 失敗

▫5 - 未完了

•message - エラーメッセージ（エラーがない場合は空欄）

•address - 端末アドレス

•begtime - 開始時間

•endtime - 終了時間

ignored

プロシージャテキスト

--[[

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 ID5

 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