Настройка

Предварительные требования

Для работы Брокера необходимы:

• установленный модуль Inventory
• настроенное подключение к системной базе данных

Включение приема сообщений

По умолчанию прием сообщений выключен, и журнал Брокера не заполняется. Чтобы включить прием, откройте Навигационное меню - Параметры системы - Консоль разработчика и выполните запрос:

PUT _cluster/settings
{
  "persistent": {
    "sm.broker.enabled": true
  }
}

После этого модули начинают присылать сообщения в журнал.

Чтобы выключить прием, выполните тот же запрос со значением false. Новые сообщения перестанут поступать в журнал, а уже полученные сообщения и объекты сохранятся.

Срок хранения журнала

По умолчанию сообщения хранятся в журнале 12 месяцев, более старые сообщения удаляются. Срок задается в месяцах кластерной настройкой sm.broker.retention_months, значение 0 отключает удаление.

Пример запроса, который устанавливает срок хранения 6 месяцев:

PUT _cluster/settings
{
  "persistent": {
    "sm.broker.retention_months": 6
  }
}

Права доступа

Доступ к данным Брокера задается правами на модули и на конфигурации идентификации:

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

Доступ к отдельному модулю задается пунктом Разрешения в меню действий модуля на странице Источники сообщений. Доступ к отдельной конфигурации задается так же на странице Правила идентификации.

Доступ сразу ко всем модулям и конфигурациям дают разрешения кластера, которые назначаются роли:

Разрешение	Что дает
cluster:admin/sm/broker_sources/read_all	просмотр всех модулей
cluster:admin/sm/broker_sources/write_all	изменение всех модулей
cluster:admin/sm/broker_identity_configs/read_all	просмотр всех конфигураций идентификации
cluster:admin/sm/broker_identity_configs/write_all	изменение и удаление всех конфигураций идентификации
cluster:admin/sm/broker_identity_configs/create	создание конфигураций идентификации

Добавление раздела в навигационное меню

Чтобы добавить Брокер в меню, перейдите в Навигационное меню - Параметры системы - Настройки модулей - Основное - Настройки меню - JSON структура и добавьте объект JSON ниже в список data.

Меню Брокера

{
  "itemType": "group",
  "name": "broker",
  "id": "7fe7e349-698b-48e5-a132-cd67b6f7f49e",
  "title": "Брокер",
  "enabled": true,
  "sections": [
    {
      "itemType": "page",
      "name": "sources",
      "id": "e737692c-6e1f-47dd-be5c-e6dc42716386",
      "title": "Источники сообщений",
      "enabled": true
    },
    {
      "itemType": "page",
      "name": "messages",
      "id": "058de378-b050-4fa5-a4ec-62e10d28f096",
      "title": "Журнал",
      "enabled": true
    },
    {
      "itemType": "page",
      "name": "objects",
      "id": "f41800c7-0710-46e2-8c54-74f4303de08b",
      "title": "Объекты",
      "enabled": true
    },
    {
      "itemType": "page",
      "name": "identity",
      "id": "a057f380-33da-47b0-8bdb-cfcaa441b86d",
      "title": "Правила идентификации",
      "enabled": true
    }
  ]
}