Alpha.Community

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

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

Агент безопасности представляет собой:

  • службу Alpha.Security.Agent на ОС Windows;
  • сервис alpha.security.service на ОС Linux.

Служба (сервис) выполняет следующие функции:

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

Например, при регистрации пользователя в Alpha.HMI.Alarms, введенные данные проверяются на LDAP-сервере агентом безопасности. Если данные верны, и пользователь имеет доступ к программе, агент безопасности запоминает пользователя как текущего, и передает сведения о правах пользователя из LDAP-сервера в Alpha.HMI.Alarms.

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

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

После изменения настроек нужно перезапустить службу Alpha.Security.Agent.

Пример настроенного конфигурационного файла находится в Приложение A: Пример конфигурационного файла Агент Alpha.Security.

Настроить связь с узлами сети Alpha.Net

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

Чтобы установить связь Alpha.Security с Net-агентом, в конфигурационном файле укажите адрес точки доступа Alpha.Net.Agent в качестве значений атрибутов элемента <EntryPointNetAgent />:

  • Address – IP-адрес Net-агента;
  • Port – порт для подключения.
<EntryPointNetAgent Address="127.0.0.1" Port="1010"/>

Настроить связь с LDAP-сервером

Эта настройка выполняется в случае, если OpenLDAP и агент безопасности установлены на разных компьютерах.

Чтобы установить связь между Агент Alpha.Security и LDAP-сервером, установленным на другом компьютере, укажите адрес и порт LDAP-сервера в качестве значений атрибутов элемента <LdapHosts />:

<LdapHosts>
	<LDAPServer Address="127.0.0.1" Port="389"/>
</LdapHosts>

Указать администратора LDAP

По умолчанию здесь указан логин стандартной учетной записи администратора LDAP.

  • Для ОС Windows учетная запись создаётся автоматически при установке Alpha.Security. Логин – manager, пароль администратора по умолчанию – secret, либо указанный при установке Alpha.Security.
  • Для ОС Linux учетная запись создаётся при установке OpenLDAP. Логин – admin, пароль администратора задается при установке.

Если меняли администратора LDAP, укажите его логин в качестве значения атрибута value элемента <LdapUser /> в указанном виде:

<LdapUser value="cn=Manager,dc=maxcrc,dc=com"/>

dc=maxcrc,dc=com – домен LDAP-сервера, указываемый для связи с Агент Alpha.Security. Это значение менять нельзя.

cn="логин-администратора",dc="домен-базы-данных" – формат указания каталога, принятый для OpenLDAP.

Здесь же укажите пароль администратора LDAP в зашифрованном виде в качестве значения атрибута value элемента <LdapPassword />:

<LdapPassword value="VuZyuLC...JFchMHvKXNeztHoFpe24v2Wl9viv"/>

Когда необходимо зашифровать пароль, используйте приложение:

  • alpha.security.crypter.exe, расположенное в C:\Program Files\Automiq\Alpha.Security\Utils – для ОС Windows;
  • alpha.security.crypter, расположенное в /opt/Automiq/Alpha.Security/Utils – для ОС Linux.

Чтобы получить пароль в зашифрованном виде:

  1. Запустите приложение через командную строку (терминал) от имени администратора.
  2. Введите шифруемый пароль и нажмите Enter.
  3. Зашифрованное значение скопируйте и вставьте в качестве значения атрибута value элемента <LdapPassword /> в конфигурационный файл.

Пароли шифруются с использованием алгоритма Salted SHA-1 и хранятся в виде необратимых хэш-значений.

Указать пользователя по умолчанию

Можно указать пользователя по умолчанию – пользователя, чьи права используются, когда нет активной пользовательской сессии. Пользователем по умолчанию может быть любой пользователь из созданных при конфигурировании LDAP-сервера. В целях безопасности не указывайте пользователя, у которого есть права на редактирование конфигурации подсистемы безопасности.

Задайте имя пользователя в конфигурационном файле в качестве значения атрибута value элемента <DefaultUser />:

<DefaultUser value="ИМЯПОЛЬЗОВАТЕЛЯ"/>

Здесь же укажите пароль пользователя по умолчанию в зашифрованном виде в качестве значения атрибута value элемента <DefaultUserPassword />:

<DefaultUserPassword value="VuZyuLC...JFchMHvKXNeztHoFpe24v2Wl9viv"/>

Указать каталог LDAP для подключения

Этот параметр менять не нужно, если на LDAP-сервере всего один каталог, и он создался автоматически при запуске службы агента безопасности. Подробнее об этом – в разделе LDAP-сервер и его настройка.

Если же на LDAP-сервере хранится несколько разных каталогов (корневых папок), то подключаться по умолчанию агент будет только к одному из них. Укажите название нужного каталога в качестве значения атрибута value элемента <SecurityDn />:

<SecurityDn value="ou=AlphaSecurity,dc=maxcrc,dc=com"/>

где AlphaSecurity – название каталога по умолчанию.

dc=maxcrc,dc=com – домен LDAP-сервера, указываемый для связи с агентом безопасности. Это значение менять нельзя.

ou="имя-каталога",dc="домен-базы-данных" – формат указания каталога, принятый для OpenLDAP.

Изменить уровень логирования

Эта настройка реализована одним из атрибутов элемента <Options /> в конфигурационном файле.

Чтобы изменить уровень логирования, назначьте атрибуту LoggerLevel значение:

  • 0 – чтобы выводить в лог минимум информации о работе Alpha.Security;
  • 2 – чтобы выводить в лог всю необходимую информацию о работе Alpha.Security;
  • 5 – чтобы выводить в лог дополнительную информацию о работе Alpha.Security.

Рекомендуемое значение – 2. Значение 5 следует использовать только при поиске и анализе ошибок.

Заблокировать использование горячих клавиш (только для ОС Windows)

Эта настройка реализована одним из атрибутов элемента <Options /> в конфигурационном файле.

Чтобы запретить использование горячих клавиш, назначьте в качестве значения атрибута kbDriverString перечень сочетаний SCAN-кодов клавиш. SCAN-коды клавиш разделяются внутри сочетания символом +, а сами сочетания – символом ;. Перечень SCAN-кодов можно посмотреть в Приложение B: SCAN-коды клавиш.

<Options kbDriverString="0x1D+0x38+0x53;0x1D+0x2A+0x01;" />

Такое значение блокирует сочетания ctrl+alt+del и ctrl+shift+esc.

Чтобы блокировка использования сочетаний клавиш выполнялась корректно, необходимо установить драйвер kbDriver, поставляемый вместе с дистрибутивом Alpha.Security. Для этого перейдите к расположению C:\Program Files\Automiq\Alpha.Security\kbDriver. Инструкция по установке драйвера описана в расположенном здесь файле readme_kbdriver_install.txt.

Указать необходимость постоянного запроса значений прав с LDAP-сервера

Эта настройка реализована одним из атрибутов элемента <Options /> в конфигурационном файле.

Значение атрибута UseRightsCacheStorage используется для выбора источника данных о правах:

  • 1 – права пользователя не запрашиваются с LDAP-сервера, используются кэшированные значения прав;
  • 0 – права пользователя запрашиваются с LDAP-сервера всегда.

Скрыть пользователя из запрашиваемого списка пользователей

Эта настройка реализована одним из атрибутов элемента <Options /> в конфигурационном файле.

Значение атрибута ReducedUserList используется для сокращения списка пользователей, предоставляемого по запросу:

  • 1 – по запросу предоставляется сокращенный список пользователей;
  • 0 – по запросу предоставляется полный список пользователей.

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

Изменить параметры отслеживания синхронизации баз данных

Если для LDAP-сервера настроено резервирование, иногда могут возникать ситуации, в которых базы данных резервируемого и резервирующих серверов перестают соответствовать друг другу. Такая ситуация иначе называется рассинхронизацией баз данных. Агент безопасности отслеживает состояние синхронизации баз резервируемых серверов и отправляет сообщение аудита в случае, если базы рассинхронизируются.

Настроить периодичность проверок синхронизации баз можно, изменив значение атрибута SynchronizationTimeout элемента <Options /> в конфигурационном файле (значение указывается в минутах).

<Options SynchronizationTimeout="10" />

Это означает, что проверка синхронизации баз данных резервируемых серверов будет выполняться каждые десять минут.

Транслировать сообщения из системного журнала в сообщения аудита безопасности (для ОС Linux)

Эта настройка реализована одним из атрибутов элемента <Options /> в конфигурационном файле.

Значение атрибута FAMode позволяет настроить трансляцию выбранных сообщений из текстовых файлов (например, из системного журнала) в сигналы сообщений аудита:

  • 1 – трансляция сообщений включена;
  • 0 – трансляция сообщений отключена.

Чтобы выбрать сообщения для трансляции:

  1. Перейдите к файлу alpha.security.fa.xml, расположенному в /opt/Automiq/Alpha.Security.
  2. Ознакомьтесь с содержанием файла. По умолчанию здесь описаны шаблоны сообщений, транслируемых из системных журналов /var/log/auth.log и /var/log/secure. Для каждого источника создан элемент <FileRecords /> со вложенным элементом <Records />, внутри которого и описаны шаблоны сообщений – в элементах <Rec />. Назначение атрибутов элемента описано в этом же файле. Обратите внимание, что значения атрибута EventType соответствует названиям типов сообщений аудита – Normal или Admin. Эти названия можно менять – подробнее назначение типов описано в разделе Аудит безопасности. Если типы были переименованы при настройке аудита, здесь эти значения тоже нужно изменить.
  3. Раскомментируйте конструкции <Rec />, если необходимо транслировать описанные сообщения в аудит. Создайте собственные конструкции по аналогии, если необходимо транслировать сообщения иного вида.

Настроить подключение к внешним источникам учетных данных

Настройка подключения к внешним источникам выполняется для импорта учетных записей из этих источников. После настройки подключения импорт можно выполнить средствами Alpha.HMI.Security в собственном проекте Alpha.HMI, либо с помощью Alpha.HMI.SecurityConfigurator 2.5.0 и новее. Подробнее об этом – в документации на Alpha.HMI.Security и Alpha.HMI.SecurityConfigurator соответственно.

Описание внешних источников выполняется в элементе <ExternalAuthenticationSource />. Каждый отдельный источник описывается вложенным в <ExternalAuthenticationSource /> элементом <Source />. Для каждого элемента <Source /> следует указать значения следующих атрибутов:

  • SourceID – уникальный идентификатор внешнего источника;
  • Address – IP-адрес источника;
  • Port – порт подключения к источнику;
  • Secure – флаг использования SSL/TLS при подключении:
    • true – использовать TLS;
    • false – использовать SSL.

Также для каждого источника (элемента <Source />) необходимо:

  • определить соответствие между полями учетных записей OpenLDAP (login, firstname и др.) и внешнего источника – в качестве значений атрибутов вложенного элемента <MappedAttributes />;
  • указать шаблон формирования логина для удаленного источника – в виде значения атрибута value вложенного элемента <LoginTemplate />.

Пример:

<ExternalAuthenticationSource>
 <Source SourceID = "Source1" Address="111.111.1.1" Port="389" Secure = "False" >
  <MappedAttributes login = "uid" fistname = "givenName" midname = "initials" lastname = "sn" description = "company"
  displayname = "displayName" email = "mail" position = "title" objectSid = "ipaNTSecurityIdentifier" objectGUID = "ipaUniqueID"/>
  <LoginTemplate value = "uid={login},cn=users,cn=accounts,{domainDN}" />
 </Source>
</ExternalAuthenticationSource>