Alpha.Community

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

Аудит безопасности

Alpha.Security отправляет сообщения о любых изменениях в подсистеме безопасности. Эта функция называется аудитом безопасности.

По умолчанию Агент Alpha.Security транслирует сообщения, однако их получение необходимо настраивать, как описано в данном разделе. Можно настроить запись сообщений аудита в сигналы Alpha.Server и, при необходимости, в журнал приложений. Чтобы получать сообщения о состоянии подсистемы безопасности в сигналы Alpha.Server, необходимо:

  • настроить Агент Alpha.Security, при необходимости изменив тексты сообщений;
  • подготовить сигналы в Alpha.Server, подключить к серверу модуль OPC AE Server (он записывает сообщения в сигналы).

Как полностью отключить трансляцию любых сообщений аудита, описано в подразделе Отключение аудита безопасности.

О типах сообщений

Сообщения, транслируемые агентом безопасности, делятся на три типа:

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

Чтобы ознакомиться с сообщениями первых двух типов, перейдите к файлу alpha.security.agent.json, расположенному в:

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

Сообщениями третьего типа являются:

  • логин текущего пользователя;
  • отображаемое имя текущего пользователя;
  • название группы, в которой состоит текущий пользователь;
  • имя текущей рабочей станции.

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

  • Alpha.HMI.SecurityConfigurator транслирует сообщения аудита первого типа, перечисленные в alpha.security.agent.json.
  • SecurityConfigurator транслирует собственные сообщения аудита первого типа, поэтому изменить их не получится.

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

Настройка Агент Alpha.Security и редактирование текстов сообщений

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

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

Редактирование шаблонов текстов сообщений

Файл alpha.security.agent.json хранит тексты сообщений аудита, которые можно редактировать. При формировании шаблона текста сообщения можно использовать теги, хранящие уточняющую информацию о событии аудита: имена пользователей, о которых идет речь в сообщении, рабочих станциях, группах пользователей и т.п.. Теги описаны в начале файла alpha.security.agent.json.

По умолчанию сообщение описано следующим образом:

{"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"}

Для каждого шаблона сообщения указаны параметры, назначение которых описано в таблице ниже. Расшифровка текстов сообщений для упрощения их понимания приведена в приложении Приложение E: Сообщения аудита.

Название параметра Назначение параметра
name Идентификатор сообщения. Менять нельзя.
value Текст сообщения.
type

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

По умолчанию все сообщения имеют тип Admin и записываются в один и тот же сигнал, указанный в карте сигналов конфигурационного файла alpha.security.agent.xml. Чтобы разные сообщения записывались в разные сигналы, одним сообщениям необходимо указать тип Admin, а другим – Normal, а затем в карте сигналов указать эти типы для разных сигналов.

Названия Admin и Normal можно менять, главное – чтобы новые названия были указаны в обоих конфигурационных файлах.

severity Категория важности сообщения. Этот параметр служит для разделения всех сообщений на четыре категории важности. Категории описаны в карте важности конфигурационного файла alpha.security.agent.xml. По умолчанию для всех сообщений указана категория важности Info.
sound Звук, который должен быть воспроизведен при наступлении события, о котором говорится в сообщении. Формат значения – имя и расширение файла звука. Файл звука должен находиться в папке проекта, посредством которого просматриваются события, например, Alpha.HMI.Alarms. Подробнее об этом – в документе на соответствующий продукт.
ackrequired Необходимость квитирования события, о котором говорится в сообщении. Если необходимо квитировать событие, укажите значение 1, если нет – 0.

В файле alpha.security.agent.json не упомянут тег #remaindattempts#, хранящий информацию о количестве оставшихся попыток входа пользователя. Тег может понадобиться в при редактировании сообщения AUDIT_USER_FAILED_LOGIN о неудачной попытке входа пользователя. По умолчанию это сообщение не содержит информацию об оставшихся попытках входа, но если вам необходимо, вы можете использовать тег, заменив шаблон:

{"name":"AUDIT_USER_FAILED_LOGIN", "value":"Неудачная попытка входа пользователя '#user.symbolicId#' в систему на '%arm.name%'. #exception.message#.", "type":"Admin", "severity":"Info", "sound":"", "ackrequired":"0"}

на:

{"name":"AUDIT_USER_FAILED_LOGIN", "value":"Неудачная попытка входа пользователя '#user.symbolicId#' в систему на '%arm.name%'. #exception.message#. Осталось попыток входа: #remaindattempts#", "type":"Admin", "severity":"Info", "sound":"", "ackrequired":"0"}

Настройка агента безопасности

Файл alpha.security.agent.xml позволяет настроить трансляцию сообщений аудита. Для этого:

  1. Откройте файл. Перейдите к элементу <AuditLogConsumers />.

    Чтобы сообщения помимо сигналов Alpha.Server транслировались в журнал приложений, задайте значение атрибута TraceAudit:

    • 1 – для включения трансляции сообщений в журнал приложений;
    • 0 – для отключения трансляции сообщений в журнал приложений.
    <AuditLogConsumers TraceAudit="1" />

    Если настроить трансляцию только в сигналы сервера (TraceAudit="0"), с сообщениями можно будет ознакомиться в любом приложении для просмотра значений сигналов или в Alpha.HMI.Alarms. Если настроить трансляцию в журнал приложений (TraceAudit="1"), то для его просмотра можно будет использовать Alpha.HMI.SystemLogViewer или EventLogViewer.

  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. Атрибут может принимать значения от 0 до 999. Обратите внимание, что эти значения понадобятся в дальнейшем – например, при настройке событий в сигналах Alpha.Server, при настройке отображения событий в Alpha.HMI.Alarms.

    Таким образом можно отметить, какие сообщения имеют высокую важность, а какие – низкую. По умолчанию всем сообщениям в файле alpha.security.agent.json указана категория важности Info.

    <SeverityMap>
     <Severity Category="Critical" Value="800" Sound=""/>
     <Severity Category="Important" Value="200" Sound=""/>
     <Severity Category="Info" Value="100" Sound=""/>
     <Severity Category="Debug" Value="0" Sound=""/>
    </SeverityMap>

    Здесь же для каждой категории в качестве значения атрибута Sound можно указать файл звука, который должен быть воспроизведен при наступлении события из этой категории. Звук может быть указан либо для категории важности, либо для каждого сообщения о событии отдельно – в файле alpha.security.agent.json, как описано выше. Если для сообщения не указан звук, то при наступлении события воспроизводится звук, указанный для категории важности этого события. Файл звука должен находиться в папке проекта, посредством которого просматриваются события, например, Alpha.HMI.Alarms. Подробнее об этом – в документе на соответствующий продукт.

  4. Заполните значения атрибутов карты сигналов <SignalMap />. В указанные здесь сигналы и записываются сообщения аудита. Обратите внимание, что названия сигналов могут быть любыми. Важно, чтобы для каждого типа – Normal, Admin, UserName, DisplayName, GroupName и WorkstationName – было создано по два сигнала с разным режимом записи. Подробнее назначения атрибутов карты описаны в таблице ниже.
    <SignalMap>
     <Signal Name="DynEvents.NormalDynSignal" Mode="DynamicEvent" Type="Normal"/>
     <Signal Name="DynEvents.AdminDynSignal" Mode="DynamicEvent" Type="Admin"/>
     <Signal Name="DynEvents.UserNameDynSignal" Mode="DynamicEvent" Type="UserName"/>
     <Signal Name="DynEvents.DisplayNameDynSignal" Mode="DynamicEvent" Type="DisplayName"/>
     <Signal Name="DynEvents.GroupNameDynSignal" Mode="DynamicEvent" Type="GroupName"/>
     <Signal Name="DynEvents.WorkstationNameDynSignal" Mode="DynamicEvent" Type="WorkstationName"/>
     <Signal Name="DynEvents.NormalMessage" Mode="Value" Type="Normal"/>
     <Signal Name="DynEvents.AdminMessage" Mode="Value" Type="Admin"/>
     <Signal Name="DynEvents.UserNameMessage" Mode="Value" Type="UserName"/>
     <Signal Name="DynEvents.DisplayNameMessage" Mode="Value" Type="DisplayName"/>
     <Signal Name="DynEvents.GroupNameMessage" Mode="Value" Type="GroupName"/>
     <Signal Name="DynEvents.WorkstationNameMessage" Mode="Value" Type="WorkstationName"/>
    </SignalMap>
    Назначения атрибутов карты сигналов
    Название атрибутаНазначение атрибута
    NameПолное имя сигнала как в Alpha.Server.
    Mode

    Режим записи сообщения в сигнал:

    • DynamicEvent – сигнал, создающий динамическое событие;
    • Value – обычная запись сообщения.

    Type

    Тип сообщений, записывающихся в сигнал. Типы описаны в начале данного раздела.

    Для каждого сообщения третьего типа (UserName, DisplayName, GroupName и WorkstationName) создается по собственной паре сигналов.

    Для сообщений первого и второго типа достаточно двух пар сигналов. В этом случае атрибут Type служит для пометки сообщений, которые могут быть записаны в один и тот же сигнал. По умолчанию в файле alpha.security.agent.json все сообщения имеют тип Admin, и записываются в один и тот же сигнал, указанный в карте сигналов. Чтобы разные сообщения записывались в разные сигналы, одним сообщениям необходимо указать тип Admin, а другим – Normal, а затем в карте сигналов указать эти типы для разных пар сигналов. Названия Admin и Normal можно менять, главное – чтобы новые названия были указаны в обоих конфигурационных файлах.

  5. Дополнительно можно изменить префикс сообщений аудита, изменив значение атрибута value элемента <mesPrefix />. Он служит для выделения сообщений аудита безопасности в списке всех остальных сообщений, которые могут отображаться в средстве просмотра.

Подготовка сигналов в Alpha.Server

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

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

  • Динамические сигналы, приведенные в конфигурационном файле по умолчанию:
    • DynEvents.NormalDynSignal;
    • DynEvents.AdminDynSignal;
    • DynEvents.UserNameDynSignal;
    • DynEvents.DisplayNameDynSignal;
    • DynEvents.GroupNameDynSignal;
    • DynEvents.WorkstationNameDynSignal.
  • Обычные сигналы, приведенные в конфигурационном файле по умолчанию:
    • DynEvents.NormalMessage;
    • DynEvents.AdminMessage;
    • DynEvents.UserNameMessage;
    • DynEvents.DisplayNameMessage;
    • DynEvents.GroupNameMessage;
    • DynEvents.WorkstationNameMessage.

Создание сигналов в приложении Конфигуратор

Если для конфигурирования Alpha.Server вы используете приложение Конфигуратор, то:

  1. Создайте в дереве сигналов папку для сигналов аудита (например DynEvents). Внутри папки создайте 12 сигналов типа String.
  2. Затем настройте генерацию событий при записи сообщений в сигналы. Для этого назначьте созданным объектам свойства, описанные в таблицах ниже. Также можно включить флаг ведения истории, чтобы иметь возможность обратиться к ней при перезаписи значения сигнала.

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

    • Папке DynEvents:
      СвойствоЗначение
      999000 (тип объекта)Можно не указывать.

      999004

      (условие генерации сообщений)

      Cкрипт, генерирующий сообщение при наступлении события.

      <EventConditions>
       <EventCondition Name="DynamicCondition" Type="Dynamic" Enabled="1">
        <Subcondition Type="Dynamic" Message="" Value="" Sound="" Severity="100"
      AckRequired="0" Enabled="1" SoundEnabled="0" />
       </EventCondition>
      </EventConditions>

      где:

      • значение атрибута Name будет использоваться при настройке динамических сигналов;
      • значение атрибута Severity должно совпадать со значением категории важности сообщений, записывающихся в сигнал, указанным при настройке агента.
    • Динамическим сигналам (содержат частицу Dyn в названии по умолчанию):
      СвойствоЗначение
      5000 (адрес сигнала)Conditions=(DynamicCondition),

      где название условия в скобках должно совпадать со значением атрибута Name, указанным в свойстве 999004 папки DynEvents.

      9001 (флаг ведения истории)True
    • Обычным сигналам:
      СвойствоЗначение
      9001 (флаг ведения истории)True

Создание сигналов в Alpha.DevStudio

Порядок создания проекта и конфигурирования Alpha.Server описаны в документации на Alpha.DevStudio (раздел Знакомство с Alpha.DevStudio руководства пользователя). Здесь описано создание сигналов в уже сконфигурированном Alpha.Server в существующем проекте.

Если для конфигурирования Alpha.Server вы используете Alpha.DevStudio, то:

  1. Откройте имеющийся проект Alpha.DevStudio. Перейдите к элементу, описывающему сервер в вашем проекте. Убедитесь, что здесь подключен модуль OPC AE Server.
  2. Перейдите внутрь элемента, описывающего сервер. Здесь может быть размещен элемент приложения. Если его нет, создайте, перетянув элемент Приложение с панели элементов.
  3. Внутри элемента приложения создайте логический объект. Это будет папка для сигналов, предназначенных для записи сообщений аудита (например DynEvents).
  4. Внутри созданного логического объекта создайте двенадцать параметров, соответствующих двенадцати сигналам, предназначенным для записи сообщений аудита. Для всех параметров укажите значения свойств:
    • Направление (отсутсвует);
    • Тип (string);
    • Имя.
  5. Для шести параметров, предназначенных для создания динамических событий, в окне События установите флаг Генерировать события (такие сигналы в именах по умолчанию содержат частицу Dyn). Чтобы открыть окно, перейдите к панели инструментов и выберите Вид -> События. В открывшейся таблице укажите значение важности события, соответствующее категории важности, указанной при конфигурировании агента. Если необходимо, укажите файл звука, воспроизводимого при наступлении события, и параметры квитирования.

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

Получение сообщений аудита

После внесения изменений в конфигурации сервера и агента безопасности, перезапустите их службы (сервисы). В результате будет настроена трансляция сообщений аудита в сигналы Alpha.Server и в журнал приложений (если настраивали). Чтобы ознакомиться с сообщениями, используйте любое средство просмотра значений сигналов сервера либо приложение Alpha.HMI.Alarms. Если также настраивали трансляцию сообщений в журнал приложений, просмотреть его можно в приложениях EventLogViewer и Alpha.HMI.SystemLogViewer.

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

Отключение аудита безопасности

Чтобы полностью отключить трансляцию сообщений аудита, закомментируйте или полностью удалите элемент <AuditLogConsumers /> в конфигурационном файле alpha.security.agent.xml. Трансляция сообщений не будет выполняться, однако при каждом перезапуске агента безопасности в журнале приложений будет появляться одно сообщение с текстом Аудит недоступен: параметры аудита не определены в конфигурации Security-агента (элемент AuditLogConsumers).