Spec-Zone.ru › Ansible

модуль fortinet.fortios.fortios_firewall_sniffer — настройка сниффера в Fortinet FortiOS и FortiGate.

Примечание

Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля необходимы дополнительные компоненты. Подробную информацию см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_firewall_sniffer.

Добавлено в fortinet.fortios 2.0.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя параметры межсетевого экрана и категорию сниффера. Перед использованием необходимо скорректировать все примеры параметров и значений в соответствии с источниками данных. Проверено на FOS v6.0.0

Требования

На узле, выполняющем этот модуль, должны быть соблюдены следующие требования.

  • ansible>=2.16

Параметры

Параметр

Комментарии

access_token

string

Аутентификация на основе токена. Создается в графическом интерфейсе Fortigate.

enable_log

boolean

Включить/отключить ведение журнала для задачи.

Варианты:

  • false ← (по умолчанию)
  • true

firewall_sniffer

dictionary

Настройка анализатора трафика.

anomaly

list / elements=dictionary

Способ настройки параметров обнаружения аномалий типа «отказ в обслуживании» (DoS).

action

string

Действие, выполняемое при достижении порогового значения.

Варианты:

  • "pass"
  • "block"
  • "proxy"

log

string

Включить/отключить регистрацию аномалий в журнале.

Варианты:

  • "enable"
  • "disable"

name

string / обязательный

Имя аномалии.

quarantine

string

Метод помещения в карантин.

Варианты:

  • "none"
  • "attacker"

quarantine_expiry

string

Продолжительность карантина. (Формат

quarantine_log

string

Включить/отключить регистрацию событий помещения в карантин в журнале.

Варианты:

  • "disable"
  • "enable"

status

string

Включить/отключить эту аномалию.

Варианты:

  • "disable"
  • "enable"

synproxy_tcp_mss

string

Определяет значение максимального размера сегмента TCP (MSS) для пакетов, отправляемых модулем syn proxy.

Варианты:

  • "0"
  • "256"
  • "512"
  • "1024"
  • "1300"
  • "1360"
  • "1460"
  • "1500"

synproxy_tcp_sack

string

Включить/отключить выборочное подтверждение TCP (SACK) для пакетов, отправляемых модулем syn proxy.

Варианты:

  • "enable"
  • "disable"

synproxy_tcp_timestamp

string

Включить/отключить параметр временной метки TCP для пакетов, отправляемых модулем syn proxy.

Варианты:

  • "enable"
  • "disable"

synproxy_tcp_window

string

Определяет размер окна TCP для пакетов, отправляемых модулем syn proxy.

Варианты:

  • "4096"
  • "8192"
  • "16384"
  • "32768"

synproxy_tcp_windowscale

string

Определяет значение параметра масштабирования окна TCP для пакетов, отправляемых модулем syn proxy.

Варианты:

  • "0"
  • "1"
  • "2"
  • "3"
  • "4"
  • "5"
  • "6"
  • "7"
  • "8"
  • "9"
  • "10"
  • "11"
  • "12"
  • "13"
  • "14"

synproxy_tos

string

Определяет значение кода дифференцированного обслуживания TCP (тип обслуживания).

Варианты:

  • "0"
  • "10"
  • "12"
  • "14"
  • "18"
  • "20"
  • "22"
  • "26"
  • "28"
  • "30"
  • "34"
  • "36"
  • "38"
  • "40"
  • "46"
  • "255"

synproxy_ttl

string

Определяет значение времени жизни (TTL) для пакетов, отправляемых модулем syn proxy.

Варианты:

  • "32"
  • "64"
  • "128"
  • "255"

threshold

integer

Пороговое значение аномалии. Количество обнаруженных экземпляров (пакетов в секунду или одновременных сеансов), при котором запускается действие для аномалии.

threshold_default

integer

Количество обнаруженных экземпляров в минуту, при котором запускается действие (1–2147483647). Обратите внимание, что для каждой аномалии задано свое пороговое значение.

application_list

string

Имя существующего списка приложений. Источник: application.list.name.

application_list_status

string

Включить/отключить профиль контроля приложений.

Варианты:

  • "enable"
  • "disable"

av_profile

string

Имя существующего антивирусного профиля. Источник: antivirus.profile.name.

av_profile_status

string

Включить/отключить антивирусный профиль.

Варианты:

  • "enable"
  • "disable"

casb_profile

string

Имя существующего профиля CASB. Источник: casb.profile.name.

casb_profile_status

string

Включить/отключить профиль CASB.

Варианты:

  • "enable"
  • "disable"

dlp_profile

string

Имя существующего профиля DLP. Источник: dlp.profile.name.

dlp_profile_status

string

Включить/отключить профиль DLP.

Варианты:

  • "enable"
  • "disable"

dlp_sensor

string

Имя существующего датчика DLP. Источник: dlp.sensor.name.

dlp_sensor_status

string

Включить/отключить датчик DLP.

Варианты:

  • "enable"
  • "disable"

dsri

string

Включить/отключить DSRI.

Варианты:

  • "enable"
  • "disable"

emailfilter_profile

string

Имя существующего профиля фильтрации электронной почты. Источник: emailfilter.profile.name.

emailfilter_profile_status

string

Включить/отключить фильтрацию электронной почты.

Варианты:

  • "enable"
  • "disable"

file_filter_profile

string

Имя существующего профиля фильтрации файлов. Источник: file-filter.profile.name.

file_filter_profile_status

string

Включить/отключить фильтрацию файлов.

Варианты:

  • "enable"
  • "disable"

host

string

Узлы для фильтрации трафика анализатора (примеры формата: 1.1.1.1, 2.2.2.0/24, 3.3.3.3/255.255.255.0, 4.4.4.0-4.4.4.240).

id

integer / обязательный

Идентификатор анализатора трафика (0–9999). См. <a href=’#notes’>Примечания</a>.

interface

string

Имя интерфейса, на котором будет выполняться анализ трафика. Источник: system.interface.name.

ip_threatfeed

list / elements=dictionary

Имя существующего источника данных об IP-угрозах.

name

string / обязательный

Имя источника данных об угрозах. Источник: system.external-resource.name.

ip_threatfeed_status

string

Включить/отключить источник данных об IP-угрозах.

Варианты:

  • "enable"
  • "disable"

ips_dos_status

string

Включить/отключить обнаружение аномалий DoS средствами IPS.

Варианты:

  • "enable"
  • "disable"

ips_sensor

string

Имя существующего датчика IPS. Источник: ips.sensor.name.

ips_sensor_status

string

Включить/отключить датчик IPS.

Варианты:

  • "enable"
  • "disable"

ipv6

string

Включить/отключить анализ пакетов IPv6.

Варианты:

  • "enable"
  • "disable"

logtraffic

string

Записывать в журнал все сеансы, только сеансы с примененным профилем безопасности либо отключить ведение журнала для этой политики.

Варианты:

  • "all"
  • "utm"
  • "disable"

max_packet_count

integer

Максимальное количество пакетов (1–1000000).

non_ip

string

Включить/отключить анализ пакетов, не относящихся к IP.

Варианты:

  • "enable"
  • "disable"

port

string

Порты для анализа (примеры формата: 10, :20, 30:40, 50-, 100-200).

protocol

string

Целочисленное значение типа протокола согласно определению IANA (0–255).

scan_botnet_connections

string

Включить/отключить сканирование подключений к серверам ботнетов.

Варианты:

  • "disable"
  • "block"
  • "monitor"

spamfilter_profile

string

Имя существующего профиля фильтрации спама. Источник: spamfilter.profile.name.

spamfilter_profile_status

string

Включить/отключить фильтрацию спама.

Варианты:

  • "enable"
  • "disable"

status

string

Включение или отключение анализатора трафика.

Варианты:

  • "enable"
  • "disable"

uuid

string

Универсальный уникальный идентификатор (UUID; назначается автоматически, но может быть сброшен вручную).

vlan

string

Список VLAN для анализа.

webfilter_profile

string

Имя существующего профиля веб-фильтрации. Источник: webfilter.profile.name.

webfilter_profile_status

string

Включение или отключение профиля веб-фильтрации.

Варианты:

  • "enable"
  • "disable"

member_path

string

Путь к атрибуту элемента, над которым выполняется операция.

Если атрибутов несколько, они разделяются символом косой черты.

Параметр member_path можно использовать для выполнения операции над элементом.

member_state

string

Добавить или удалить элемент по указанному пути к атрибуту.

Если указан member_state, параметр state игнорируется.

Варианты:

  • "present"
  • "absent"

state

string / обязательный

Указывает, нужно ли создать или удалить объект.

Варианты:

  • "present"
  • "absent"

vdom

string

Виртуальный домен из числа ранее определённых. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство.

По умолчанию: "root"

Примечания

Примечание

  • Настоятельно рекомендуем использовать собственное значение для id вместо 0. Значение «0» — специальный заполнитель, позволяющий серверной части назначить объекту последний доступный номер, однако у него есть ограничения. Подробнее см. в разделе «Вопросы и ответы».
  • Устаревшая библиотека fortiosapi объявлена нерекомендуемой; для запуска плейбуков предпочтительно использовать httpapi.
  • Модуль поддерживает check_mode.

Примеры

- name: Configure sniffer.
  fortinet.fortios.fortios_firewall_sniffer:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      firewall_sniffer:
          anomaly:
              -
                  action: "pass"
                  log: "enable"
                  name: "default_name_6"
                  quarantine: "none"
                  quarantine_expiry: "<your_own_value>"
                  quarantine_log: "disable"
                  status: "disable"
                  synproxy_tcp_mss: "0"
                  synproxy_tcp_sack: "enable"
                  synproxy_tcp_timestamp: "enable"
                  synproxy_tcp_window: "4096"
                  synproxy_tcp_windowscale: "0"
                  synproxy_tos: "0"
                  synproxy_ttl: "32"
                  threshold: "0"
                  threshold_default: "0"
          application_list: "<your_own_value> (source application.list.name)"
          application_list_status: "enable"
          av_profile: "<your_own_value> (source antivirus.profile.name)"
          av_profile_status: "enable"
          casb_profile: "<your_own_value> (source casb.profile.name)"
          casb_profile_status: "enable"
          dlp_profile: "<your_own_value> (source dlp.profile.name)"
          dlp_profile_status: "enable"
          dlp_sensor: "<your_own_value> (source dlp.sensor.name)"
          dlp_sensor_status: "enable"
          dsri: "enable"
          emailfilter_profile: "<your_own_value> (source emailfilter.profile.name)"
          emailfilter_profile_status: "enable"
          file_filter_profile: "<your_own_value> (source file-filter.profile.name)"
          file_filter_profile_status: "enable"
          host: "myhostname"
          id: "36"
          interface: "<your_own_value> (source system.interface.name)"
          ip_threatfeed:
              -
                  name: "default_name_39 (source system.external-resource.name)"
          ip_threatfeed_status: "enable"
          ips_dos_status: "enable"
          ips_sensor: "<your_own_value> (source ips.sensor.name)"
          ips_sensor_status: "enable"
          ipv6: "enable"
          logtraffic: "all"
          max_packet_count: "4000"
          non_ip: "enable"
          port: "<your_own_value>"
          protocol: "<your_own_value>"
          scan_botnet_connections: "disable"
          spamfilter_profile: "<your_own_value> (source spamfilter.profile.name)"
          spamfilter_profile_status: "enable"
          status: "enable"
          uuid: "<your_own_value>"
          vlan: "<your_own_value>"
          webfilter_profile: "<your_own_value> (source webfilter.profile.name)"
          webfilter_profile_status: "enable"

Возвращаемые значения

Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

build

string

Номер сборки образа FortiGate

Возвращается: всегда

Пример: "1547"

http_method

string

Последний метод, использованный для передачи содержимого на FortiGate

Возвращается: всегда

Пример: "PUT"

http_status

string

Последний результат, полученный от FortiGate при выполнении последней операции

Возвращается: всегда

Пример: "200"

mkey

string

Главный ключ (id), использованный при последнем вызове FortiGate

Возвращается: при успехе

Пример: "id"

name

string

Имя таблицы, использованной для выполнения запроса

Возвращается: всегда

Пример: "urlfilter"

path

string

Путь к таблице, использованной для выполнения запроса

Возвращается: всегда

Пример: "webfilter"

revision

string

Внутренний номер ревизии

Возвращается: всегда

Пример: "17.0.2.10658"

serial

string

Серийный номер устройства

Возвращается: всегда

Пример: "FGVMEVYYQT3AB5352"

status

string

Результат операции

Возвращается: всегда

Пример: "success"

vdom

string

Использованный виртуальный домен

Возвращается: всегда

Пример: "root"

version

string

Версия FortiGate

Возвращается: всегда

Пример: "v5.6.3"

Авторы

  • Link Zheng (@chillancezen)
  • Jie Xue (@JieX19)
  • Hongbin Lu (@fgtdev-hblu)
  • Frank Shen (@frankshen01)
  • Miguel Angel Munoz (@mamunozgonzalez)
  • Nicolas Thomas (@thomnico)

Ссылки на коллекцию

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortios/fortios_firewall_sniffer_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API