Alpha.Community

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

Конфигурирование агента безопасности

Настройка службы Alpha.Security.Agent (на ОС Windows) или Alpha.Security.service (на ОС Linux) обычно выполняется в конфигурационном файле alpha.security.agent.xml, расположенном в C:\Program Files\Automiq\Alpha.Security (для Windows) или в /opt/Automiq/Alpha.Security (для Linux). Подробнее назначение и настройка службы описаны в документе на Alpha.Security, в разделах О продукте и Настройка компонентов соответственно.

В этом разделе продемонстрирована возможность конфигурирования агента безопасности из проекта Alpha.HMI с помощью компонента расширения Alpha.HMI.Security. Для этого описан проект-пример, в котором можно ознакомиться с текущими настройками агента с помощью экземпляра компонента Мастер конфигурирования Security.

Для ознакомления с этим разделом:

  • Скачайте проект-пример и откройте его в Дизайнер Alpha.HMI.
  • Ознакомьтесь с настройками подсистемы безопасности Alpha.Security: откройте конфигурационный файл alpha.security.agent.xml, расположенный в C:\Program Files\Automiq\Alpha.Security (для Windows) или в /opt/Automiq/Alpha.Security (для Linux).

Состав проекта-примера

Единственная форма в проекте – ConfiguringService.

На форму добавлен элемент типа Мастер конфигурирования Security - Configurator. Для получения текущих настроек агента безопасности сначала нужно вызвать функцию Read() элемента. Функция вызывается по нажатию на кнопку ReadConfigurationButton. Ознакомьтесь с обработчиком события MouseClick кнопки:

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

  • Значения из конфигурационного файла записываются в элемент Configurator. Чтобы обратиться к ним, используются свойства и функции компонента.
  • Активируется событие ReadingFinished элемента Configurator. Ознакомьтесь с кодом обработчика данного события:
    //запись в лог информации об успешном выполнении операции
    DebugTool.Log("Конфигурация прочитана");
    //вызов команд, записывающих информацию о настройках агента
    //в соответсвующих поля формы и в лог
    WriteBasic.Invoke();
    WriteAudit.Invoke();

    Для удобства действия, выполняемые при наступлении события, разделены на две команды – WriteBasic и WriteAudit.

    • Команда WriteBasic записывает в соответствующие поля основную информацию о настройках агента безопасности – параметры используемого Net-агента, LDAP-сервера, данные администратора и корневого каталога, сведения о ведении аудита и защищенности соединения агента с LDAP-сервером. Ознакомьтесь с кодом обработчика события Invoked команды:
      //запись значений свойств элемента Configurator в текстовые поля
      Host.Text = Configurator.NetHost;
      Port.Text = String.ToString(Configurator.NetPort);
      LDAPHost.Text = Configurator.LdapHost;
      SecureConnectionCheckbox.State = Configurator.UseSecureConnection;
      AuditCheckbox.State = Configurator.TraceAudit;
      User.Text = Configurator.LdapUser;
      Catalog.Text = Configurator.LdapDN;
      /*Список LDAP-серверов - это массив,
      поэтому для обращения к его значениям используется цикл while*/
      i: int4 = 0;
      while (i <= Configurator.LdapCount)
      {
       LDAPHost.Text = Configurator.GetLdapHost(0);
       LDAPPort.Text = String.ToString(Configurator.GetLdapPort(0));
       i += 1;
      }
    • Команда WriteAudit записывает в соответствующие поля информацию о настройках подключения первого описанного в конфигурационном файле сервера-потребителя, а в лог - информацию о категориях важности сообщений и сигналах, предназначенных для записи сообщений в данном сервере. Ознакомьтесь с кодом обработчика события Invoked команды:
      /*здесь извлекается информация только о первом описанном в
      конфигурационном файле сервере-потребителе аудита
      (индекс во внутреннем массиве элемента Configurator - 0).
      Если в вашем конфигурационном файле описано больше серверов-потребителей,
      необходимо будет расширить форму и переписать код, добавив вызов
      еще одного цикла while*/
      AuditHost.Text = Configurator.GetAuditServerHost(0);
      AuditPort.Text = String.ToString(Configurator.GetAuditServerPort(0));
      AuditProgID.Text = Configurator.GetServerProgId(0);
      AuditServerType.Text = Configurator.GetServerType(0);
      i: int4 = 0;
      while (i < Configurator.GetSeverityCount(0))
      {
       DebugTool.Log("Категория важности: "+Configurator.GetSeverityCategory(0,i)+"; 
       Значение: "+String.ToString(Configurator.GetSeverityValue(0,i)));
       i += 1;
      }
      k: int4 = 0;
      while (k < Configurator.GetSignalsCount(0))
      {
       DebugTool.Log("Название сигнала: "+Configurator.GetSignalName(0,k)+"; 
       Режим записи: "+String.ToString(Configurator.GetSignalMode(0,k))+"; 
       Тип сигнала: "+Configurator.GetSignalType(0,k));
       k += 1;
      }

Запустите проект-пример в рантайм. Откроется окно Конфигурирование агента безопасности. В поле ввода уже указан путь к конфигурационному файлу службы Агент Alpha.Security. Нажмите кнопку Прочитать текущую конфигурацию агента безопасности. Текстовые поля окна заполнятся информацией о текущих настройках агента безопасности.

В Журнале времени исполнения появится информация о категориях важности сообщений и сигналах, предназначенных для записи сообщений в данном сервере:

Сравните значения в окне проекта со значениями, указанными в конфигурационном файле – они будут совпадать. Например:

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