Параметры запроса
Параметр
|
Описание
|
Обязательный
|
bases
|
Если параметр имеет значение yes, то в ответе будет приведена информация о вирусных базах, используемых на станции.
Допустимые значения: yes | no. По умолчанию: no.
|
нет
|
components
|
Если параметр имеет значение yes, то в ответе будет приведена информация о компонентах станции.
Допустимые значения: yes | no. По умолчанию: no.
|
нет
|
group-membership
|
Если параметр имеет значение yes, то в ответе будет приведена информация о группах, в которые входит станция.
Допустимые значения: yes | no. По умолчанию: no.
|
нет
|
id
|
Идентификатор станции
|
да
|
installed-components
|
Если параметр имеет значение yes, то в ответе будет приведена информация об антивирусных компонентах, установленных на станции.
Допустимые значения: yes | no. По умолчанию: no.
|
нет
|
keys
|
Если параметр имеет значение yes, то в ответе будет приведена информация о лицензионных ключах станции.
Допустимые значения: yes | no. По умолчанию: no.
|
нет
|
machines
|
Если параметр имеет значение yes, то в ответе будет приведена информация о компьютерах, на которых установлен Агент Dr.Web.
Допустимые значения: yes | no. По умолчанию: no.
|
нет
|
modules
|
Если параметр имеет значение yes, то в ответе будет приведена информация об антивирусных модулях, установленных на станции.
Допустимые значения: yes | no. По умолчанию: no.
|
нет
|
rights
|
Если параметр имеет значение yes, то в ответе будет приведена информация о правах станции.
Допустимые значения: yes | no. По умолчанию: no.
|
нет
|
running-components
|
Если параметр имеет значение yes, то в ответе будет приведена информация об антивирусных компонентах, запущенных на станции в данный момент.
Допустимые значения: yes | no. По умолчанию: no.
|
нет
|
station-type
|
Если параметр имеет значение yes, то в ответе будет приведена информация о типе станции.
Допустимые значения: yes | no. По умолчанию: no.
|
нет
|
Пример запроса
https://192.168.1.1:9081/api/stations/info.ds?id=1002&bases=yes&components=yes&group-membership=yes&installed-components=yes&keys=yes&machines=yes&modules=yes&rights=yes&running-components=yes
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="4.3.2" timestamp="1589394736" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
<stations total="1">
<station id="1002" name="win10-1909-pro-x86-ru" created="1589384744" modified="1589388720" parent_id="20e27d73-d21d-b211-a788-85419c46f0e6" parent_name="Everyone" parent_type="0" password="123456" state="1">
<blocking>
<begin>0</begin>
<end>0</end>
</blocking>
<lastseenat>1589388597</lastseenat>
<lastseenfrom>tcp://10.20.0.245:49687</lastseenfrom>
<os code="33754631">Windows 10 Pro</os>
<department>Test_office></department>
<description>Test_1002></description>
<country>RU</country>
<street>Test_avenue</street>
<room>Room_1002></room>
<city>Test_town</city>
<floor>Floor_1002</floor>
<longitude>2222220</longitude>
<latitude>3333330</latitude>
<organization>Test_Inc</organization>
<province>Test_region</province>
<email>Test_mail</email>
<connection port="2193" server="192.168.1.1">
<public_key url="https://192.168.1.1:9081/install/drwcsd.pub" uuid="1459895a-a115-4a66-93e7-a31fb717e9bd">
<![CDATA[; Dr.Web (R) Public key file
; Do not edit! 1459895a-a115-4a66-93e7-a31fb717e9bd
<!-- The key skipped in documentation. -->
; ***EOF***]]>
</public_key>
</connection>
<packages>
<package arch="all" os="windows" url="https://192.168.1.1:9081/download/download.ds?os=windows&id=1002"/>
</packages>
<config><![CDATA[https://192.168.1.1:9081/download/download.ds?code=gGNtByEyYydTpin]]></config>
<modules total="31">
<module name="drweb32.dll" version="7.00.46.03050" created="1589374257" modified="1589374257" hash="2e6df87878901996d4fa258705ec5524" file_size="4672776" file_owner="BUILTIN\Administrators:WIN10-1909-PRO-\None @ WIN10-1909-PRO-" description=""/>
<!-- etc. Skipped in documentation -->
</modules>
<machines total="1">
<machine machine_id="S-1-5-21-3870357344-3028028635-523956326" mac="fa:16:3e:25:10:d6" machine_name="win10-1909-pro-x86-ru" logged_time="20200513165200193" logged_address="10.20.0.245"/>
</machines>
<bases total="192">
<base file_name="dwp11000.vdb" version="1100" created="1589385656" viruses="739"/>
<!-- etc. Skipped in documentation -->
</bases>
<keys inherited="true" inherited_group_id="20e27d73-d21d-b211-a788-85419c46f0e6" inherited_group_name="Everyone">
<key id="daa111be1fdbca01"/>
</keys>
<installed-components total="11">
<component code="144" name="Preventive protection" installed="1589374270" path="C:\Program Files\DrWeb" server=""/>
<!-- etc. Skipped in documentation -->
</installed-components>
<running-components total="7">
<component code="57" name="SpIDer Guard for Windows" params="" started="1589388720" type="8" user="NT AUTHORITY\SYSTEM"/>
<!-- etc. Skipped in documentation -->
</running-components>
<rights inherited="true" inherited_group_id="20e27d73-d21d-b211-a788-85419c46f0e6" inherited_group_name="Everyone">
<right code="1" name="Run Dr.Web Scanner for Windows" value="1"/>
<!-- etc. Skipped in documentation -->
</rights>
<components total="11" inherited="true" inherited_group_id="20e27d73-d21d-b211-a788-85419c46f0e6" inherited_group_name="Everyone">
<component code="4" name="Dr.Web Scanner for Windows" status="1"/>
<!-- etc. Skipped in documentation -->
</components>
<group-membership total="2">
<group id="20e27d73-d21d-b211-a788-85419c46f0e6" inherited_group_name="Everyone" type="1" />
<group id="f5bf5a82-5d5b-11ea-b603-f832e48ba98f" inherited_group_name="Windows 10 Pro" type="4" />
</group-membership>
<acl priority="allow">
<allowed>
<address net_proto="tcp" net_mask="32">192.168.1.1</address>
</allowed>
<disallowed>
<address net_proto="tcp" net_mask="32">192.168.1.2</address>
</disallowed>
</acl>
</station>
</stations>
</drweb-es-api>
|
|
В ответный документ об удаленной станции не включаются элементы:
<os /> — операционная система станции,
<running-components /> — запущенные компоненты,
<installed-components /> — установленные компоненты,
<components /> — устанавливаемые компоненты,
<bases /> — вирусные базы,
<packages /> — установочные пакеты,
<connection /> и <public_key /> — информация о подключении и открытый ключ шифрования,
<rights /> — права доступа (см. Приложение А1. Коды прав станций),
<modules /> — модули,
<group-membership /> — членство в группах,
<config /> — адрес ресурса для скачивания конфигурационного файла с параметрами подключения для мобильных клиентов.
|
Описание параметров ответного XML
Элемент <stations /> содержит информацию обо всех станциях, указанных в запросе.
Атрибут элемента <stations />:
Атрибут
|
Описание
|
total
|
Общее количество станций в ответе
|
•Элемент <station /> содержит параметры конкретной станции.
Атрибуты элемента <station />:
Атрибут
|
Описание
|
id
|
Идентификатор станции
|
name
|
Название станции
|
created
|
Дата создания станции
|
modified
|
Время последней модификации
|
parent_id
|
Идентификатор родительской группы станции
|
parent_name
|
Название родительской группы станции
|
parent_type
|
Тип родительской группы станции
|
password
|
Пароль доступа к Серверу Dr.Web
|
state
|
Код состояния станции (см. Приложение Г. Возвращаемые коды состояния станции)
|
▫Элемент <blocking /> содержит информацию о блокировке станции во вложенных элементах: <begin /> — дату начала блокировки, <end /> — дату ее окончания.
▫Элемент <lastseenat /> содержит дату, когда станция последний раз подключалась к Серверу Dr.Web.
▫Элемент <lastseenfrom /> содержит адрес и порт, с которых станция последний раз подключалась к Серверу Dr.Web.
▫Элемент <os /> содержит информацию об операционной системе, которая установлена на станции.
Атрибут элемента <os />:
Атрибут
|
Описание
|
code
|
Код операционной системы
|
Значение элемента <os /> — название операционной системы.
▫Вложенные элементы элемента <station /> с информацией о станции:
Элемент
|
Описание
|
<department />
|
Отдел
|
<description />
|
Описание
|
<country />
|
Страна
|
<street />
|
Улица
|
<room />
|
Помещение
|
<city />
|
Город
|
<floor />
|
Этаж
|
<longitude />
|
Долгота
|
<latitude />
|
Широта
|
<organization />
|
Организация
|
<province />
|
Область
|
<email />
|
Адрес электронной почты
|
▫Элемент <connection /> содержит параметры подключения к Серверу Dr.Web.
Атрибуты элемента <connection />:
Атрибут
|
Описание
|
port
|
Номер порта для подключения к Серверу Dr.Web
|
server
|
DNS-имя или IP-адрес Сервера Dr.Web
|
▪Элемент <public_key /> содержит информацию об открытом ключе шифрования Сервера Dr.Web, а также сам открытый ключ.
Атрибуты элемента <public_key />:
Атрибут
|
Описание
|
url
|
Адрес, по которому располагается открытый ключ на Сервере Dr.Web
|
uuid
|
Идентификатор открытого ключа
|
Значение элемента <public_key /> — содержание открытого ключа.
▫Элемент <packages /> содержит ссылки на установочные пакеты, созданные на данном Сервере Dr.Web, для различных архитектур процессора и операционных систем.
▪Элемент <package /> содержит ссылку на конкретный антивирусный пакет.
Атрибуты элемента <package />:
Атрибут
|
Описание
|
arch
|
Архитектура процессора, на которую может быть установлен данный пакет:
•all — операционные системы любой разрядности,
•x86 — 32-хразрядные операционные системы,
•x86_64 — 64-хразрядные операционные системы |
os
|
Операционная система, на которую может быть установлен данный пакет
|
url
|
Адрес ресурса для скачивания пакета (Агента Dr.Web)
|
▫Элемент <config /> содержит адрес ресурса для скачивания конфигурационного файла с параметрами подключения для мобильных клиентов.
▫Элемент <modules /> содержит информацию обо всех программных модулях.
Атрибут элемента <modules />:
Атрибут
|
Описание
|
total
|
Общее количество модулей
|
▪Элемент <module /> содержит информацию о конкретном программном модуле.
Атрибуты элемента <module />:
Атрибут
|
Описание
|
name
|
Название файла
|
version
|
Версия модуля
|
created
|
Дата создания модуля
|
modified
|
Дата последнего изменения модуля
|
hash
|
Контрольная сумма модуля
|
file_size
|
Размер файла (в байтах)
|
file_owner
|
Имя владельца файла
|
description
|
Название модуля
|
▫Элемент <machines /> содержит информацию о компьютерах, на которых установлен Агент Dr.Web.
Атрибут элемента <machines />:
Атрибут
|
Описание
|
total
|
Общее количество компьютеров
|
▪Элемент <machine /> содержит информацию о конкретном компьютере, на котором установлен Агент Dr.Web.
Атрибуты элемента <machine />:
Атрибут
|
Описание
|
machine_id
|
Идентификатор защиты (SID) компьютера
|
mac
|
MAC-адрес компьютера
|
machine_name
|
NetBios-имя или доменное имя компьютера
|
logged_time
|
Дата последнего подключения Агента Dr.Web, установленного на этом компьютере, к Серверу Dr.Web
|
logged_address
|
Адрес, с которого Агент Dr.Web, установленный на этом компьютере, последний раз подключался к Серверу Dr.Web
|
▫Элемент <bases /> содержит информацию обо всех вирусных базах, установленных на станции.
Атрибут элемента <bases />:
Атрибут
|
Описание
|
total
|
Общее количество вирусных баз
|
▪Элемент <base /> содержит информацию о конкретной вирусной базе.
Атрибуты элемента <base />:
Атрибут
|
Описание
|
file_name
|
Название файла вирусной базы
|
version
|
Версия базы
|
created
|
Дата создания базы
|
viruses
|
Количество записей об угрозах в базе
|
▫Элемент <keys /> содержит информацию о лицензионных ключах данной станции.
Атрибуты элемента <keys />:
Атрибут
|
Описание
|
inherited
|
Если принимает значение true, то ключи унаследованы от родительской группы, если false — параметры ключей заданы индивидуально.
|
inherited_group_id
|
Идентификатор родительской группы, от которой унаследованы ключи.
Если атрибут inherited принимает значение false, то значение данного атрибута будет пустым.
|
inherited_group_name
|
Название родительской группы, от которой унаследованы ключи.
Если атрибут inherited принимает значение false, то значение данного атрибута будет пустым.
|
▪Элемент <key /> содержит информацию о конкретном лицензионном ключе.
Атрибут элемента <key />:
Атрибут
|
Описание
|
id
|
Идентификатор ключа
|
▫Элемент <installed-components /> содержит информацию обо всех установленных компонентах.
Атрибут элемента <installed-components/>:
Атрибут
|
Описание
|
total
|
Общее количество установленных компонентов
|
▪Элемент <component /> элемента <installed-components /> содержит информацию о конкретном установленном компоненте.
Атрибуты элемента <component />:
Атрибут
|
Описание
|
code
|
Числовой код компонента (см. Приложение Б2. Коды компонентов)
|
name
|
Название компонента (см. Приложение Б2. Коды компонентов)
|
installed
|
Время установки компонента
|
path
|
Путь установки компонента
|
server
|
Адрес Сервера Dr.Web, с которого был установлен компонент
|
▫Элемент <running-components /> содержит информацию обо всех компонентах, запущенных на момент запроса.
Атрибут элемента <running-components />:
Атрибут
|
Описание
|
total
|
Общее количество запущенных компонентов
|
▪Элемент <component /> элемента <running-components /> содержит информацию о конкретном запущенном компоненте.
Атрибуты элемента <component />:
Атрибут
|
Описание
|
code
|
Числовой код компонента (см. Приложение Б2. Коды компонентов)
|
name
|
Название компонента (см. Приложение Б2. Коды компонентов)
|
params
|
Параметры запуска компонента
|
started
|
Время запуска компонента
|
type
|
Способ запуска компонента:
1 — запущен вручную,
2 — запущен по расписанию,
4 — запущен пользователем,
8 — запущен как служебный процесс.
|
user
|
Пользователь станции, от имени которого был запущен компонент
|
▫Элемент <rights /> содержит информацию обо всех правах станции.
Атрибуты элемента <rights />:
Атрибут
|
Описание
|
inherited
|
Если принимает значение true, то права унаследованы от родительской группы, false — права заданы индивидуально.
|
inherited_group_id
|
Идентификатор родительской группы, от которой унаследованы права.
Если атрибут inherited принимает значение false, то значение данного атрибута будет пустым.
|
inherited_group_name
|
Название родительской группы, от которой унаследованы права.
Если атрибут inherited принимает значение false, то значение данного атрибута будет пустым.
|
▪Элемент <right /> содержит информацию о конкретном праве.
Атрибуты элемента <right /> :
Атрибут
|
Описание
|
code
|
Числовой код права (см. Приложение А1. Коды прав станций)
|
name
|
Название права (см. Приложение А1. Коды прав станций)
|
value
|
Статус права:
0 — запрещено использование данного права,
1 — право предоставлено.
|
▫Элемент <components /> содержит информацию обо всех компонентах.
Атрибуты элемента <components />:
Атрибут
|
Описание
|
total
|
Общее количество компонентов
|
inherited
|
Если принимает значение true, то компоненты унаследованы от родительской группы, если false — параметры компонентов заданы индивидуально.
|
inherited_group_id
|
Идентификатор родительской группы, от которой унаследованы параметры компонентов.
Если атрибут inherited принимает значение false, то значение данного атрибута будет пустым.
|
inherited_group_name
|
Название родительской группы, от которой унаследованы параметры компонентов.
Если атрибут inherited принимает значение false, то значение данного атрибута будет пустым.
|
▪Элемент <component /> элемента <components /> содержит информацию о конкретном компоненте.
Атрибуты элемента <component />:
Атрибут
|
Описание
|
code
|
Числовой код компонента (см. Приложение Б2. Коды компонентов)
|
name
|
Название компонента (см. Приложение Б2. Коды компонентов)
|
status
|
Статус компонента:
2 — компонент должен быть установлен,
1 — компонент может быть установлен,
0 — компонент не должен быть установлен.
|
•Элемент <group-membership /> содержит информацию обо всех группах, в которых состоит станция.
Атрибут элемента <group-membership />:
Атрибут
|
Описание
|
total
|
Общее количество групп, в которых состоит станция
|
▪Элемент <group /> содержит информацию о конкретной группе.
Атрибуты элемента <group />:
Атрибут
|
Описание
|
id
|
Идентификатор группы
|
name
|
Название группы
|
type
|
Тип группы:
0 — пользовательская группа,
1 — базовая группа и группа по умолчанию,
2 — группа, содержащая станции в сети (online),
3 — группа, содержащая станции не в сети (offline),
4 — группа, содержащая станции, сгруппированные по операционной системе,
5 — группа, содержащая станции, сгруппированные по сетевому протоколу,
6 — группа, содержащая станции с деинсталлированным Агентом Dr.Web,
7 — группа, содержащая станции с просроченным сроком допуска к Серверу Dr.Web,
10 — псевдогруппа,
13 — группа, содержащая Прокси-серверы Dr.Web для подключения Агентов и соседних Серверов Dr.Web.
|
▫Элемент <acl /> содержит списки контроля доступа, задающие ограничения на сетевые адреса, с которых Агент Dr.Web может получать доступ к Серверу Dr.Web.
Атрибут элемента <acl />:
Атрибут
|
Описание
|
priority
|
Определяет приоритетность использования списков:
•allowed — приоритет у списка разрешенных адресов: адреса, входящие в оба списка или не входящие ни в один из списков, будут разрешены;
•disallowed — приоритет у списка запрещенных адресов: адреса, входящие в оба списка или не входящие ни в один из списков, будут запрещены. |
▪Элементы <allowed /> и <disallowed /> определяют списки адресов, с которых соответственно разрешен или запрещен доступ к Серверу Dr.Web.
Оба элемента могут содержать вложенные элементы <address />, значением каждого является конкретный адрес.
Атрибуты элемента <address />:
Атрибут
|
Описание
|
net_proto
|
Сетевой протокол
|
net_mask
|
Маска сети
|
▫Элемент <station_type_info /> содержит информацию о типе станции. Если станция является Виртуальным агентом, он содержит список сканирующих серверов. Если станция является Сканирующим сервером, он содержит список виртуальных агентов. Если это обычная станция, то пустой список.
Атрибуты элемента <station_type_info />:
Название поля
|
Описание
|
station_type
|
Тип станции:
•0 - обычная,
•1 - Виртуальный агент,
•2 - Сканирующий сервер |
▪Атрибуты элемента <station_type_info /> содержат параметры конкретной станции:
Название поля
|
Описание
|
id
|
Идентификатор станции
|
name
|
Название станции
|
station_type
|
Тип станции:
•0 — обычная,
•1 — Виртуальный агент,
•2 — Сканирующий сервер. |
addr
|
Адрес: порт.
|
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1589398833,
"api": {
"version": 40302,
"versionString": "4.3.2"},
"server": {
"name": "192.168.1.1",
"version": "13.00.0.202005090",
"uuid": "b35d999d-9212-481d-af8c-8551c4113383"}},
"data": {
"total": 1,
"list": [
{"id": "1002",
"name": "win10-1909-pro-x86-ru",
"parent_id": "20e27d73-d21d-b211-a788-85419c46f0e6",
"parent_name": "Everyone",
"parent_type": "0",
"password": "123456",
"state": 1,
"block_begin_time": 0,
"block_end_time": 0,
"last_seen_time": 1589388597,
"last_seen_addr": "tcp://10.20.0.245:49687",
"connection": {
"port": 2193,
"public_key": {
"file": "; [^] Dr.Web (R) Public key file\n
; Do not edit!\n
1459895a-a115-4a66-93e7-a31fb717e9bd\n
...
; ***EOF***\n",
"id": "1459895a-a115-4a66-93e7-a31fb717e9bd",
"url": "https://192.168.1.1:9081/install/drwcsd.pub"},
"server": "192.168.1.1"},
"packages": [
{"arch": "all,
"os": "windows","
"url": "https://192.168.1.1:9081/download/download.ds?os=windows&id=1002"}],
"config_url": "https://192.168.1.1:9081/d/c.ds?c=8r9Xiw22Ey83KDlFFv",
"department": "Test_office",
"description": "Test_1002",
"country": "RU",
"street": "Test_avenue",
"room": "Room_1002",
"city": "Test_town",
"floor": "Floor_1002",
"longitude": 2222220,
"latitude": 3333330,
"organization": "Test_Inc",
"province": "Test_region",
"email": "Test_mail",
"components": {
"inherited": true,
"inherited_group_id": "20e27d73-d21d-b211-a788-85419c46f0e6",
"inherited_group_name": "Everyone",
"list": [
{"code": 4,
"name": "Dr.Web Scanner for Windows",
"status": 1},
...]},
"installed_components": [
{"code": 144,
"installed_time": 1589374270,
"name": "Preventive protection",
"path": "C:\\Program Files\\DrWeb",
"server": ""},
...],
"running_components": [
{"code": 57,
"name": "SpIDer Guard for Windows",
"params": "",
"pid": "14",
"started_time": 1589388720,
"type": 8,
"user": "NT AUTHORITY\\SYSTEM"},
...],
"modules": [
{"created_time": 1589374257,
"description": "Dr.Web Virus-Finding Engine",
"file_name": "drweb32.dll",
"file_owner": "BUILTIN\\Administrators:WIN10-1909-PRO-\\None @WIN10-1909-PRO-",
"file_size": 4672776,
"hash": "2e6df87878901996d4fa258705ec5524",
"modified_time": 1589374257,
"version": "7.00.46.03050"},
...],
"bases": [
{"created_time": 1589385656,
"file_name": "dwp11000.vdb",
"version": "1100",
"viruses": 739},
...],
"group_membership": [
{"id": "20e27d73-d21d-b211-a788-85419c46f0e6",
"name": "Everyone",
"type": 1}
{"id": "f5bf5a82-5d5b-11ea-b603-f832e48ba98f",
"name": "Windows 10 Pro",
"type": 4}],
"keys": {
"inherited": true,
"inherited_group_id": "20e27d73-d21d-b211-a788-85419c46f0e6",
"inherited_group_name": "Everyone",
"list": [
"daa669be6fdbca01"]},
"permissions": {
"inherited": true,
"inherited_group_id": "20e27d73-d21d-b211-a788-85419c46f0e6",
"inherited_group_name": "Everyone",
"list": [
{"name": "Run Dr.Web Scanner for Windows",
"right": 1,
"value": 1},
...]},
"machines": [
{"logged_address": "10.20.0.245",
"logged_time": "20200513165200193",
"machine_id": "S-1-5-21-3870357344-3028028635-523956326",
"machine_mac": "fa:16:3e:25:10:d6",
"machine_name": "win10-1909-pro-x86-ru"}],
"acl": {
"priority": "allow",
"allowed": [{
"net_mask": "32",
"net_address": "192.168.1.1"}],
"disallowed": [{
"net_mask": "32",
"net_address": "192.168.1.2"}]},
"os_code": 33754631,
"os_name": "Windows 10 Pro",
"created_time": 1589384744,
"modified_time": 1589388720}]}}
|
Описание параметров ответного JSON
Блок data содержит информацию обо всех станциях, указанных в запросе.
Элементы блока data:
Название поля
|
Описание
|
total
|
Общее количество станций в ответе
|
list
|
Массив параметров для каждой станции
|
•Каждый объект массива list содержит параметры конкретной станции.
Элементы объектов в массиве list:
Название поля
|
Описание
|
id
|
Идентификатор станции
|
name
|
Название станции
|
parent_id
|
Идентификатор родительской группы станции
|
parent_name
|
Название родительской группы станции
|
parent_type
|
Тип родительской группы станции
|
password
|
Пароль доступа к Серверу Dr.Web
|
state
|
Текущие состояние станции (см. Приложение Г. Возвращаемые коды состояния станции)
|
block_begin_time
|
Дата начала блокировки станции
|
block_end_time
|
Дата окончания блокировки станции
|
last_seen_time
|
Дата последнего подключения станции к Серверу Dr.Web
|
last_seen_addr
|
Адрес, с которого станция последний раз подключалась к Серверу Dr.Web
|
connection
|
Блок параметров подключения к Серверу Dr.Web
|
packages
|
Массив ссылок на установочные пакеты, созданные на данном Сервере Dr.Web, для различных архитектур процессора и операционных систем
|
config_url
|
Адрес ресурса для скачивания конфигурационного файла с параметрами подключения для мобильных клиентов
|
department
|
Отдел
|
description
|
Описание
|
country
|
Страна
|
street
|
Улица
|
room
|
Помещение
|
city
|
Город
|
floor
|
Этаж
|
longitude
|
Долгота
|
latitude
|
Широта
|
organization
|
Организация
|
province
|
Область
|
email
|
Адрес электронной почты
|
components
|
Блок с информацией обо всех компонентах
|
installed_components
|
Массив параметров для каждого установленного компонента
|
running_components
|
Массив параметров для каждого компонента, запущенного на момент запроса
|
modules
|
Массив параметров для каждого программного модуля
|
bases
|
Массив параметров для каждой вирусной базы
|
group_membership
|
Массив с информацией обо всех группах, в которых состоит станция
|
keys
|
Блок параметров для каждого лицензионного ключа станции
|
permissions
|
Блок параметров для каждого права группы
|
machines
|
Массив с информацией о компьютерах, на которых установлен Агент Dr.Web
|
acl
|
Блок со списками контроля доступа. Списки задают ограничения на сетевые адреса, с которых Агент может получать доступ к Серверу Dr.Web
|
os_code
|
Код операционной системы
|
os_name
|
Название операционной системы
|
created_time
|
Дата создания станции
|
modified_time
|
Время последней модификации
|
station_type_info
|
Информация о типе станции. Если станция является виртуальным агентом, содержит список сканирующих серверов. Если станция является сканирующим сервером, содержит список виртуальных агентов. Если это обычная станция, то пустой список.
|
Элементы блока connection:
Название поля
|
Описание
|
port
|
Номер порта для подключения к Серверу Dr.Web
|
public_key
|
Блок с информацией об открытом ключе шифрования
|
server
|
DNS-имя или IP-адрес Сервера Dr.Web
|
▪Элементы блока public_key:
Название поля
|
Описание
|
file
|
Содержание открытого ключа
|
id
|
Идентификатор открытого ключа
|
url
|
Адрес, по которому располагается открытый ключ на Сервере Dr.Web
|
▫Элементы объектов в массиве packages:
Название поля
|
Описание
|
arch
|
Архитектура процессора, на которую может быть установлен данный пакет:
•all — операционные системы любой разрядности,
•x86 — 32-хразрядные операционные системы,
•x86_64 — 64-хразрядные операционные системы |
os
|
Операционная система, на которую может быть установлен данный пакет
|
url
|
Адрес ресурса для скачивания пакета (Агента Dr.Web)
|
▫Элементы блока components:
Название поля
|
Описание
|
inherited
|
Если принимает значение true, то компоненты унаследованы от родительской группы, если false — параметры компонентов заданы индивидуально.
|
inherited_group_id
|
Идентификатор родительской группы, от которой унаследованы параметры компонентов.
Данный элемент будет отсутствовать, если элемент inherited принимает значение false.
|
inherited_group_name
|
Название родительской группы, от которой унаследованы параметры компонентов.
Данный элемент будет отсутствовать, если элемент inherited принимает значение false.
|
list
|
Массив параметров для каждого компонента
|
▪Элементы объектов в массиве list:
Название поля
|
Описание
|
code
|
Числовой код компонента (см. Приложение Б2. Коды компонентов)
|
name
|
Название компонента (см. Приложение Б2. Коды компонентов)
|
status
|
Статус компонента:
2 — компонент должен быть установлен,
1 — компонент может быть установлен,
0 — компонент не должен быть установлен.
|
▫Элементы объектов в массиве installed-components:
Название поля
|
Описание
|
code
|
Числовой код компонента (см. Приложение Б2. Коды компонентов)
|
installed_time
|
Время установки компонента
|
name
|
Название компонента (см. Приложение Б2. Коды компонентов)
|
path
|
Путь установки данного компонента
|
server
|
Адрес Сервера Dr.Web, с которого был установлен данный компонент
|
▫Элементы объектов в массиве running-components:
Название поля
|
Описание
|
code
|
Числовой код компонента (см. Приложение Б2. Коды компонентов)
|
name
|
Название компонента (см. Приложение Б2. Коды компонентов)
|
params
|
Параметры запуска компонента
|
pid
|
Идентификатор процесса на станции
|
started_time
|
Время запуска компонента
|
type
|
Способ запуска компонента:
1 — запущен вручную,
2 — запущен по расписанию,
4 — запущен пользователем,
8 — запущен как служебный процесс.
|
user
|
Пользователь станции, от имени которого был запущен компонент
|
▫Элементы объектов в массиве modules:
Название поля
|
Описание
|
created_time
|
Дата создания модуля
|
description
|
Название модуля
|
file_name
|
Название файла
|
file_owner
|
Имя владельца файла
|
file_size
|
Размер файла (в байтах)
|
hash
|
Контрольная сумма модуля
|
modified_time
|
Дата последнего изменения модуля
|
version
|
Версия модуля
|
▫Элементы объектов в массиве bases:
Название поля
|
Описание
|
created
|
Дата создания базы
|
file_name
|
Название файла вирусной базы
|
version
|
Версия базы
|
viruses
|
Количество записей об угрозах в базе
|
▫Элементы объектов в массиве group-membership:
Название поля
|
Описание
|
id
|
Идентификатор группы
|
name
|
Название группы
|
type
|
Тип группы:
0 — пользовательская группа,
1 — базовая группа и группа по умолчанию,
2 — группа, содержащая станции в сети (online),
3 — группа, содержащая станции не в сети (offline),
4 — группа, содержащая станции, сгруппированные по операционной системе,
5 — группа, содержащая станции, сгруппированные по сетевому протоколу,
6 — группа, содержащая станции с деинсталлированным Агентом Dr.Web,
7 — группа, содержащая станции с просроченным сроком допуска к Серверу Dr.Web,
10 — псевдогруппа,
13 — группа, содержащая Прокси-серверы Dr.Web для подключения Агентов и соседних Серверов Dr.Web.
|
▫Элементы блока keys:
Название поля
|
Описание
|
inherited
|
Если принимает значение true, то ключи унаследованы от родительской группы, если false — ключи заданы индивидуально.
|
inherited_group_id
|
Идентификатор родительской группы, от которой унаследованы права.
Данный элемент будет отсутствовать, если элемент inherited принимает значение false.
|
inherited_group_name
|
Название родительской группы, от которой унаследованы ключи.
Данный элемент будет отсутствовать, если элемент inherited принимает значение false.
|
list
|
Массив идентификаторов ключей
|
▪Элементы объектов в массиве list:
Название поля
|
Описание
|
id
|
Идентификатор ключа
|
▫Элементы блока permissions:
Название поля
|
Описание
|
inherited
|
Если принимает значение true, то права унаследованы от родительской группы, если false — права заданы индивидуально.
|
inherited_group_id
|
Идентификатор родительской группы, от которой унаследованы права.
Данный элемент будет отсутствовать, если элемент inherited принимает значение false.
|
inherited_group_name
|
Название родительской группы, от которой унаследованы права.
Данный элемент будет отсутствовать, если элемент inherited принимает значение false.
|
list
|
Массив параметров для каждого права станции
|
▪Элементы объектов в массиве list:
Название поля
|
Описание
|
name
|
Название права (см. Приложение А1. Коды прав станций)
|
right
|
Числовой код права (см. Приложение А1. Коды прав станций)
|
value
|
Статус права:
0 — запрещено использование данного права,
1 — право предоставлено.
|
▫Элементы объектов в массиве machines:
Название поля
|
Описание
|
logged_address
|
Адрес, с которого Агент, установленный на этом компьютере, последний раз подключался к Серверу Dr.Web
|
logged_time
|
Дата последнего подключения Агента, установленного на этом компьютере, к Серверу Dr.Web
|
machine_id
|
Идентификатор защиты (SID) компьютера
|
machine_mac
|
MAC-адрес компьютера
|
machine_name
|
NetBios-имя или доменное имя компьютера
|
▫Элементы блока acl:
Название поля
|
Описание
|
priority
|
Определяет приоритетность использования списков:
•allowed — приоритет у списка разрешенных адресов: адреса, входящие в оба списка или не входящие ни в один из списков, будут разрешены.
•disallowed — приоритет у списка запрещенных адресов: адреса, входящие в оба списка или не входящие ни в один из списков, будут запрещены. |
allowed
|
Массив адресов, с которых разрешен доступ к Серверу Dr.Web
|
disallowed
|
Массив адресов, с которых запрещен доступ к Серверу Dr.Web
|
▪Элементы массивов allowed и disallowed:
Название поля
|
Описание
|
net_mask
|
Маска сети
|
net_address
|
Сетевой адрес
|
▫Элементы блока station_type_info:
Название поля
|
Описание
|
station_type
|
Тип станции:
•0 - обычная,
•1 - Виртуальный агент,
•2 - Сканирующий сервер |
list
|
Массив параметров для каждой станции. Каждый объект массива list содержит параметры конкретной станции.
|
▪Элементы объектов в массиве list:
Название поля
|
Описание
|
id
|
Идентификатор станции
|
name
|
Название станции
|
station_type
|
Тип станции:
•0 — обычная,
•1 — Виртуальный агент,
•2 — Сканирующий сервер. |
addr
|
Адрес: порт.
|
|