4.3.1.1.1.1.10.1. Настройка Astra.Security.Agent и редактирование текстов сообщений
Для настройки аудита безопасности и его сообщений следует редактировать конфигурационные файлы astra.security.agent.json и astra.security.agent.xml, расположенные в:
C:\Program Files\AstraRegul\Astra.Security – для ОС Windows;
/opt/AstraRegul/Astra.Security – для ОС Linux.
Редактирование текстов сообщений
Файл astra.security.agent.json хранит тексты сообщений, которые можно редактировать. При формировании текста сообщения можно использовать теги. Теги описаны в начале файла.
Для каждого сообщения указаны параметры, назначение которых описано в таблице ниже.
|
Название параметра
|
Назначение параметра
|
|
name
|
Идентификатор сообщения. Менять нельзя.
|
|
value
|
Текст сообщения.
|
|
type
|
Тип сообщения. Тип служит для пометки сообщений, которые могут быть записаны в один и тот же сигнал Astra.Server. По умолчанию все сообщения имеют тип "Admin" и записываются в один и тот же сигнал, указанный в карте сигналов конфигурационного файла astra.security.agent.xml. Чтобы разные сообщения записывались в разные сигналы, одним сообщениям необходимо указать тип "Admin", а другим – "Normal", а затем в карте сигналов указать эти типы для разных сигналов.
Названия "Admin" и "Normal" можно менять, главное – чтобы новые названия были указаны в обоих конфигурационных файлах.
|
|
severity
|
Категория важности сообщения. Этот параметр служит для разделения всех сообщений на четыре категории важности. Категории описаны в карте важности конфигурационного файла astra.security.agent.xml. По умолчанию для всех сообщений указана категория важности "Info".
|
|
sound
|
Звук, который должен быть воспроизведен при наступлении события, о котором говорится в сообщении. Формат значения – имя и расширение файла звука. Файл звука должен находиться в папке проекта, посредством которого просматриваются события, например, Astra.HMI.Alarms.
|
|
ackrequired
|
Необходимость квитирования события, о котором говорится в сообщении. Если необходимо квитировать событие, укажите значение "1", если нет – "0".
|
По умолчанию сообщение описано следующим образом:
{"name":"AUDIT_ADD_USER", "value":"На '%arm.name%' от имени '%currUser.symbolicId%' группа '%currGroup.symbolicId%': Настройка
списка пользователей - Добавлен пользователь '#user.displayName#'.", "type":"Admin", "severity":"Info", "sound":"", "ackrequired":"0"} |
Здесь можно изменить текст сообщения, тип и важность, указать звук и необходимость квитирования:
{"name":"AUDIT_ADD_USER", "value":"В группу '%currGroup.symbolicId%' добавлен пользователь '#user.displayName#'.", "type":"Normal", "severity":"Debug", "sound":"defaul.wav", "ackrequired":"1"}
|
Сообщения первого типа отправляются в результате изменений, произведенных в конфигураторе безопасности.
Astra.HMI.SecurityConfigurator транслирует сообщения аудита первого типа, перечисленные в astra.security.agent.json.