Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Настройка безопасности: Контроль целостности (SecurityIntegrityControl)

Подсистема безопасности Alpha.Security позволяет контролировать целостность указанных файлов и папок. На основе контрольной суммы файлов и папок создается эталон состояния. Когда необходимо проверить их целостность, считается текущая контрольная сумма и сравнивается с эталонным значением.

Компонент Настройка безопасности: Контроль целостности предназначен для:

  • запроса текущей конфигурации контроля целостности и ее изменения;
  • создания эталона состояния файлов и папок;
  • выполнения проверок состояния файлов и папок;
  • получения информации об изменениях в файлах и папках.

Пример использования компонента в проекте описан в разделе Контроль целостности файлов и папок.

Получение текущей конфигурации контроля целостности

Чтобы получить какую-либо информацию о группах контроля целостности, необходимо:

  1. Добавить экземпляр Настройка безопасности: Контроль целостности на форму.
  2. Отправить JSON-запрос агенту безопасности, вызвав функцию компонента JsonRequest() (или JsonRemoteRequest(), если запрос отправляется на удаленную рабочую станцию). В качестве входного параметра функции указать JSON-запрос. Шаблоны JSON-запросов приведены ниже.
  3. В обработчике событий JsonRequestComplete (JsonRemoteRequestComplete) указать, что должно происходить при получении JSON-ответа. Для чтения ответа можно использовать внутреннюю переменную события response, куда записывается полученный JSON-ответ. В ответе может быть текущая конфигурация контроля целостности, либо текст ошибки в случае ее возникновения. Примеры JSON-ответов приведены ниже.

Компонент может запрашивать информацию только у Alpha.Security версии 1.7.24 и новее.

Как построить JSON-запрос

Чтобы построить JSON-запрос, необходимо указать объект запроса и команду. Некоторые команды требуют указания параметров. Параметры для каждой команды описаны в подразделах с примерами запросов, приведенном ниже.

{
 "object": "объект",
 "command": "команда",
 "params": {}
}

Объект запроса – конфигурация групп контроля целостности. В качестве объекта запроса следует указать строку "ic_api/ic_config/ic_group" (на данный момент поддерживается только такой объект, в будущем можно будет строить запросы к каждому объекту ic_api, ic_config или ic_group отдельно).

Команды могут либо запрашивать текущую конфигурацию, либо вносить в нее изменения. Команды запроса текущей конфигурации:

  • List – команда для получения списка групп контроля целостности, хранимых агентом;
  • Fetch – команда для получения конфигураций всех групп контроля целостности, хранимых агентом;
  • Get – команда для получения конфигурации конкретной группы контроля целостности.

Команды для обновления текущей конфигурации:

  • Add – команда для добавления новой группы контроля целостности;
  • Update – команда для обновления конфигурации контроля целостности;
  • Delete – команда для удаления конкретной группы контроля целостности.

Примеры JSON-запросов и возвращаемых JSON-ответов

Ниже приведены примеры запросов к агенту безопасности и его ответов.

List

В результате выполнения данного запроса будет получена JSON-строка, содержащая список групп контроля целостности, хранимых агентом.

Пример запроса:

{
 "object": "ic_api/ic_config/ic_group",
 "command": "List"
}

Пример ответа:

{
 "result": {
  "ic_group": [{
    "id": "29e16896-0b69-4b3e-a358-b294578e6dd6",
    "name": "legacy"
   }, {
    "id": "55369ec7-226d-48f5-a98c-6ca36597b323",
    "name": "Default"
   }
  ]
 }
}
Описание полей JSON-ответа
Поле Описание
ic_group

JSON-объект ic_group, содержащий информацию о настройках контроля целостности, хранимых агентом безопасности.

Представляет собой массив JSON-объектов, каждый из которых описывает конкретную группу контроля целостности. Свойства этих объектов описаны в этой таблице далее.

id

Идентификатор конкретной группы контроля целостности.

Совпадает с именем зашифрованного файла в папке C:\Program Files\Automiq\Alpha.Security\IC.

name

Название группы контроля целостности.

Устаревшие настройки, автоматически преобразованные в новый формат, всегда сохраняются в группу с именем legacy.

Fetch

В результате выполнения данного запроса будет получена JSON-строка, содержащая настройки каждой группы, хранимой агентом.

Пример запроса:

{
 "object": "ic_api/ic_config/ic_group",
 "command": "Fetch"
}

Пример ответа:

{
 "result": {
  "ic_group": [{
    "id": "29e16896-0b69-4b3e-a358-b294578e6dd6",
    "name": "legacy",
    "description": "",
    "active": true,
    "options": {
     "ic_execution_period": 60,
     "ic_error_log_max": 0,
     "ic_error_object_not_exist": true,
     "ic_error_date_changed": true,
     "ic_error_file_changed": false,
     "ic_error_new_object": true
    },
    "ic_list": [{
      "id": "63aa73d3-7433-43da-9143-a3481113fd64",
      "name": "Default",
      "path": "C:\\Program Files\\OpenLDAP",
      "mask": "*",
      "recursive": true
    }, {
      "id": "977e18cf-5217-41b0-95c3-0ceb297a86ec",
      "name": "Default",
      "path": "C:\\ProgramData\\OpenLDAP\\openldap\\slapd.conf",
      "mask": "*",
      "recursive": true
     }
    ],
    "ic_exclude_list": []
   }
  ]
 }
}
Описание полей JSON-ответа
Поле Описание
ic_group

JSON-объект ic_group, содержащий информацию о настройках контроля целостности, хранимых агентом безопасности.

Представляет собой массив JSON-объектов, каждый из которых описывает конкретную группу контроля целостности. Свойства этих объектов описаны в этой таблице далее.

id

Идентификатор конкретной группы контроля целостности.

Совпадает с именем зашифрованного файла в папке C:\Program Files\Automiq\Alpha.Security\IC.

name

Название группы контроля целостности.

Устаревшие настройки, автоматически преобразованные в новый формат, всегда сохраняются в группу с именем legacy.

description Описание группы.
active

Активность группы.

Из нескольких групп активна может быть только одна.

options

Настройки проверок для конкретной группы.

Описаны в виде следующих свойств:

  • ic_execution_period – таймер автоматической проверки, значение указано в секундах;
  • ic_error_log_max – определяет максимальное количество сообщений об ошибках контроля целостности, выводимых в аудит и системный журнал сообщений. Если значение 0, то вывод сообщений об ошибках контроля файлов отключен.

Следующие свойства определяют серьезность нарушений. Если для отдельного параметра указано значение true, то нарушение данного типа считается ошибкой, если false – нарушение данного типа считается предупреждением:

  • ic_error_object_not_exist – определяет серьёзность нарушения "Объект не существует";
  • ic_error_date_changed – определяет серьёзность нарушения "Изменилась дата объекта";
  • ic_error_file_changed – определяет серьёзность нарушения "Изменилось содержимое файла";
  • ic_error_new_object – определяет серьёзность нарушения "Обнаружен новый объект".
ic_list

Список контролируемых объектов и настройки. Представлен в виде массива JSON-объектов.

Каждый контролируемый объект (файл или папка) описан в виде JSON-объекта со следующими свойствами:

  • id – идентификатор контролируемого объекта;
  • name – название объекта;
  • path – полный путь к контролируемому объекту;
  • mask – настройка фильтрации объектов, вложенных в контролируемый объект (если указано *, значит, контролируется целостность для всех вложенных объектов, в противном случае контролируются только объекты с указанным расширением);
  • recursive – настройка контроля целостности для папок (если указано false, контроль целостности выполняется только для самой папки, если true – контролируется целостность и вложенных в нее объектов).
ic_exclude_list

Список объектов, исключенных из контроля целостности. Представлен в виде массива JSON-объектов.

Каждый исключенный из контроля целостности объект (файл или папка) описан в виде JSON-объекта со следующими свойствами:

  • id – идентификатор исключенного объекта;
  • name – название исключенного объекта;
  • path – полный путь к исключенному объекту.

Get

В результате выполнения данного запроса будет получена JSON-строка, содержащая настройки определенной группы, хранимой агентом. Для этой команды нужно указать обязательный параметр ic_groupId, в качестве значения параметра указать идентификатор группы.

Пример запроса:

{
 "object": "ic_api/ic_config/ic_group",
 "command": "Get"
  "params": {
   "ic_groupId":"29e16896-0b69-4b3e-a358-b294578e6dd6"
}

Пример ответа:

{
 "result": {
    "id": "29e16896-0b69-4b3e-a358-b294578e6dd6",
    "name": "legacy",
    "description": "",
    "active": true,
    "options": {
     "ic_execution_period": 60,
     "ic_error_log_max": 0,
     "ic_error_object_not_exist": true,
     "ic_error_date_changed": true,
     "ic_error_file_changed": false,
     "ic_error_new_object": true
    },
    "ic_list": [{
      "id": "63aa73d3-7433-43da-9143-a3481113fd64",
      "name": "Default",
      "path": "C:\\Program Files\\OpenLDAP",
      "mask": "*",
      "recursive": true
    }, {
      "id": "977e18cf-5217-41b0-95c3-0ceb297a86ec",
      "name": "Default",
      "path": "C:\\ProgramData\\OpenLDAP\\openldap\\slapd.conf",
      "mask": "*",
      "recursive": true
     }
    ],
    "ic_exclude_list": []
 }
}
Описание полей JSON-ответа
Поле Описание
id

Идентификатор группы контроля целостности.

Совпадает с именем зашифрованного файла в папке C:\Program Files\Automiq\Alpha.Security\IC.

name

Название группы контроля целостности.

Устаревшие настройки, автоматически преобразованные в новый формат, всегда сохраняются в группу с именем legacy.

description Описание группы.
active

Активность группы.

options

Настройки проверок для группы.

Описаны в виде следующих свойств:

  • ic_execution_period – таймер автоматической проверки, значение указано в секундах;
  • ic_error_log_max – определяет максимальное количество сообщений об ошибках контроля целостности, выводимых в аудит и системный журнал сообщений. Если значение 0, то вывод сообщений об ошибках контроля файлов отключен.

Следующие свойства определяют серьезность нарушений. Если для отдельного параметра указано значение true, то нарушение данного типа считается ошибкой, если false – нарушение данного типа считается предупреждением:

  • ic_error_object_not_exist – определяет серьёзность нарушения "Объект не существует";
  • ic_error_date_changed – определяет серьёзность нарушения "Изменилась дата объекта";
  • ic_error_file_changed – определяет серьёзность нарушения "Изменилось содержимое файла";
  • ic_error_new_object – определяет серьёзность нарушения "Обнаружен новый объект".
ic_list

Список контролируемых объектов и настройки. Представлен в виде массива JSON-объектов.

Каждый контролируемый объект (файл или папка) описан в виде JSON-объекта со следующими свойствами:

  • id – идентификатор контролируемого объекта;
  • name – название объекта;
  • path – полный путь к контролируемому объекту;
  • mask – настройка фильтрации объектов, вложенных в контролируемый объект (если указано *, значит, контролируется целостность для всех вложенных объектов, в противном случае контролируются только объекты с указанным расширением);
  • recursive – настройка контроля целостности для папок (если указано false, контроль целостности выполняется только для самой папки, если true – контролируется целостность и вложенных в нее объектов).
ic_exclude_list

Список объектов, исключенных из контроля целостности. Представлен в виде массива JSON-объектов.

Каждый исключенный из контроля целостности объект (файл или папка) описан в виде JSON-объекта со следующими свойствами:

  • id – идентификатор исключенного объекта;
  • name – название исключенного объекта;
  • path – полный путь к исключенному объекту.

Add

В результате выполнения данного запроса агенту будет отправлена команда на создание новой группы контроля целостности.

Если группа будет создана успешно, агент автоматически присвоит ей идентификатор и название Default, и предоставит эти данные в качестве ответа. Затем можно будет переименовать группу и записать в нее настройки контроля целостности с помощью команды Update.

Пример запроса:

{
 "object": "ic_api/ic_config/ic_group",
 "command": "Add"
}

Пример ответа:

{
 "result": {
  "id": "55369ec7-226d-48f5-a98c-6ca36597b323",
  "name": "Default"
 }
}
Описание полей JSON-ответа
Поле Описание
id

Идентификатор новой группы контроля целостности.

Совпадает с именем зашифрованного файла в папке C:\Program Files\Automiq\Alpha.Security\IC.

name

Название группы контроля целостности.

По умолчанию новой группе всегда присваивается имя Default.

Update

В результате выполнения данного запроса будет обновлена конфигурация для всех указанных групп контроля целостности. Для этой команды в качестве значения параметра команды нужно указать массив JSON-объектов, описывающих обновленную конфигурацию подлежащих обновлению групп.

Если команда не будет выполнена, агент безопасности отправить уведомление об этом.

Пример запроса:

{
 "command": "Update",
 "object": "ic_api/ic_config/ic_group",
 "params": [{
    "id": "55369ec7-226d-48f5-a98c-6ca36597b323",
    "name": "MyGroup",
    "description": "",
    "active": false,
    "options": {
     "ic_execution_period": 60,
     "ic_error_log_max": 0,
     "ic_error_object_not_exist": true,
     "ic_error_date_changed": true,
     "ic_error_file_changed": true,
     "ic_error_new_object": true
    },
    "ic_list": [{
      "id": "63aa73d3-7433-43da-9143-a3481113fd64",
      "name": "Default",
      "path": "C:\\Program Files\\OpenLDAP",
      "mask": "*",
      "recursive": true
     }
    ],
    "ic_exclude_list": []
 }]
}

Убедиться, что конфигурация контроля целостности обновлена успешно, можно с помощью отправки команды Fetch.

Описание параметров запроса
Параметр Что нужно указать
id

Идентификатор группы контроля целостности, подлежащей обновлению.

Совпадает с именем зашифрованного файла в папке C:\Program Files\Automiq\Alpha.Security\IC.

name

Название группы контроля целостности. Можно указать новое значение.

description Описание группы. Можно указать новое значение.
active

Активность группы. Можно указать новое значение.

Из нескольких групп активна может быть только одна. Если при обновлении были переданы конфигурации нескольких активных групп, то после обработки запроса активной группой останется только последняя.

options

Настройки проверок для группы.

Укажите значения свойств:

  • ic_execution_period – таймер автоматической проверки, значение указывается в секундах;
  • ic_error_log_max – определяет максимальное количество сообщений об ошибках контроля целостности, выводимых в аудит и системный журнал сообщений. Если указать в качестве значения 0, то вывод сообщений об ошибках контроля файлов будет отключен.

Следующие свойства определяют серьезность нарушений. Если для отдельного параметра указать значение true, то нарушение данного типа будет считаться ошибкой, если указать false – нарушение данного типа будет считаться предупреждением:

  • ic_error_object_not_exist – определяет серьёзность нарушения "Объект не существует";
  • ic_error_date_changed – определяет серьёзность нарушения "Изменилась дата объекта";
  • ic_error_file_changed – определяет серьёзность нарушения "Изменилось содержимое файла";
  • ic_error_new_object – определяет серьёзность нарушения "Обнаружен новый объект".
ic_list

Список контролируемых объектов и настройки. Должен быть представлен в виде массива JSON-объектов.

Каждый контролируемый объект (файл или папку) нужно описать в виде JSON-объекта со следующими свойствами:

  • id – идентификатор контролируемого объекта (можно не указывать либо указать любой, если файл описывается в текущей группе впервые);
  • name – название объекта;
  • path – полный путь к контролируемому объекту;
  • mask – настройка фильтрации объектов, вложенных в контролируемый объект (можно указать *, контроль целостности будет выполняться для всех вложенных объектов; либо указать маску, например, расширение файлов, которые должны быть проконтролированы, в формате "*.exe");
  • recursive – настройка контроля целостности для папок (если указать false, контроль целостности будет выполняться только для самой папки, если true – будет контролироваться целостность и вложенных в нее объектов).
ic_exclude_list

Список объектов, которые должны быть исключены из контроля целостности. Должен быть представлен в виде массива JSON-объектов.

Каждый исключенный из контроля целостности объект (файл или папка) нужно описать в виде JSON-объекта со следующими свойствами:

  • id – идентификатор исключаемого объекта;
  • name – название исключаемого объекта;
  • path – полный путь к исключаемому объекту.

Delete

В результате выполнения данного запроса агенту будет отправлена команда на удаление группы контроля целостности. Для этой команды нужно указать обязательный параметр ic_groupId, в качестве значения параметра указать идентификатор группы.

Если команда не будет выполнена, агент безопасности отправить уведомление об этом.

Пример запроса:

{
 "object": "ic_api/ic_config/ic_group",
 "command": "Delete",
 "params": {
  "ic_groupId":"55369ec7-226d-48f5-a98c-6ca36597b323"
 }
}

Убедиться, что конфигурация контроля целостности обновлена успешно, можно с помощью отправки команды Fetch.