В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.
-
Альфа платформа (ред. 26)
-
Лицензирование Альфа платформы
-
Ключи Guardant
-
Ключи Sentinel
-
-
Правила брандмауэра
-
Настройка DCOM
-
Работа в ОС Linux
-
Alpha.Server 6.5 (ред. 2. Предварительная)
-
Alpha.Server
-
Основные механизмы
-
Приложения
-
Модули
-
Коммуникационные модули
-
Link
-
TCP Сервер
-
-
Modbus
-
Modbus RTU Опросчик
-
Настройка обмена данными со станцией
-
Modbus RTU Станция
-
Modbus TCP Опросчик
-
Modbus TCP Станция
-
-
OPC
-
OPC AE Сервер
-
Функциональные возможности
-
OPC DA
-
OPC DA Клиент
-
OPC DA Сервер
-
-
OPC HDA
-
OPC HDA Клиент
-
OPC HDA Сервер
-
-
OPC UA
-
OPC UA Клиент
-
Настройка обмена данными с OPC UA сервером
-
Установка безопасного соединения
-
Приложения
-
OPC UA Сервер
-
Сертификаты
-
Приложения
-
-
-
МЭК 60870-5
-
МЭК 60870-5-101 Опросчик
-
Приложения
-
МЭК 60870-5-101 Станция
-
МЭК 60870-5-104 Опросчик
-
МЭК 60870-5-104 Станция
-
-
Универсальный модуль Опросчик (Меркурий, DCON)
-
МЭК 61850 Клиент
-
Обмен данными с устройствами
-
Набор данных устройства и сигналы сервера
-
ПОРТАЛ Клиент
-
Настройка обмена данными с ППД
-
ТЭМ-104
-
Приложения
-
BACnet Клиент
-
Настройка обмена данными с устройством
-
Приложения
-
EtherNet/IP Сканер
-
Приложения
-
FINS Клиент
-
Настройка обмена данными с ПЛК
-
MDLC Клиент
-
Настройка обмена данными с устройством MDLC
-
MQTT Клиент
-
Настройка обмена данными
-
Siemens S7 Клиент
-
Настройка обмена данными с ПЛК
-
Приложения
-
SNMP Менеджер
-
SQL Клиент
-
Настройка обмена данными с источником
-
Приложения
-
UNET Клиент
-
-
Служебные модули
-
Клиент безопасности
-
Получение значений из Alpha.Security
-
Модуль вычислений
-
Модуль истории
-
Приложения
-
Подсистема резервирования
-
Data Buffer
-
NetDiag, NetDiag2
-
Приложения
-
ProcessMonitor
-
SMTP
-
Snapshot
-
Запись данных в файл-срез
-
Модули Syslog
-
Syslog Клиент
-
Syslog Сервер
-
Приложения
-
Приложения
-
-
Write VQT
-
FS Generator
-
-
-
Сервисные приложения
-
Конфигуратор
-
Статистика
-
Просмотрщик лога кадров
-
-
Alpha.AccessPoint 6.5 (ред. 2. Предварительная)
-
Alpha.Imitator 6.5 (ред. 2. Предварительная)
-
Приложения
-
Alpha.Historian 4.0 (ред. 3. Предварительная)
-
Устройство и принципы работы
-
Управление базами данных
-
Общие
-
4x
-
3x
-
-
Устаревшие разделы
-
Справочник
-
Настройки базы данных
-
Alpha.Domain 1.5 (ред. 1)
-
Принципы настройки подсистемы
-
Приложения
-
Alpha.DevStudio 4.2 (ред. 4. Предварительная)
-
Руководство пользователя
-
Знакомство с Alpha.DevStudio
-
Разработка проекта
-
Описание домена
-
Добавление компонентов домена
-
-
Добавление объектов
-
Описание объектов
-
Добавление атрибутов
-
-
Пользовательский интерфейс
-
Инструменты
-
Редакторы
-
-
Интерфейс командной строки
-
Справочник
-
Элементы
-
Автоматизация
-
ВНИИАЭС
-
Карты адресов
-
Коммуникационные модули
-
-
Гидроуклон
-
Служебные модули
-
-
Инконтрол
-
Инконтрол
-
-
Контроллеры Modicon
-
Modbus
-
Контроллеры
-
-
Контроллеры OMRON
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Контроллеры REGUL
-
Modbus
-
OPC
-
Контроллеры
-
МЭК 60870-5
-
-
Контроллеры SIMATIC
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Контроллеры ТРЭИ
-
Modbus
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Обобщенные устройства
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Общие элементы
-
Последовательная шина
-
Устройства
-
-
Программируемые логические контроллеры
-
Modbus
-
OPC
-
Контроллеры
-
-
Развёртывание
-
Компьютеры
-
Устройства
-
-
Связи
-
Ссылки
-
-
Сервер истории
-
Сети BACnet
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети CANopen
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети EtherNet/IP
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети Ethernet
-
Сети KNX
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
Устройства
-
-
Сети Link
-
Link
-
Карты адресов
-
-
Сети MDLC
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети MQTT
-
Карты адресов
-
Коммуникационные модули
-
-
Сети Modbus
-
Modbus
-
Карты адресов
-
-
Сети NFL
-
Карты адресов
-
Коммуникационные модули
-
-
Сети OPC
-
OPC
-
Карты адресов
-
-
Сети SMTP
-
Карты адресов
-
Служебные модули
-
-
Сети SNMP
-
Карты адресов
-
-
Сети SQL
-
Карты адресов
-
Коммуникационные модули
-
-
Сети Syslog
-
Карты адресов
-
Служебные модули
-
-
Сети МЭК 60870-5
-
Карты адресов
-
МЭК 60870-5
-
-
Сети МЭК 61850
-
Карты адресов
-
Устройства
-
-
ТПТС-НТ
-
Инконтрол
-
Контроллеры
-
-
Теплосчетчики ТЭМ
-
Карты адресов
-
Коммуникационные модули
-
Устройства
-
-
Уровень управления
-
Вычисления
-
-
Файловый обмен
-
Физический уровень
-
Элементы HMI
-
Элементы сервера
-
Карты адресов
-
Коммуникационные модули
-
Коммуникационные модули\Link
-
Коммуникационные модули\Modbus
-
Коммуникационные модули\OPC
-
Коммуникационные модули\МЭК 60870-5
-
Настройки по умолчанию
-
Служебные модули
-
-
-
Атрибуты
-
Om.BACnet
-
Om.CANopen
-
Om.EtherNetIP
-
Om.GenericDevices
-
Om.HMI
-
Om.Hydroslope
-
Om.IEC60870
-
Om.KNX
-
Om.MDLC
-
Om.MQTT
-
Om.OPC
-
Om.PLC
-
Om.Server
-
Om.System
-
-
-
Alpha.Security 1.7 (ред. 18)
-
LDAP-сервер и его настройка
-
Редактирование конфигурации на LDAP-сервере с помощью SecurityConfigurator
-
Приложения
-
Alpha.Om 1.4 (ред. 6. Предварительная)
-
Функции
-
Математические функции
-
Строковые функции
-
Функции обработки времени
-
Функции типа variant
-
-
Приложения
-
Alpha.HMI 2.0 (ред. 31. Предварительная)
-
Руководство пользователя
-
О продукте
-
Основные этапы работы с проектом
-
Запуск дизайнера
-
Запуск на исполнение
-
-
Разработка мнемосхем
-
Экранные формы
-
Компоненты
-
Графические примитивы
-
Готовые компоненты
-
-
Действия с объектами и экранными формами
-
Просмотр характеристик
-
Свойства объектов
-
Свойства в рантайме
-
Обработчики событий
-
Функции объектов
-
-
Заливка градиентом
-
Демонстрационный проект Резервуарный парк
-
-
Источники данных
-
OPC DA
-
TCP
-
Получение событий
-
-
Взаимодействие с окружением проекта
-
Приложения
-
Справочное руководство
-
Компоненты для работы с данными
-
Источник OPC
-
Элемент OPC
-
Источник AP
-
Элемент AP
-
Учетные данные АР
-
Браузер источника АР
-
Запрос алармов
-
Менеджер алармов
-
Запрос значений элемента AP
-
Запрос значений множества сигналов АР
-
Запрос значений сигналов АР
-
Очередь активных алармов
-
-
Компоненты окружения
-
Окружение: архиватор
-
Окружение: группа окон
-
Окружение: окно
-
Окружение: сеть
-
Окружение: файлы
-
Окружение: ошибка работы с файлами
-
Окружение: система
-
Окружение: запрос системного журнала
-
Окружение: браузер файлов
-
Окружение: процесс
-
Окружение: этот процесс
-
Окружение: переменные среды процесса
-
Текстовый файл
-
Оборудование: клавиатура
-
Оборудование: монитор
-
Снимок экрана
-
-
Компоненты для предоставления сервисных функций
-
Статистика: браузер
-
Статистика: JSON-браузер
-
Статистика: узел
-
Статистика: источник данных
-
-
Данные: агрегатор
-
Компоненты печати
-
Печать
-
Принтер
-
Системные принтеры
-
Размеры страницы
-
-
Компоненты для выполнения SQL-запросов
-
Источник SQL
-
Запрос источника SQL
-
Запрос SQL
-
-
Компоненты разметки
-
Линейная разметка
-
Плоская разметка
-
Вес элемента разметки
-
Ограничение размеров элемента разметки
-
Сворачивание элемента разметки
-
Выравнивание элемента разметки
-
Отступы элемента разметки
-
-
Графические компоненты
-
Линейный градиент
-
Радиальный градиент
-
Соединительная линия
-
Место соединения
-
Линия
-
Кривая линия
-
Прямоугольник
-
Эллипс
-
Изображение
-
Точка трансформации
-
-
Компоненты для построения пользовательского интерфейса
-
Индикатор гистограммы
-
Всплывающая подсказка
-
Уведомление
-
Перемещение
-
Кнопка
-
Курсор
-
Глобальный курсор
-
Полоса прокрутки
-
Панель вкладок
-
Системная кнопка
-
Флажок
-
Текст
-
Расширенный текст
-
Поле ввода
-
Редактор текста
-
Индикатор прогресса
-
Ползунок
-
Выпадающий список
-
Фрейм
-
-
Встраиваемые компоненты
-
Alpha.Alarms
-
Свойства
-
Функции
-
События
-
-
Alpha.Trends
-
Свойства
-
Функции
-
События
-
-
-
Компоненты для проверки ввода и преобразования форматов
-
Входной формат
-
Выходной формат
-
Формат булевского значения
-
Формат даты/времени
-
Формат числа с плавающей запятой
-
Проверка ввода
-
Проверка ввода целого числа
-
Проверка ввода беззнакового целого числа
-
Проверка ввода числа с плавающей запятой
-
Проверка ввода регулярного выражения
-
-
Компоненты периодичного выполнения
-
Таймер
-
Мигание
-
Команда
-
Звук
-
Инициализатор
-
Сессия
-
-
Буфер обмена
-
Веб содержимое
-
Компоненты для работы с графиками
-
График: данные
-
График: декоратор линии
-
График: линия
-
График: ось
-
График: поле графика
-
График: реперная линия
-
График: точка пересечения
-
График: экспорт
-
-
Компоненты для формирования древовидной структуры
-
Дерево
-
Источник данных дерева
-
Колонка дерева
-
-
Экранные формы
-
Средство отладки
-
Менеджер проекта
-
Среда исполнения
-
-
Alpha.HMI.WebViewer 2.0 (ред. 31. Предварительная)
-
О продукте
-
-
Alpha.HMI - дополнительные модули
-
Alpha.HMI.Security 2.0 (ред. 15)
-
Руководство пользователя
-
Справочное руководство
-
Контекст безопасности (SecurityContext)
-
Список пользователей (UserList)
-
Настройка безопасности: Контроль целостности (SecurityIntegrityControl)
-
Числовой элемент безопасности (NumericTokenProxy)
-
Строковый элемент безопасности (StringTokenProxy)
-
Булевский элемент безопасности (BoolTokenProxy)
-
Настройка безопасности: Менеджер (SecurityManager)
-
Настройка безопасности: Приложение (SecurityManagerApplication)
-
Настройка безопасности: Пользователь (SecurityManagerUser)
-
Настройка безопасности: Группа (SecurityManagerGroup)
-
Мастер конфигурирования Security (Configurator)
-
Информация лицензирования: Получение (LicenseInfo)
-
-
-
Alpha.HMI.Tables 2.1 (ред. 1)
-
Построение таблицы модели данных
-
Справочник API
-
Таблицы
-
Таблица
-
Свойства
-
Функции
-
События
-
-
Таблица: декоратор
-
Свойства
-
-
Таблица: итератор
-
Свойства
-
Функции
-
-
Таблица: модель данных
-
Свойства
-
Функции
-
События
-
-
Таблица: столбец
-
Свойства
-
Функции
-
События
-
-
Таблица: устойчивый итератор
-
Функции
-
-
-
-
-
Alpha.HMI - библиотеки
-
Alpha.HMI.CommonLib 3.0 (ред. 2)
-
Руководство пользователя
-
Примеры использования компонентов расширения
-
Справочное руководство
-
Типы
-
Тема оформления
-
Конвертер значений
-
Утилиты для работы со строками
-
Утилиты для работы с окном
-
Утилиты для работы с файлами
-
Информация о продукте
-
Буфер аргументов события
-
Обработчик события
-
Пользовательская команда
-
Текстовые шаблоны
-
Редакторы
-
Редактор целого числа
-
Редактор даты
-
Редактор времени
-
Редактор интервала времени
-
Горизонтальный сплиттер
-
Вертикальный сплиттер
-
Рамка с ошибкой
-
Редактор даты и времени
-
-
Меню
-
Элемент меню
-
Результат выбора меню
-
-
Панель инструментов
-
Кнопка панели инструментов
-
Кнопка выпадающего списка
-
Разделитель панели инструментов
-
Панель поиска
-
Тема оформления панели инструментов
-
-
Строка статуса
-
Кнопка авторизации
-
Кнопка-индикатор журнала сообщений
-
Индикатор подключения к серверу
-
Кнопка вызова экранной клавиатуры
-
Параметры вызова экранной клавиатуры
-
-
Диалоги
-
Результат выбора папки
-
Результат выбора цвета
-
Результат выбора параметров подключения
-
Результат выбора даты и времени
-
Результат ввода значения
-
Результат редактирования колонтитула
-
Результат выбора файла
-
Результат диалога авторизации
-
Список файлов
-
Дерево сигналов
-
Журнал сообщений
-
Редактируемая таблица
-
Редактор ячейки таблицы
-
-
Экранные формы
-
Меню
-
Календарь
-
Сообщение
-
Диалог ввода значения
-
Диалог выбора цвета
-
Диалог подключения к серверу
-
Редактор колонтитула
-
Файлы
-
Диалог открытия файла
-
Диалог сохранения файла
-
Диалог выбора папки
-
-
Безопасность
-
Диалог авторизации пользователя
-
Диалог смены пароля
-
Диалог ввода учетных данных
-
-
Общие свойства компонентов библиотеки
-
-
-
-
Alpha.HMI - приложения
-
Alpha.HMI.AdminConsole 1.0 (ред. 3)
-
Руководство пользователя
-
Справочное руководство
-
Консоль администрирования
-
Инструментальная панель
-
Разрешения
-
AdminConsole_Page
-
-
-
Alpha.HMI.Alarms 3.3 (ред. 1. Предварительная)
-
Руководство пользователя
-
Встраивание в проект
-
Привлечение внимания к важным событиям
-
Квитирование событий
-
Экспорт сообщений в файл
-
Справочное руководство
-
Alarms
-
Свойства
-
Функции
-
-
Alarms_Table
-
Свойства
-
Функции
-
-
Alarms_Sounds
-
Свойства
-
Функции
-
-
EventStatistics
-
Свойства
-
-
Разрешения пользователя
-
Свойства
-
Функции
-
-
-
-
Alpha.HMI.ComtradeViewer 1.1 (ред. 1)
-
Встраивание в проект
-
API
-
ComtradeViewer
-
Свойства
-
Функции
-
-
Разрешения (ComtradeViewer_Permissions)
-
Свойства
-
-
-
Alpha.HMI.Explorer 4.0 (ред. 2)
-
Руководство пользователя
-
Справочное руководство
-
Explorer_Form
-
-
Alpha.HMI.IntegrityControl 2.8 (ред. 1)
-
Руководство пользователя
-
Контроль целостности
-
Справочное руководство
-
IntegrityControl
-
IntegrityConfiguration
-
Разрешения
-
Настройки
-
IntegrityControl_KTN
-
IntegrityControl_Form
-
IntegrityConfiguration_Form
-
-
-
Alpha.HMI.SecurityConfigurator 4.0 (ред. 1)
-
Руководство пользователя
-
Редактирование конфигурации
-
Приложения
-
Справочное руководство
-
SecurityConfigurator
-
Настройки
-
Разрешения
-
SecurityConfigurator_Page
-
SecurityConfigurator_Form
-
-
-
Alpha.HMI.SetPoints 2.5 (ред. 2)
-
Руководство пользователя
-
Приложения
-
Справочное руководство
-
SetPoints
-
SetPoints_Settings
-
Разрешения
-
Тема оформления Уставок
-
SetPoints_Page
-
SetPoints_Form
-
-
-
Alpha.HMI.Statistics 1.2 (ред. 1)
-
Руководство пользователя
-
Справочное руководство
-
Statistics
-
Разрешения
-
Настройки
-
Statistics_Form
-
-
-
Alpha.HMI.SystemLogViewer 2.0 (ред. 1)
-
Руководство пользователя
-
Справочное руководство
-
SystemLogViewer
-
Разрешения
-
Тема оформления Журнала событий
-
SystemLogViewer_Form
-
-
-
Alpha.HMI.Trends 2.4 (ред. 1. Предварительная)
-
Руководство пользователя
-
Встраивание в проект
-
Сохранение и загрузка данных
-
Справочное руководство
-
Свойства
-
Функции
-
-
-
-
Alpha.Alarms 3.30 (ред. 1)
-
Варианты запуска
-
Начало работы
-
Аспекты безопасности
-
Просмотр оперативных событий
-
Подавление и блокирование событий источника/объекта
-
Аналитика событий
-
Фильтрация сообщений о событиях
-
Дополнительные возможности
-
Работа со встраиваемым компонентом
-
Alarms-API
-
Свойства
-
Функции
-
События
-
-
-
Alpha.Trends 3.33 (ред. 3. Предварительная)
-
Начало работы
-
Просмотр значений сигналов
-
Аналитика графиков
-
Использование реперных линий
-
Вертикальные реперы
-
-
Вспомогательные функции
-
Работа со встраиваемым компонентом Alpha.Trends
-
Свойства
-
Функции
-
События
-
-
Alpha.Tools 1.6 (ред. 8)
-
EventLogViewer
-
Приложения
-
OpcExplorer
-
Настройка и подключение к источнику данных
-
Просмотр адресного пространства
-
Приложения
-
-
Alpha.RMap 1.7 (ред. 2)
-
Приложения
-
Установка и настройка
-
-
Alpha.Diagnostics 2.2
-
Alpha.AuditReport
-
Настройка Alpha.AuditReport
-
Alpha.SystemMonitor
-
Интерфейс
-
Настройка
-
Alpha.Hashcheck
-
Настройка конфигурации
-
Alpha.NTPClient
-
Alpha.Utilities
-
Приложения
-
Alpha.Reports 1.1 (ред. 18)
-
Руководство администратора
-
Приложения
-
Конфигуратор
-
Конструктор отчётов
-
Описание интерфейса и функций программы
-
Приложения
-
Поддерживаемые функции
-
Текстовые
-
Числовые
-
Математические
-
Информационные
-
Логические
-
Поиск и ссылки
-
Дата и время
-
База данных
-
Финансовые
-
-
-
Библиотека
-
Функции библиотеки
-
Приложения
-
Просмотр отчётов
-
-
Alpha.SmartControl 9.3 (ред. 1)
-
Администрирование
-
Отчеты
-
Бланки переключений
-
Специальные возможности
Контроль целостности файлов и папок
В разделе описано, как получать информацию о текущей конфигурации контроля целостности, а также об изменениях в контролируемых файлах и папках с помощью компонентов расширения Alpha.HMI.Security.
Для наглядности к разделу приложен проект-пример. Скачайте архив с проектом-примером IntegrityControl.hmi и откройте его в Дизайнер Alpha.HMI.
Состав проекта-примера
Единственная форма в проекте – IntegrityControl. На ней размещены:
- экземпляры типов Контекст безопасности (SecurityContext) и Настройка безопасности: Контроль целостности (SecurityIntegrityControl); первый служит для взаимодействия с агентом безопасности, второй – для получения и изменения текущих настроек контроля целостности, а также для создания эталонов, запуска проверок целостности и получения их результатов.
- вспомогательные компоненты – кнопки, текстовое поле, компонент для работы с файлами.
Назначение проекта-примера
Проект-пример в режиме рантайма представляет собой приложение, позволяющее:
- по нажатию кнопки Получить текущую конфигурацию IC получить файл, содержащий настройки активной конфигурации контроля целостности в виде JSON-строки (подробнее об этом – ниже);
- по нажатию кнопки Создать эталон создать срез текущего состояния контролируемых файлов, который будет считаться эталоном, и с которым будет сравниваться будущее состояние файлов при проверках;
- по нажатию кнопки Проверка целостности выполнить проверку целостности (сравнить текущее состояние контролируемых файлов с эталонным);
- по нажатию кнопки Получить результат проверки получить сообщения о состоянии каждого контролируемого файла.
Что представляет собой конфигурация контроля целостности
По умолчанию контроль целостности включен и выполняется для некоторых системных файлов и папок. Информация о том, целостность каких файлов и папок контролируется, с какой периодичностью и т.п., называется конфигурацией контроля целостности, и хранится в папке
Alpha.Security версии 1.7.24 и новее при установке автоматически преобразовывает разработанную в более ранних версиях конфигурацию контроля целостности в новый формат. Ранее конфигурация представляла собой файл alpha.security.ic.
Преобразованная конфигурация представляет собой группу с именем 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 – количество файлов, к которым не удалось получить доступ на момент создания эталона. Не входят в общую статистику ошибок.