Identity Cloud : 5.3. Управление приложениями

Общие сведения

Управление приложениями – функциональность в Avanpost Identity Cloud, предназначенная для контроля и настройки приложений. Данная функциональность необходима для управления соединением между структурными элементами Avanpost Identity Cloud и внешними приложениями, предоставляющими услуги, такими, например, как 1C или Zoom. 

Предположим, что организация использует 1С:Предприятие для управления бизнес-процессами. Для Avanpost Identity Cloud приложение 1С:Предприятие является внешним. Организация может интегрировать 1С:Предприятие с продуктом Avanpost Identity Cloud при помощи функциональности управления приложениями. После настройки параметров интеграции приложения администратор может назначить доступ к нему группам или отдельным пользователям Avanpost Identity Cloud.

Функциональность управления приложениями в Avanpost Identity Cloud позволяет администратору решать следующие задачи:

1. Создавать, удалять и настраивать приложения.
2. Управлять доступом пользователей и групп пользователей к приложению.
3. Настраивать сценарии аутентификации для приложения.
4. Передавать информацию о приложении в механизм определения сценария аутентификации для упрощения, усложнения сценария MFA или для принятия решения о запрете аутентификации.
5. Настраивать параметры интеграции приложений для корректной работы с Avapost Identity Cloud.
6. Настраивать параметры безопасности для приложения.
7. Настраивать модель доступа и права (scopes) приложения для OIDC-приложений.

8. Управлять сертификатами OIDC-приложений.

9. Управлять атрибутами SAML-приложений.
10. Управлять атрибутами вендоров (VSA) для RADIUS-приложений.
11. Получать информацию о прохождении аутентификации в приложении в режиме отладки.
12. Отображать администратору информацию о приложениях.

Функциональность управления приложениями позволяет администратору осуществлять следующие операции:

• поиск и получение информации о приложениях;
• добавление/удаление приложений;
• настройка параметров интеграции приложений;
• настройка сценариев аутентификации для приложений;
• заполнение и редактирование данные техподдержки;
• настройка специфических параметров для OIDC-приложений, SAML-приложений, RADIUS-приложений;
• проверка правильности функционирования внешнего приложения в режиме отладки.

Подробные данные о механизмах интеграции приложений доступны в разделы Механизмы интеграции.

Управление приложениями осуществляется в режиме "Приложения", который содержит:

• реестр приложений, отображающий базовую информацию о приложениях;
• элементы управления поиском;
• кнопку "Добавить приложение", переводящую на вкладку с формой добавления приложения.

Типы приложений

Avapost Identity Cloud поддерживает интеграцию со следующими типами приложений:

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

• 5.3.1. Управление OpenID Connect-приложениями
• 5.3.2. Управление SAML-приложениями
• 5.3.3. Управление RADIUS-приложениями
• 5.3.4. Управление Reverse Proxy-приложениями
• 5.3.5. Управление Enterprise SSO-приложениями
• 5.3.6. Управление Windows Logon-приложениями
• 5.3.7. Управление Linux Logon-приложениями
• 5.3.8. Управление LDAP Proxy-приложениями
• 5.3.9. Управление Exchange ActiveSync-приложениями

Служебные приложения

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

К служебным приложениям относятся следующие приложения:

• adminconsole;
• lk-client;
• access-bridge;
• e-passport. 

Поиск приложений

Управление поиском осуществляется при помощи поисковой строки. Поисковая строка позволяет искать пользователей по наименованиям приложений. При этом в реестре отображается следующая информация:

Профиль приложения

Для перехода в профиль приложения требуется нажать на наименование данного приложения в реестре режима "Приложения". Профиль приложения содержит следующие возможности:

• базовые возможности управления приложением, открывающиеся в выпадающем списке при нажатии на кнопку "Еще" в правом верхнем углу: 
  • включить/выключить приложение нажатием на "Включить"/"Выключить" соответственно;
  • включить/выключить режим отладки приложения нажатием на "Включить режим отладки"/"Выключить режим отладки" соответственно;
  • удалить приложение путем нажатия на "Удалить приложение" и подтверждения выбранного действия;
• внесение изменений в настройки приложения;
• получение информации о текущих настройках приложения

Каждое из приложений обладает собственным набором параметров, которые можно разделить на два типа:

• общие - параметры, имеющиеся у всех приложений в системе Avanpost Identity Cloud и представленные во вкладках "Основное", "MFA", "Техподдержка";
• настройки интеграции - параметры, зависящие от конкретных типов приложений, и представленные в соответствующих вкладках в профиле приложения:
  • вкладка "Настройки", содержание которой меняется в зависимости от типа приложения;
  • вкладки "OpenID Connect" для приложений типа OAuth/OpenID Connect;
  • вкладка "SAML" для приложений типа SAML;
  • вкладка "RADIUS" для приложений типа RADIUS.

Специфические параметры приложений рассмотрены в разделах с настройками данных типов приложений. 

Доступна следующая настройка общих параметров приложений.

Режим отладки

В Avanpost Identity Cloud предусмотрена функциональность режима отладки приложений. При включении данного режима в Журнал отладки вносятся специализированные записи при каждой попытке входа пользователей в данное приложение. В сообщениях содержится детализированная информация о процессах, происходящих при аутентификации пользователя в приложении. Журнал отладки предназначен для сбора и анализа технических данных о работе приложения в процессе аутентификации.

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

1. В профиле приложения в правом верхнем углу нажать кнопку "Еще".
2. В выпадающем списке нажать "Включить режим отладки" (для отключения режима нажать "Выключить режим отладки").

Перейти в Журнал отладки приложений можно следующими способами:

• В профиле приложения. При включении режима отладки в профиле приложения появится вкладка "Журнал отладки". При этом в профиле приложения выводится журнал отладки данного приложения. 
• Во вкладке "Журнал отладки приложений" режима "Отчеты". В данном случае пользователю открывается журнал отладка по всем приложениям. 

Статус-коды ошибок gRPC-приложений

В процессе управления gRPC-приложениями (типа Windows Logon, Linux Logon, Enteprise SSO, LDAP Proxy, Exchane ActiveSync) в разработчик получает не только сообщения локализации, но и статус-коды ошибки (параметр errorCode в разделе metadata). Каждый из статус-кодов соответствует той или иной проблеме, возникшей в процессе аутентификации. Перечень и краткое описание статус-кодов даны в таблице. 

Пример отображения статус-кода в сообщении:

"metadata": {
    "message": "Today is a bad day",
    "errorCode": "EmptyPassword"
}