DHCP-сервер

Получение статуса службы DHCP-сервера

GET /dhcp_server/status

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

[
  {
    "name": "string",
    "status": "active" | "activating" | "deactivating" | "failed" | "inactive" | "reloading",
    "msg": ["string"]
  }
]

• name - название службы;

• status - текущее состояние службы;

• msg - список строк, подробно описывающих состояние службы;

Настройки

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

GET /dhcp_server/settings

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

[
  {
        "enabled": boolean,
        "interface": "string",
        "relay": {
            "external_servers": [
                "string"
            ]
        },
        "server": null,
        "id": "string"
    },
  {
        "enabled": boolean,
        "interface": "string",
        "relay": null,
        "server": {
            "dns": ["string"],
            "domain": "string",
            "gateway": "string",
            "lease_time": int,
            "options": [
                {
                    "comment": "string",
                    "enabled": boolean,
                    "forced": boolean,
                    "option": "string"
                }
            ],
            "ranges": [ "string" ],
            "routes": [ {
                    "destination": "string",
                    "gateway": "string"
                } ],
            "tftp_filename": "string",
            "tftp_server": "string",
            "wins": [ "string" ],
            "wpad_enabled": boolean
        },
        "id": "string"
    },
    ...
]

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

• enabled - включена или выключена настройка;

• interface - интерфейс Ideco NGFW;

• relay - режим работы (если активен server, должен быть null);

  • external_servers - IP-адрес внешнего DHCP-сервера;

• server - режим работы (если активен relay, должен быть null)

  • dns - поля DNS-1 и DNS-2 в веб-интерфейсе. Если не задано значение в поле DNS-1 или DNS-2, то DNS-сервером для всех сетевых устройств локальной сети будет являться Ideco NGFW;

  • domain - DNS-суффикс;

  • gateway - шлюз для направления трафика по умолчанию. Если поле не заполнено, шлюзом будет выступать IP-адрес выбранного интерфейса;

  • lease_time - время аренды (в минутах);

  • options - опции dnsmasq:

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

    • enabled - включена или отключена опция;

    • forced - принудительная отправка опции клиенту;

    • option - значение опции;

  • ranges - диапазон IP-адресов для выдачи;

  • routes - статические маршруты:

    • destination - хост;

    • gateway - шлюз;

  • tftp_filename - имя файла для загрузки по TFTP;

  • tftp_server - IP-адрес TFTP-сервера для настройки загрузки образа по сети;

  • wins - IP-адрес WINS-сервера;

  • wpad_enabled - включение протокола автоматической настройки прокси. Для работы WPAD необходимо разрешить прямые подключения к прокси.

Создание настроек

POST /dhcp_server/settings

Json-тело запроса для режима сервера:

{
      "enabled": boolean,
      "interface": "string",
      "relay": null,
      "server": {
          "dns": ["string"],
          "domain": "string",
          "gateway": "string",
          "lease_time": int,
          "options": [
              {
                  "comment": "string",
                  "enabled": boolean,
                  "forced": boolean,
                  "option": "string"
              }
          ],
          "ranges": [ "string" ],
          "routes": [ {
                  "destination": "string",
                  "gateway": "string"
              } ],
          "tftp_filename": "string",
          "tftp_server": "string",
          "wins": [ "string" ],
          "wpad_enabled": boolean
      }
  }

Json-тело запроса для режима релея:

{
      "enabled": boolean,
      "interface": "string",
      "relay": {
          "external_servers": [
              "string"
          ]
      },
      "server": null
  }

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

{
  "id": "string",
}

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

PATCH /dhcp_server/settings/<id настройки>

Json-тело запроса - все или некоторые поля для создания настроек, например:

{
      "relay": {
          "external_servers": [
              "string"
          ]
      }
  }

Ответ: Статус 200

Удаление настроек

DELETE /dhcp_server/settings/<id настройки>

Ответ: 200 ОК

Привязка IP к MAC

Получение статических привязок

GET /dhcp_server/static_leases

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

[
    {
        "comment": "",
        "enabled": true,
        "ip_address": "192.168.0.40",
        "mac": "50:46:5d:6e:8c:20",
        "id": "3e4827dd-5e0c-4932-98b1-fa2d9826b0ce"
    },
    ...
]

Создание статической привязки

POST /dhcp_server/static_leases

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

{
    "comment": "string",
    "enabled": boolean,
    "ip_address": "string",
    "mac": "string"
  }

Будьте внимательны при согласовании настроек клиентских устройств и DHCP-сервера на Ideco NGFW. Некоторые устройства предоставляют MAC-адрес с разделенными с помощью дефиса октетами (01-02-03-04-05-06). В настройках Ideco NGFW октеты MAC-адреса разделяются только двоеточиями (01:02:03:04:05:06).

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

{
  "id": "string"
}

Редактирование статической привязки

PATCH /dhcp_server/static_leases/<id статической привязки>

Json-тело запроса (все или некоторые поля):

{
    "comment": "string",
    "enabled": boolean,
    "ip_address": "string",
    "mac": "string"
  }

Ответ: 200 ОК

Удаление статической привязки

DELETE /dhcp_server/static_leases/<id статической привязки>

Ответ: 200 ОК