Alpha.Community

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

Назначение и принцип работы

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

Модуль Клиент безопасности подключается к локальному Агенту Alpha.Security и подписывается на элементы безопасности, значения которых необходимо передавать в сигналы Alpha.Server.

Пример использования модуля

В некотором проекте Alpha.Security используется для хранения настроек, влияющих на работу реализованных в проекте алгоритмов работы.

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

В проекте АРМ Администратора в Alpha.HMI с использованием Alpha.HMI.Security реализована возможность просмотра и изменения настроек. Когда администратор подтверждает изменения настроек, они сохраняются в LDAP-сервере. Агент Alpha.Security получает обновление значений и уведомляет об этом клиентов, включая модуль Клиент безопасности.

Таким образом обеспечивается:

  • централизованное хранение и изменение настроек проекта;
  • распространение изменений настроек по исполняющим компонентам, задействованным в проекте.

Привязка сигналов

Сигналы Alpha.Server, в которые необходимо передавать значения из элементов безопасности, Клиент безопасности определяет по наличию свойства 10100 (CLIENT_SECURITY_PROPERTY_ID. Данное свойство содержит привязку сигнала к элементу безопасности. Общий формат привязки:

{App=(<app-id>) <token-type>=(<token-id>) <get-value-method>=(<get-value-expression>)}

В привязке определяется:

  • Приложение (поле App) - в качестве значения app-id указывается идентификатор приложения в Alpha.Security.
  • Элемент безопасности, из которого нужно получать значение, и его тип:

    • token-type - определяет тип элемента безопасности:
      • BoolToken - логическое право;
      • StringToken - строковое право;

    • token-id - идентификатор элемента безопасности.

  • Опциональное поле, определяющее метод получения нужного значения из значения элемента безопасности, и соответствую выражение:

    • get-value-method - метод получения значения;
    • get-value-expression - выражение, соответствующее методу.

Модуль Клиент безопасности поддерживает следующие соответствия типов сигналов и привязок:

  1. Для сигналов типа Bool поддерживается привязка к логическому праву без указания выражения получения значения. Текущее значение логического права напрямую передаётся в сигнал.
  2. Для сигналов типа String поддерживается привязка к строковому праву без указания выражения получения значения. В сигнал напрямую передаётся первая строка разрешений.
  3. Для сигналов типов Bool, String, а также целочисленных и вещественных типов поддерживается привязка к строковому праву с указанием выражения получения значения.

В качестве метода получения значения модуль Клиент безопасности использует извлечение из JSON-строки со следующими особенностями:

  1. Значение извлекается из самой первой строки разрешения, если она существует.
  2. Строка содержит JSON-объект. Поля, к значениям которых осуществляется доступ, имеют атомарный тип.
  3. Идентификатор метода (поле get-value-method): JsonValue.
  4. Значение выражения (get-value-expression) - имя поля JSON-объекта, содержащегося в строке.

Привязка к значению логического права:

{App=(AuditService) BoolToken=(EnableAutoCleanup)}

Привязка к значению первой строки разрешения строкового права:

{App=(AuditService) StringToken=(SimpleStringSetting)}

Получение значений максимального размера БД:

{App=(AuditService) StringToken=(SizeSettings) JsonValue=(maxsize)}

Качество сигналов

Качества сигналов, выставляемые модулем Клиент безопасности, приведены в таблице.

Идентификатор качества Расшифровка
(24) COMM_FAILURE Не установлено соединение с Агентом Alpha.Security.
(64) UNCERTAIN Установлено соединение с Агентом Alpha.Security, но значения ещё не получены.
(4) CONFIG_ERROR Указанное приложение или элемент безопасности отсутствует.
(16) SENSOR_FAILURE Приложение или элемент безопасности существует, но не удалось получить значение.
(192) GOOD Значение получено.
(20) LAST_KNOWN Потеряна связь с Агентом Alpha.Security, это последнее известное значение.