Перейти к основному содержимому

Sgroup to FQDN

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

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

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

  • 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 - Поле определяющее действие с данными из запроса.
названиеобязательностьтип данныхзначение по умолчанию
fqdnRules.rulesдаObject
fqdnRules.rules[].FQDNдаString
fqdnRules.rules[].logsнетBooleanfalse
fqdnRules.rules[].portsнетObject[]null
fqdnRules.rules[].ports[].dнетStringnull
fqdnRules.rules[].ports[].sнетStringnull
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 символов.
    • Значение должно начинаться и заканчиваться символами без пробелов.
    • Возможно указать только существующий Security Group.

  • fqdnRules.rules[].ports:

    • Source порты не должны пересекаться в разных пачках в рамках ресурса
    • Source || destination порт обязателен для заполнения

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

    • Значения портов должно находиться в интервале от 1 до 65535.
    • Если значение не будет указано то будет использоваться весь диапазон портов.
    • Значения портов прописываются по одному или интервально, используя '-'.
    • Не допускаются пересечения портов для ресурса.
    • Интервал прописывается от меньшего к большему (99-110)

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

    • Значения портов должно находиться в интервале от 1 до 65535.
    • Если значение не будет указано то будет использоваться весь диапазон портов.
    • Значения портов прописываются по одному или интервально используя '-'.
    • Интервал прописывается от меньшего к большему (9090-1010)
    • Допускаются пересечения портов destination для ресурса.

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

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
"fqdnRules": {
    "rules": [
        {
            "ports": [
                {
                    "s": "8080",
                    "d": "40000-45000"
                }
            ],
            "sgFrom": "sg-0",
            "FQDN": "google.com",
            "transport": "TCP",
            "logs": true,
            "action": "DROP",
            "priority": {
                "some": 255
            }
        }
    ],
    "syncOp": "Upsert"
}'

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

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

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

Пользователь указал некорректные значения агрументов
  • HTTP code: 400
  • gRPC code: INVALID_ARGUMENT
  • gRPC number: 3
Не найден метод
  • HTTP code: 404
  • gRPC code: NOT_FOUND
  • gRPC number: 5
Ошибка в указанных данных
  • HTTP code: 500
  • gRPC code: INTERNAL
  • gRPC number: 13

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