Alpha.Community

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

Собственная форма входа

Когда пользователь вводит личные учетные данные в проекте Alpha.HMI, подсистема безопасности "запоминает" его как текущего пользователя, и может предоставлять информацию о нем сторонним приложениям. Для удобства регистрации в подсистеме безопасности можно использовать собственную форму входа.

Для создания собственной формы входа необходимы компоненты расширения Alpha.HMI.Security. В разделе описано, как с их помощью:

  • использовать ограничение длительности сессий пользователей;
  • использовать ограничение срока действия паролей;
  • менять пароли в учетных записях.

Раздел описывает расширенный сценарий применения компонентов Alpha.HMI.Security. В большинстве случаев в проектах Alpha.HMI достаточно обеспечить вход и выход пользователя так, как описано в разделе Управление доступом в проектах.

Для наглядности описан проект-пример формы входа.

  1. Скачайте архив с проектом-примером AuthorizationForm.hmi и откройте в Дизайнер Alpha.HMI.
  2. Запустите Конфигуратор Alpha.Security для просмотра текущей конфигурации подсистемы безопасности.

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

Основная форма проекта-примера – AuthorizationForm:

Форма AuthorizationForm предназначена для вывода информационных сообщений. На ней расположены элементы управления, поля вывода системных сообщений и два элемента типа Таймер. Кроме того, на форме находится SecurityContext – элемент типа Контекст безопасности, обеспечивающий взаимодействие с Alpha.Security.

Форма входа – форма с именем LoginForm:

Форма LoginForm предназначена для ввода учетных данных. На форму добавлены:

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

Форма изменения пароля – форма с именем ChangePasswordAndLoginForm:

Форма предназначена для изменения пароля и регистрации в подсистеме безопасности с новыми учетными данными. На форму добавлены:

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

Уведомление об ограничении длительности сессии

Для того, чтобы ограничить длительность сессии пользователя, необходимо настроить соответствующее право Максимальное время сессии, мин (SessionDurationLimit) в Конфигуратор Alpha.Security. Обратите внимание на вкладку учетной записи пользователя Иванов: для него это право уже добавлено, длительность сессии – 2 минуты. По истечении двух минут после входа сессия завершается, и текущим пользователем становится пользователь по умолчанию.

С правом Максимальное время сессии, мин (SessionDurationLimit) связаны свойства элемента SecurityContext:

  • SessionDurationLimit – хранит значение, записанное в право Максимальное время сессии, мин (SessionDurationLimit);
  • SessionExpiresIn – хранит значение времени, оставшегося до завершения сессии текущего пользователя.

Откройте форму AuthorizationForm. Ознакомьтесь с кодом обработчика события OnTimer элемента Timer_Session, написанным на языке Alpha.Om. Свойство SessionExpiresIn применяется для вывода сообщения об оставшемся до завершения сессии времени:

if (SecurityContext.SessionExpiresIn == 0)
//если время до истечения сессии пользователя равно 0, сессия не ограничена
{
Text_SysMsgSessionDuration.Text = "Длительность сессии не ограничена";
}
else
{
//иначе выводится значение времени, оставшегося до истечении сессии, переведенное в минуты
Text_SysMsgSessionDuration.Text="До конца сессии осталось "
+String.ToString(SecurityContext.SessionExpiresIn/60+1)+" минут(-ы)";
}

Запустите проект в рантайм. Откроется окно выбора действия – основное окно проекта. Для пользователя по умолчанию guest длительность сессии не ограничена, о чем будет написано в информационном сообщении:

Нажмите кнопку Войти. Откроется окно входа:

Из выпадающего списка выберите имя Иванов и введите пароль ivanov1. Окно входа закроется, а в информационном сообщении основного окна появится уведомление о том, что:

  • текущим пользователем стал пользователь с логином ivanov;
  • до завершения сессии текущего пользователя осталось 2 минуты:

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

При вводе учетных данных видеть имя в выпадающем списке привычнее, чем логин. Поэтому в данном примере выпадающий список заполняется не логинами, а отображаемыми именами. Для этого вместо функции GetLoginName() используется функция GetDisplayName() элемента UserList. Функция GetDisplayName() возвращает отображаемое имя учетной записи.

Уведомление об истечении срока действия пароля

Для того, чтобы установить срок действия пароля учетной записи, необходимо настроить право Срок действия пароля, дней (PasswordAge) в Конфигуратор Alpha.Security. Для пользователя с именем Иванов максимальный срок действия пароля – 2 дня. Через два дня после изменения пароля попытки входа отклоняются подсистемой безопасности.

С правом Срок действия пароля, дней (PasswordAge) связано свойство PasswordExpiresIn элемента SecurityContext. Это свойство хранит оставшееся время действия пароля.

Откройте форму AuthorizationForm. Ознакомьтесь с кодом обработчика события OnTimer элемента Timer_Password, написанным на языке Alpha.Om. Свойство PasswordExpiresIn применяется для вывода сообщения об истечении срока действия пароля:

if (SecurityContext.PasswordExpiresIn == 0)
//если время до истечения срока действия пароля равно 0, срок действия пароля не ограничен
{
Text_SysMsgPswdExpiration.Text = "Срок действия пароля не ограничен";
}
else
{
//иначе выводится значение времени, оставшегося до конца срока действия пароля, переведенное в часы
Text_SysMsgPswdExpiration="Ваш пароль истечет через "
+String.ToString(SecurityContext.PasswordExpiresIn/3600+1)+" часов";
}

Запустите проект в рантайм. Войдите с учетными данными Иванов. В информационном сообщении основного окна появится уведомление о том, что:

  • текущим пользователем стал пользователь с логином ivanov;
  • срок действия пароля текущего пользователя истечет в указанное время:

Изменение пароля учетной записи

Когда необходимо реализовать возможность изменения пароля, можно использовать функцию AsyncLoginWithPasswordChange() элемента SecurityContext.

Откройте форму изменения пароля ChangePasswordAndLoginForm. Ознакомьтесь с обработчиком события MouseClick кнопки Изменить и войти:

SecurityContext.AsyncLoginWithPasswordChange(UserName[ComboBox_UserList.SelectedIndex],
TextEdit_OldPswd,TextEdit_NewPswd);
//выполнение функции AsyncLoginWithPasswordChange, входными параметрами для которой являются 
//логин, старый пароль и новый пароль
Close();

Входными параметрами функции AsyncLoginWithPasswordChange() являются логин, текущий и новый пароль, введенные в соответствующие поля.

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

Окно изменения пароля закроется, а результат операции появится в информационном сообщении основного окна. Если операция завершится без ошибок, будет осуществлен вход с новыми учетными данными.

Пароль не удастся изменить, если не вышел минимальный срок его действия. Сделать это может только пользователь с правами администратора в Конфигуратор Alpha.Security. Минимальный срок действия пароля указан в праве Срок действия пароля (PasswordAge).