Alpha.Community

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

Управление доступом в проектах

Прежде чем изучить этот и следующие разделы рекомендуется ознакомиться с:

  • основами разработки проектов в Дизайнер Alpha.HMI;
  • назначением и принципом работы подсистемы безопасности Alpha.Security;
  • принципами конфигурирования подсистемы безопасности Alpha.Security.

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

Для работы с проектом-примером должны быть установлены:

  • Дизайнер Alpha.HMI – для просмотра, запуска и модификации проекта;
  • Alpha.Security – для создания учетных записей пользователей и прав;
  • Alpha.Domain – для обеспечения взаимодействия компонентов подсистемы безопасности Alpha.Security;
  • Alpha.HMI.Security – для взаимодействия Alpha.HMI и Alpha.Security.

Также для работы необходимы:

  • файлы проекта-примера AccessControl.hmi;
  • файл конфигурации Alpha.Security Configuration.Example.bak.

Скачайте архив с указанными файлами. Откройте проект-пример в Дизайнер Alpha.HMI. Восстановите резервную копию из файла конфигурации Alpha.Security.

Если у вас имеется собственная конфигурация Alpha.Security, сохраните ее резервную копию, прежде чем приступить к работе с проектом-примером.

Подключитесь к каталогу OpenLDAP, в который вы восстановили резервную копию проекта-примера, с помощью SecurityConfigurator, поставляемого в составе дистрибутива Alpha.Security. Администратор – manager, пароль – secret. Убедитесь, что в конфигурации каталога появились:

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

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

Назначение проекта-примера

Проект-пример имитирует АРМ, которое позволяет:

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

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

Главная экранная форма проекта – MainForm:

На главную форму добавлены:

  • SecurityContext – элемент типа Контекст безопасности, обеспечивающий взаимодействие с Агент Alpha.Security;
  • BoolTokenProxy_ControlTank – элемент типа Булевский элемент безопасности, привязанный к праву, регулирующему доступ к управлению резервуаром;
  • BoolTokenProxy_ControlPump – элемент типа Булевский элемент безопасности, привязанный к праву, регулирующему доступ к управлению насосом;
  • StringTokenProxy – элемент типа Строковый элемент безопасности, привязанный к праву, содержащему текстовые разрешения и запреты обоих пользователей.

Вторая форма проекта – форма входа AuthorizationForm:

На форму входа AuthorizationForm добавлены:

  • UserList – элемент типа Список пользователей, позволяющий работать со списком учетных записей из подсистемы безопасности Alpha.Security;
  • SecurityContext – элемент типа Контекст безопасности, обеспечивающий взаимодействие с Alpha.Security.

Здесь и в других проектах-примерах на каждой форме размещен свой элемент типа Контекст безопасности. Такое решение не является обязательным. Можно применить любое подходящее для проекта решение, например:

  • использовать ссылки на элемент типа Контекст безопасности, расположенный на одной из форм проекта;
  • использовать один глобальный элемент типа Контекст безопасности.

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

Запустите проект-пример в рантайм. При запуске откроется главное окно:

При запуске главного окна элемент SecurityContext обратился к Агент Alpha.Security для получения информации о текущем пользователе и его правах. В систему никто не вошел, поэтому Агент Alpha.Security предоставил информацию о пользователе, чья учетная запись используется по умолчанию – guest.

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

Пользователь guest не имеет прав на управление системой, поэтому кнопки Включить насос, Наполнить резервуар и Осушить резервуар недоступны. О том, что текущим пользователем является guest, написано в информационном сообщении в нижней части главного окна.

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

Вход с личными учетными данными

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

Логин можно ввести либо выбрать из выпадающего списка.

За предоставление списка учетных записей отвечает элемент UserList. При запуске окна входа с помощью функции BeginUpdate() был запрошен список учетных записей из подсистемы безопасности Alpha.Security (см. код обработчика события Opened формы входа). Когда обновление завершилось, активировалось событие UpdateFinished элемента UserList. Ознакомьтесь с кодом обработчика этого события, написанным на языке Alpha.Om. Для получения логинов учетных записей используется функция GetLoginName():

Использование проекта с личной учетной записью

Выберите логин ivanov из выпадающего списка и введите пароль ivanov1. Нажмите кнопку Вход. Окно входа закроется, а на главном окне станут доступны кнопки Наполнить резервуар и Осушить резервуар:

При нажатии кнопки Вход:

  1. Была вызвана функция AsyncLogin() элемента SecurityContext, входными параметрами для которой являются логин и пароль:

  2. Агент Alpha.Security принял введенные учетные данные и зарегистрировал ivanov как текущего пользователя.
  3. Агент Alpha.Security обновил текущие значения прав в соответствии с конфигурацией Alpha.Security для текущего пользователя.
  4. Элементы BoolTokenProxy_ControlTank, BoolTokenProxy_ControlPump и StringTokenProxy получили информацию о новых значениях прав.
  5. Кнопки управления резервуаром стали доступны, так как их свойства активности связаны со значением булевского права:

Нажмите кнопку Узнать разрешения. Название кнопки изменится. Теперь на ней будет написано, какое оборудование доступно пользователю. Ознакомьтесь с обработчиком события MouseClick этой кнопки. Элемент StringTokenProxy предоставляет значение разрешения текущего пользователя с помощью функции GetAllowed().

Нажмите кнопку Выйти. Будет вызвана функция LogOut() элемента SecurityContext. В информационном сообщении вы увидите, что текущим пользователем снова стал guest, а кнопки управления резервуаром недоступны.

Откройте окно входа и введите другие учетные данные: логин petrov и пароль petrov1.

  1. Вновь будет вызвана функция AsyncLogin() элемента SecurityContext, и на стороне Агент Alpha.Security petrov будет зарегистрирован как текущий пользователь.
  2. Выполнится условие активности, связанное с правом на управление насосом, и кнопка Включить насос станет доступна.
  3. При нажатии на кнопку Узнать разрешения появится текстовое описание разрешения текущего пользователя:

Попробуйте при попытке входа ввести случайную комбинацию символов в качестве логина и/или пароля:

Так как введены несуществующие учетные данные, Агент Alpha.Security отклонит попытку входа. Активируется событие LoginRejected элемента SecurityContext, и в поле вывода информационного сообщения появится соответствующее предупреждение: