Управление пользователями

Длина комментариев (comment) при API-запросах ограничена 255 символами.

Управление пользователями

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

GET /user_backend/users

Ответ на успешный запрос:

[
    {
        "id": "integer",
        "name": "string",
        "login": "string",
        "parent_id": "integer",
        "enabled": "boolean",
        "domain_type": "local" | "ad" | "ald" | "radius" | "device",
        "domain_name": "string",
        "ldap_guid": "string",
        "phone_number": "string",
        "comment": "string"
    },
    ...
]

• id - идентификатор пользователя;

• name - имя пользователя;

• login - логин пользователя;

• parent_id - идентификатор группы;

• enabled - соответствует опции Запретить доступ: true - включена, false - выключена;

• domain_type - тип пользователя:

  • local - локальный пользователь Ideco NGFW;

  • ad - пользователь, импортированный из Active Directory;

  • ald - пользователь, импортированный из ALD Pro;

  • radius - пользователь RADIUS-сервера;

  • device - клиентское устройство, подключающееся через Ideco Client в режиме Device VPN.

• domain_name - имя домена, из которого импортирован пользователь;

• ldap_guid - идентификатор объекта AD;

• phone_number - номер телефона пользователя;

• comment - комментарий.

Создание пользователя

POST /user_backend/users

Json-тело запроса:

{
    "name": "string",
    "login": "string",
    "psw": "string",
    "parent_id": "integer",
    "phone_number": "string" | null,
    "comment": "string"
}

• name - имя пользователя;

• login - логин пользователя;

• psw - пароль пользователя;

• parent_id - идентификатор группы;

• phone_number - номер телефона пользователя, не обязательно;

• comment - комментарий, может быть пустым.

Ответ на успешный запрос:

{
    "id": "integer"
}

• id - идентификатор добавленного пользователя.

Если пользователь с указанным логином или именем существует, то исключение с описанием ошибки.

Изменение одного пользователя

PUT /user_backend/users/<id пользователя>

Json-тело запроса:

{
    "name": "string",
    "login": "string",
    "parent_id": "integer",
    "enabled": "boolean",
    "domain_type": "string",
    "domain_name": "string",
    "ldap_guid": "string",
    "phone_number": "string" | null,
    "comment": "string"
}

• name - имя пользователя;

• login - логин пользователя;

• parent_id - идентификатор группы;

• enabled - соответствует опции Запретить доступ: true - включена, false - выключена;

• domain_type - тип пользователя:

  • local - локальный пользователь Ideco NGFW;

  • ad - пользователь, импортированный из Active Directory;

  • ald - пользователь, импортированный из ALD Pro;

  • radius - пользователь RADIUS-сервера;

  • device - клиентское устройство, подключающееся через Ideco Client в режиме Device VPN.

• domain_name - имя домена, из которого импортирован пользователь;

• ldap_guid - идентификатор объекта AD;

• phone_number - номер телефона пользователя;

• comment - комментарий, может быть пустым.

Важно! Для пользователя со значением domain_type: radius можно изменить только значения полей enabled, comment и name. Для пользователя со значением domain_type: device нельзя изменить никакие значения.

Ответ на успешный запрос: 200 OK

Удаление пользователя

DELETE /user_backend/users/<id пользователя>

Ответ на успешный запрос: 200 OK

Смена пароля пользователя

PUT /user_backend/change_password/<id пользователя>

Json-тело запроса:

{
    "password": "string"
}

• password - новый пароль пользователя, не может быть пустым.

Ответ на успешный запрос: 200 ОК

Управление группами пользователей

Получение групп пользователей

GET /user_backend/groups

Ответ на успешный запрос:

[
    {
        "id": "integer",
        "name": "string",
        "parent_id": "integer",
        "domain_type": "string",
        "domain_name": "string",
        "ldap_guid": "string"
    }
]

• id - идентификатор группы;

• name - имя группы;

• parent_id - идентификатор родительской группы;

• domain_type - тип группы пользователей:

  • local - локальная группа Ideco NGFW;

  • ad - группа, импортированная из Active Directory;

  • ald - группа, импортированная из ALD Pro;

  • radius - группа RADIUS-сервера;

  • device - группа Device VPN.

• domain_name - имя домена, из которого импортирована группа;

• ldap_guid - идентификатор объекта AD.

Создание группы пользователей

POST /user_backend/groups

Json-тело запроса:

{
    "name": "string",
    "parent_id": "integer"
}

• name - имя группы;

• parent_id - идентификатор группы.

Ответ на успешный запрос:

{
    "id": "integer"
}

• id - идентификатор добавленной группы.

Если группа с указанным именем у указанного предка существует, то код ответа 542 c описанием ошибки.

Изменение группы

PUT /user_backend/groups/<id группы>

Json-тело запроса:

{
    "name": "string",
    "parent_id": "integer",
    "domain_type": "string",
    "domain_name": "string",
    "ldap_guid": "string"
}

• name - имя группы;

• parent_id - идентификатор родительской группы;

• domain_type - тип группы пользователей:

  • local - локальная группа Ideco NGFW;

  • ad - группа, импортированная из Active Directory;

  • ald - группа, импортированная из ALD Pro;

  • radius - группа RADIUS-сервера;

  • device - группа Device VPN.

• domain_name - имя домена, из которого импортирована группа;

• ldap_guid - идентификатор объекта AD.

Ответ на успешный запрос: 200 OK

Удаление группы

DELETE /user_backend/groups/<id группы>

Ответ на успешный запрос: 200 ОК