В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.
-
Альфа платформа (ред. 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)
-
Администрирование
-
Отчеты
-
Бланки переключений
-
Специальные возможности
Настройка безопасности: Контроль целостности (SecurityIntegrityControl)
Подсистема безопасности Alpha.Security позволяет контролировать целостность указанных файлов и папок. На основе контрольной суммы файлов и папок создается эталон состояния. Когда необходимо проверить их целостность, считается текущая контрольная сумма и сравнивается с эталонным значением.
Компонент Настройка безопасности: Контроль целостности предназначен для:
- запроса текущей конфигурации контроля целостности и ее изменения;
- создания эталона состояния файлов и папок;
- выполнения проверок состояния файлов и папок;
- получения информации об изменениях в файлах и папках.
Пример использования компонента в проекте описан в разделе Контроль целостности файлов и папок.
Получение текущей конфигурации контроля целостности
Чтобы получить какую-либо информацию о группах контроля целостности, необходимо:
- Добавить экземпляр Настройка безопасности: Контроль целостности на форму.
- Отправить JSON-запрос агенту безопасности, вызвав функцию компонента JsonRequest() (или JsonRemoteRequest(), если запрос отправляется на удаленную рабочую станцию). В качестве входного параметра функции указать JSON-запрос. Шаблоны JSON-запросов приведены ниже.
- В обработчике событий 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-ответов
Ниже приведены примеры запросов к агенту безопасности и его ответов.
В результате выполнения данного запроса будет получена 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"
}
]
}
}
| Поле | Описание |
|---|---|
ic_group
|
JSON-объект Представляет собой массив JSON-объектов, каждый из которых описывает конкретную группу контроля целостности. Свойства этих объектов описаны в этой таблице далее. |
id
|
Идентификатор конкретной группы контроля целостности. Совпадает с именем зашифрованного файла в папке |
name
|
Название группы контроля целостности. Устаревшие настройки, автоматически преобразованные в новый формат, всегда сохраняются в группу с именем legacy. |
В результате выполнения данного запроса будет получена 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": []
}
]
}
}
| Поле | Описание |
|---|---|
ic_group
|
JSON-объект Представляет собой массив JSON-объектов, каждый из которых описывает конкретную группу контроля целостности. Свойства этих объектов описаны в этой таблице далее. |
id
|
Идентификатор конкретной группы контроля целостности. Совпадает с именем зашифрованного файла в папке |
name
|
Название группы контроля целостности. Устаревшие настройки, автоматически преобразованные в новый формат, всегда сохраняются в группу с именем legacy. |
description |
Описание группы. |
active |
Активность группы. Из нескольких групп активна может быть только одна. |
options |
Настройки проверок для конкретной группы. Описаны в виде следующих свойств:
Следующие свойства определяют серьезность нарушений. Если для отдельного параметра указано значение true, то нарушение данного типа считается ошибкой, если false – нарушение данного типа считается предупреждением:
|
ic_list
|
Список контролируемых объектов и настройки. Представлен в виде массива JSON-объектов. Каждый контролируемый объект (файл или папка) описан в виде JSON-объекта со следующими свойствами:
|
ic_exclude_list
|
Список объектов, исключенных из контроля целостности. Представлен в виде массива JSON-объектов. Каждый исключенный из контроля целостности объект (файл или папка) описан в виде JSON-объекта со следующими свойствами:
|
В результате выполнения данного запроса будет получена 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": []
}
}
| Поле | Описание |
|---|---|
id
|
Идентификатор группы контроля целостности. Совпадает с именем зашифрованного файла в папке |
name
|
Название группы контроля целостности. Устаревшие настройки, автоматически преобразованные в новый формат, всегда сохраняются в группу с именем legacy. |
description
|
Описание группы. |
active
|
Активность группы. |
options
|
Настройки проверок для группы. Описаны в виде следующих свойств:
Следующие свойства определяют серьезность нарушений. Если для отдельного параметра указано значение true, то нарушение данного типа считается ошибкой, если false – нарушение данного типа считается предупреждением:
|
ic_list
|
Список контролируемых объектов и настройки. Представлен в виде массива JSON-объектов. Каждый контролируемый объект (файл или папка) описан в виде JSON-объекта со следующими свойствами:
|
ic_exclude_list
|
Список объектов, исключенных из контроля целостности. Представлен в виде массива JSON-объектов. Каждый исключенный из контроля целостности объект (файл или папка) описан в виде JSON-объекта со следующими свойствами:
|
В результате выполнения данного запроса агенту будет отправлена команда на создание новой группы контроля целостности.
Если группа будет создана успешно, агент автоматически присвоит ей идентификатор и название Default, и предоставит эти данные в качестве ответа. Затем можно будет переименовать группу и записать в нее настройки контроля целостности с помощью команды Update.
Пример запроса:
{
"object": "ic_api/ic_config/ic_group",
"command": "Add"
}
Пример ответа:
{
"result": {
"id": "55369ec7-226d-48f5-a98c-6ca36597b323",
"name": "Default"
}
}
| Поле | Описание |
|---|---|
id
|
Идентификатор новой группы контроля целостности. Совпадает с именем зашифрованного файла в папке |
name
|
Название группы контроля целостности. По умолчанию новой группе всегда присваивается имя Default. |
В результате выполнения данного запроса будет обновлена конфигурация для всех указанных групп контроля целостности. Для этой команды в качестве значения параметра команды нужно указать массив 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
|
Идентификатор группы контроля целостности, подлежащей обновлению. Совпадает с именем зашифрованного файла в папке |
name
|
Название группы контроля целостности. Можно указать новое значение. |
description
|
Описание группы. Можно указать новое значение. |
active
|
Активность группы. Можно указать новое значение. Из нескольких групп активна может быть только одна. Если при обновлении были переданы конфигурации нескольких активных групп, то после обработки запроса активной группой останется только последняя. |
options
|
Настройки проверок для группы. Укажите значения свойств:
Следующие свойства определяют серьезность нарушений. Если для отдельного параметра указать значение true, то нарушение данного типа будет считаться ошибкой, если указать false – нарушение данного типа будет считаться предупреждением:
|
ic_list
|
Список контролируемых объектов и настройки. Должен быть представлен в виде массива JSON-объектов. Каждый контролируемый объект (файл или папку) нужно описать в виде JSON-объекта со следующими свойствами:
|
ic_exclude_list
|
Список объектов, которые должны быть исключены из контроля целостности. Должен быть представлен в виде массива JSON-объектов. Каждый исключенный из контроля целостности объект (файл или папка) нужно описать в виде JSON-объекта со следующими свойствами:
|
В результате выполнения данного запроса агенту будет отправлена команда на удаление группы контроля целостности. Для этой команды нужно указать обязательный параметр ic_groupId, в качестве значения параметра указать идентификатор группы.
Если команда не будет выполнена, агент безопасности отправить уведомление об этом.
Пример запроса:
{
"object": "ic_api/ic_config/ic_group",
"command": "Delete",
"params": {
"ic_groupId":"55369ec7-226d-48f5-a98c-6ca36597b323"
}
}
Убедиться, что конфигурация контроля целостности обновлена успешно, можно с помощью отправки команды Fetch.