Alpha.Community

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

История изменений

2.0

Важно. Текущая версия предназначена для использования c Alpha.HMI 2.0.

Улучшение

Функция GetMembersList() компонента Настройка безопасности: Пользователь (SecurityManagerUser) теперь предоставляет больше данных. Помимо uid и логина (или названия) участника группы теперь предоставляется информация о том, является ли участник пользователем или дочерней группой.

Исправление

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

2.0.1

Улучшение

Функция RequestUserList() компонента Настройка безопасности: Менеджер (SecurityManager), помимо прочих данных об учетных записях, теперь предоставляет их уникальные идентификаторы (uid).

Исправления

Доработаны функции и события компонента Контекст безопасности (SecurityContext):

  • При обращении функции RemoteGetLoggedUsersList() к недоступной рабочей станции не активировалось событие RemoteGetLoggedUsersFailed.
  • События ConnectedChanged и CurrentUserChanged активировались дважды при запуске проекта Alpha.HMI в рантайм, теперь - только один раз.

2.0.2

Функция GetTokensList() компонента Настройка безопасности: Приложение теперь предоставляет больше данных о правах приложений.

2.0.3

Обратите внимание: не рекомендуется использовать предыдущую версию 2.0.2 из-за иногда возникающих ошибок запуска проектов Alpha.HMI, использующих компоненты безопасности.

Новая возможность

Разработан компонент Информация лицензирования: Получение (LicenseInfo). Компонент предназначен для получения информации о лицензии на продукты Альфа платформы, установленные на локальной или удаленных рабочих станциях, включенных в сеть Alpha.Net.

Исправления

  • Устранена причина, по которой недавно удаленная учетная запись появлялась в списке пользователей, полученном в результате вызова функции RequestUsersList() компонента Настройка безопасности: Менеджер (SecurityManager).
  • Метод проверки соответствия пароля требованиям ValidatePassword() компонента Настройка безопасности: Пользователь (SecurityManagerUser) теперь корректно работает и для кириллических паролей.

2.0.4

Исправления

  • Исправлена ошибка, из-за которой был невозможен вход под учетной записью, которой требовалась смена пароля, во время другой активной пользовательской сессии.
  • Устранена причина активации двух событий компонента Настройка безопасности: Менеджер при вызове функции ExportConfiguration() – успешное и неуспешное сохранение резервной копии конфигурации – если сохранить копию пытался пользователь без прав на создание файлов в указанной папке.
  • Теперь при сохранении учетной записи пользователя с помощью функции Save() компонента Настройка безопасности: Пользователь выполняется проверка, не указан ли пустой пароль.
  • Исправлена ошибка, из-за которой у пользователя не учитывались права, назначенные его группе из приложения, если этой группе также была назначена роль из этого приложения.
  • Устранена причина, по которой функция GetApplicationsList() компонента Настройка безопасности: Группа не возвращала список прав группы, унаследованных от родительской группы.
  • Исправлена ошибка, из-за которой у компонента Настройка безопасности: Контроль целостности активировались события об успешном завершении операции при обращении к несуществующему узлу.
  • События ConnectedChanged и CurrentUserChanged компонента Контекст безопасности снова активируются дважды при запуске проекта Alpha.HMI в рантайм. Два события – это более правильное поведение компонента. В первый раз событие активируется при начальной инициализации проекта. Второй раз – когда агент передает в проект информацию о текущем пользователе.
  • Исправлены другие некритичные ошибки.

2.0.5

Исправление

Устранена причина, по которой функция GroupDisplayName() компонента Контекст безопасности не возвращала значений. Ошибка возникала при использовании предыдущей версии – 2.0.4.

2.0.7

Исправления

  • Устранена причина, по которой свойство GuestMode компонента Контекст безопасности предоставляло некорректное значение при первом запуске проекта в рантайм.
  • Функция ValidatePassword() компонента Настройка безопасности: Пользователь теперь возвращает корректные значения, если проверяемый пароль пустой или содержит пробелы.
  • Исправлена ошибка, из-за которой права, назначенные роли, не удалялись при использовании функции RoleDeleteRight() компонента Настройка безопасности: Приложение.

2.0.8

Исправления

2.0.9

Новые возможности

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

  • свойства CurrentLdapHost, CurrentLdapPort – для получения информации о текущем LDAP-сервере;
  • функции SetConfigureServer(), ResetConfigureServer() – для подключения и отключения от LDAP-сервера;
  • события LDAPServerChanged, LDAPServerChangeFailure – для получения информации о подключении к LDAP-серверу.

Улучшение

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

Исправления

  • Устранена причина, по которой функция RequestUsersList() компонента Настройка безопасности: Менеджер не предоставляла обновленный список пользователей после импорта учетных записей из домена.
  • Исправлена некорректная активация событий DeleteUserComplete и DeleteUserFailed компонента Настройка безопасности: Менеджер при попытке удаления учетной записи с правом Запрещено удалять пользователя если есть активная сессия (NonDeletebleWhileActive).
  • Исправлен текст ошибки, возникающей при попытке повторного входа пользователя с правом Только одна пользовательская сессия (ActivityLimitedToOneWorkstation). Ранее текст ошибки был неинформативен.
  • Устранена ошибка, возникавшая при попытке создать приложение или право с длинным названием: допустимое количество символов увеличено до 100.

2.0.10

Улучшение

Компоненту Настройки безопасности: Контроль целостности добавлены новые функции и события:

  • Функция SubscribeEtalonDiffConfig() предназначена для подписки на событие изменения файла конфигурации контроля целостности, функция UnsubscribeEtalonDiffConfig() – для отмены подписки. Можно не указывать входной параметр – тогда будет меняться состояние подписки на изменения локального файла; либо указать имя удаленной рабочей станции для подписки на изменения удаленного файла.
  • События EtalonDiffConfig и RemoteEtalonDiffConfig, активирующиеся при получении уведомления об изменении файла конфигурации контроля целостности на локальной или удаленной станции соответственно.
  • События EtalonDiffConfigFailed и RemoteEtalonDiffConfigFailed, активирующиеся при возникновении проблем при получении уведомления об изменении файла конфигурации контроля целостности на локальной или удаленной станции соответственно.

Исправления

  • Устранены ошибки, связанные с выполнением функции SetConfigureServer() компонента Настройка безопасности: Менеджер:
    • Увеличен таймаут запроса данных с удаленного LDAP-сервера. Ранее запрос часто завершался с ошибкой "Ответ не получен за отведенное время".
    • Устранена причина, по которой при подключении к удаленному LDAP-серверу сохранение и восстановление конфигурации из резервной копии ошибочно выполнялось для локального сервера.
  • Исправлен неинформативный текст ошибки, возникающей при попытке редактирования конфигурации от имени пользователя, имеющего права на просмотр, но не редактирование конфигурации.
  • Устранена причина аварийного завершения работы Alpha.HMI при указании слишком длинного пароля в качестве значения входного параметра функции AsyncLogin() компонента Контекст безопасности.

2.0.12

Исправления

Исправлена некорректная работа следующих компонентов:

  • Настройка безопасности: Контроль целостности, событие EtalonDiffConfig.
  • Настройка безопасности: Приложения, функция SaveFalied() – при попытке изменить значение права роли.
  • Настройка безопасности: Пользователь, функция Save() – при попытке изменить пароль пользователя после ужесточения требований к паролю.

Включены изменения непубличной версии 2.0.11

Улучшения

  • Компоненту Настройка безопасности: Контроль целостности добавлены новые функции и события:

    • функции JsonRequest() и JsonRemoteRequest(), предназначенные для получения и изменения текущей конфигурации контроля целостности в виде JSON-строки на локальной или удаленной рабочей станции;
    • события JsonRequestComplete и JsonRemoteRequestComplete, активирующиеся при получении текущей конфигурации контроля целостности в переменную response или в случае возникновения проблем при ее получении;
    • функции SubscribeAutoControlResults() и UnsubscribeAutoControlResults(), предназначенные для подписки и отмены подписки на результаты автоматических проверок целостности;
    • события AutoCheckComplete и AutoCheckFailed, активирующиеся при получении результата автоматической проверки целостности в переменную autoResult или в случае возникновения проблем при его получении.

    Также у компонента удалены события RemoteEtalonDiffConfig и RemoteEtalonDiffConfigFailed, добавленные в Alpha.HMI.Security 2.0.10. Теперь уведомление об изменении файла конфигурации контроля целостности на локальной или удаленной станции активирует одно и то же событие – EtalonDiffConfig, а ошибка получения уведомления – событие EtalonDiffConfigFailed.

  • Компоненту Контекст безопасности добавлено свойство Дополнительная проверка криптостойкости пароля (ExtendPasswordStrengthCheck), запускающее дополнительную проверку криптостойкости пароля.

Исправления

  • Устранена причина, по которой при подключении к каталогу на удаленном LDAP-сервере пользователю, не имеющему доступа к просмотру и редактированию конфигурацию каталога, такой доступ ошибочно предоставлялся.
  • Попытка сохранить значение строкового права с пустыми строками приводила к исчезновению этого права.
  • Наличие экземпляра типа Контекст безопасности в проекте приводило к аварийному завершению работы Alpha.HMI при перезапуске службы Alpha.Net.

2.0.13

Для корректной работы этой версии используйте Alpha.Security 1.7.26.

Новая возможность

Компоненту Настройка безопасности: Менеджер (SecurityManager) добавлены:

  • функция GetExternalUserList(), запрашивающая список учетных записей из внешнего источника аутентификации, указанного в настройках агента безопасности;
  • событие GetExternalUserListFinished, активирующееся в случае успешного получения списка учетных записей, запрошенных функцией GetExternalUserList().

Исправления

  • Устранена причина, по которой компоненты расширения не получали актуальных значений прав для текущего пользователя из удаленного LDAP-сервера.
  • Импорт конфигурации из резервной копии на удаленном LDAP-сервере теперь возможен только при предоставлении учетных данных администратора этого сервера.
  • Эффективные значения прав системного приложения Alpha.Security теперь высчитываются корректно.

2.0.15

Исправление

[Контроль целостности] Устранена причина аварийного завершения работы Alpha.HMI при попытке создания эталона с использованием компонентов расширения.

2.0.16

Новая возможность

Добавлен новый элемент Числовой элемент безопасности (NumericTokenProxy). Экземпляры элемента можно использовать в проектах Alpha.HMI для создания и редактирования в подсистеме безопасности прав, имеющих числовое значение.

Исправления

  • Исправлены ошибки, из-за которых в результате запуска проектов Alpha.HMI, использующих компоненты Alpha.HMI.Security, происходили:
    • аварийное завершение работы службы агента безопасности, Alpha.HMI.WebViewer или самого Alpha.HMI;
    • долгий запуск и зависание режима рантайма.
  • Новые значения прав "Состав пароля" и "Сложность пароля" теперь сравниваются при задании пароля пользователя средствами расширения. Ранее удавалось изменить значения этих прав на конфликтующие, в результате чего возникала вероятность утраты доступа пользователя к конфигурации.
  • Устранена причина, по которой компоненты расширения не получали от агента безопасности актуальные значения прав приложений, созданных путем импорта из файла.

Изменения документации

Редакция 1

Обновлен пример возвращаемого значения:

Редакция 2

В разделе Контроль целостности файлов и папок руководства пользователя:

В справочном руководстве актуализировано описание свойства IC_List_JSON компонента Настройка безопасности: Контроль целостности.

Редакция 3

Внутренние изменения. Содержимое документа не изменилось.

Редакция 4

В справочном руководстве описан новый компонент – Информация лицензирования: Получение (LicenseInfo).

Редакция 5

В руководстве пользователя:

В справочном руководстве:

  • Описана ранее не описанная функция компонента Настройка безопасности: Пользователь – ValidatePassword(). Здесь же актуализировано описание функции SetPassword().
  • Обновлен пример значения, возвращаемого функцией GetTokensList() компонента Настройка безопасности: Приложение.

Редакция 6

Внутренние изменения. Содержимое документа не изменилось.

Редакция 7

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

Редакция 8

В руководстве пользователя обновлен раздел, описывающий, как создать Собственный конфигуратор подсистемы безопасности: добавлен подраздел, описывающий настройку подключения к произвольному LDAP-серверу. Также обновлен прикладываемый к разделу проект-пример.

Актуализировано справочное руководство.

Редакция 9

В руководстве пользователя обновлен раздел Контроль целостности файлов и папок: переработана структура раздела, добавлен пример использования компонента Настройка безопасности: Контроль целостности (SecurityIntegrityControl) для получения текущей конфигурации контроля целостности, обновлен проект-пример, прикладываемый к разделу.

Также актуализировано справочное руководство:

Редакция 10

В справочном руководстве актуализировано описание компонента Настройка безопасности: Менеджер (SecurityManager), описаны его новые функция GetExternalUserList() и событие GetExternalUserListFinished.

Редакция 11

В справочном руководстве:

  • Описаны новая функция LogAudit2() элемента Контекст безопасности и новое событие LdapUserChanged элемента Настройка безопасности: Менеджер.
  • В описаниях свойств, функций и событий, обрабатывающих строковые права, упомянута возможность загрузки нескольких значений.

Редакция 12

В справочном руководстве исправлено описание события ValueChanged компонента Строковый элемент безопасности.

Редакция 13

В справочном руководстве исправлена опечатка в описании события ValueChanged компонента Строковый элемент безопасности.

Редакция 14

В справочном руководстве:

В руководстве пользователя актуализированы скриншоты и исправлены опечатки.

Редакция 15

  • В справочном руководстве актуализировано описание компонента Настройка безопасности: Контроль целостности (SecurityIntegrityControl): помечены устаревшие свойства, функции и методы, добавлены описания для новых свойств, функций и методов, заменяющих устаревшие.
  • В руководстве пользователя актуализирован раздел Контроль целостности файлов и папок: здесь указано, какие функции и события использовать взамен устаревших для создания эталонов, выполнения проверок и получения их результатов.

1.2

1.2.3

Улучшение

Функция RequestUserList() компонента Настройка безопасности: Менеджер (SecurityManager) теперь предоставляет больше данных. Раньше список, возвращаемый функцией, содержал только uid и логин каждой учетной записи подсистемы безопасности. Теперь список содержит больше данных: фамилии, должности, номера телефонов и пр.

Исправление

Компонент Контекст безопасности (SecurityContext) больше не посылает в журнал приложений сообщения о внутренней работе. К таким относились сообщения вида "Деструктуризация булевского токена ...", "Удаление указателя на прокси контекст у токена ..." и т.п.

Изменения документации

Редакция 1

В руководстве пользователя более подробно описан процесс подготовки конфигурационных файлов Alpha.Security для настройки контроля целостности.

В справочном руководстве:

Во всем документе скриншоты, содержащие код обработчиков событий, заменены на текстовые блоки кода.

Редакция 2

Описан ранее не описанный компонент Мастер конфигурирования Security:

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

Редакция 3

В руководстве пользователя:

В справочном руководстве:

  • Обновлен пример значения, возвращаемого функцией RequestUserList() компонента Настройка безопасности: Менеджер (SecurityManager). Пример приведен в описании события RequestAppListComplete, активирующегося в результате успешного выполнения функции.
  • Добавлена информация об особенности события CurrentUserChanged – оно активируется дважды при запуске проекта Alpha.HMI в рантайм.

Также исправлена история изменений для второй редакции документа, соответствующей Alpha.HMI.Security версии 1.2. Ранее было указано, что содержимое документа не изменилось.

1.1

1.1.1

Реализована возможность создания и восстановления резервных копий конфигурации Alpha.Security.

Изменения документации

Редакция 2

Руководство пользователя

Справочное руководство

  • Описаны новые функции и события компонента Настройка безопасности: Менеджер, используемые для создания и восстановления резервных копий конфигурации Alpha.Security.
  • Исправлено неверно указанное имя входного параметра функции GetErrorDescriptionByCode() компонентов Настройка безопасности: Приложение, Настройка безопасности: Группа, Настройка безопасности: Пользователь: параметр называется не FailReason, а FailReasonCode.
  • Исправлено описание функции LogAudit(): входные параметры могут принимать значения от 0 до 3, а не от 1 до 4, как было указано ранее.
  • Дополнены примеры возвращаемых значений некоторых функций.

1.0

Изменения документации

Редакция 2

  • Реализована возможность скачивания файлов проектов-примеров из веб-версии документа.
  • Обновлена информация о количестве юнитов, появляющихся при установке расширения. Вместо двух юнитов – Security и Security Configuration – появляется один юнит Security.
  • Добавлено описание функции Login() компонента Контекст безопасности (SecurityContext).
  • Исправлен неверно указанный входной параметр функций ForceStopUserSession() и ResetUserFailedLoginCounter() компонента Контекст безопасности (SecurityContext). Входным параметром обеих функций является логин пользователя, а не uid, как было указано ранее.