Получение информации о станции

Параметры запроса

Параметр

Описание

Обязательный

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&amp;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="14" name="SpIDer Mail 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 — Сканирующий сервер.

connected

Когда Виртуальный агент и Сканирующий сервер включены и Виртуальный агент подключился к Сканирующему серверу, то возвращается 1, иначе - 0.

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": 14,

            "name": "SpIDer Mail 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 — Сканирующий сервер.

connected

Когда Виртуальный агент и Сканирующий сервер включены и Виртуальный агент подключился к Сканирующему серверу, то возвращается 1, иначе - 0.

addr

Адрес: порт.