Руководство разработчика: облачная сигнализация в DoSGate

Досгейт может получать сигнал о переводе IP-префиксов получателей в определенные профили через REST API.

REST API Signaling

Сигнализация реализуется за счет ПО dosgate-signaling-receiver, которое настраивается на стороне DoSGate получателя сигнала, и контролирует, к какому профилю должен быть привязан IP-префикс получателя:

• При активной сигнализации
• Без активной сигнализации

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

При активной сигнализации - IP-префикс будет перенесен из одного профиля в другой, в котором уже присутствуют правила.

Получение статуса активных сигнализаций

Request

Secret_key Client_ID

HTTP GET https://url/path/<client-id>/<secret-key>/status

Response

{
  "IP_prefix": ["5.5.5.5/32", "1.1.1.1/32", "8.8.8.0/24"]
}

Запуск сигнализации

Request

Secret_key Client_ID IP_prefix

HTTP POST https://url/path/<client-id>/<secret-key>/start

Тело запроса с IP-prefix

{
  "IP_prefix": ["1.1.1.0/22", "6.7.6.5/32"]
}

Response

Success HTTP 200 ok secret_key invalid ip_prefix invalid cloud signaling already active

Остановка сигнализации

Request

Secret_key Client_ID IP_prefix

HTTP POST https://url/path/<client-id>/<secret-key>/stop

Тело запроса с IP-prefix

{
  "IP_prefix": ["1.1.1.0/22", "6.7.6.5/32"]
}

Response

Success HTTP 200 ok secret_key invalid ip_prefix invalid cloud signaling is not active

Тестирование сигнализации по REST API

Для тестирования облачной сигнализации с ПО Досгейт можно воспользоваться тестовым API

https://signal.dosgate.com/request

Данные для тестирования

Клиент 1: Client ID 123 Secret Key 123 IP-prefix: 10.20.1.0/24

Клиент 2: Client ID 12345 Secret Key 123456 IP-prefix: 127.0.0.0/24