POST /v1/sync

Networks

Ресурс Networks представляет собой введенную нами абстракцию, которая позволяет определять группы IP-адресов или подсетей, доступных для управления Host Based NGFW. Эти подсети затем могут быть связаны с конкретными группами безопасности для логического разделения и использоваться в правилах для разрешения или блокирования доступа к определенным ресурсам в вашей сети.

Более подробно по организации БД можно посмотреть здесь.

Входные параметры

• networks[] - Массив/Список подсетей типа IP.
• networks[].name - название подсети.
• networks[].network - объект содержащий CIDR подсети
• networks[].network.CIDR - Подсеть типа IP.
• syncOp - Поле определяющее действие с данными из запроса.

название	обязательность	тип данных	значение по умолчанию
networks[]	да	Object[]
networks[].name	да	String
networks[].network	да	Object
networks[].network.CIDR	да	String
syncOp	да	Enum("Delete", "Upsert", "FullSync")

Ограничения

• networks.networks[].name:

  • Длина значения поля не должна превышать 256 символов.
  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • Значение должно быть уникальным в рамках типа ресурса.

• networks.networks[].network.CIDR:

  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • В пределах одной Security Group и направления трафика (I/E), необходимо обеспечить, непересекаемость диапазонов адресов подсетей.
  • Подсеть должна соответствовать формату записи, определенному в RFC 4632.

Пример использования

curl '127.0.0.1:9007/v1/sync' \
--header 'Content-Type: application/json' \
--data '{
    "networks": {
        "networks": [{
            "name": "nw-1",
            "network": {
                "CIDR": "10.0.0.0/24"
            }
        }]
    },
    "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

Security Groups

Ресурс Groups представляет собой введенную нами абстракцию, которая позволят объединить подсети в логические группы и применять к ним единые правила сетевого взаимодействия.

Более подробно по организации БД можно посмотреть здесь и здесь.

Входные параметры

• groups.grous[] - Структура, содержащая описание создаваемых Security Group
• groups.groups[].defaultAction - представляет действие по умолчанию в конце цепочек для SG
• groups.groups[].logs - Включить/отключить логирование.
• groups.groups[].name - Security Group относительно которой рассматриваются правила.
• groups.groups[].networks - Имена подсетей
• groups.groups[].trace - Включить/отключить трассировку.
• sgIcmpRules.rules[] - Структура, содержащая описание создаваемых правил.
• sgIcmpRules.rules[].ICMP - Структура, содержащая описание создаваемых правил типа ICMP.
• sgIcmpRules.rules[].ICMP.IPv - Версия IP для ICMP (IPv4 или IPv6).
• sgIcmpRules.rules[].ICMP.Types - Список, определяющий допустимые типы ICMP запросов.
• sgIcmpRules.rules[].SG - Security Group относительно которой рассматриваются правила.
• sgIcmpRules.rules[].logs - Включить/отключить логирование.
• sgIcmpRules.rules[].trace - Включить/отключить трассировку.
• sgIcmpRules.rules[].action - Действие для пакетов в сформированных правил в цепочке.
• syncOp - Поле определяющее действие с данными из запроса.

название	обязательность	тип данных	Значение по умолчанию	API request
				groups	sgIcmpRules
groups.groups[]	да	Object[]		✔
groups.groups[].defaultAction	да	Enum("ACCEPT", "DROP")		✔
groups.groups[].logs	нет	Boolean	false	✔
groups.groups[].name	да	String		✔
groups.groups[].networks	нет	String[]	[]	✔
groups.groups[].trace	нет	Boolean	false	✔
sgIcmpRules.rules[]	да	Object[]			✔
sgIcmpRules.rules[].ICMP	да	Object			✔
sgIcmpRules.rules[].ICMP.IPv	да	Enum("IPv4", "IPv6")			✔
sgIcmpRules.rules[].ICMP.Types	нет	String[]	[]		✔
sgIcmpRules.rules[].SG	да	String			✔
sgIcmpRules.rules[].logs	нет	Boolean	false		✔
sgIcmpRules.rules[].trace	нет	Boolean	false		✔
sgIcmpRules.rules[].action	да	Enum("UNDEF", "ACCEPT", "DROP")			✔
syncOp	да	Enum("Delete", "Upsert", "FullSync")		✔	✔

Ограничения

• groups.groups[].name:

  • Длина значения поля не должна превышать 256 символов.
  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • Значение должно быть уникальным в рамках типа ресурса.

• groups.groups[].networks[]:

  • Значение элемента должно начинаться и заканчиваться символами без пробелов.
  • Повторения значений в списке не допускаются.
  • Необходимо указать минимум одно значение.
  • В пределах одной Security Group и направления трафика (I/E), необходимо обеспечить, непересекаемость диапазонов адресов подсетей.
  • Подсеть должна соответствовать формату записи, определенному в RFC 4632.

• sgIcmpRules.rules[].SG:

  • Длина значения поля не должна превышать 256 символов.
  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • Значение должно быть уникальным в рамках типа ресурса.

• $node.rules[].type[]:

  • Значение должно быть числом в диапазоне от 0 до 255.
  • Повторения значений в списке не допускаются.

Пример использования

Security Groups

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
    "groups": {
        "groups": [{
            "defaultAction": "ACCEPT",
            "logs": true,
            "name": "sg-example",
            "networks": ["10.0.0.0/24", "11.0.0.0/24"],
            "trace": true
        }]
    },
    "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

ICMP

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
    "sgIcmpRules": {
        "rules": [{
            "ICMP": {
                "IPv": "IPv4",
                "Types": [0,8]
            },
            "SG": "sg-example",
            "logs": true,
            "trace": true,
            "action": "DROP",
        },
        {
            "ICMP": {
                "IPv": "IPv6",
                "Types": [0,8]
            },
            "SG": "sg-example",
            "logs": true,
            "trace": true,
            "action": "DROP",
        }]
    },
    "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Rules

Sgroup to Sgroup

Данный тип правил управляет обменом данными между различными группами безопасности. Он автоматически создает два правила на хостах: одно для исходящего трафика от инициирующей стороны и другое для входящего трафика от группы безопасности, к которой предоставлен доступ.

Более подробно по организации БД можно посмотреть здесь и здесь.

Входные параметры

• $node.rules[] - Структура, содержащая описание создаваемых правил.
• $node.rules[].sgFrom - Security Group, с которой устанавливаются правила взаимодействия.
• $node.rules[].sgTo - Security Group, с которой устанавливаются правила взаимодействия.
• $node.rules[].logs - Включить/отключить логирование.
• $node.rules[].trace - Включить/отключить трассировку.
• $node.rules[].ports - Блок описывающий набор пар портов (src-dst).
• $node.rules[].ports[].d - Набор открытых портов получателя
• $node.rules[].ports[].s - Набор открытых портов отправителя.
• $node.rules[].transport - Протокол L3/L4 уровня модели OSI.
• $node.rules[].ICMP - Структура, содержащая описание создаваемых правил типа ICMP.
• $node.rules[].ICMP.IPv - Версия IP для ICMP (IPv4 или IPv6).
• $node.rules[].ICMP.Types - Список, определяющий допустимые типы ICMP запросов.
• $node.rules[].action - Действие для пакетов в сформированных правил в цепочке.
• $node.rules[].priority - Структура, содержащая описание порядка применения правил в цепочке.
• $node.rules[].priority.some - Поле определяющее порядок применения правил в цепочке.
• syncOp - Поле определяющее действие с данными из запроса.

Области применения полей относительно используемого протокола

название	обязательность	тип данных	значение по умолчанию	transport*
				TCP	UDP	ICMP
$node.rules[]	да	Object[]	null	✔	✔	✔
$node.rules[].sgFrom	да	String		✔	✔	✔
$node.rules[].sgTo	да	String		✔	✔	✔
$node.rules[].logs	нет	Boolean	false	✔	✔	✔
$node.rules[].trace	нет	Boolean	false	✔	✔	✔
$node.rules[].ports	нет	Object[]	null	✔	✔
$node.rules[].ports[].d	нет	String	null	✔	✔
$node.rules[].ports[].s	нет	String	null	✔	✔
$node.rules[].transport	нет	Enum("TCP", "UDP")	TCP	✔	✔
$node.rules[].ICMP	да	Object				✔
$node.rules[].ICMP.IPv	да	Enum("IPv4", "IPv6")				✔
$node.rules[].ICMP.Types	нет	String[]	[]			✔
$node.rules[].action	да	Enum("UNDEF", "ACCEPT", "DROP")		✔	✔	✔
$node.rules[].priority	нет	Object		✔	✔	✔
$node.rules[].priority.some	нет	Integer		✔	✔	✔
syncOp	да	Enum("Delete", "Upsert", "FullSync")		✔	✔	✔

Ограничения

• sgSgRules.rules[].sgFrom:

  • Длина значения поля не должна превышать 256 символов.
  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • Значение должно быть уникальным в рамках типа ресурса.

• sgSgRules.rules[].sgTo:

  • Длина значения поля не должна превышать 256 символов.
  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • Значение должно быть уникальным в рамках типа ресурса.

• sgSgRules.rules[].ports[].d:

  • Значения портов должно находиться в интервале от 1 до 65535.
  • Если значение не будет указано то будет использоваться весь диапазон портов.
  • Значения портов прописываются по одному или интервально используя '-'.

• sgSgRules.rules[].ports[].s:

  • Значения портов должно находиться в интервале от 1 до 65535.
  • Если значение не будет указано то будет использоваться весь диапазон портов.
  • Значения портов прописываются по одному или интервально используя '-'.
  • Не допускаются пересечения портов в правилах в рамках одной пары Security Group.</li>

• sgSgRules.rules[].ICMP.Types[]:

  • Значение должно быть числом в диапазоне от 0 до 255.
  • Повторения значений в списке не допускаются.

Пример использования

TCP

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "sgRules": {
    "rules": [{
      "sgFrom": "sg-local-example",
      "sgTo": "sg-example",
      "logs": true,
      "trace": true,
      "ports": [{
        "d": "443,80",
        "s": "64231"
      }],
      "transport": "TCP",
      "action": "ACCEPT",
      "priority": {
        "some": -200
      }
    }]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

UDP

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "sgRules": {
    "rules": [{
      "sgFrom": "sg-local-example",
      "sgTo": "sg-example",
      "logs": true,
      "trace": true,
      "ports": [{
        "d": "443,80",
        "s": "64231"
      }],
      "transport": "UDP",
      "action": "ACCEPT",
      "priority": {
        "some": -200
      }
    }]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

ICMP4

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "sgSgIcmpRules": {
    "rules": [{
      "sgFrom": "sg-local-example",
      "sgTo": "sg-example",
      "logs": true,
      "trace": true
      "ICMP": {
        "IPv": "IPv4",
        "Types": [0,8]
      },
      "action": "ACCEPT",
      "priority": {
        "some": -300
      }
    }]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

ICMP6

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "sgSgIcmpRules": {
    "rules": [{
      "sgFrom": "sg-local-example",
      "sgTo": "sg-example",
      "logs": true,
      "trace": true
      "ICMP": {
        "IPv": "IPv6",
        "Types": [0,8]
      },
      "action": "ACCEPT",
      "priority": {
        "some": -300
      }
    }]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

Sgroup to Sgroup (I/E)

Ресурс Security Group to Security Group представляет собой введенную нами абстракцию, которая обеспечивает гибкое управление и контроль сетевого трафика между разными группами безопасности, используя протоколы TCP, UDP и ICMP. Этот ресурс позволяет точно настраивать, какой трафик может передаваться между группами, обеспечивая таким образом высокий уровень защиты и контроля в сетевой инфраструктуре.

Более подробно по организации БД можно посмотреть здесь и здесь.

Входные параметры

• $node.rules[] - Структура, содержащая описание создаваемых правил.
• $node.rules[].SG - Security Group, с которой устанавливаются правила взаимодействия.
• $node.rules[].sgLocal - Security Group относительно которой рассматриваются правила.
• $node.rules[].logs - Включить/отключить логирование.
• $node.rules[].trace - Включить/отключить трассировку.
• $node.rules[].ports - Блок описывающий набор пар портов (src-dst).
• $node.rules[].ports[].d - Набор открытых портов получателя
• $node.rules[].ports[].s - Набор открытых портов отправителя.
• $node.rules[].traffic - Поле описывающий направление трафика.
• $node.rules[].transport - Протокол L3/L4 уровня модели OSI.
• $node.rules[].ICMP - Структура, содержащая описание создаваемых правил типа ICMP.
• $node.rules[].ICMP.IPv - Версия IP для ICMP (IPv4 или IPv6).
• $node.rules[].ICMP.Types - Список, определяющий допустимые типы ICMP запросов.
• $node.rules[].action - Действие для пакетов в сформированных правил в цепочке.
• $node.rules[].priority - Структура, содержащая описание порядка применения правил в цепочке.
• $node.rules[].priority.some - Поле определяющее порядок применения правил в цепочке.
• syncOp - Поле определяющее действие с данными из запроса.

Области применения полей относительно используемого протокола

название	обязательность	тип данных	значение по умолчанию	transport*
				TCP	UDP	ICMP
$node.rules[]	да	Object[]	null	✔	✔	✔
$node.rules[].SG	да	String		✔	✔	✔
$node.rules[].sgLocal	да	String		✔	✔	✔
$node.rules[].logs	нет	Boolean	false	✔	✔	✔
$node.rules[].trace	нет	Boolean	false	✔	✔	✔
$node.rules[].ports	нет	Object[]	null	✔	✔
$node.rules[].ports[].d	нет	String	null	✔	✔
$node.rules[].ports[].s	нет	String	null	✔	✔
$node.rules[].traffic	да	Enum("Ingress", "Egress")		✔	✔	✔
$node.rules[].transport	нет	Enum("TCP", "UDP")	TCP	✔	✔
$node.rules[].ICMP	да	Object				✔
$node.rules[].ICMP.IPv	да	Enum("IPv4", "IPv6")				✔
$node.rules[].ICMP.Types	нет	String[]	[]			✔
$node.rules[].action	да	Enum("UNDEF", "ACCEPT", "DROP")		✔	✔	✔
$node.rules[].priority	нет	Object		✔	✔	✔
$node.rules[].priority.some	нет	Integer		✔	✔	✔
syncOp	да	Enum("Delete", "Upsert", "FullSync")		✔	✔	✔

Ограничения

• sgSgRules.rules[].SG:

  • Длина значения поля не должна превышать 256 символов.
  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • Значение должно быть уникальным в рамках типа ресурса.

• sgSgRules.rules[].sgLocal:

  • Длина значения поля не должна превышать 256 символов.
  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • Значение должно быть уникальным в рамках типа ресурса.

• sgSgRules.rules[].ports[].ports_to[]:

  • Значения портов должно находиться в интервале от 1 до 65535.
  • Если значение не будет указано то будет использоваться весь диапазон портов.
  • Значения портов прописываются по одному или интервально используя '-'.

• sgSgRules.rules[].ports[].ports_from[]:

  • Значения портов должно находиться в интервале от 1 до 65535.
  • Если значение не будет указано то будет использоваться весь диапазон портов.
  • Значения портов прописываются по одному или интервально используя '-'.
  • Не допускаются пересечения портов в правилах в рамках одной пары Security Group.</li>

• sgSgRules.rules[].ICMP.Types[]:

  • Значение должно быть числом в диапазоне от 0 до 255.
  • Повторения значений в списке не допускаются.

Пример использования

TCP

Ingress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieSgSgRules": {
    "rules": [
      {
        "traffic": "Ingress",
        "SG": "sg-example",
        "sgLocal": "sg-local-example",
        "logs": true,
        "trace": true,
        "ports": [{
          "d": "64321",
          "s": "443,80"
        }],
        "transport": "TCP",
        "action": "ACCEPT",
        "priority": {
          "some": 0
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Egress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieSgSgRules": {
    "rules": [
      {
        "traffic": "Egress",
        "SG": "sg-example",
        "sgLocal": "sg-local-example",
        "logs": true,
        "trace": true,
        "ports": [{
          "d": "64321",
          "s": "443,80"
        }],
        "transport": "TCP",
        "action": "ACCEPT",
        "priority": {
          "some": 0
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

UDP

Ingress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieSgSgRules": {
    "rules": [
      {
        "traffic": "Ingress",
        "SG": "sg-example",
        "sgLocal": "sg-local-example",
        "logs": true,
        "trace": true,
        "ports": [{
          "d": "64321",
          "s": "443,80"
        }],
        "transport": "UDP",
        "action": "ACCEPT",
        "priority": {
          "some": 0
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Egress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieSgSgRules": {
    "rules": [
      {
        "traffic": "Egress",
        "SG": "sg-example",
        "sgLocal": "sg-local-example",
        "logs": true,
        "trace": true,
        "ports": [{
          "d": "64321",
          "s": "443,80"
        }],
        "transport": "UDP",
        "action": "ACCEPT",
        "priority": {
          "some": 0
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

ICMP4

Ingress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieSgSgIcmpRules": {
    "rules": [
      {
        "traffic": "Ingress",
        "SG": "sg-example",
        "sgLocal": "sg-local-example",
        "logs": true,
        "trace": true,
        "ICMP": {
          "IPv": "IPv4",
          "Types": [0, 8]
        },
        "action": "ACCEPT",
        "priority": {
          "some": -100
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Egress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieSgSgIcmpRules": {
    "rules": [
      {
        "traffic": "Egress",
        "SG": "sg-example",
        "sgLocal": "sg-local-example",
        "logs": true,
        "trace": true,
        "ICMP": {
          "IPv": "IPv4",
          "Types": [0, 8]
        },
        "action": "ACCEPT",
        "priority": {
          "some": -100
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

ICMP6

Ingress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieSgSgIcmpRules": {
    "rules": [
      {
        "traffic": "Ingress",
        "SG": "sg-example",
        "sgLocal": "sg-local-example",
        "logs": true,
        "trace": true,
        "ICMP": {
          "IPv": "IPv6",
          "Types": [0, 8]
        },
        "action": "ACCEPT",
        "priority": {
          "some": -100
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Egress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieSgSgIcmpRules": {
    "rules": [
      {
        "traffic": "Egress",
        "SG": "sg-example",
        "sgLocal": "sg-local-example",
        "logs": true,
        "trace": true,
        "ICMP": {
          "IPv": "IPv6",
          "Types": [0, 8]
        },
        "action": "ACCEPT",
        "priority": {
          "some": -100
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

Sgroup to CIDR (I/E)

Ресурс Security Group to CIDR представляет собой введенную нами абстракцию, которая обеспечивает гибкое управление и контроль за сетевым трафиком между различными группами безопасности и подсетями, используя TCP, UDP и ICMP протоколы. Этот ресурс дает возможность детально настроить, какой трафик разрешен к передаче между группами безопасности и определенными подсетями, тем самым гарантируя высокий уровень защиты и управления сетевой инфраструктурой.

Более подробно по организации БД можно посмотреть здесь и здесь.

Входные параметры

• $node.rules[] - Структура, содержащая описание создаваемых правил.
• $node.rules[].CIDR - Список, содержащий подсети типа IP.
• $node.rules[].SG - Security Group относительно которой рассматриваются правила.
• $node.rules[].logs - Включить/отключить логирование.
• $node.rules[].trace - Включить/отключить трассировку.
• $node.rules[].ports - Блок описывающий набор пар портов (src-dst).
• $node.rules[].ports[].d - Набор открытых портов получателя
• $node.rules[].ports[].s - Набор открытых портов отправителя.
• $node.rules[].traffic - Поле описывающий направление трафика.
• $node.rules[].transport - Протокол L3/L4 уровня модели OSI.
• $node.rules[].ICMP - Структура, содержащая описание создаваемых правил типа ICMP.
• $node.rules[].ICMP.IPv - Версия IP для ICMP (IPv4 или IPv6).
• $node.rules[].ICMP.Types - Список, определяющий допустимые типы ICMP запросов.
• $node.rules[].action - Действие для пакетов в сформированных правил в цепочке.
• $node.rules[].priority - Структура, содержащая описание порядка применения правил в цепочке.
• $node.rules[].priority.some - Поле определяющее порядок применения правил в цепочке.
• syncOp - Поле определяющее действие с данными из запроса.

Области применения полей относительно используемого протокола

название	обязательность	тип данных	значение по умолчанию	transport*
				TCP	UDP	ICMP
$node.rules[]	да	Object	null	✔	✔	✔
$node.rules[].CIDR	да	String		✔	✔	✔
$node.rules[].SG	да	String		✔	✔	✔
$node.rules[].logs	нет	Boolean	false	✔	✔	✔
$node.rules[].trace	нет	Boolean	false	✔	✔	✔
$node.rules[].ports	нет	Object[]	null	✔	✔
$node.rules[].ports[].d	нет	String	null	✔	✔
$node.rules[].ports[].s	нет	String	null	✔	✔
$node.rules[].traffic	да	Enum("Ingress", "Egress")		✔	✔	✔
$node.rules[].transport	нет	Enum("TCP", "UDP")	TCP	✔	✔
$node.rules[].ICMP	да	Object				✔
$node.rules[].ICMP.IPv	да	Enum("IPv4", "IPv6")				✔
$node.rules[].ICMP.Types	нет	String[]	[]			✔
$node.rules[].action	да	Enum("UNDEF", "ACCEPT", "DROP")		✔	✔	✔
$node.rules[].priority	нет	Object		✔	✔	✔
$node.rules[].priority.some	нет	Integer		✔	✔	✔
syncOp	да	Enum("Delete", "Upsert", "FullSync")		✔	✔	✔

Ограничения

• $node.rules[].SG:

  • Длина значения поля не должна превышать 256 символов.
  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • Значение должно быть уникальным в рамках типа ресурса.

• $node.rules[].CIDR:

  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • В пределах одной Security Group и направления трафика (I/E), необходимо обеспечить, непересекаемость диапазонов адресов подсетей.
  • Подсеть должна соответствовать формату записи, определенному в RFC 4632.

• $node.rules[].ports[].s:

  • Значения портов должно находиться в интервале от 1 до 65535.
  • Если значение не будет указано то будет использоваться весь диапазон портов.
  • Значения портов прописываются по одному или интервально используя '-'.
  • Не допускаются пересечения портов в правилах в рамках одной пары Security Group.</li>

• $node.rules[].ports[].d:

  • Значения портов должно находиться в интервале от 1 до 65535.
  • Если значение не будет указано то будет использоваться весь диапазон портов.
  • Значения портов прописываются по одному или интервально используя '-'.

• $node.rules[].type[]:

  • Значение должно быть числом в диапазоне от 0 до 255.
  • Повторения значений в списке не допускаются.

Пример использования

TCP

Ingress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieCidrSgRules": {
    "rules": [
      {
        "traffic": "Ingress",
        "CIDR": "10.0.0.0/8",
        "SG": "sg-local-example",
        "logs": true,
        "trace": true,
        "ports": [{
          "d": "64321",
          "s": "443,80"
        }],
        "transport": "TCP",
        "action": "ACCEPT",
        "priority": {
          "some": 300
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Egress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieCidrSgRules": {
    "rules": [
      {
        "traffic": "Egress",
        "CIDR": "10.0.0.0/8",
        "SG": "sg-local-example",
        "logs": true,
        "trace": true,
        "ports": [{
          "d": "64321",
          "s": "443,80"
        }],
        "transport": "TCP",
        "action": "ACCEPT",
        "priority": {
          "some": 300
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

UDP

Ingress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieCidrSgRules": {
    "rules": [
      {
        "traffic": "Ingress",
        "CIDR": "10.0.0.0/8",
        "SG": "sg-local-example",
        "logs": true,
        "trace": true,
        "ports": [{
          "d": "64321",
          "s": "443,80"
        }],
        "transport": "UDP",
        "action": "ACCEPT",
        "priority": {
          "some": 300
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Egress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieCidrSgRules": {
    "rules": [
      {
        "traffic": "Egress",
        "CIDR": "10.0.0.0/8",
        "SG": "sg-local-example",
        "logs": true,
        "trace": true,
        "ports": [{
          "d": "64321",
          "s": "443,80"
        }],
        "transport": "UDP",
        "action": "ACCEPT",
        "priority": {
          "some": 300
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

ICMP4

Ingress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieCidrSgIcmpRules": {
    "rules": [
      {
        "traffic": "Ingress",
        "CIDR": "10.0.0.0/8",
        "SG": "sg-local-example",
        "logs": true,
        "trace": true,
        "ICMP": {
          "IPv": "IPv4",
          "Types": [0, 8]
        },
        "action": "ACCEPT",
        "priority": {
          "some": 200
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Egress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieCidrSgIcmpRules": {
    "rules": [
      {
        "traffic": "Egress",
        "CIDR": "10.0.0.0/8",
        "SG": "sg-local-example",
        "logs": true,
        "trace": true,
        "ICMP": {
          "IPv": "IPv4",
          "Types": [0, 8]
        },
        "action": "ACCEPT",
        "priority": {
          "some": 200
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

ICMP6

Ingress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieCidrSgIcmpRules": {
    "rules": [
      {
        "traffic": "Ingress",
        "CIDR": "::ffff:a00:0/104",
        "SG": "sg-local-example",
        "logs": true,
        "trace": true,
        "ICMP": {
          "IPv": "IPv6",
          "Types": [0, 8]
        },
        "action": "ACCEPT",
        "priority": {
          "some": 200
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Egress

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "ieCidrSgIcmpRules": {
    "rules": [
      {
        "traffic": "Egress",
        "CIDR": "::ffff:a00:0/104",
        "SG": "sg-local-example",
        "logs": true,
        "trace": true,
        "ICMP": {
          "IPv": "IPv6",
          "Types": [0, 8]
        },
        "action": "ACCEPT",
        "priority": {
          "some": 200
        }
      }
    ]
  },
  "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности

Sgroup to FQDN (E)

Ресурс Security Group to FQDN представляет собой введенную нами абстракцию, которая обеспечивает гибкое управление и контроль за сетевым трафиком между различными группами безопасности и IP адресами стоящие за FQDN записями, используя TCP, UDP протоколы. Этот ресурс дает возможность детально настроить, какой трафик разрешен к передаче между группами безопасности и IP адресами стоящие за определенными FQDN записями, тем самым гарантируя высокий уровень защиты и управления сетевой инфраструктурой.

Более подробно по организации БД можно посмотреть здесь.

Входные параметры

• fqdnRules.rules - Структура, содержащая описание создаваемых правил.
• fqdnRules.rules[].FQDN - Полное доменное имя (FQDN), для которого применяется данное правило.
• fqdnRules.rules[].logs - Включить/отключить логирование.
• fqdnRules.rules[].ports - Включить/отключить трассировку.
• fqdnRules.rules[].ports[].d - Набор открытых портов получателя
• fqdnRules.rules[].ports[].s - Набор открытых портов отправителя.
• fqdnRules.rules[].sgFrom - Security Group относительно которой рассматриваются правила.
• fqdnRules.rules[].transport - Протокол L3/L4 уровня модели OSI.
• fqdnRules.rules[].action - Действие для пакетов в сформированных правил в цепочке.
• fqdnRules.rules[].priority - Структура, содержащая описание порядка применения правил в цепочке.
• fqdnRules.rules[].priority.some - Поле определяющее порядок применения правил в цепочке.
• syncOp - Поле определяющее действие с данными из запроса.

Области применения полей относительно используемого протокола

название	обязательность	тип данных	значение по умолчанию	transport*
				TCP	UDP
fqdnRules.rules	да	Object		✔	✔
fqdnRules.rules[].FQDN	да	String		✔	✔
fqdnRules.rules[].logs	нет	Boolean	false	✔	✔
fqdnRules.rules[].ports	нет	Object[]	null	✔	✔
fqdnRules.rules[].ports[].d	нет	String	null	✔	✔
fqdnRules.rules[].ports[].s	нет	String	null	✔	✔
fqdnRules.rules[].sgFrom	да	String		✔	✔
fqdnRules.rules[].transport	да	Enum("TCP", "UDP")		✔	✔
fqdnRules.rules[].action	да	Enum("UNDEF", "ACCEPT", "DROP")		✔	✔
fqdnRules.rules[].priority	нет	Object		✔	✔
fqdnRules.rules[].priority.some	нет	Integer		✔	✔
syncOp	да	Enum("Delete", "Upsert", "FullSync")		✔	✔

Ограничения

• fqdnRules.rules[].FQDN:

  • Длина значения поля не должна превышать 256 символов.
  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • FQDN должен соответствовать формату записи, определенному в RFC 1034, 1035, 1123.

• fqdnRules.rules[].sgFrom:

  • Длина значения поля не должна превышать 256 символов.
  • Значение поля должно начинаться и заканчиваться символами без пробелов.
  • Значение должно быть уникальным в рамках типа ресурса.

• fqdnRules.rules[].protocols[]:

  • Не допускаются дубликация протоколов в списке.
  • Значения должны соответствовать поддерживаемым протоколам.

• fqdnRules.rules[].ports[].ports_to[]:

  • Значения портов должно находиться в интервале от 1 до 65535.
  • Если значение не будет указано то будет использоваться весь диапазон портов.
  • Значения портов прописываются по одному или интервально используя '-'.
  • Не допускаются пересечения портов в правилах в рамках одной пары Security Group.</li>

• fqdnRules.rules[].ports[].ports_from[]:

  • Значения портов должно находиться в интервале от 1 до 65535.
  • Если значение не будет указано то будет использоваться весь диапазон портов.
  • Значения портов прописываются по одному или интервально используя '-'.

Пример использования

TCP

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
    "fqdnRules": {
      "rules": [{
        "FQDN": "example.com",
        "logs": true,
        "ports": [{
          "d": "443,80",
          "s": "64231"
        }],
        "sgFrom": "sg-local-example",
        "transport": "TCP",
        "action": "ACCEPT",
        "priority": {
          "some": 100
        }
      }]
    },
    "syncOp": "Upsert"
}'

UDP

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
    "fqdnRules": {
      "rules": [{
        "FQDN": "example.com",
        "logs": true,
        "ports": [{
          "d": "443,80",
          "s": "64231"
        }],
        "sgFrom": "sg-local-example",
        "transport": "UDP",
        "action": "ACCEPT",
        "priority": {
          "some": 100
        }
      }]
    },
    "syncOp": "Upsert"
}'

Выходные параметры

название	тип данных	описание
-	Object	в случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов

• HTTP code: 400
• gRPC code: INVALID_ARGUMENT
• gRPC number: 3

Не найден метод

• HTTP code: 404
• gRPC code: NOT_FOUND
• gRPC number: 5

Диаграмма последовательности