Alpha.Community

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

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

4.0

Изменение

В шаблонах приложений, поставляемых с дистрибутивом конфигуратора, название json-объекта "Tokens" заменено на "Rights".

Улучшения

  • Поддержана возможность создания и редактирования прав, имеющих числовое значение.
  • Добавлена возможность масштабирования форм, поставляемых в составе компонентов расширения. Масштаб формы можно изменить, применив к ней тему оформления.
  • В шаблоны приложений Alarms и Trends добавлено право "Максимальная длительность интервала запроса истории, суток" (MaxHistoryInterval).

Исправления

  • Исправлена блокировка кнопок панели инструментов в окне редактирования только что созданной роли.
  • Устранена причина ошибочного появления сообщения об успешном импорте приложения из файла, не имеющего требуемой структуры json-объектов.
  • Текст в окнах импорта пользователей из домена и внешней системы аутентификации теперь отображается корректно.

4.0.1

Исправления

  • Теперь перед удалением группы выполняется проверка наличия в ней пользователей. Ранее удаление таких групп было доступно, даже если для конфигуратора была настроена обязательность добавления пользователей в группу (параметр UserInAtLeastOneGroup=true).
  • Исправлено отображение кнопок на панели инструментов редактирования групп.

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

Редакция 1

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

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

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

3.0

Улучшения

  • Добавлена возможность использования новых системных прав: Состав Пароля, Проверка наличия пользовательских данных в пароле, Время сохранения сессии пользователя при разрыве связи агента безопасности с хранилищем, сек.
  • На панель инструментов добавлены кнопки Назад, Вперед, Наверх.
  • Изменен внешний вид окна просмотра приложений и окна редактирования ролей.
  • Формат иконок приложения изменен на SVG. Ранее использовался формат PNG.
  • Изменены расположение и содержимое конфигурационных файлов приложения:

    • Настройки приложения и компонентов расширения хранятся в файлах app_settings.json и settings.json, расположенных в папке:
      • C:\ProgramData\Automiq\HMI.SecurityConfigurator для ОС Windows;
      • /home/<user>/Automiq/HMI.SecurityConfigurator для ОС Linux.
    • Настройки сессии приложения хранятся в файле app_session.json, настройки сессии компонентов – в файле session.json. Эти файлы расположены в папке:
      • C:\Users\<user>\Automiq\HMI.SecurityConfigurator для ОС Windows;
      • /home/<user>/Automiq/HMI.SecurityConfigurator для ОС Linux.

Исправления

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

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

Редакция 1

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

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

2.5

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

  • Добавлена возможность подключения к произвольному LDAP-серверу. Для этого на панель инструментов добавлена кнопка Подключиться к серверу, нажатие на которую открывает диалоговое окно подключения, в котором необходимо указать адрес и порт нужного LDAP-сервера, название корневого каталога и учетные данные администратора этого каталога.
  • Добавлена возможность импорта учетных записей из внешних источников учетных данных. Для этого рядом с кнопкой импорта учетных записей добавлена кнопка, открывающая выпадающий список, содержащий команду открытия окна подключения к внешнему источнику данных. Источники должны быть заранее описаны в настройках агента безопасности. Для подключения ко внешнему источнику необходимо указать его идентификатор (как в настройках агента безопасности), имя, а так же учетные данные администратора этого источника.

Изменения

  • Изменено окно восстановления конфигурации из резервной копии. Теперь если восстановление конфигурации выполняется для удаленного LDAP-сервера, потребуется указать учетные данные администратора этого LDAP-сервера.
  • Срок действия пароля теперь можно увеличивать до 750 дней.

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

Редакция 1

Изменена структура руководства пользователя: разделы, описывающие непосредственно изменение конфигурации каталога (добавление групп, учетных записей и пр.), объединены в узел "Редактирование конфигурации". Также в руководстве:

2.4

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

  • Добавлена возможность импорта учетных записей из домена. Для этого на панель инструментов окна просмотра учетных записей добавлена соответствующая кнопка. Также добавлена кнопка открытия журнала, в котором можно отслеживать процесс импорта. Журнал импорта пользователей можно сохранить в файл *.csv, *.pdf или *.xlsx.
  • Добавлена возможность включения/отключения проверки дополнительных требований к криптостойкости пароля при создании и редактировании пользователя. Для этого в файле app_settings.json измените значение свойства ExtendPasswordStrength объекта Permissions. Файл расположен в папке:
    • C:\ProgramData\Automiq\HMI.SecurityConfigurator для ОС Windows;
    • /home/<user>/Automiq/HMI.SecurityConfigurator для ОС Linux.

Изменение

Шаблоны приложений, поставляемые вместе с дистрибутивом конфигуратора, теперь находятся в папке:

  • C:\ProgramData\Automiq\HMI.SecurityConfigurator\AppTemplates для ОС Windows;
  • /usr/local/share/Automiq/HMI.SecurityConfigurator/AppTemplates для ОС Linux.

Улучшения

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

Исправления

  • При попытке удаления учетной записи активного пользователя теперь появляется уведомление о невозможности удаления, если пользователю назначено право Запрет удаления активного пользователя (NonDeletableWhileActive) со значением true. Ранее такую учетную запись позволялось удалить, однако фактически удаления не происходило.
  • Исправлена ошибка, из-за которой создаваемой учетной записи не удавалось назначить роль.
  • Устранена причина, по которой при удалении права из одного приложения удалялись права с таким же названием из других приложений.
  • Для строковых прав многострочные значения из резервной копии конфигурации теперь восстанавливаются нормально. Ранее восстанавливалось только одно значение из нескольких.
  • В окне создания новой учетной записи теперь отображается предупреждение о необходимости указать пароль.

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

Редакция 1

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

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

2.3

Улучшения

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

Исправления

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

2.3.1

Изменения

  • Теперь при попытке использовать в именах приложений и прав спец. символы (.,+\";<>) появляется предупреждение о запрете их использования.
  • В окне создания нового пользователя больше нет полей Пароль и Подтверждение пароля. Чтобы задать пароль для новой учетной записи, используйте кнопку задания пароля. Кнопка находится рядом с предупреждением Необходимо задать пароль. Предупреждение и кнопка отображаются, пока пароль не будет задан.

Исправление

Исправлена ошибка, из-за которой нажатие клавиши Shift в окне просмотра учетных записей приводило к возникновению множества диалоговых окон с ошибкой Очередь остановлена.

2.3.2

Изменение

Видоизменена кнопка задания пароля (увеличен размер и добавлена надпись).

Исправления

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

2.3.3

Исправление

Исправлена ошибка совместимости с Alpha.HMI.CommonLib 2.2.0.

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

Редакция 1

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

Редакция 2

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

Редакция 3

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

2.2

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

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

  • Создан тип Разрешения (SecurityConfigurator_Permissions) со свойством FileSystemAccess (Доступность файловой системы), значение которого регулирует доступ к системе.
  • Типу Настройки (SecurityConfigurator_Settings) добавлено свойство ExportFolder (Папка для экспорта).

Если у пользователя отсутствует доступ к файловой системе (FileSystemAccess = false), то в файловых диалогах будет недоступен просмотр дерева папок и создание новых папок, а экспорт будет возможен только в папку экспорта, указанную в свойстве ExportFolder. По умолчанию папкой для экспорта является:

  • C:\ProgramData\Automiq\HMI.SecurityConfigurator\Export – в ОС Windows.
  • /home/<user>/Automiq/HMI.SecurityConfigurator/Export – в ОС Linux.

Улучшения

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

Изменение

Исключена возможность экспорта информации в файлы *.pdf во всех местах, где можно выполнить экспорт:

  • экспорт списка пользователей и их прав;
  • экспорт таблицы "Список прав и их значений для приложения" со страницы списка приложений;
  • экспорт прав открытого на редактирование приложения.

Исправления

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

2.2.1

Улучшения

  • Тип Разрешения (SecurityConfigurator_Permissions) теперь позволяет использовать сервер безопасности для определения прав доступа пользователя к файловой системе.
  • Панель инструментов теперь оформляется в соответствии с выбранной темой.

Исправление

При использовании Alpha.HMI.WebViewer разделитель областей окна конфигуратора не позволял нормально изменять их размеры.

2.2.2

Исправление

Максимально допустимое значение для прав Максимальное время сессии и Максимальное время бездействия увеличено до 10000. При назначении прав по умолчанию устанавливается значение 1440 (минут).

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

Редакция 1

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

  • В разделе Безопасность в компонентах Альфа платформы актуализирован список шаблонов приложений Alpha.Security, поставляемых с дистрибутивом конфигуратора.
  • Исключено упоминание возможности экспорта данных в файлы *.pdf.
  • Обновлены скриншоты.

В справочном руководстве описаны новые компоненты Настройки и Разрешения, а также их свойства. Для компонентов SecurityConfigurator, SecurityConfigurator_Form и SecurityConfigurator_Page описаны новые свойства – ссылки на экземпляры типов Настройки и Разрешения.

2.1

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

  • Внешний модуль SecurityConfigurator предоставляет новые компоненты для разработки проектов Alpha.HMI:
    • тип SecurityConfigurator, предназначенный для размещения на форме;
    • форма SecurityConfigurator_Page - аналог прежней формы SecurityConfigurator, предназначенный для открытия во фрейме;
    • форма SecurityConfigurator_Form - аналог прежней формы SecurityConfigurator, предназначенный для открытия в виде отдельного окна;
    • форма SecurityConfigurator_App - основная форма, предназначенная для запуска в виде отдельного приложения;
    • тип SecurityConfigurator_Settings, предназначенный для упрощения настройки экземпляров конфигуратора, создаваемых на основе указанных выше типов и форм.
  • Для типа SecurityConfigurator и форм SecurityConfigurator_Page, SecurityConfigurator_Form можно:
    • выбрать тему оформления.
    • настроить вызов экранной клавиатуры в файловых диалогах.
  • Реализована возможность экспорта и импорта собственных шаблонов приложений.

Улучшения

  • Настройки самостоятельного приложения Alpha.HMI.SecurityConfigurator теперь сохраняются в конфигурационный файл app_settings.json, расположенный в:
    • C:\ProgramData\Automiq\HMI.SecurityConfigurator (ОС Windows);
    • /home/<user>/Automiq/HMI.SecurityConfigurator (ОС Linux).
  • Перед удалением учетной записи пользователя теперь проверяется его активность на удаленных рабочих станциях, указанных в настройках экземпляра конфигуратора.
  • Всплывающая подсказка с текстом ошибки теперь отображается всегда, без необходимости наведения мыши на элемент с ошибкой:
    • в окне редактирования учетной записи пользователя;
    • в окне смены пароля учетной записи пользователя.
  • В окне просмотра учетных записей теперь можно создавать, редактировать и удалять учетные записи с помощью клавиатуры или контекстного меню. Аналогично в окне просмотра приложений можно создавать, редактировать и удалять приложения с помощью клавиатуры или контекстного меню.
  • В окне просмотра групп вызвать контекстное меню для создания новой группы теперь можно без выделения существующей группы.
  • Добавлены шаблоны приложений безопасности для решений Alpha.HMI.SetPoints и Alpha.HMI.IntegrityControl.
  • Обновлен шаблон приложения безопасности для Alpha.HMI.Trends.
  • В интерфейсе конфигуратора обновлены иконки.

2.1.1

Исправления

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

2.1.2

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

Теперь при экспорте списка пользователей в файл можно дополнительно создать файлы с перечнем эффективных прав каждого пользователя.

Исправление

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

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

Редакция 2

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

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

Редакция 3

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

В истории изменений исправлен ошибочно указанный номер предыдущей редакции. Вместо "Редакция 1" указано "Редакция 2".

2.0

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

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

Редакция 1

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

1.3

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

Списки приложений и пользователей теперь можно экспортировать в файлы форматов *.csv, *.xlsx, *.pdf.

Примечание: свойство Путь для экспорта таблиц формы SecurityConfigurator, разрабатывавшееся для реализации этой возможности, удалено из интерфейса, так как более неактуально.

Улучшения

  • В окне просмотра списка приложений появилась таблица предварительного просмотра приложений. Теперь при выборе приложения из списка в области справа отображается информация о правах приложения, их значениях и назначениях.
  • В окне просмотра списка пользователей теперь отображается больше информации о пользователях. Помимо логина и отображаемого имени в таблице появились номера телефонов, должности, роли и пр. Набор столбцов таблицы можно менять.

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

Редакция 1

В руководстве пользователя описано, как экспортировать списки приложений и пользователей в файлы форматов *.csv, *.xlsx, *.pdf.

Из справочного руководства удалено упоминание устаревшего свойства Путь для экспорта таблиц формы SecurityConfigurator.

Во всем документе актуализированы скриншоты.

Редакция 2

Информация о конфигурационных файлах приложения актуализирована и перенесена из подраздела Запуск в виде самостоятельного приложения -> "Настройки вида приложения" в новый раздел – Настройки безопасности для разграничения возможностей пользователей.

1.2

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

Улучшения:

  • В окне редактирования групп пользователей у дерева групп появилось контекстное меню с командами:
    • Добавить группу;
    • Редактировать группу;
    • Удалить группу.
  • При перезапуске конфигуратора теперь сохраняется больше параметров внешнего вида приложения.

Исправленные ошибки:

  • При сортировке ролей в окне редактирования ролей значения прав отображались некорректно.
  • При использовании Alpha.HMI.WebViewer в окне редактирования ролей значения строковых прав отображались некорректно.

1.2.1

Улучшение

В наборе компонентов, предоставляемых внешним модулем SecurityConfigurator, появилась новая экранная форма – SecurityConfigurator_Tests. Форма предназначена для ознакомления с примером встраивания конфигуратора безопасности в проект Alpha.HMI – здесь окно конфигуратора открывается по нажатию на кнопку Настройка пользователей.

Исправления

  • Иконка права PasswordAge (Срок действия пароля, дней) в окне выбора прав отображалась некорректно при использовании приложения на ОС Linux.
  • Устранена причина, по которой в окне редактирования учетных записей не сохранялась установленная вручную ширина столбцов.

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

Редакция 1

В руководстве пользователя из раздела Подготовка к работе бывший подраздел Запуск в виде самостоятельного приложения вынесен в самостоятельный раздел. В нем более подробно описан процесс встраивания и обновления расширения в проекте Alpha.HMI.

Редакция 2

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

Редакция 3

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

1.1

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

Добавлена возможность запуска приложения по ярлыку из меню Пуск.

1.1.1

Улучшения:

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

Исправления:

  • Исправлена ошибка, из-за которой пользователям и группам не назначались роли.
  • Устранена причина, по которой группу нельзя было редактировать или удалить сразу после создания.
  • В окне редактирования пользователя или группы при назначении роли больше не блокируется кнопка Сохранить изменения.
  • В окне редактирования пользователя или группы при назначении роли название назначаемой роли отображалось только после нажатия кнопки Сохранить изменения, теперь - сразу при назначении.
  • Исправлено блокирование кнопки Добавить/Удалить в окне выбора прав, происходящее после отмены выбора некоторых пунктов даже при наличии других выбранных пунктов.

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

Редакция 1

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

Редакция 2

Актуализированы скриншоты в разделе Резервное копирование конфигурации.