Расширенные возможности администрирования пользователей

Получение списка пользователей системы и их ролей

В некоторых случаях, например, для интеграции со сторонними системами, требуется получить список пользователей. В этом параграфе показан пример получения списка пользователей. Чтобы выполнить этот http-запрос, нужно предварительно получить значение куки BSESSIONID. Это можно сделать, посмотрев Инструменты разработчика (по кнопке F12 или Исследовать) либо выполнив http-запрос аутентификации.

Пример запроса:

curl 'http://hive.host.address/api/user/' \
    -H 'Content-Type: application/json' \
    -H 'Cookie: BSESSIONID=<session_id>'

Пример ответа:

[
  {
    "passwordChangeRequired": false,
    "permissions": [
      "ISSUE_SCHEMA_WRITE",
      "ISSUE_TEMPLATE_WRITE",
      "PROJECT_CREATE",
      "PROJECT_GROUP_CREATE",
      "KNOWLEDGE_BASE_WRITE"
    ],
    "role": "EDITOR",
    "userCreateDate": "2025-04-18T14:19:53.667217",
    "userEmail": "user1@example.com",
    "userId": "7bc0dd52-aee2-4e1b-b14c-525f6d0d79d4",
    "userIsAdmin": false,
    "userIsConfirmed": true,
    "userLastConfirmed": "2025-04-18T14:19:53.667058",
    "userLogin": "user1",
    "userName": "user1"
  },
  {
    "passwordChangeRequired": false,
    "permissions": [],
    "role": "READONLY",
    "userCreateDate": "2025-04-18T14:20:22.377370",
    "userEmail": "user2@example.com",
    "userId": "0e997cac-a313-4c1e-85b6-44b69cd9680b",
    "userIsAdmin": false,
    "userIsConfirmed": true,
    "userLastConfirmed": "2025-04-18T14:20:22.377181",
    "userLogin": "user2",
    "userName": "user2"
  },
  {
    "passwordChangeRequired": false,
    "permissions": [
      "ALL"
    ],
    "role": "ADMIN",
    "userCreateDate": "2025-04-18T14:22:29.216248",
    "userEmail": "user3@example.com",
    "userId": "04aeb7b8-1bd9-4619-b3a0-569c719e7cd8",
    "userIsAdmin": true,
    "userIsConfirmed": true,
    "userLastConfirmed": "2025-04-18T14:22:29.216055",
    "userLogin": "user3",
    "userName": "user3"
  }
]

В данном примере:

userIsAdmin — пользователь является администратором;
userIsConfirmed — false, если пользователь заблокирован или ещё не подтверждён.

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

В Hive продолжительность пользовательской сессии по умолчанию — 360 минут (6 часов). То есть, через 6 часов бездействия сессия пользователя будет прервана, и ему придётся логиниться заново. Но вы можете изменить время жизни пользовательской сессии.

Чтобы изменить продолжительность пользовательской сессии в Hive, измените конфигурацию.

Добавьте опцию b.engine.session.lifetime.minutes и установите числовое значение в минутах.

Пример:

b.engine.session.lifetime.minutes = 1

Выполните реконфигурацию, чтобы изменения вступили в силу.