Alpha.Community

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

Контроль целостности файлов и папок

В разделе описано, как получать информацию о текущей конфигурации контроля целостности, а также об изменениях в контролируемых файлах и папках с помощью компонентов расширения Alpha.HMI.Security.

Для наглядности к разделу приложен проект-пример. Скачайте архив с проектом-примером IntegrityControl.hmi и откройте его в Дизайнер Alpha.HMI.

Состав проекта-примера

Единственная форма в проекте – IntegrityControl. На ней размещены:

Назначение проекта-примера

Проект-пример в режиме рантайма представляет собой приложение, позволяющее:

  • по нажатию кнопки Получить текущую конфигурацию IC получить файл, содержащий настройки активной конфигурации контроля целостности в виде JSON-строки (подробнее об этом – ниже);
  • по нажатию кнопки Создать эталон создать срез текущего состояния контролируемых файлов, который будет считаться эталоном, и с которым будет сравниваться будущее состояние файлов при проверках;
  • по нажатию кнопки Проверка целостности выполнить проверку целостности (сравнить текущее состояние контролируемых файлов с эталонным);
  • по нажатию кнопки Получить результат проверки получить сообщения о состоянии каждого контролируемого файла.

Что представляет собой конфигурация контроля целостности

По умолчанию контроль целостности включен и выполняется для некоторых системных файлов и папок. Информация о том, целостность каких файлов и папок контролируется, с какой периодичностью и т.п., называется конфигурацией контроля целостности, и хранится в папке C:\Program Files\Automiq\Alpha.Security\IC в виде зашифрованных файлов. Каждый файл представляет собой определенный набор настроек контроля целостности и называется группой контроля целостности. Агент безопасности может хранить несколько групп одновременно, однако активна может быть только одна из них.

Alpha.Security версии 1.7.24 и новее при установке автоматически преобразовывает разработанную в более ранних версиях конфигурацию контроля целостности в новый формат. Ранее конфигурация представляла собой файл alpha.security.ic.xml, который располагался в папке на уровень выше.

Преобразованная конфигурация представляет собой группу с именем legacy. Подробнее о том, как получить имя и другие параметры групп, описано ниже и в разделе Настройка безопасности: Контроль целостности (SecurityIntegrityControl) справочного руководства.

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

Чтобы получить текущую конфигурацию контроля целостности, следует отправить JSON-запрос агенту безопасности. Ознакомьтесь с кодом обработчика события ButtonPressed кнопки ButtonFetch, написанным на языке JavaScript:

const request = {
 "object": "ic_api/ic_config/ic_group",
 "command": "Fetch",
};
SecurityIntegrityControl.JsonRequest(JSON.stringify(request));

Здесь приложение с помощью экземпляра SecurityIntegrityControl типа Настройка безопасности: Контроль целостности отправляет агенту безопасности запрос JsonRequest() с командой Fetch, служащей для получения конфигураций всех групп контроля целостности, хранимых агентом безопасности. Подробнее с принципами построения запроса и командами можно ознакомиться в разделе Настройка безопасности: Контроль целостности (SecurityIntegrityControl) справочного руководства.

Компонент позволяет не только получать, но и менять настройки контроля целостности с помощью JSON-запросов. Так, например, чтобы добавить новую группу контроля целостности, следует сначала отправить запрос с командой Add, затем с помощью запроса с командой Fetch получить ID созданной группы, а затем записать настройки контроля целостности в добавленную группу с помощью запроса с командой Update.

В результате выполнения запроса ответ будет отправлен в переменную response события JsonRequestComplete экземпляра SecurityIntegrityControl типа Настройка безопасности: Контроль целостности. Пример ответа приведен в разделе Настройка безопасности: Контроль целостности (SecurityIntegrityControl) справочного руководства. При получении ответа приложение:

  • запишет этот ответ в текстовый файл response.txt, который создаст в папке проекта-примера;
  • отобразит информацию об активной группе контроля целостности (той конфигурации, которая используется агентом для контроля целостности в данный момент) в окне приложения.

Ознакомьтесь с кодом обработчика события JsonRequestComplete экземпляра SecurityIntegrityControl, написанным на языке JavaScript:

// ответ на запрос записывается в файл response.txt в папке проекта
var filePath = FileSystem.CombinePath(FileSystem.ProjectFolder, "response.txt");
FileSystem.WriteTextFile(filePath,response);
// разбираем ответ с помощью функции parse
const parsedResponse = JSON.parse(response);
// определяем активную группу и помещаем ее название и ID в текстовое поле на форме
var group = parsedResponse.result.ic_group;
for (let i = 0; i < group.length; i++) {
 let groupid = group[i].id;
 let groupname = group[i].name;
 let activity = group[i].active;
 if (activity) {
  Text_SysMsg.Text = "Группа: "+JSON.stringify(groupname)+", ID группы:"+JSON.stringify(groupid);
 }
}

Создание эталона состояния файлов

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

Чтобы создать эталон, следует вызвать функцию CreateEtalon() экземпляра типа Настройка безопасности: Контроль целостности, указав в качестве входного параметра название сервера, на котором нужно создать эталон. В рассматриваемом проекте-примере такая функция вызывается по нажатию кнопки Button_Create, в качестве входного параметра указана пустая строка (""), т.к. эталон должен быть создан локально.

В результате вызова функции активируется одно из двух событий экземпляра типа Настройка безопасности: Контроль целостности:

  • CreateEtalonComplete в случае успешного создания эталона;
  • CreateEtalonFailed в случае возникновения ошибки.

Ознакомьтесь с кодами обработчиков этих событий.

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

Чтобы запустить проверку целостности файлов, следует вызвать функцию CheckFiles() экземпляра типа Настройка безопасности: Контроль целостности, указав в качестве входного параметра название сервера, на котором нужно выполнить проверку. В рассматриваемом проекте-примере такая функция вызывается по нажатию кнопки Button_Update, в качестве входного параметра указана пустая строка (""), т.к. проверка должна быть выполнена локально.

В результате вызова функции активируется одно из двух событий экземпляра типа Настройка безопасности: Контроль целостности:

  • CheckComplete в случае успешного запуска проверки;
  • CheckFailed в случае возникновения ошибки.

Ознакомьтесь с кодами обработчиков этих событий.

Получение результатов проверки

Чтобы получить результаты последней проверки целостности файлов, следует вызвать функцию GetResults() экземпляра типа Настройка безопасности: Контроль целостности, указав в качестве входного параметра название сервера, с которого нужно получить результаты проверки. В рассматриваемом проекте-примере такая функция вызывается по нажатию кнопки Button_GetResult, в качестве входного параметра указана пустая строка (""), т.к. нужно получить результаты локальной проверки.

В результате вызова функции активируется одно из двух событий экземпляра типа Настройка безопасности: Контроль целостности:

  • GetResultsComplete в случае успешного получения результатов проверки;
  • GetResultsFailed в случае возникновения ошибки.

Результат последней проверки целостности будет записан в переменную IC_List_JSON события GetResultsComplete экземпляра SecurityIntegrityControl типа Настройка безопасности: Контроль целостности. При этом приложение отобразит информацию о состоянии каждого контролируемого объекта в окне приложения исходя из значения параметра status для этого объекта. Ознакомьтесь с кодом обработчика события GetResultsComplete экземпляра SecurityIntegrityControl, написанным на языке JavaScript:

// разбираем ответ с помощью функции parse
var IClst = JSON.parse(IC_List_JSON);
// формируем сообщения о состоянии первых 10 файлов* на основе значения параметра status
// *для ускорения работы проекта-примера
for (var i = 0; i < 10; i++)
 {
 if (IClst.data[i] != undefined)
 {
  // проверка состояния файла: файл не был изменен
  if (IClst.data[i].status == 0)
  {
   Text_SysMsg.Text += "Файл "+IClst.data[i].name+" не был изменен"+"\n";
   SecurityContext.LogAudit("Файл "+IClst.data[i].name+" не был изменен.",1);
  }
  // проверка состояния файла: не была ли нарушена целостность
  if (IClst.data[i].status == 8)
  {
   Text_SysMsg.Text += "Файл "+IClst.data[i].name+" был изменен"+"\n";
   SecurityContext.LogAudit("Файл "+IClst.data[i].name+" был изменен.",1)
  }
  // проверка наличия файла
  if (IClst.data[i].status == 4)
  {
   Text_SysMsg.Text += "Файл "+IClst.data[i].name+" был удален или перемещен"+"\n";
   SecurityContext.LogAudit("Файл "+IClst.data[i].name+" был удален или перемещен.",1)
  }
 }
 else Text_SysMsg.Text = "Текущее состояние файлов не отличается от эталонного";
}

Получение и расшифровка сообщений от агента безопасности

Сообщения о выполнении проверки целостности файлов можно получать в другие приложения. Например, в EventLogViewer сообщения приходят автоматически после включения контроля целостности в настройках Агент Alpha.Security. Сообщения имеют следующий вид:

Проверено XXX / YYY объектов. Обнаружено нарушений AA, ошибок A1, предупреждений A2. Скрыто эталоном BB.

Здесь:

  • XXX – количество файлов, которые записаны в эталон. Это число постоянно, если эталон не пересоздавать.
  • YYY – фактическое количество файлов в подконтрольных папках. Контроль целостности выполняется для всех этих файлов, из которых только XXX записаны в эталон.
  • AA – общее количество нарушений. Среди них:
    • A1 – количество нарушений, считающихся ошибками.
    • A2 – количество нарушений, считающихся предупреждениями.
  • BB – количество файлов, к которым не удалось получить доступ на момент создания эталона. Не входят в общую статистику ошибок.