Словари приложений

Что такое словари приложений

Словари приложений — это механизм автоматической синхронизации структуры внешнего приложения с системой управления доступом IDENTYX. Когда приложение отправляет свои справочники в IAM, система может автоматически создавать соответствующие объекты, действия и организации для управления правами доступа.

Типы словарей

IDENTYX поддерживает три типа словарей приложений:

Просмотр словарей приложения

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

1. Перейдите в раздел Приложения → OpenID Connect
2. Нажмите на нужное приложение для открытия карточки
3. Перейдите на вкладку Справочники

На вкладке Справочники доступны две подвкладки:

Реестр

Вкладка Реестр отображает список всех словарей, которые были загружены приложением в IDENTYX.

Колонка	Описание
Тип справочника	Тип словаря: Объекты приложения, Действия приложения или Организации
Операции	Кнопка просмотра содержимого словаря

Просмотр содержимого словаря

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

1. На вкладке Реестр нажмите кнопку с иконкой глаза напротив нужного словаря
2. Откроется модальное окно с содержимым словаря

В окне просмотра содержимого отображается:

• Дерево элементов — иерархическая структура объектов, действий или организаций
• Количество элементов — общее количество записей в словаре
• Настройки применения — параметры для обработки словаря

Автоматическая загрузка словарей

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

Настройка автообработки

Для настройки автоматической обработки словарей:

1. В карточке приложения перейдите на вкладку Справочники
2. Откройте подвкладку Автоматическая загрузка справочников
3. В таблице настроек отобразятся все доступные типы словарей

Для каждого типа словаря доступны следующие параметры:

Параметр	Описание
Автоматически загружать	Установите флажок для включения автоматической обработки этого типа словаря
Удалять старые объекты	Если флажок установлен, объекты, которых нет в новом словаре, будут удалены из системы

Когда происходит автоматическая обработка

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

• При импорте приложения из JSON — если приложение содержит словари и настроена автообработка
• При обновлении словарей через API — когда приложение отправляет обновленные справочники
• При сохранении настроек приложения — если были изменены маппинги словарей

Ручное применение словаря

Если автоматическая обработка не включена, вы можете применить словарь вручную:

1. Откройте реестр словарей на вкладке Справочники → Реестр
2. Нажмите кнопку просмотра напротив нужного словаря
3. В открывшемся окне настройте параметр Удалять объекты, если их нет в новом справочнике (опционально)
4. Нажмите кнопку Применить справочник

После применения словаря:

• Будут созданы или обновлены соответствующие объекты безопасности в разделе Права доступа → Объекты
• Будут созданы или обновлены действия безопасности в разделе Права доступа → Действия
• При необходимости будут обновлены связанные учетные записи и правила доступа

Импорт и экспорт словарей

Словари приложений автоматически включаются в экспорт и импорт приложений через JSON файлы.

Экспорт приложения со словарями

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

1. Откройте карточку приложения
2. Нажмите кнопку Экспорт внизу карточки
3. Будет создан JSON файл с именем app-{client_id}.json

Экспортируемый файл содержит:

• Все настройки приложения (client_id, client_secret, маршруты и т.д.)
• Маппинги словарей с настройками автообработки
• Параметры удаления старых объектов для каждого типа словаря

Импорт приложения со словарями

При импорте приложения из JSON:

1. Система создаст или обновит приложение
2. Восстановит настройки маппинга словарей
3. Если включена автообработка и в JSON есть словари, они будут автоматически применены

API для работы со словарями

Внешние приложения могут отправлять свои словари в IDENTYX через специальный API метод:

POST /api/service
{
  "action": "putDictionaries",
  "client_id": "client-id-приложения",
  "client_secret": "secret-приложения",
  "data": {
    "dictionaries": {
      "objects": [
        {"id": "/documents", "title": "Документы"},
        {"id": "/reports", "title": "Отчеты"},
        {"id": "/settings", "title": "Настройки"}
      ],
      "actions": [
        {"id": "/read", "title": "Чтение"},
        {"id": "/write", "title": "Запись"},
        {"id": "/delete", "title": "Удаление"}
      ]
    }
  }
}

При получении словарей через API:

1. Система сохраняет содержимое словарей в базу данных
2. Если для этого типа словаря включена автообработка, словарь будет автоматически применен
3. Будут созданы или обновлены соответствующие объекты и действия в дереве прав доступа

Практические сценарии использования

Сценарий 1: Синхронизация структуры меню

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

1. Настройте в приложении отправку словаря objects со структурой меню
2. В IDENTYX включите автоматическую обработку словаря объектов
3. После отправки словаря в IDENTYX автоматически создастся дерево объектов, соответствующее структуре меню
4. Создайте правила доступа (ACL), назначив пользователям или группам права на конкретные разделы меню
5. Приложение при авторизации получит список прав через scope permissions и покажет только разрешенные разделы меню

Сценарий 2: Разграничение прав на действия

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

1. Отправьте словарь actions с доступными действиями (read, write, delete)
2. Отправьте словарь objects с разделами приложения (documents, reports)
3. В IDENTYX создайте правила доступа в формате объект:действие, например:
   • /app-id/documents:read — разрешить чтение документов
   • /app-id/documents:write — разрешить редактирование документов
   • /app-id/documents:delete — разрешить удаление документов
4. Приложение проверяет наличие соответствующих прав перед выполнением операций

Сценарий 3: Автообновление при изменениях

Структура вашего приложения меняется — добавляются новые разделы, удаляются старые. Вы хотите, чтобы изменения автоматически отражались в IAM.

1. Включите автоматическую обработку словарей для приложения
2. Установите флажок Удалять старые объекты (если хотите удалять неактуальные элементы)
3. Настройте приложение на периодическую отправку обновленных словарей в IDENTYX
4. При каждом обновлении структура прав доступа в IAM будет автоматически синхронизироваться с приложением

Связанные разделы

• Создание OIDC приложения — базовая настройка приложений
• Экспорт и импорт приложений — работа с JSON файлами
• Объекты и действия — основы системы прав доступа
• Правила доступа (ACL) — настройка прав на объекты и действия