Ideco NGFW
Скачать PDF
v19
v19
  • Об Ideco NGFW
  • Общая информация
    • Лицензирование
    • Системные требования и источники данных Ideco NGFW
      • Выбор аппаратной платформы
    • Техническая поддержка
      • Информация о поддержке версий Ideco NGFW
  • Быстрый старт Ideco NGFW
    • Рекомендации при первоначальной настройке
    • Подготовка платформы к установке
      • Настройка гипервизора
      • Настройка программно-аппаратных комплексов Ideco NGFW
      • Создание загрузочного USB-накопителя
    • Установка
    • Первоначальная настройка
    • Регистрация сервера
    • Получение доступа в интернет
  • Настройка Ideco NGFW
    • Панель мониторинга
    • Пользователи
      • Учетные записи
        • Управление учетными записями и группами
        • Настройка пользователей
      • Авторизация пользователей
        • Веб-аутентификация
        • IP и MAC авторизация
          • Авторизация по IP-адресу
          • Авторизация по MAC-адресу
        • Авторизация по подсетям
        • Авторизация пользователей терминальных серверов
      • Двухфакторная аутентификация
      • VPN-подключение
        • Подключение по PPTP
        • Подключение по IKEv2/IPsec
        • Подключение по SSTP
        • Подключение по L2TP/IPsec
        • Особенности маршрутизации и организации доступа
        • Инструкция по запуску PowerShell скриптов
      • Ideco Client
        • Установка и настройка Ideco Client на Windows
        • Установка и настройка Ideco Client на MacOS
        • Установка и настройка Ideco Client на Linux
        • Настройка Device VPN
        • Создание сертификатов для Device VPN
        • Балансировка VPN-подключений
        • Кастомная настройка Ideco Client
      • Профили устройств
      • Active Directory/Samba DC
        • Импорт пользователей
        • Аутентификация пользователей AD/Samba DC
          • Настройка сервера Active Directory
          • Настройка клиентских машин
          • Скрипты автоматической разавторизации
      • RADIUS
      • ALD Pro
      • Обнаружение устройств
      • Wi-Fi-сети
    • Мониторинг
      • Сессии администраторов
      • Сессии пользователей
      • Сессии ЛК
      • Графики загруженности
      • Монитор трафика
      • Telegram-бот
      • SNMP
      • Zabbix-агент
      • Netflow
    • Правила трафика
      • Файрвол
        • Таблицы файрвола (FORWARD, DNAT, INPUT и SNAT)
        • Примеры создания правил файрвола
        • Логирование
        • Тестирование правил
        • Предварительная фильтрация
        • Аппаратная фильтрация
      • Контент-фильтр
        • Правила
        • Описание категорий контент-фильтра
        • Морфологические словари
        • Настройки
        • Настройка фильтрации HTTPS
      • Ограничение скорости
      • Антивирус
      • Предотвращение вторжений
        • Группы сигнатур
        • Пользовательские сигнатуры
        • Настройки
      • Исключения
      • Объекты
    • Профили безопасности
      • Web Application Firewall
      • Контроль приложений
        • Особенности создания профилей
        • Пример создания иерархической структуры
        • Настройка фильтрации трафика, для которого в таблице FORWARD нет правил
      • Предотвращение вторжений
    • Сервисы
      • Сетевые интерфейсы
        • Внешние и локальные интерфейсы
        • Агрегированные интерфейсы (LACP)
        • Туннельные интерфейсы (GRE)
        • VCE-интерфейсы
        • SPAN-интерфейсы
      • Балансировка и резервирование
      • Маршрутизация
      • BGP
      • OSPF
      • IGMP Proxy
      • Прокси
        • Исключения
        • Настройка прямого подключения к прокси
        • Настройка прокси с одним интерфейсом
      • Обратный прокси
      • ЛК/Портал SSL VPN
      • Защита и управление DNS
        • Внешние DNS-серверы
        • Master-зоны
        • Forward-зоны
        • DDNS
      • DHCP-сервер
      • NTP-сервер
      • IPsec
        • Подключение между двумя Ideco NGFW в туннельном режиме работы
        • Подключение между двумя Ideco NGFW в транспортном режиме работы
        • Подключение Ideco NGFW и Mikrotik по IPsec в туннельном режиме
        • Подключение Ideco NGFW и Mikrotik по IPsec в транспортном режиме
        • Подключение MikroTik и Ideco NGFW по L2TP/IPsec
        • Подключение Cisco IOS и Ideco NGFW по IPsec в туннельном режиме
        • Подключение Cisco IOS и Ideco NGFW по IPsec в транспортном режиме
        • Подключение Cisco IOS и Ideco NGFW по route-based IPsec
        • Подключение pfSense к Ideco NGFW по IPsec
        • Подключение Kerio Control и Ideco NGFW по IPsec
        • Подключение Keenetic по SSTP или IPsec
      • ГОСТ VPN
      • Сертификаты
        • Загрузка SSL-сертификата на сервер
        • Создание самоподписанного сертификата c помощью PowerShell
        • Создание сертификата c помощью openssl
      • USB-токены
    • Отчеты и журналы
      • Трафик
      • Системный журнал
      • Журнал веб-трафика
      • Журнал трафика
      • События безопасности
      • Действия администраторов
      • Журнал аутентификации
      • Журнал авторизации ЛК
      • Конструктор отчетов
      • Syslog
    • Управление сервером
      • Администраторы
      • Ideco Center
      • VCE
      • Кластеризация
        • Настройка кластера
        • Обновление кластера
      • Обновления
      • Бэкапы
      • Терминал
        • Примеры использования утилит
      • Лицензия
      • Дополнительно
    • Почтовый релей
      • Основные настройки
        • Web-почта
        • Настройка почтового релея
        • Настройка почтового сервера
      • Расширенные настройки
        • Настройка домена у регистратора/держателя зоны
      • Антиспам и антивирус
      • Правила
        • Переадресация почты
      • Почтовая очередь
      • Настройка почтовых клиентов
      • Схема фильтрации почтового трафика
    • Публикация ресурсов
      • Доступ из внешней сети без NAT
      • Публикация веб-приложений (обратный прокси-сервер)
      • Настройка публичного IP-адреса на компьютере в локальной сети
      • Портмаппинг (проброс портов, DNAT)
    • Интеграция NGFW и SkyDNS
    • Полный цикл обработки трафика в Ideco NGFW
  • Настройка MY.IDECO
    • О личном кабинете MY.IDECO
    • NGFW
    • Центральная консоль
    • Monitoring Bot и Security
    • Личные данные и Компании
  • Настройка Ideco Center
    • Об Ideco Center
    • Установка Ideco Center
    • Серверы
    • Мониторинг
    • Политики и объекты
    • Профили безопасности
    • Сервисы
    • Отчеты и журналы
    • Управление сервером
  • Популярные инструкции и диагностика проблем
    • FAQ
      • Инструкции по созданию VPN-подключений
        • Создание VPN-подключения в Alt Linux
        • Создание VPN-подключения в Ubuntu
        • Создание VPN-подключения в Fedora
        • Создание подключения в Astra Linux
        • Создание подключения в Windows
        • Создание VPN-подключения на мобильных устройствах
        • Создание подключения в Mac OS
        • Подключение по SSTP Wi-Fi роутеров Keenetic
      • Подлючение к серверу по COM-порту и настройка Ideco NGFW
      • Анализ трафика
      • Режим удаленного помощника
      • Настройка LACP на Hyper-V
      • Разрешить интернет всем: диагностика неполадок
      • Как разрешить доступ к ресурсам в ограниченной сети
      • Удаленный доступ к серверу
      • Тестирование оперативной памяти сервера
      • Как избавиться от асимметричной маршрутизации трафика
      • Что делать если ваш IP попал в черные списки DNSBL
      • Как восстановить доступ к Ideco NGFW
      • Как восстановиться на прошлую версию после обновления Ideco NGFW
      • Проверка настроек фильтрации с помощью security ideco
      • Поддержка устаревших алгоритмов шифрования
      • Настройка программы Proxifier для прямых подключений к прокси серверу
      • Блокировка популярных ресурсов
      • Настройка прозрачной авторизации на Astra Linux
      • Настройка автоматической веб-аутентификации на Ideco NGFW на Linux
      • Перенос данных и настроек на другой сервер
      • Порядок обработки веб-трафика в Ideco NGFW
      • Интеграция Ideco NGFW и брокера сетевых пакетов DS Integrity NG
      • Настройка совместной работы ViPNet Координатор с Ideco NGFW
      • Блокировка чат-ботов
      • Таблица портов Ideco NGFW, доступных из локальной и внешних сетей
      • Как Ideco Client осуществляет обработку запросов с редиректом на сервер Ideco NGFW
      • Как включить таймер при загрузке Ideco NGFW
    • Диагностика проблем
      • Ошибка при открытии сайта ERR_CONNECTION_TIMED_OUT или Не открывается сайт
      • Что делать если не работает интернет
      • Ошибка при авторизации "The browser is outdated"
      • Если соединение по IPsec не устанавливается
      • Ошибка 400 Bad Request Request Header Or Cookie Too Large при авторизации в браузерах
  • API
    • Описание основных хендлеров
    • Управление интеграцией с Active Directory
    • Управление интеграцией с ALD Pro
    • Управление администраторами
    • Управление пользователями
    • Управление Ideco Client
    • Мониторинг и журналы
    • Управление правилами трафика
      • Файрвол
      • Контроль приложений
      • Контент-фильтр
      • Предотвращение вторжений
      • Исключения
    • Управление профилями безопасности
    • Управление сетевыми интерфейсами
    • Управление VPN
    • Управление обратным прокси
    • DHCP-сервер
    • DNS-сервер
    • Настройка удаленной передачи системных логов
    • Управление Ideco Center
    • Бэкапы и возврат к предыдущей версии
    • Почтовый релей
      • Расширенные настройки
      • Антиспам и антивирус
      • Правила
      • Почтовая очередь
    • Примеры использования
      • Редактирование пользовательской категории контент-фильтра
      • Создание правила FORWARD
  • changelog
    • Ideco NGFW 19.X
    • ФСТЭК Ideco UTM 19.X
    • Ideco Center 19.Х
Powered by GitBook
On this page
  • Внешние и локальные интерфейсы
  • Получение списка всех внешних и локальных интерфейсов
  • Управление внешними и локальными интерфейсами
  • Агрегированные интерфейсы
  • Туннельные интерфейсы
  • VCE-интерфейсы
  • SPAN-интерфейсы

Was this helpful?

  1. API

Управление сетевыми интерфейсами

PreviousУправление профилями безопасностиNextУправление VPN

Last updated 27 days ago

Was this helpful?

Внешние и локальные интерфейсы

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

LAN (Локальный Ethernet-интерфейс)
GET /network/connections

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

{
    "id": "integer",
    "type": "lan",
    "title": "string",
    "enabled": "boolean",
    "mac": "string",
    "enable_dhcp": "boolean",
    "addresses": [ "string" ],
    "gateway": "null" | "string",
    "dns": [ "string" ],
    "vlan_tag": "null" | "integer",
    "zone": "null" | "string",
    "is_vce_vlan": "boolean",
    "netflow_index": "integer"
}
  • id - идентификатор интерфейса;

  • title - название интерфейса, не может быть пустым;

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • mac - MAC-адрес сетевой карты или идентификатор агрегированного интерфейса. MAC-адрес в формате 11:22:33:44:55:66, все буквы в нижнем регистре;

  • addresses - список адресов в формате IP/prefix. Может быть пустым, если включено получение адресов по DHCP;

  • gateway - IP-адрес шлюза. Может быть null, если включено получение адресов по DHCP;

  • dns - список IP-адресов DNS. Может быть пустым независимо от флага включения DHCP;

  • vlan_tag - тэг VLAN, число от 1 до 4095 (включительно). Может быть равен null, если не назначен;

  • zone - идентификатор зоны, к которой относится интерфейс. Может быть null, если не назначен;

  • is_vce_vlan - true, если подключение создано на основе проброшенного в VCE VLAN;

  • netflow_index - целое число от 0 до 65535, индекс сетевого подключения для .

WAN (Подключение к провайдеру по Ethernet)
GET /network/connections

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

{
    "id": "integer",
    "type": "wan",
    "title": "string",
    "enabled": "boolean",
    "mac": "string",
    "enable_dhcp": "boolean",
    "addresses": [ "string" ],
    "gateway": "null" | "string",
    "dns": [ "string" ],
    "vlan_tag": "null" | "integer",
    "zone": "null" | "string",
    "is_vce_vlan": "boolean",
    "netflow_index": "integer"
}
  • id - идентификатор интерфейса;

  • title - название интерфейса, не может быть пустым;

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • mac - MAC-адрес сетевой карты или идентификатор агрегированного интерфейса. MAC-адрес в формате 11:22:33:44:55:66, все буквы в нижнем регистре;

  • enable_dhcp - получать ли адрес интерфейса и адрес шлюза от провайдера по DHCP;

  • addresses - список адресов в формате IP/prefix. Может быть пустым, если включено получение адресов по DHCP;

  • gateway - IP-адрес шлюза. Может быть null, если включено получение адресов по DHCP;

  • dns - список IP-адресов DNS, может быть пустым независимо от флага включения DHCP;

  • vlan_tag - тэг VLAN, число от 1 до 4095 (включительно), null, если не назначен;

  • zone - идентификатор зоны, к которой относится интерфейс. Может быть null, если не назначен;

  • is_vce_vlan - true, если подключение создано на основе проброшенного в VCE VLAN;

  • netflow_index - целое число от 0 до 65535, индекс сетевого подключения для .

PPTP (Подключение к провайдеру по PPTP)

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

GET /network/connections
{
    "id": "integer",
    "type": "pptp",
    "title": "string",
    "enabled": "boolean",
    "server": "string",
    "login": "string",
    "password": "string",
    "mac": "string",
    "enable_dhcp": "boolean",
    "addresses": [ "string" ],
    "gateway": "null" | "string",
    "dns": [ "string" ],
    "vlan_tag": "null" | "integer",
    "zone": "null" | "string",
    "is_vce_vlan": "boolean",
    "netflow_index": "integer"
}
  • id - идентификатор интерфейса;

  • title - название интерфейса, не может быть пустым;

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • server - IP-адрес или доменное имя PPTP-сервера, к которому осуществляется подключение;

  • login - логин на сервере PPTP, не может быть пустым;

  • password - пароль на сервере PPTP, не может быть пустым;

  • mac - MAC-адрес сетевой карты или идентификатор агрегированного интерфейса. MAC-адрес в формате 11:22:33:44:55:66, все буквы в нижнем регистре;

  • enable_dhcp - получать ли адрес интерфейса и адрес шлюза от провайдера по DHCP;

  • addresses - список адресов в формате IP/prefix. Может быть пустым, если включено получение адресов по DHCP;

  • gateway - IP-адрес шлюза. Может быть null, если включено получение адресов по DHCP или PPTP-сервер находится в той же подсети, что назначена на интерфейс;

  • dns - список IP-адресов DNS, может быть пустым независимо от флага включения DHCP;

  • vlan_tag - тэг VLAN, число от 1 до 4095 (включительно). Может быть null если не назначен;

  • zone - идентификатор зоны, к которой относится интерфейс. Может быть null, если не назначен;

  • is_vce_vlan - true, если подключение создано на основе проброшенного в VCE VLAN;

  • netflow_index - целое число от 0 до 65535, индекс сетевого подключения для .

L2TP (Подключение к провайдеру по L2TP)
GET /network/connections

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

{
    "id": "integer",
    "type": "l2tp",
    "title": "string",
    "enabled": "boolean",
    "server": "string",
    "login": "string",
    "password": "string",
    "mac": "string",
    "enable_dhcp": "boolean",
    "addresses": [ "string" ],
    "gateway": "null" | "string",
    "dns": [ "string" ],
    "vlan_tag": "null" | "integer",
    "zone": "null" | "string",
    "is_vce_vlan": "boolean",
    "netflow_index": "integer"
}
  • id - идентификатор интерфейса;

  • title - название интерфейса, не может быть пустым;

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • server - IP-адрес или доменное имя L2TP-сервера, к которому осуществляется подключение;

  • login - логин на сервере L2TP, не может быть пустым;

  • password - пароль на сервере L2TP, не может быть пустым;

  • mac - MAC-адрес сетевой карты или идентификатор агрегированного интерфейса. MAC-адрес в формате 11:22:33:44:55:66, все буквы в нижнем регистре;

  • enable_dhcp - получать ли адрес интерфейса и адрес шлюза от провайдера по DHCP;

  • addresses - список адресов в формате IP/prefix. Может быть пустым, если включено получение адресов по DHCP;

  • gateway - IP-адрес шлюза. Может быть null, если включено получение адресов по DHCP или L2TP-сервер находится в той же подсети, что назначена на интерфейс;

  • dns - список IP-адресов DNS, может быть пустым независимо от флага включения DHCP;

  • vlan_tag - тэг VLAN, число от 1 до 4095 (включительно), null, если не назначен;

  • zone - идентификатор зоны, к которой относится интерфейс. Может быть null, если не назначен;

  • is_vce_vlan - true, если подключение создано на основе проброшенного в VCE VLAN;

  • netflow_index - целое число от 0 до 65535, индекс сетевого подключения для .

PPPoE (Подключение к провайдеру по PPPoE)
GET /network/connections

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

{
    "id": "integer",
    "type": "pppoe",
    "title": "string",
    "enabled": "boolean",
    "login": "string",
    "password": "string",
    "service": "string",
    "concentrator": "string",
    "mac": "string",
    "vlan_tag": "null" | "integer",
    "zone": "null" | "string",
    "is_vce_vlan": "boolean",
    "netflow_index": "integer"
}
  • id - идентификатор интерфейса;

  • title - название интерфейса, не может быть пустым;

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • login - логин на сервере PPPoE, не может быть пустым;

  • password - пароль на сервере PPPoE, не может быть пустым;

  • service - название сервиса, может быть пустым;

  • concentrator - название концентратора, может быть пустым;

  • mac - MAC-адрес сетевой карты или идентификатор агрегированного интерфейса. MAC-адрес в формате 11:22:33:44:55:66, все буквы в нижнем регистре;

  • vlan_tag - тэг VLAN, число от 1 до 4095 (включительно), null, если не назначен;

  • zone - идентификатор зоны, к которой относится интерфейс. Может быть null, если не назначен;

  • is_vce_vlan - true, если подключение создано на основе проброшенного в VCE VLAN;

Loopback
GET /network/connections

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

{
    "mac": "string",
    "osdevname": "string",
    "addresses": [ "string" ],
    "comment": "string",
    "enabled": "boolean",
    "is_vce_vlan": "boolean",
    "netflow_index": "integer",
    "title": "string",
    "type": "loopback",
    "vlan_tag": "integer",
    "zone": "string",
    "id": "integer"
}
  • mac - MAC-адрес интерфейса. Для Loopback-интерфейса - null;

  • osdevname - название Loopback-интерфейса в операционной системе (например, Oloopback3). Значение создается автоматически, является уникальным и доступно только для чтения;

  • addresses - список адресов в формате IP/prefix.

  • comment - комментарий, может быть пустым. Максимальное количество символов - 256;

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • is_vce_vlan - признак подключения, созданного на основе проброшенного в VCE VLAN. Для Loopback-интерфейса - false;

  • title - название интерфейса, не может быть пустым;

  • type - тип подключения;

  • vlan_tag - тэг VLAN. Для Loopback-интерфейса - null;

  • zone - идентификатор зоны, к которой относится интерфейс. Для Loopback-интерфейса - null;

  • id - идентификатор интерфейса.

Управление внешними и локальными интерфейсами

Получение состояния локальных интерфейсов и подключений
GET /network/states

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

[
  {
    "id": "integer",
    "zone": "null" | "string",
    "type": "lan" | "wan" | "pptp" | "l2tp" | "pppoe" | "loopback",
    "ether": {
        "device": "null" | "string",
        "vlan_tag": "null" | "integer",
        "addresses": [ "string" ],
        "gateway": "null" | "string",
        "dns": [ "string" ],
        "status": "down" | "going-up" | "up",
        "errors": [ "string" ]
    },
    "ppp": {
        "device": "null" | "string",
        "remote_address": "null" | "string",
        "local_address": "null" | "string",
        "dns": [ "string" ],
        "status": "down" | "going-up" | "up",
        "errors": [ "string" ]
    },
    "summary": {
        "device": "null" | "string",
        "addresses": [ "string" ],
        "dns": [ "string" ],
        "gateway": "null" | "string",
        "ifindex": "null" | "integer",
        "scope": "kernel" | "vpp"
    }
  },
...
]
  • id - идентификатор интерфейса;

  • zone - идентификатор зоны, к которой относится интерфейс. Может быть null, если не назначен. Для Loopback-интерфейса - null;

  • type - тип подключения;

  • ether - состояние Ethernet или VLAN:

    • device - название устройства в системе, например, Leth1;

    • vlan_tag - тэг VLAN, число от 1 до 4095 (включительно) или null, если не назначен. Для Loopback-интерфейса - null;

    • addresses - список адресов, может быть пустым. Адреса в формате IP/prefix;

    • gateway - IP-адрес шлюза, может быть равен null, если шлюза нет;

    • dns - адреса DNS, выданные по DHCP или назначенные пользователем, может быть пустым;

    • status - текущее состояние интерфейса:

      • down - отключен;

      • going-up - промежуточное состояние, когда интерфейс находится в процессе включения (например, после активации или перезагрузки);

      • up - активен.

    • errors - список ошибок.

  • ppp - состояние РРР-подключения. Поле определено только для интерфейсов с полем type равным pptp | l2tp | pppoe, для всех остальных типов lan | wan | loopback равно null:

    • device - название устройства в системе, например Eppp4;

    • remote_address - туннельный IP-адрес сервера;

    • local_address - туннельный IP-адрес клиента (IP-адрес NGFW);

    • dns - адреса DNS, выданные из PPP;

    • status - текущее состояние интерфейса:

      • down - отключен;

      • going-up - промежуточное состояние, когда интерфейс находится в процессе включения (например, после активации или перезагрузки);

      • up - активен.

    • errors - список ошибок.

  • summary - общее состояние подключение:

    • device - итоговое активное устройство, например, Eppp4 или Eeth3;

    • addresses - список адресов интерфейса или подключения к провайдеру;

    • dns - адреса DNS, пригодные к использованию для сервера DNS и других целей;

    • gateway - IP-адрес шлюза, может быть равен null, если шлюза нет;

    • ifindex - числовой идентификатор интерфейса;

    • scope - принадлежность интерфейса сетевому стеку: kernel - ядро.

Создание внешнего или локального интерфейса
POST /network/connections
  • LAN | WAN | PPTP | L2TP | PPPoE - без поля id.

  • Loopback - без полей id и osdevname.

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

{
    "id": "number"
}
  • id - идентификатор созданного интерфейса.

Редактирование внешнего или локального интерфейса
PATCH /network/connections/<id интерфейса>

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

Удаление внешнего или локального интерфейса
DELETE /network/connections/<id интерфейса>

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

Агрегированные интерфейсы

Получение списка агрегированных интерфейсов
GET /network/aggregated

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

[  
  {
    "id": "string",
    "enabled": "boolean",
    "title": "string",
    "comment": "string",
    "nics": [ "string" ]
  },
...
]
  • id - идентификатор агрегированного интерфейса;

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • title - название, не может быть пустым;

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

  • nics - список MAC-адресов в формате 11:22:33:44:55:66, все буквы в нижнем регистре, может быть пустым.

Получение состояния агрегированных интерфейсов
GET /network/aggregated_states

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

[
  {
    "id": "string",
    "link": "up" | "down"
  },
...
]
  • id - идентификатор агрегированного интерфейса;

  • link - состояние соединения на агрегированном интерфейсе.

Создание нового агрегированного интерфейса
POST /network/aggregated

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

{
  "enabled": "boolean",
  "title": "string",
  "comment": "string",
  "nics": [ "string" ]
  }
  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • title - название, не может быть пустым;

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

  • nics - список MAC-адресов в формате 11:22:33:44:55:66, все буквы в нижнем регистре, может быть пустым.

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

{
    "id": "string"
}
  • id - идентификатор созданного агрегированного интерфейса.

Редактирование агрегированного интерфейса
PUT /network/aggregated/<id интерфейса>

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

{
  "enabled": "boolean",
  "title": "string",
  "comment": "string",
  "nics": [ "string" ]
  }
  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • title - название, не может быть пустым;

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

  • nics - список MAC-адресов в формате 11:22:33:44:55:66, все буквы в нижнем регистре, может быть пустым.

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

Удаление агрегированного интерфейса
DELETE /network/aggregated/<id интерфейса>

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

Туннельные интерфейсы

Получение списка всех туннельных интерфейсов
GET /network/tunnels

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

[  
  {
    "id": "string",
    "title": "string",
    "enabled": "boolean",
    "comment": "string",
    "addresses": [ "string" ],
    "gateway": "null" | "string",
    "parent_interface": "string",
    "osdevname": "string",
    "server": "string",
    "zone": "null" | "string",
    "netflow_index": "integer",
    "local_ip": "null" | "string"
  },
...
]
  • id - идентификатор интерфейса, строка в формате UUID;

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

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

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

  • addresses - список адресов в формате IP/prefix;

  • gateway - IP-адрес шлюза, может быть равен null;

  • parent_interface - алиас родительского интерфейса, его IP-адрес будет источником туннеля;

  • osdevname - название существующего или планируемого сетевого интерфейса в ядре (например, Gre00000001). Значение создается автоматически, является уникальным и доступно только для чтения;

  • server - IP-адрес или доменное имя устройства, к которому осуществляется подключение;

  • zone - идентификатор зоны, к которой относится интерфейс. Может быть null, если не назначен;

  • local_ip - IP-адрес родительского интерфейса запущенного туннеля.

Получение состояния туннельных интерфейсов
GET /network/tunnel_states

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

{
  "id": "string",
  "link": "up" | "down" | "inactive",
  "local_ip": "string"
}
  • id - идентификатор интерфейса;

  • link - состояние туннельного интерфейса, inactive при недоступности родительского интерфейса;

  • local_ip - IP-адрес родительского интерфейса запущенного туннеля.

Создание нового туннельного интерфейса
POST /network/tunnels

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

{
    "title": "string",
    "enabled": "boolean",
    "comment": "string",
    "addresses": [ "string" ],
    "gateway": "null" | "string",
    "parent_interface": "string",
    "osdevname": "string",
    "server": "string",
    "zone": "null" | "string",
    "netflow_index": "integer",
    "local_ip": "null" | "string"
}
  • title - название интерфейса, не может быть пустым, максимальная длина - 42 символа;

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

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

  • addresses - список адресов в формате IP/prefix;

  • gateway - IP-адрес шлюза, может быть равен null;

  • parent_interface - алиас родительского интерфейса, его IP-адрес будет источником туннеля;

  • osdevname - название существующего или планируемого сетевого интерфейса в ядре (например, Gre00000001). Значение создается автоматически, является уникальным и доступно только для чтения;

  • server - IP-адрес или доменное имя устройства, к которому осуществляется подключение;

  • zone - идентификатор зоны, к которой относится интерфейс. Может быть null, если не назначен;

  • local_ip - IP-адрес родительского интерфейса запущенного туннеля. Если не задавать, берется с родительского интерфейса.

Важно: Для каждого родительского интерфейса все настроенные туннели должны иметь уникальные значения в поле server. Не допускается создание туннельных интерфейсов с повторяющимися значениями в полях parent_interface и server!

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

{
    "id": "string"
}
  • id - идентификатор созданного туннельного интерфейса.

Редактирование туннельного интерфейса
PUT /network/tunnels/<id интерфейса>

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

{
    "title": "string",
    "enabled": "boolean",
    "comment": "string",
    "addresses": [ "string" ],
    "gateway": "null" | "string",
    "parent_interface": "string",
    "osdevname": "string",
    "server": "string",
    "zone": "null" | "string",
    "netflow_index": "integer",
    "local_ip": "null" | "string"
}
  • title - название интерфейса, не может быть пустым, максимальная длина - 42 символа;

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

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

  • addresses - список адресов в формате IP/prefix;

  • gateway - IP-адрес шлюза, может быть равен null;

  • parent_interface - алиас родительского интерфейса, его IP-адрес будет источником туннеля;

  • osdevname - название существующего или планируемого сетевого интерфейса в ядре (например, Gre00000001). Значение создается автоматически, является уникальным и доступно только для чтения;

  • server - IP-адрес или доменное имя устройства, к которому осуществляется подключение;

  • zone - идентификатор зоны, к которой относится интерфейс. Может быть null, если не назначен;

  • local_ip - IP-адрес родительского интерфейса запущенного туннеля. Если не задавать, берется с родительского интерфейса.

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

Удаление туннельного интерфейса
DELETE /network/tunnels/<id интерфейса>

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

VCE-интерфейсы

Получение списка всех сетевых интерфейсов, пробрасываемых в VCE
GET /network/vce_conns

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

[
  {
    "id": "string",
    "title": "string",
    "vce_id": "string",
    "mac": "string",
    "vlan_tag": "null" | "integer",
    "comment": "string"
  },
  ...
]
  • id - идентификатор интерфейса;

  • title - название интерфейса, не может быть пустым;

  • vce_id - идентификатор VCE, для которого создан интерфейс;

  • mac - MAC-адрес сетевой карты в формате 11:22:33:44:55:66, все буквы в нижнем регистре;

  • vlan_tag - тэг VLAN, число от 1 до 4095 (включительно). Может быть null, если пробрасывается сетевой интерфейс целиком;

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

Важно: Изменяемыми являются только поля title и comment.

Создание пробрасываемого в VCE интерфейса
POST /network/vce_conns

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

{
    "title": "string",
    "vce_id": "string",
    "mac": "string",
    "vlan_tag": "null" | "integer",
    "comment": "string"
}
  • title - название интерфейса, не может быть пустым;

  • vce_id - идентификатор VCE, для которого создан интерфейс;

  • mac - MAC-адрес сетевой карты в формате 11:22:33:44:55:66, все буквы в нижнем регистре;

  • vlan_tag - тэг VLAN, число от 1 до 4095 (включительно). Может быть null, если пробрасывается сетевой интерфейс целиком;

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

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

{
  "id": "string"
}
  • id - идентификатор созданного интерфейса.

Редактирование пробрасываемого в VCE интерфейса
PATCH /network/vce_conns/<id интерфейса>

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

{
    "title": "string",
    "comment": "string"
}
  • title - название интерфейса, не может быть пустым;

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

Поля опциональны, можно передавать любое из них отдельно или оба сразу.

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

Удаление пробрасываемого в VCE интерфейса
DELETE /network/vce_conns/<id интерфейса>

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

SPAN-интерфейсы

Получение списка SPAN-интерфейсов
GET /network/span

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

[  
  {
    "id": "string",
    "title": "string",
    "comment": "string",
    "enabled": "boolean",
    "mac": "string",
    "monitor_interfaces": [ "string" ],
    "direction": "string",
    "osdevindex": "integer"
  },
...
] 
  • id - идентификатор интерфейса (строка в формате UUID);

  • title - название интерфейса, не может быть пустым;

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

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • mac - MAC-адрес сетевой карты;

  • monitor_interfaces - список идентификаторов алиасов интерфейсов, трафик с которых надо зеркалировать. Допустимые типы алиасов: isp, lan, interface.vpn_traffic;

  • direction - тип трафика, который требуется дублировать на SPAN-интерфейс. Может принимать значения rx - входящий, tx - исходящий и both - оба;

  • osdevindex - суффикс (числовой индекс) названия существующего или планируемого сетевого интерфейса в ядре (например, число 43818 соответствует интерфейсу с системным именем Span43818). Значение создается автоматически. Является уникальным и доступно только для чтения.

Создание нового SPAN-интерфейса
POST /network/span

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

{
    "title": "string",
    "comment": "string",
    "enabled": "boolean",
    "mac": "string",
    "monitor_interfaces": [ "string" ],
    "direction": "string"
}
  • title - название интерфейса, не может быть пустым;

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

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • mac - MAC-адрес сетевой карты;

  • monitor_interfaces - список идентификаторов алиасов интерфейсов, трафик с которых надо зеркалировать. Допустимые типы алиасов: isp, lan, ipsec, ipsec_gre, tunnel;

  • direction - тип трафика, который требуется дублировать на SPAN-интерфейс. Может принимать значения rx - входящий, tx - исходящий и both - оба.

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

{
    "id": "string"
}
  • id - идентификатор созданного SPAN-интерфейса.

Редактирование SPAN-интерфейса
PATCH /network/span/<id SPAN-интерфейса>

Json-тело запроса (любые поля интерфейса, кроме id и osdevindex):

{
    "title": "string",
    "comment": "string",
    "enabled": "boolean",
    "mac": "string",
    "monitor_interfaces": [ "string" ],
    "direction": "string"
}
  • title - название интерфейса, не может быть пустым;

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

  • enabled - статус активности интерфейса:

    • true - включен;

    • false - выключен.

  • mac - MAC-адрес сетевой карты;

  • monitor_interfaces - список идентификаторов алиасов интерфейсов, трафик с которых надо зеркалировать. Допустимые типы алиасов: isp, lan, ipsec, ipsec_gre, tunnel;

  • direction - тип трафика, который требуется дублировать на SPAN-интерфейс. Может принимать значения rx - входящий, tx - исходящий и both - оба.

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

Удаление SPAN-интерфейса
DELETE /network/span/<id SPAN-интерфейса>

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

netflow_index - целое число от 0 до 65535, индекс сетевого подключения для .

netflow_index - целое число от 0 до 65535, индекс сетевого подключения для ;

Json-тело запроса: один из объектов описанных в разделе :

Json-тело запроса: один из объектов описанных в разделе .

netflow_index - целое число от 0 до 65535, индекс сетевого подключения для ;

netflow_index - целое число от 0 до 65535, индекс сетевого подключения для ;

netflow_index - целое число от 0 до 65535, индекс сетевого подключения для ;

NetFlow
NetFlow
NetFlow
NetFlow
NetFlow
NetFlow
NetFlow
NetFlow
NetFlow
Получение списка всех внешних и локальных интерфейсов
Получение списка всех внешних и локальных интерфейсов