Описание настроек пользователей

Запрос для получения настроек:

https://[адрес_сервера]:[порт]/settings/users/?sid=[id_сессии]

Ответ:

{
    "name" : "users",
    "type" : "UsersFolder",
    "subdirs" : [
        "Admin",
        "Demo",
        "IXWkytqU",
        "Script",
        "XZoJlPC2",
        "user_add"
    ],
    "values" : [
        "local_operator",
        "local_operator_logout"
    ]
}

Таблица 183.

subdirs Описание Версия ПО
Admin Настройки пользователя Admin ≥3.1
Demo Настройки пользователя Demo ≥3.1
Script Настройки пользователя Script ≥3.1
[GUID_пользователя] Настройки пользователя ≥3.1
[GUID_группы] Настройки прав группы пользователей ≥3.1
user_add Создание нового пользователя или новой группы ≥3.1

Запрос для получения настроек группы пользователей:

https://[адрес_сервера]:[порт]/settings/users/[GUID_группы]/?sid=[id_сессии]

Ответ:

{
    "name" : "IXWkytqU",
    "type" : "Group",
    "subdirs" : [

    ],
    "values" : [
        "acl",
        "archive_speed_limit",
        "base_rights",
        "can_change_password",
        "icon",
        "name",
        "notes",
        "ptz_priority",
        "saveable_icon",
        "settings_button",
        "shutdown_button",
        "templates_managing",
        "templates_sharing",
        "view_button"
    ]
}

Запрос для получения настроек пользователя:

https://[адрес_сервера]:[порт]/settings/users/[GUID_пользователя]/?sid=[id_сессии]

Ответ:

{
    "name" : "XZoJlPC2",
    "type" : "User",
    "subdirs" : [

    ],
    "values" : [
        "acl",
        "analytics_rights",
        "archive_speed_limit",
        "base_rights",
        "can_change_password",
        "cloud_login_offline_ttl_sec",
        "cloud_utc_offset_minutes",
        "enable_analytics",
        "enable_local",
        "enable_remote",
        "enable_web",
        "from_cloud",
        "group",
        "group_changed",
        "icon",
        "internal_revision",
        "last_login_address",
        "last_login_time",
        "name",
        "notes",
        "password",
        "password_empty_warning",
        "ptz_priority",
        "random_passwords",
        "roles",
        "saveable_icon",
        "settings_button",
        "shutdown_button",
        "templates_managing",
        "templates_sharing",
        "timer_id",
        "view_button"
    ]
}

Получить значение (R):

https://[адрес_сервера]:[порт]/settings/users/[GUID_группы]/[настройка]?sid=[id_сессии]
https://[адрес_сервера]:[порт]/settings/users/[GUID_пользователя]/[настройка]?sid=[id_сессии]

Изменить значение (W):

https://[адрес_сервера]:[порт]/settings/users/GUID_группы/[настройка]=[значение]?sid=[id_сессии]
https://[адрес_сервера]:[порт]/settings/users/[GUID_пользователя]/[настройка]=[значение]?sid=[id_сессии]

Таблица 184.

values Описание Тип   Версия ПО
acl

Права пользователя на отдельные объекты, записанное в формате:

/[GUID_объекта1]/channels.[сумма_значений_прав1],/[GUID_объекта2]/channels.[сумма_значений_прав2]

 string RW ≥3.1
analytics_rights Права пользователя на аналитику string RW ≥4.0
archive_speed_limit Лимит скорости записи в архив integer RW ≥4.0
base_rights Базовые права группы/пользователя integer RW ≥3.1
can_change_password

Пользователю/группе разрешена смена пароля

0 - нет, 1 - да

integer RW ≥3.3
cloud_login_offline_ttl_sec   integer R ≥4.0
cloud_utc_offset_minutes   integer R ≥4.0
enable_analytics

Пользователю разрешена аналитика через сеть:

0 - нет, 1 - да

integer RW ≥4.0
enable_local

Пользователю разрешен локальный вход:

0 - нет, 1 - да

integer RW ≥3.1
enable_remote

Пользователю разрешено удалённое подключение:

0 - нет, 1 - да

integer RW ≥3.1
enable_web

Пользователю разрешено подключение через браузер/мобильное приложение:

0 - нет, 1 - да

integer RW ≥4.1
from_cloud

Облачный пользователь:

0 - нет, 1 - да

integer RW ≥3.3
group GUID_группы, в которую входит пользователь string RW ≥3.2
group_changed   integer RW ≥3.2
icon Путь к иконке пользователя/группы string RW ≥3.1
internal_revision   integer RW ≥3.2
last_login_address Адрес последней авторизации пользователя string RW ≥3.1
last_login_time Дата и время последней авторизации пользователя, в формате UNIX-время string R ≥3.1
name Имя группы/пользователя string RW ≥3.1
notes   string RW ≥3.1
password Пароль пользователя string W ≥3.1
password_empty_warning   integer RW ≥3.1
ptz_priority Приоритет PTZ integer RW ≥3.1
random_passwords   string W ≥3.3
roles Права облачного пользователя string R ≥4.0
saveable_icon Путь к иконке пользователя/группы string RW ≥3.1
settings_button

Пользователю/группе разрешена аналитика кнопка "Настройки":

0 - нет, 1 - да

integer RW ≥3.1
shutdown_button Разрешить кнопку выключения integer RW ≥3.1
templates_managing

Пользователю/группе разрешено управление шаблонами:

0 - нет, 1 - да

integer RW ≥3.1
templates_sharing

Пользователю/группе разрешена публикация шаблонов в облако:

0 - нет, 1 - да

integer RW ≥4.0
timer_id   string R ≥4.0
view_button

Пользователю/группе разрешена кнопка "Вид":

0 - нет, 1 - да

integer RW ≥3.2

Базовые права группы/пользователя base_rights и права пользователя на отдельные объекты (acl) формируются при помощи битовой маски, в которой каждый бит отвечает за определенное право. Таким образом право пользователя - это сумма всех значений, соответствующих разрешенному (для base_rights) или разрешенному/запрещенному праву (для acl):

Таблица 185.

Номер бита Значение Право пользователя Используется в настройках
0 + 1 Разрешен просмотр base_rights и acl
1 + 2 Разрешен просмотр архива base_rights и acl
2 + 4 Разрешено управление base_rights и acl
3 + 8 Разрешена настройка base_rights и acl
5 + 32 Разрешено редактирование закладок архива base_rights
6 + 64 Разрешена настройка пользователей и скриптов base_rights
8 + 256 Разрешен экспорт архива, скриншотов base_rights
9 + 512 Разрешено использование PTZ base_rights и acl
10 + 1 024 Разрешено слушать звук base_rights и acl
32 + 4 294 967 296 Запрещен просмотр acl
33 + 8 589 934 592 Запрещен просмотр архива acl
34 + 17 179 869 184 Запрещено управление acl
35 + 34 359 738 368 Запрещена настройка acl
41 + 2 199 023 255 552 Запрещено использование PTZ acl
42 + 4 398 046 511 104 Запрещено слушать звук acl

Чтобы запрограммировать базовые права пользователя (Разрешен просмотр, Разрешен просмотр архива, Разрешено использование PTZ, нужно выполнить запрос: 

https://192.168.1.200:8080/settings/users/o7J4zntS/base_rights=515?sid=shMa536E

В запросе:

  • o7J4zntS - уникальный guid пользователя;
  • 515 - сумма значений (1 + 2 + 512), соответствующих правам пользователя (Разрешен просмотр, Разрешен просмотр архива, Разрешено использование PTZ).

Чтобы запрограммировать права пользователя (Разрешено слушать звук и Запрещено использование PTZ) на объект PMAPNyRZ, нужно выполнить запрос: 

https://192.168.1.200:8080/settings/users/o7J4zntS/acl=/PMAPNyRZ/channels.2199023256576?sid=shMa536E

В запросе:

  • o7J4zntS - уникальный guid пользователя;
  • PMAPNyRZ - уникальный guid объекта, на который пользователю назначаются права;
  • 2199023256576 - сумма значений (1024 + 2199023255552), соответствующих правам пользователя (Разрешено слушать звук и Запрещено использование PTZ).

Подсказка

Запросы для добавления новых пользователей и групп пользователей описаны в разделе Запросы для добавления новых пользователей и групп пользователей.

См. также