Alpha.Community

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

Свойства

Дополнительная проверка криптостойкости пароля (ExtendPasswordStrengthCheck)

Активация дополнительной проверки криптостойкости пароля (проверка наличия повторяющихся символов и символов, расположенных в закономерной последовательности на клавиатуре) при создании или изменении пароля функциями ChangePassword() и AsyncLoginWithPasswordChange() компонента Контекст безопасности и ValidatePassword() компонента Настройка безопасности: Пользователь.

Вызов: SecurityContext.ExtendPasswordStrengthCheck

Значение:

  • true – выполняется дополнительная проверка криптостойкости пароля;
  • false – дополнительная проверка криптостойкости пароля не выполняется.

CurrentUser

Логин текущего пользователя. Тип значения – string.

Только для чтения в режиме рантайма.

Вызов: SecurityContext.CurrentUser

Пример значения: ivanov.

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

CurrentUserId

Уникальный идентификатор (uid) текущего пользователя. Тип значения – string.

Только для чтения в режиме рантайма.

Вызов: SecurityContext.CurrentUserId

Вид значения: alpha:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Пример значения: alpha:c3a997b1-326e-42ee-8907-e359fc17feb7.

Уникальный идентификатор формируется подсистемой безопасности в момент создания учетной записи.

CurrentUserDisplayName

Отображаемое имя текущего пользователя. Тип значения – string.

Только для чтения в режиме рантайма.

Вызов: SecurityContext.CurrentUserDisplayName

Пример значения: Иванов.

GuestMode

Признак гостевого режима. Тип значения – bool.

Только для чтения в режиме рантайма.

Вызов: SecurityContext.CurrentUser

Значение:

  • true – текущим пользователем является пользователь по умолчанию;
  • false – текущий пользователь вошел с личными учетными данными.

Connected

Состояние соединения с Агент Alpha.Security. Тип значения – bool.

Только для чтения в режиме рантайма.

Вызов: SecurityContext.Connected

Значение: 

  • true – есть соединение с Агент Alpha.Security; 
  • false – нет соединения с Агент Alpha.Security.

ConnectionError

Текст ошибки соединения с Агент Alpha.Security. Тип значения – string.

Только для чтения в режиме рантайма.

Вызов: SecurityContext.ConnectionError

Пример значения: Соединение с Net агентом разорвано. Код ошибки1.

LdapConnectionsInfo

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

Только для чтения в режиме рантайма.

Вызов: SecurityContext.LdapConnectionsInfo

Пример значения:

{
 "connectionState": [
  {
   "host": "127.0.0.1",
   "port": 389,
   "isAvailable": true,
   "isActive": true,
   "currentContextCSN": "",
   "connectionSyncState": 2,
   "lastErrorCode": -1
  },
  {
   "host": "192.11.99.22",
   "port": 389,
   "isAvailable": true,
   "isActive": false,
   "currentContextCSN": "",
   "connectionSyncState": 2,
   "lastErrorCode": -1
  }
 ],
 "syncState": 2
}

SessionStartTime

Метка времени начала текущей сессии пользователя. Тип значения – timestamp.

Только для чтения в режиме рантайма.

Пример вызова: Text_Msg.Text = DateTime.ToString(SecurityContext.SessionStartTime)

Пример значения: 13.08.2021 09:20:14 после применения функции DateTime.ToString().

InactiveRemainTime

Оставшееся время неактивности пользователя. Тип значения – uint4, единица измерения – секунда.

Только для чтения в режиме рантайма.

В момент, когда пользователь перестает взаимодействовать с АРМ, запускается таймер, отсчитывающий оставшееся время неактивности.

Значение максимального времени неактивности для текущего пользователя указано в праве Максимальное время бездействия, мин (MaxIdleTime). Назначить право можно в Конфигуратор Alpha.Security.

По истечении указанного в праве времени сессия текущего пользователя автоматически завершается.

Вызов: SecurityContext.InactiveRemainTime

Для отслеживания активности должен выполняться процесс Alpha.Security CheckActivity Executable, запускаемый утилитой alpha.security.useractivity.exe.

SessionDurationLimit

Максимальная длительность сессии текущего пользователя. Тип значения – uint4, единица измерения – секунда.

Только для чтения в режиме рантайма.

Значение максимальной длительности сессии для текущего пользователя указано в праве Максимальное время сессии, мин (SessionDurationLimit). Назначить право можно в Конфигуратор Alpha.Security.

Вызов: SecurityContext.SessionDurationLimit

Пример значения: 120.

SessionExpiresIn

Оставшееся время до завершения текущей сессии. Тип значения – uint4, единица измерения – секунда.

Только для чтения в режиме рантайма.

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

Значение максимального времени длительности сессии для текущего пользователя указано в праве Максимальное время сессии, мин (SessionDurationLimit). Назначить право можно в Конфигуратор Alpha.Security.

По истечении указанного в праве времени сессия текущего пользователя автоматически завершается.

Вызов: SecurityContext.SessionExpiresIn

Пример использования: Уведомление об ограничении длительности сессии.

PasswordExpires

Наличие ограничений срока действия пароля. Тип значения – bool.

Только для чтения в режиме рантайма.

Значение определяется наличием у текущего пользователя права Срок действия пароля, дней (PasswordAge). Назначить право можно в Конфигуратор Alpha.Security.

Вызов: SecurityContext.PasswordExpires

Значение: 

  • true – есть ограничения срока действия пароля; 
  • false – нет ограничений срока действия пароля.

PasswordExpiresSoon

Уведомление о скором истечении срока действия пароля. Тип значения – bool.

Только для чтения в режиме рантайма.

Значение свойства связано со значениями прав Срок действия пароля, дней (PasswordAge) и Уведомление о смене пароля, дней (PasswordNotifyForChange) текущего пользователя. Оставшееся время действия пароля сравнивается со сроком уведомления о смене пароля.

Назначить права можно в Конфигуратор Alpha.Security.

Вызов: SecurityContext.PasswordExpiresSoon

Значение: 

  • true – оставшееся время действия пароля внутри срока уведомления о смене пароля; 
  • false – оставшееся время действия пароля вне срока уведомления о смене пароля.

PasswordExpiresIn

Оставшееся время действия пароля. Тип значения – uint4, единица измерения – секунда.

Только для чтения в режиме рантайма.

В момент, когда пользователь меняет пароль, запускается таймер, отсчитывающий оставшееся время действия пароля.

Значение срока действия пароля для текущего пользователя указано в праве Срок действия пароля, дней (PasswordAge). Назначить право можно в Конфигуратор Alpha.Security.

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

Вызов: SecurityContext.PasswordExpiresIn

Пример использования: Уведомление об истечении срока действия пароля.

LoginError

Текст ошибки входа. Тип значения – string.

Только для чтения в режиме рантайма.

Вызов: SecurityContext.PasswordExpiresIn

Пример значения: На узле 'LOCAL' зафиксирована ошибка: Служба 'SECURITYAGENT' не зарегистрирована.

LoginRejectReason

Причина отклонения входа подсистемой безопасности. Тип значения – string.

Только для чтения в режиме рантайма.

Подсистема безопасности отклоняет вход при:

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

Вызов: SecurityContext.LoginRejectReason

Пример значения: Неверные учетные данные.

PasswordChangeError

Текст ошибки, возникающей при попытке смены пароля. Тип значения – string.

Только для чтения в режиме рантайма.

Вызов: SecurityContext.PasswordChangeError

Пример значения: Не вышел минимальный срок действия пароля.

GroupCount

Количество групп, в которых состоит текущий пользователь. Тип значения – uint8.

Только для чтения в режиме рантайма.

Вызов: SecurityContext.GroupCount

Пример значения: 2.

Ready

Готовность экземпляра компонента к работе. Тип значения – bool.

Только для чтения в режиме рантайма.

Вызов: SecurityContext.Ready

Значение: 

  • true – экземпляр готов к работе;
  • false – экземпляр не готов к работе: возможно, не выполнено подключение к агенту безопасности, возникли ошибки на LDAP-сервере и т.п..