Alpha.Community

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

Логирование сообщений безопасности

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

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

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

  1. Создать сигналы для записи сообщений безопасности в Alpha.Server.
  2. Настроить и включить функцию аудита безопасности, предоставляемую подсистемой Alpha.Security.
  3. Вызвать функцию отправки сообщения агенту безопасности в проекте Alpha.HMI.
  4. Для просмотра сообщений можно использовать любое средство просмотра значений сигналов сервера (OpcExplorer) или сообщений (EventLogViewer, Alpha.HMI.Alarms, Alpha.Alarms).

С настройкой функции аудита безопасности подробно можно ознакомиться в руководстве администратора Alpha.Security, в разделе Аудит безопасности, либо кратко – ниже.

Создать сигналы для записи сообщений в Alpha.Server

Чтобы подготовить Alpha.Server к записи сообщений подсистемы безопасности, необходимо создать 12 сигналов типа String в отдельной папке дерева сигналов, например, Messages. Имена сигналов по умолчанию перечислены в конфигурационном файле alpha.security.agent.xml, расположенном в папке установки Alpha.Security. Эти названия можно менять. Папка установки Alpha.Security:

  • C:\Program Files\Automiq\Alpha.Security – для ОС Windows;
  • /opt/Automiq/Alpha.Security – для ОС Linux.

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

Динамические сигналы, приведенные в конфигурационном файле по умолчанию:

  • Messages.NormalDynSignal;
  • Messages.AdminDynSignal;
  • Messages.UserNameDynSignal;
  • Messages.DisplayNameDynSignal;
  • Messages.GroupNameDynSignal;
  • Messages.WorkstationNameDynSignal.

Обычные сигналы, приведенные в конфигурационном файле по умолчанию:

  • Messages.NormalMessage;
  • Messages.AdminMessage;
  • Messages.UserNameMessage;
  • Messages.DisplayNameMessage;
  • Messages.GroupNameMessage;
  • Messages.WorkstationNameMessage.

Для динамических сигналов необходимо настроить генерацию событий при записи сообщений в сигналы.

  • Если для конфигурирования Alpha.Server вы используете приложение Конфигуратор, то папке с сигналами назначьте свойство 999004 (условие генерации сообщений), и в качестве значения укажите:
    <EventConditions>
     <EventCondition Name="DynamicCondition" Type="Dynamic" Enabled="1">
      <Subcondition Type="Dynamic" Message="" Value="" Sound="" Severity="100"
    AckRequired="0" Enabled="1" SoundEnabled="0" />
     </EventCondition>
    </EventConditions>

    А каждому динамическому сигналу назначьте свойство 5000 (адрес сигнала), и в качестве значения укажите ссылку на описанное выше условие:

    Conditions=(DynamicCondition)
  • Если для конфигурирования Alpha.Server вы используете Alpha.DevStudio, то для шести параметров, предназначенных для создания динамических событий, в окне События установите флаг Генерировать события (чтобы открыть окно, перейдите к панели инструментов и выберите Вид -> События). В открывшейся таблице укажите значение важности события, соответствующее категории важности, указанной при конфигурировании агента. Если необходимо, укажите файл звука, воспроизводимого при наступлении события, и параметры квитирования. Затем постройте решение и примените конфигурацию.

После внесения изменений в конфигурацию сервера перезапустите его службу (сервис).

Настроить трансляцию сообщений аудита безопасности

Для настройки аудита безопасности следует редактировать конфигурационный файл alpha.security.agent.xml, расположенный в:

  • C:\Program Files\Automiq\Alpha.Security – для ОС Windows;
  • /opt/Automiq/Alpha.Security – для ОС Linux.

Чтобы изменить текущие настройки, выполните следующие действия:

  1. Перейдите к элементу <AuditLogConsumers>. Включите трансляцию сообщений, задав значение атрибута TraceAudit:
    • 1 – для включения аудита;
    • 0 – для отключения аудита.
    <AuditLogConsumers TraceAudit="0">
  2. Во вложенном элементе <OpcDaLogConsumer> опишите так называемый сервер-потребитель сообщений – экземпляр Alpha.Server, в сигналы которого будут транслироваться сообщения. Укажите значения атрибутов элемента <Server>:
    • Host – IP-адрес сервера;
    • Type – тип сервера (OPC или TCP для Windows, только TCP для Linux);
    • ProgId – строковый идентификатор OPC-сервера (если выбран OPC-сервер);
    • TCPServerPort – порт для подключения к TCP-серверу (если выбран TCP-сервер);
    • HostTcpReserve – имя или IP-адрес сервера для резервного канала связи с TCP-сервером (значение может быть пустым);
    • MasterPasswordCipher – хэш-значение мастер-пароля, установленного на подключение к TCP-серверу (значение может быть пустым).

      Это значение должно совпадать со значением атрибута Cipher элемента <MasterPassword> в файле настроек Alpha.Server или Alpha.AccessPoint:

      <MasterPassword Cipher="bknxu/rPt/+PCnmzYA....lB1i2bHuzYk2/XKKYFr" />

    <Server Host="127.0.0.1" Type="OPC" ProgId="AP.OPCDAServer" TCPServerPort="4388" 
    HostTcpReserve="" MasterPasswordCipher="">

    В рамках одного элемента <OpcDaLogConsumer> может быть настроен только один сервер-потребитель сообщений.

    Количество вложенных элементов <OpcDaLogConsumer> может быть любым.

  3. Задайте значения для каждой категории важности событий в карте важности <SeverityMap>, изменив значения атрибутов Value. Здесь же для каждой категории в качестве значения атрибута Sound можно указать файл звука, который должен быть воспроизведен при наступлении события из этой категории.
  4. Заполните карту сигналов <SignalMap>. Если при создании сигналов использовали имена по умолчанию, карту можно не менять. Сообщения, отправляемые агенту безопасности компонентом Контекст безопасности, записываются в сигналы, для которых указан тип Admin.

После внесения изменений в конфигурацию агента безопасности перезапустите его службу (сервис).

Вызвать функцию записи сообщения в проекте Alpha.HMI

Чтобы записать сообщение в сигнал, сначала необходимо отправить его агенту безопасности. Для этого используется функция LogAudit() компонента Контекст безопасности (SecurityContext). При вызове функции укажите в качестве входных параметров текст сообщения и его важность (от 1 до 4, где 1 – наименее важные сообщения (Debug), 4 – наиболее важные сообщения (Critical)).

Также для отправки сообщений агенту можно использовать функцию LogAuditExt(). Она позволяет указать тип сообщения, который, в свою очередь, определяет, в какой именно сигнал будет записано сообщение. Подробнее – в справочном руководстве и в руководстве администратора Alpha.Security.

Чтобы ознакомиться с примером использования функции, откройте проект-пример, прикрепляемый к разделу Контроль целостности файлов и папок, в Дизайнер Alpha.HMI. Ознакомьтесь с кодом каждого обработчика событий экземпляра Настройка безопасности: Контроль целостности.

Здесь:

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