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

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

В некоторых случаях, например, для интеграции со сторонними системами, требуется получить список пользователей. В этом параграфе показан пример получения списка пользователей. Для того что бы выполнить этот http запрос вам нужно, предварительно, любым возможным получить значение куки BSESSIONID. Это можно сделать, например, посмотрев в инструментах разработчика или (по кнопке F12 или Inspect) или выполнив 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

Сделайте reconfig что бы изменения вступили в силу.