Описание основных хендлеров

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

Авторизация администратора

POST /web/auth/login

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

{
    "login": "string",
    "password": "string",
    "rest_path": "string",
}

login - логин, каталог администратора указывается после @. Примеры:
- admin - локальный админ, без @;
- admin@ad_domain.ru - AD/ALD администратор;
- admin@radius - для RADIUS-администраторов @radius.
password - пароль;
rest_path - префикс URL, на который выставлять cookie. Например, / или /rest.

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

После успешной авторизации сервер Ideco NGFW передает в заголовках куки. Пример значений:

set-cookie: insecure-ideco-session=02428c1c-fcd5-42ef-a533-5353da743806
set-cookie: __Secure-ideco-3ea57fca-65cb-439b-b764-d7337530f102=df164532-b916-4cda-a19b-9422c2897663:1663839003

Эти куки нужно передавать при каждом запросе после авторизации в заголовке запроса Cookie.

Разавторизация администратора

DELETE /web/auth/login

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

После успешной разавторизации сервер Ideco NGFW передает в заголовках куки. Пример значений:

set-cookie: insecure-ideco-session=""; expires=Thu, 01 Jan 1970 00:00:00 GMT; Max-Age=0; Path=/
set-cookie: __Secure-ideco-b7e3fb6f-7189-4f87-a4aa-1bdc02e18b34=""; HttpOnly; Max-Age=0; Path=/; SameSite=Strict; Secure

Добавление правила авторизации

POST /auth/rules

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

{
    "enabled": "boolean",
    "ip": "string" | "null",
    "mac": "string" | "null",   
    "user_id":  "integer",
    "always_logged": "boolean",
    "comment": "string"
}

enabled - true для включения правила, false для выключения;
ip - IP-адрес, который нужно авторизовать;
mac - MAC-адрес, который нужно авторизовать;
always_logged - авторизован всегда. Может быть включено только при указанном IP;
user_id - идентификатор пользователя, к которому будет применено правило;
comment - комментарий к правилу, может быть пустым, максимальная длина - 255 символов.

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

{
    "id": "string"
}

id - идентификатор созданного правила.

Изменение части правила авторизации

PATCH /auth/rules/<id правила>

{
    "enabled": "boolean",
    "ip": "string" | "null",
    "mac": "string" | "null",   
    "user_id":  "integer",
    "always_logged": "boolean",
    "comment": "string"
}

enabled - true для включения правила, false для выключения;
ip - IP-адрес, который нужно авторизовать;
mac - MAC-адрес, который нужно авторизовать;
always_logged - авторизован всегда. Может быть включено только при указанном IP;
user_id - идентификатор пользователя, к которому будет применено правило;
comment - комментарий к правилу, может быть пустым, максимальная длина - 255 символов.

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

Удаление правила авторизации

DELETE /auth/rules/<id правила>

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

Сбор анонимной статистики о работе сервера

Получение текущих настроек:

GET /gather_stat/settings

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

{
    "enabled": "boolean"
}

enabled - если true, то сбор анонимной статистики о работе сервера включен, false - выключен.

Изменение настроек

PATCH /gather_stat/settings

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

{
    "enabled": "boolean"
}

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

Лицензирование

Регистрация сервера

POST /license/register

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

{
    "token": "string"
}

token - получить токен лицензии можно в отделе продаж, он высылается в активационном письме;

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

Чтобы добавить enterprise-demo лицензию, необходимо сначала получить токен лицензии в личном кабинете. Для этого выполните действия:

1. Авторизуйтесь в личном кабинете MY.IDECO:

POST /api/v3/login

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

{
    "login": "string",
    "password": "string",
    "g_recaptcha_response": "string" | "null"
}

2. Выполните запрос на регистрацию сервера:

PUT /api/v3/<company_id>/go_to_product

company_id - идентификатор компании пользователя, его можно получить по запросу GET /api/v3/companies.

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

{
    "token": "string"
}

Используйте полученный токен в теле запроса при регистрации Ideco NGFW.

Получение информации о лицензии

GET /license/info

Пример ответа на успешный запрос:

{
    "modules": {
        "active_directory": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "kaspersky_av_for_web": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "kaspersky_av_for_mail": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "application_control": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "suricata": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "advanced_content_filter": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "standard_content_filter": {
            "available": false,
            "expiration_date": 0
        },
        "ips_advanced_rules": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "cluster": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "icsd": {
            "available": true,
            "max_users_count": 10000
        }
    },
    "general": {
        "available": true,
        "reason": "",
        "not_upgrade_after": 1712400382.0,
        "tech_support_end": 1712400382.0,
        "start_date": 1708944382.2658572,
        "expiration_date": 1712400382.0
    },
    "license_type": "enterprise-demo",
    "license_id": "UTM-3883264353",
    "server_name": "UTM",
    "last_update_time": 1708944385.1747465,
    "company_id": "Ideco",
    "server_id": "OQHsviy10sEOOQXWs-8c7tnwJb4AaOvplT2iJc-im677",
    "registered": true,
    "unreliable": false,
    "has_connection": true,
    "license_server": "https://my.ideco.ru"
}

Если лицензия для данного сервера отсутствует:

{
    "registered": false,
    "has_connection": true,
    "license_server": "https://my.ideco.ru"
}

Получение информации о механизме обновления лицензии

GET /license/update-type

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

{
    "update_type": "auto" | "manual"
}

auto - при автоматическом получении лицензии;
manual - при ручной загрузке лицензии.

Изменение механизма обновления лицензии

PATCH /license/update-type

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

{
    "update_type": "auto" | "manual"
}

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

Получение ссылки для офлайн-регистрации

GET /license/license-get-offline-registration-url

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

{
    "registration_url": "https://my.ideco.ru/ngfw?server_name=...hwid=...version=..."
}

server_name - имя сервера Ideco NGFW;
hwid - HWID сервера;
version - версия сервера.

Получение ссылки для офлайн-регистрации сервера возможно только при ручном механизме обновления лицензии.

Загрузка файла с лицензией на NGFW

PUT /license/license-upload

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

Офлайн-обновления

Загрузить ISO-файл с офлайн-обновлением системы

PUT /sysupdate/iso-upload

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

Получить версию загруженного офлайн-обновления системы

GET /sysupdate/iso-upload

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

{
    "uploaded_iso_version": "SystemVersion" | "null"
}

null - если ISO-файл не был загружен;
SystemVersion - объект с описанием версии для загруженного ISO-файла:

{
    "major": "integer",
    "minor": "integer",
    "build": "integer",
    "timestamp": "integer",
    "vendor": "string",
    "product": "UTM" | "CC",
    "kind": "FSTEK" | "VPP" | "STANDARD" | "BPF",
    "release_type": "release" | "beta" | "devel"
}

major - мажорный номер версии (например, 18);
minor - минорный номер версии (например, 1);
build - номер сборки (например, 42);
timestamp - время сборки версии в формате UNIX timestamp;
vendor - вендор продукта, значения могут быть произвольными;
product - название продукта;
kind - вид продукта;
release_type - тип редакции.

Запустить обновление из загруженного ISO-файла для офлайн-обновления системы

POST /sysupdate/iso-install

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

Офлайн-обновление баз GeoIP, Iplist, Suricata

PUT /api/offline-update

ideco-header.json - json-файл, словарь, содержащий ключи:
- hwid - должно совпадать с HWID NGFW, на который загружается обновление;
- pack-type - значение должно быть равно suricata-iplist-geoip для архива с обновлением базы данных GeoIP, Iplist, Suricata;
- geoip-timestamp - timestamp создания базы GeoIP;
- iplist-timestamp - timestamp создания базы Iplist;
- version - значения атрибутов версии.
license.jwt - файл с лицензией для этого NGFW, содержит подписанную лицензию в формате jwt;
ideco-geoip.mmdb - файл обновления базы GeoIP;
iplist.tar.gz - файл обновления списка IP-адресов;
suricata-rules.tar.gz - файл обновления правил Suricata.

Файлы должны быть представлены именно в такой последовательности, других файлов в архиве быть не должно.

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

Офлайн-обновление Контент-фильтра

PUT /content-filter/update_archive_upload

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

Управление объектами

Получение идентификаторов объектов

GET /aliases/<название объекта> | all

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

[
    {
        "comment": "string",
        "title": "string",
        "type": "string",
        "values": [
            "string" | "integer",
            "string" | "integer"
        ],
        "id": "type.id.1"
    }, 
{
        "comment": "string",
        "title": "string",
        "type": "string",
        "value": "string" | "integer",
        "id": "type.id.1"
    },
    ...
]

В качестве ответа будет возвращен список всех объектов, существующих в NGFW:

protocol.ah - протокол AH;
protocol.esp - протокол ESP;
protocol.gre - протокол GRE;
protocol.icmp - протокол ICMP;
protocol.tcp - протокол TCP;
protocol.udp - протокол UDP;
any - допускается любое значение в этом поле;
interface.external_any - все внешние интерфейсы (равно таблице Подключение к провайдеру в веб-интерфейсе и включает в себя подключения к провайдеру по Ethernet/VPN);
interface.external_eth - внешние Ethernet-интерфейсы;
interface.external_vpn - внешние VPN-интерфейсы;
interface.ipsec_any - IPsec-интерфейсы;
interface.local_any - все локальные интерфейсы;
interface.tunnel_any - все туннельные интерфейсы;
group.id. - идентификатор группы пользователей;
interface.id.- идентификатор конкретного интерфейса;
interface.utm_outgoing - исходящий трафик устройства;
interface.vpn_traffic - клиентский VPN-трафик;
interface.wccp_gre_any - все WCCP GRE интерфейсы;
hip_profile.id. - устройства без профиля;
security_group.guid. - идентификатор группы безопасности AD;
user.id. - идентификатор пользователя;
domain.id. - идентификатор домена;
ip.id. - идентификатор IP-адреса;
ip_range.id. - идентификатор объекта Диапазон адресов;
address_list.id. - идентификатор объекта Список IP-объектов;
list_of_iplists.id. - идентификатор объекта Список стран;
port_list.id. - идентификатор объекта Порты;
time_list.id. - идентификатор объекта Расписание;
subnet.id. - идентификатор объекта Подсеть;
port_range.id. - идентификатор объекта Диапазон портов;
port.id. - идентификатор объекта Порт;
time_range.id. - идентификатор объекта Время.

Создание объектов

Создание объекта IP-адрес

POST /aliases/ip_addresses

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

{
    "title": "string",
    "comment": "string",
    "value": "string"
}

title - название объекта. Максимальная длина - 42 символа;
comment - комментарий к объекту. Может быть пустым, максимальная длина - 255 символов;
value - IP-адрес в формате 192.168.0.0.

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

{
    "id": "string"
}

id - идентификатор объекта IP-адрес.

Создание объекта Диапазон IP-адресов

POST /aliases/ip_ranges

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

{
    "title": "string", 
    "comment": "string", 
    "start": "string", 
    "end": "string"
}

title - название объекта. Максимальная длина - 42 символа;
comment - комментарий к объекту. Может быть пустым, максимальная длина - 255 символов;
start - первый IP-адрес в диапазоне, например, 192.168.100.2;
end - последний IP-адрес в диапазоне, например, 192.168.100.15.

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

{
    "id": "string"
}

id - идентификатор объекта Диапазон IP-адресов.

Создание объекта Подсеть

POST /aliases/networks

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

{
    "title": "string",
    "comment": "string",
    "value": "string"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - адрес подсети в формате 192.168.0.0/24 либо 192.168.0.0/255.255.255.0.

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

{
    "id": "string"
}

id - идентификатор объекта Подсеть.

Создание объекта Домен

POST /aliases/domains

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

{
    "title": "string", 
    "comment": "string",
    "value": "string" 
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - домен в формате mydomain.com.

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

{
    "id": "string"
}

id - идентификатор объекта Домен.

Создание объекта Порт

POST /aliases/ports

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

{
    "title": "string",
    "comment": "string",
    "value": "integer"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - номер порта в формате 8080.

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

{
    "id": "string"
}

id - идентификатор объекта Порт.

Создание объекта Диапазон портов

POST /aliases/port_ranges

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

{
    "title": "string",
    "comment": "string",
    "start": "integer",
    "end": "integer"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
start - первый порт в диапазоне, например, 8080;
end - последний порт в диапазоне, например, 8090.

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

{
    "id": "string"
}

id - идентификатор объекта Диапазон портов.

Создание объекта Время

POST /aliases/time_ranges

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

{
    "title": "string",
    "comment": "string",
    "weekdays": [ "integer" ],
    "start": "string",
    "end": "string",
    "period": {
            "first": "integer",
            "last": "integer"
        }
}

title - название объекта. Максимальная длина - 42 символа;
comment - комментарий к объекту. Может быть пустым, максимальная длина - 255 символов;
weekdays - список дней недели, где 1-пн, 2-вт ... 7-вс;
start - начало временного отрезка в формате ЧЧ:ММ;
end - конец временного отрезка в формате ЧЧ:ММ;
first - момент начала срока действия в формате ГГГГММДДЧЧММСС, например, 20240215000000;
last - момент окончания срока действия в формате ГГГГММДДЧЧММСС, например, 20240229235959.

Если для period установить значение null, у объекта будет включена опция Бессрочно.

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

{
    "id": "string"
}

id - идентификатор объекта Время.

Создание объекта Список IP-объектов

POST /aliases/lists/addresses

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

{
    "title": "string",
    "comment": "string", 
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - идентификаторы IP-объектов, через запятую.

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

{
    "id": "string"
}

id - идентификатор объекта Список IP-объектов.

Создание объекта Список IP-адресов

POST /aliases/ip_address_lists

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

{
    "title": "string",
    "comment": "string",
    "values": [ "string" ] 
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список IP-адресов без указания маски, либо с указанием маски подсети в виде десятичного числа 0...32 или четырех десятичных чисел от 0 до 255. Например: 192.168.0.0, 192.168.0.0/24 или 192.168.0.0/255.255.255.0.

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

{
    "id": "string"
}

id - идентификатор объекта Список IP-адресов.

Создание объекта Порты

POST /aliases/lists/ports

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

{
    "title": "string",
    "comment": "string",
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список портов.

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

{
    "id": "string"
}

id - идентификатор объекта Порты.

Создание объекта Расписание

POST /aliases/lists/times

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

{
    "title": "string", 
    "comment": "string",
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список идентификаторов объектов Время.

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

{
    "id": "string"
}

id - идентификатор объекта Расписание.

Изменение объектов

Изменение объекта IP-адрес

PATCH /aliases/ip_addresses/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "value": "string"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - IP-адрес в формате 192.168.0.0.

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

Изменение объекта Диапазон IP-адресов

PATCH /aliases/ip_ranges/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "start": "string",
    "end": "string"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
start - первый IP-адрес в диапазоне, например, 192.168.100.2;
end - последний IP-адрес в диапазоне, например, 192.168.100.15.

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

Изменение объекта Подсеть

PATCH /aliases/networks/<id объекта>

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

{
    "title": "string", 
    "comment": "string",
    "value": "string"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - адрес подсети в формате 192.168.0.0/24 либо 192.168.0.0/255.255.255.0.

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

Изменение объекта Домен

PATCH /aliases/domains/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "value": "string"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - домен в формате mydomain.com.

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

Изменение объекта Порт

PATCH /aliases/ports/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "value": "integer"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - номер порта в формате 8080.

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

Изменение объекта Диапазон портов

PATCH /aliases/port_ranges/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "start": "integer",
    "end": "integer"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
start - первый порт в диапазоне, например, 8080;
end - последний порт в диапазоне, например, 8090.

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

Изменение объекта Время

PATCH /aliases/time_ranges/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "weekdays": [ "integer" ],
    "start": "string",
    "end": "string",
    "period": {
            "first": "integer",
            "last": "integer"
        }
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
weekdays - список дней недели, где 1-пн, 2-вт ... 7-вс;
start - начало временного отрезка в формате ЧЧ:ММ;
end - конец временного отрезка в формате ЧЧ:ММ;
first - момент начала срока действия в формате ГГГГММДДЧЧММСС, например, 20240215000000;
last - момент окончания срока действия в формате ГГГГММДДЧЧММСС, например, 20240229235959.

Если для period установить значение null, у объекта будет включена опция Бессрочно.

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

Изменение объекта Список IP-объектов

PATCH /aliases/lists/addresses/<id объекта>

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

{
    "title": "string", 
    "comment": "string",
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - идентификаторы IP-объектов, через запятую.

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

Изменение объекта Список IP-адресов

PATCH /aliases/ip_address_lists/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список IP-адресов без указания маски, либо с указанием маски подсети в виде десятичного числа 0...32 или четырех десятичных чисел от 0 до 255. Например: 192.168.0.0, 192.168.0.0/24 или 192.168.0.0/255.255.255.0.

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

Изменение объекта Порты

PATCH /aliases/lists/ports/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "values": [ "string" ] 
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список портов.

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

Изменение объекта Расписание

PATCH /aliases/lists/times/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список идентификаторов объектов Время.

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

Удаление объектов

DELETE /aliases/<название объекта>/<id объекта>

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

Названия объектов:

ip_addresses - IP-адрес;
ip_ranges - Диапазон IP-адресов;
networks - Подсеть;
domains - Домен;
ports - Порт;
port_ranges - Диапазон портов;
time_ranges - Время;
ip_address_lists - Список IP-адресов.

Удаление списка объектов

DELETE /aliases/lists/<название объекта>/<id объекта>

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

Названия объектов:

addresses - Список IP-объектов;
ports - Порты;
times - Расписание.

Обнаружение устройств

Получение настроек

GET /netscan_backend/settings

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

{
   "enabled": "boolean",
   "group_id": "integer",
   "networks": [ "string" ]
}

group_id - идентификатор группы, в которую будут добавлены обнаруженные устройства;
networks - список локальных сетей, устройства из которых будут автоматически добавлены и авторизованы на Ideco NGFW.

Изменение настроек

PATCH  /netscan_backend/settings

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

{
   "enabled": "boolean",
   "group_id": "integer",
   "networks": [ "string" ]
}

group_id - идентификатор группы, в которую будут добавлены обнаруженные устройства;
networks - список локальных сетей, устройства из которых будут автоматически добавлены и авторизованы на Ideco NGFW.

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

Распространенные статусы

200 OK - Операция успешно завершена;
302 Found - Запрашиваемая страница была найдена / временно перенесена на другой URL;
400 Bad Request - Сервер не смог понять запрос из-за недействительного синтаксиса;
401 Unauthorized - Запрещено. Сервер понял запрос, но он не выполняет его из-за ограничений прав доступа к указанному ресурсу;
404 Not Found - Запрашиваемая страница не найдена. Сервер понял запрос, но не нашел соответствующего ресурса по указанному URL;
405 Method Not Allowed - Метод не поддерживается. Запрос был сделан методом, который не поддерживается данным ресурсом;
502 Bad Gateway - Ошибка шлюза. Сервер, выступая в роли шлюза или прокси-сервера, получил недействительное ответное сообщение от вышестоящего сервера;
542 - Валидация не пропустила тело запроса.

PreviousОшибка 400 Bad Request Request Header Or Cookie Too Large при авторизации в браузерах NextУправление интеграцией с Active Directory

Last updated 3 days ago

Was this helpful?

Описание основных хендлеров

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

Авторизация администратора

POST /web/auth/login

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

{
    "login": "string",
    "password": "string",
    "rest_path": "string",
}

login - логин, каталог администратора указывается после @. Примеры:
- admin - локальный админ, без @;
- admin@ad_domain.ru - AD/ALD администратор;
- admin@radius - для RADIUS-администраторов @radius.
password - пароль;
rest_path - префикс URL, на который выставлять cookie. Например, / или /rest.

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

После успешной авторизации сервер Ideco NGFW передает в заголовках куки. Пример значений:

set-cookie: insecure-ideco-session=02428c1c-fcd5-42ef-a533-5353da743806
set-cookie: __Secure-ideco-3ea57fca-65cb-439b-b764-d7337530f102=df164532-b916-4cda-a19b-9422c2897663:1663839003

Эти куки нужно передавать при каждом запросе после авторизации в заголовке запроса Cookie.

Разавторизация администратора

DELETE /web/auth/login

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

После успешной разавторизации сервер Ideco NGFW передает в заголовках куки. Пример значений:

set-cookie: insecure-ideco-session=""; expires=Thu, 01 Jan 1970 00:00:00 GMT; Max-Age=0; Path=/
set-cookie: __Secure-ideco-b7e3fb6f-7189-4f87-a4aa-1bdc02e18b34=""; HttpOnly; Max-Age=0; Path=/; SameSite=Strict; Secure

Добавление правила авторизации

POST /auth/rules

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

{
    "enabled": "boolean",
    "ip": "string" | "null",
    "mac": "string" | "null",   
    "user_id":  "integer",
    "always_logged": "boolean",
    "comment": "string"
}

enabled - true для включения правила, false для выключения;
ip - IP-адрес, который нужно авторизовать;
mac - MAC-адрес, который нужно авторизовать;
always_logged - авторизован всегда. Может быть включено только при указанном IP;
user_id - идентификатор пользователя, к которому будет применено правило;
comment - комментарий к правилу, может быть пустым, максимальная длина - 255 символов.

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

{
    "id": "string"
}

id - идентификатор созданного правила.

Изменение части правила авторизации

PATCH /auth/rules/<id правила>

{
    "enabled": "boolean",
    "ip": "string" | "null",
    "mac": "string" | "null",   
    "user_id":  "integer",
    "always_logged": "boolean",
    "comment": "string"
}

enabled - true для включения правила, false для выключения;
ip - IP-адрес, который нужно авторизовать;
mac - MAC-адрес, который нужно авторизовать;
always_logged - авторизован всегда. Может быть включено только при указанном IP;
user_id - идентификатор пользователя, к которому будет применено правило;
comment - комментарий к правилу, может быть пустым, максимальная длина - 255 символов.

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

Удаление правила авторизации

DELETE /auth/rules/<id правила>

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

Сбор анонимной статистики о работе сервера

Получение текущих настроек:

GET /gather_stat/settings

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

{
    "enabled": "boolean"
}

enabled - если true, то сбор анонимной статистики о работе сервера включен, false - выключен.

Изменение настроек

PATCH /gather_stat/settings

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

{
    "enabled": "boolean"
}

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

Лицензирование

Регистрация сервера

POST /license/register

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

{
    "token": "string"
}

token - получить токен лицензии можно в отделе продаж, он высылается в активационном письме;

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

1. Авторизуйтесь в личном кабинете MY.IDECO:

POST /api/v3/login

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

{
    "login": "string",
    "password": "string",
    "g_recaptcha_response": "string" | "null"
}

2. Выполните запрос на регистрацию сервера:

PUT /api/v3/<company_id>/go_to_product

company_id - идентификатор компании пользователя, его можно получить по запросу GET /api/v3/companies.

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

{
    "token": "string"
}

Используйте полученный токен в теле запроса при регистрации Ideco NGFW.

Получение информации о лицензии

GET /license/info

Пример ответа на успешный запрос:

{
    "modules": {
        "active_directory": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "kaspersky_av_for_web": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "kaspersky_av_for_mail": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "application_control": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "suricata": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "advanced_content_filter": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "standard_content_filter": {
            "available": false,
            "expiration_date": 0
        },
        "ips_advanced_rules": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "cluster": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "icsd": {
            "available": true,
            "max_users_count": 10000
        }
    },
    "general": {
        "available": true,
        "reason": "",
        "not_upgrade_after": 1712400382.0,
        "tech_support_end": 1712400382.0,
        "start_date": 1708944382.2658572,
        "expiration_date": 1712400382.0
    },
    "license_type": "enterprise-demo",
    "license_id": "UTM-3883264353",
    "server_name": "UTM",
    "last_update_time": 1708944385.1747465,
    "company_id": "Ideco",
    "server_id": "OQHsviy10sEOOQXWs-8c7tnwJb4AaOvplT2iJc-im677",
    "registered": true,
    "unreliable": false,
    "has_connection": true,
    "license_server": "https://my.ideco.ru"
}

Если лицензия для данного сервера отсутствует:

{
    "registered": false,
    "has_connection": true,
    "license_server": "https://my.ideco.ru"
}

Получение информации о механизме обновления лицензии

GET /license/update-type

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

{
    "update_type": "auto" | "manual"
}

auto - при автоматическом получении лицензии;
manual - при ручной загрузке лицензии.

Изменение механизма обновления лицензии

PATCH /license/update-type

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

{
    "update_type": "auto" | "manual"
}

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

Получение ссылки для офлайн-регистрации

GET /license/license-get-offline-registration-url

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

{
    "registration_url": "https://my.ideco.ru/ngfw?server_name=...hwid=...version=..."
}

server_name - имя сервера Ideco NGFW;
hwid - HWID сервера;
version - версия сервера.

Получение ссылки для офлайн-регистрации сервера возможно только при ручном механизме обновления лицензии.

Загрузка файла с лицензией на NGFW

PUT /license/license-upload

Тело запроса: файл с лицензией в формате jwt, который можно скачать в личном кабинете MY.IDECO. Более подробная информация представлена в .

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

Офлайн-обновления

Загрузить ISO-файл с офлайн-обновлением системы

PUT /sysupdate/iso-upload

Тело запроса: ISO-файл с обновлением, который можно скачать в личном кабинете MY.IDECO по .

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

Получить версию загруженного офлайн-обновления системы

GET /sysupdate/iso-upload

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

{
    "uploaded_iso_version": "SystemVersion" | "null"
}

null - если ISO-файл не был загружен;
SystemVersion - объект с описанием версии для загруженного ISO-файла:

{
    "major": "integer",
    "minor": "integer",
    "build": "integer",
    "timestamp": "integer",
    "vendor": "string",
    "product": "UTM" | "CC",
    "kind": "FSTEK" | "VPP" | "STANDARD" | "BPF",
    "release_type": "release" | "beta" | "devel"
}

major - мажорный номер версии (например, 18);
minor - минорный номер версии (например, 1);
build - номер сборки (например, 42);
timestamp - время сборки версии в формате UNIX timestamp;
vendor - вендор продукта, значения могут быть произвольными;
product - название продукта;
kind - вид продукта;
release_type - тип редакции.

Запустить обновление из загруженного ISO-файла для офлайн-обновления системы

POST /sysupdate/iso-install

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

Офлайн-обновление баз GeoIP, Iplist, Suricata

PUT /api/offline-update

Тело запроса: архивный файл с обновлением, который можно скачать в личном кабинете MY.IDECO. Более подробная информация представлена в . Архивный файл содержит:

ideco-header.json - json-файл, словарь, содержащий ключи:
- hwid - должно совпадать с HWID NGFW, на который загружается обновление;
- pack-type - значение должно быть равно suricata-iplist-geoip для архива с обновлением базы данных GeoIP, Iplist, Suricata;
- geoip-timestamp - timestamp создания базы GeoIP;
- iplist-timestamp - timestamp создания базы Iplist;
- version - значения атрибутов версии.
license.jwt - файл с лицензией для этого NGFW, содержит подписанную лицензию в формате jwt;
ideco-geoip.mmdb - файл обновления базы GeoIP;
iplist.tar.gz - файл обновления списка IP-адресов;
suricata-rules.tar.gz - файл обновления правил Suricata.

Файлы должны быть представлены именно в такой последовательности, других файлов в архиве быть не должно.

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

Офлайн-обновление Контент-фильтра

PUT /content-filter/update_archive_upload

Тело запроса: архивный файл с офлайн-обновлением для Контент-фильтра, который можно скачать в личном кабинете MY.IDECO. Более подробная информация представлена в .

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

Управление объектами

Получение идентификаторов объектов

GET /aliases/<название объекта> | all

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

[
    {
        "comment": "string",
        "title": "string",
        "type": "string",
        "values": [
            "string" | "integer",
            "string" | "integer"
        ],
        "id": "type.id.1"
    }, 
{
        "comment": "string",
        "title": "string",
        "type": "string",
        "value": "string" | "integer",
        "id": "type.id.1"
    },
    ...
]

В качестве ответа будет возвращен список всех объектов, существующих в NGFW:

protocol.ah - протокол AH;
protocol.esp - протокол ESP;
protocol.gre - протокол GRE;
protocol.icmp - протокол ICMP;
protocol.tcp - протокол TCP;
protocol.udp - протокол UDP;
any - допускается любое значение в этом поле;
interface.external_any - все внешние интерфейсы (равно таблице Подключение к провайдеру в веб-интерфейсе и включает в себя подключения к провайдеру по Ethernet/VPN);
interface.external_eth - внешние Ethernet-интерфейсы;
interface.external_vpn - внешние VPN-интерфейсы;
interface.ipsec_any - IPsec-интерфейсы;
interface.local_any - все локальные интерфейсы;
interface.tunnel_any - все туннельные интерфейсы;
group.id. - идентификатор группы пользователей;
interface.id.- идентификатор конкретного интерфейса;
interface.utm_outgoing - исходящий трафик устройства;
interface.vpn_traffic - клиентский VPN-трафик;
interface.wccp_gre_any - все WCCP GRE интерфейсы;
hip_profile.id. - устройства без профиля;
security_group.guid. - идентификатор группы безопасности AD;
user.id. - идентификатор пользователя;
domain.id. - идентификатор домена;
ip.id. - идентификатор IP-адреса;
ip_range.id. - идентификатор объекта Диапазон адресов;
address_list.id. - идентификатор объекта Список IP-объектов;
list_of_iplists.id. - идентификатор объекта Список стран;
port_list.id. - идентификатор объекта Порты;
time_list.id. - идентификатор объекта Расписание;
subnet.id. - идентификатор объекта Подсеть;
port_range.id. - идентификатор объекта Диапазон портов;
port.id. - идентификатор объекта Порт;
time_range.id. - идентификатор объекта Время.

Создание объектов

Создание объекта IP-адрес

POST /aliases/ip_addresses

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

{
    "title": "string",
    "comment": "string",
    "value": "string"
}

title - название объекта. Максимальная длина - 42 символа;
comment - комментарий к объекту. Может быть пустым, максимальная длина - 255 символов;
value - IP-адрес в формате 192.168.0.0.

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

{
    "id": "string"
}

id - идентификатор объекта IP-адрес.

Создание объекта Диапазон IP-адресов

POST /aliases/ip_ranges

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

{
    "title": "string", 
    "comment": "string", 
    "start": "string", 
    "end": "string"
}

title - название объекта. Максимальная длина - 42 символа;
comment - комментарий к объекту. Может быть пустым, максимальная длина - 255 символов;
start - первый IP-адрес в диапазоне, например, 192.168.100.2;
end - последний IP-адрес в диапазоне, например, 192.168.100.15.

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

{
    "id": "string"
}

id - идентификатор объекта Диапазон IP-адресов.

Создание объекта Подсеть

POST /aliases/networks

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

{
    "title": "string",
    "comment": "string",
    "value": "string"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - адрес подсети в формате 192.168.0.0/24 либо 192.168.0.0/255.255.255.0.

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

{
    "id": "string"
}

id - идентификатор объекта Подсеть.

Создание объекта Домен

POST /aliases/domains

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

{
    "title": "string", 
    "comment": "string",
    "value": "string" 
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - домен в формате mydomain.com.

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

{
    "id": "string"
}

id - идентификатор объекта Домен.

Создание объекта Порт

POST /aliases/ports

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

{
    "title": "string",
    "comment": "string",
    "value": "integer"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - номер порта в формате 8080.

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

{
    "id": "string"
}

id - идентификатор объекта Порт.

Создание объекта Диапазон портов

POST /aliases/port_ranges

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

{
    "title": "string",
    "comment": "string",
    "start": "integer",
    "end": "integer"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
start - первый порт в диапазоне, например, 8080;
end - последний порт в диапазоне, например, 8090.

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

{
    "id": "string"
}

id - идентификатор объекта Диапазон портов.

Создание объекта Время

POST /aliases/time_ranges

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

{
    "title": "string",
    "comment": "string",
    "weekdays": [ "integer" ],
    "start": "string",
    "end": "string",
    "period": {
            "first": "integer",
            "last": "integer"
        }
}

title - название объекта. Максимальная длина - 42 символа;
comment - комментарий к объекту. Может быть пустым, максимальная длина - 255 символов;
weekdays - список дней недели, где 1-пн, 2-вт ... 7-вс;
start - начало временного отрезка в формате ЧЧ:ММ;
end - конец временного отрезка в формате ЧЧ:ММ;
first - момент начала срока действия в формате ГГГГММДДЧЧММСС, например, 20240215000000;
last - момент окончания срока действия в формате ГГГГММДДЧЧММСС, например, 20240229235959.

Если для period установить значение null, у объекта будет включена опция Бессрочно.

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

{
    "id": "string"
}

id - идентификатор объекта Время.

Создание объекта Список IP-объектов

POST /aliases/lists/addresses

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

{
    "title": "string",
    "comment": "string", 
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - идентификаторы IP-объектов, через запятую.

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

{
    "id": "string"
}

id - идентификатор объекта Список IP-объектов.

Создание объекта Список IP-адресов

POST /aliases/ip_address_lists

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

{
    "title": "string",
    "comment": "string",
    "values": [ "string" ] 
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список IP-адресов без указания маски, либо с указанием маски подсети в виде десятичного числа 0...32 или четырех десятичных чисел от 0 до 255. Например: 192.168.0.0, 192.168.0.0/24 или 192.168.0.0/255.255.255.0.

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

{
    "id": "string"
}

id - идентификатор объекта Список IP-адресов.

Создание объекта Порты

POST /aliases/lists/ports

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

{
    "title": "string",
    "comment": "string",
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список портов.

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

{
    "id": "string"
}

id - идентификатор объекта Порты.

Создание объекта Расписание

POST /aliases/lists/times

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

{
    "title": "string", 
    "comment": "string",
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список идентификаторов объектов Время.

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

{
    "id": "string"
}

id - идентификатор объекта Расписание.

Изменение объектов

Изменение объекта IP-адрес

PATCH /aliases/ip_addresses/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "value": "string"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - IP-адрес в формате 192.168.0.0.

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

Изменение объекта Диапазон IP-адресов

PATCH /aliases/ip_ranges/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "start": "string",
    "end": "string"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
start - первый IP-адрес в диапазоне, например, 192.168.100.2;
end - последний IP-адрес в диапазоне, например, 192.168.100.15.

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

Изменение объекта Подсеть

PATCH /aliases/networks/<id объекта>

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

{
    "title": "string", 
    "comment": "string",
    "value": "string"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - адрес подсети в формате 192.168.0.0/24 либо 192.168.0.0/255.255.255.0.

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

Изменение объекта Домен

PATCH /aliases/domains/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "value": "string"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - домен в формате mydomain.com.

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

Изменение объекта Порт

PATCH /aliases/ports/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "value": "integer"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - номер порта в формате 8080.

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

Изменение объекта Диапазон портов

PATCH /aliases/port_ranges/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "start": "integer",
    "end": "integer"
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
start - первый порт в диапазоне, например, 8080;
end - последний порт в диапазоне, например, 8090.

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

Изменение объекта Время

PATCH /aliases/time_ranges/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "weekdays": [ "integer" ],
    "start": "string",
    "end": "string",
    "period": {
            "first": "integer",
            "last": "integer"
        }
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
weekdays - список дней недели, где 1-пн, 2-вт ... 7-вс;
start - начало временного отрезка в формате ЧЧ:ММ;
end - конец временного отрезка в формате ЧЧ:ММ;
first - момент начала срока действия в формате ГГГГММДДЧЧММСС, например, 20240215000000;
last - момент окончания срока действия в формате ГГГГММДДЧЧММСС, например, 20240229235959.

Если для period установить значение null, у объекта будет включена опция Бессрочно.

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

Изменение объекта Список IP-объектов

PATCH /aliases/lists/addresses/<id объекта>

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

{
    "title": "string", 
    "comment": "string",
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - идентификаторы IP-объектов, через запятую.

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

Изменение объекта Список IP-адресов

PATCH /aliases/ip_address_lists/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список IP-адресов без указания маски, либо с указанием маски подсети в виде десятичного числа 0...32 или четырех десятичных чисел от 0 до 255. Например: 192.168.0.0, 192.168.0.0/24 или 192.168.0.0/255.255.255.0.

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

Изменение объекта Порты

PATCH /aliases/lists/ports/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "values": [ "string" ] 
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список портов.

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

Изменение объекта Расписание

PATCH /aliases/lists/times/<id объекта>

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

{
    "title": "string",
    "comment": "string",
    "values": [ "string" ]
}

title - название объекта, максимальная длина - 42 символа;
comment - комментарий к объекту, может быть пустым, максимальная длина - 255 символов;
value - список идентификаторов объектов Время.

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

Удаление объектов

DELETE /aliases/<название объекта>/<id объекта>

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

Названия объектов:

ip_addresses - IP-адрес;
ip_ranges - Диапазон IP-адресов;
networks - Подсеть;
domains - Домен;
ports - Порт;
port_ranges - Диапазон портов;
time_ranges - Время;
ip_address_lists - Список IP-адресов.

Удаление списка объектов

DELETE /aliases/lists/<название объекта>/<id объекта>

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

Названия объектов:

addresses - Список IP-объектов;
ports - Порты;
times - Расписание.

Обнаружение устройств

Получение настроек

GET /netscan_backend/settings

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

{
   "enabled": "boolean",
   "group_id": "integer",
   "networks": [ "string" ]
}

group_id - идентификатор группы, в которую будут добавлены обнаруженные устройства;
networks - список локальных сетей, устройства из которых будут автоматически добавлены и авторизованы на Ideco NGFW.

Изменение настроек

PATCH  /netscan_backend/settings

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

{
   "enabled": "boolean",
   "group_id": "integer",
   "networks": [ "string" ]
}

group_id - идентификатор группы, в которую будут добавлены обнаруженные устройства;
networks - список локальных сетей, устройства из которых будут автоматически добавлены и авторизованы на Ideco NGFW.

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

Распространенные статусы

200 OK - Операция успешно завершена;
302 Found - Запрашиваемая страница была найдена / временно перенесена на другой URL;
400 Bad Request - Сервер не смог понять запрос из-за недействительного синтаксиса;
401 Unauthorized - Запрещено. Сервер понял запрос, но он не выполняет его из-за ограничений прав доступа к указанному ресурсу;
404 Not Found - Запрашиваемая страница не найдена. Сервер понял запрос, но не нашел соответствующего ресурса по указанному URL;
405 Method Not Allowed - Метод не поддерживается. Запрос был сделан методом, который не поддерживается данным ресурсом;
502 Bad Gateway - Ошибка шлюза. Сервер, выступая в роли шлюза или прокси-сервера, получил недействительное ответное сообщение от вышестоящего сервера;
542 - Валидация не пропустила тело запроса.

PreviousОшибка 400 Bad Request Request Header Or Cookie Too Large при авторизации в браузерах NextУправление интеграцией с Active Directory

Last updated 3 days ago

Was this helpful?