Spec-Zone.ru › Ansible

Модуль fortinet.fortios.fortios_system_np6 — настройка атрибутов NP6 в Fortinet FortiOS и FortiGate.

Примечание

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

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

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

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

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

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

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

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

Требования

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

  • ansible>=2.16

Параметры

Параметр

Комментарии

access_token

string

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

enable_log

boolean

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

Варианты:

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

member_path

string

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

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

Параметр с пометкой member_path подходит для выполнения операции над элементом.

member_state

string

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

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

Варианты:

  • "present"
  • "absent"

state

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

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

Варианты:

  • "present"
  • "absent"

system_np6

dictionary

Настройка атрибутов NP6.

fastpath

string

Включить/отключить разгрузку обработки на NP6 (также называется быстрым путем).

Варианты:

  • "disable"
  • "enable"

fp_anomaly

dictionary

Защита NP6 от аномалий IPv4. Параметр trap-to-host перенаправляет сеансы с аномалиями на ЦП.

icmp_csum_err

string

Аномалии, связанные с недопустимой контрольной суммой IPv4 ICMP.

Варианты:

  • "drop"
  • "trap-to-host"

icmp_frag

string

Фрагментированные пакеты уровня 3, которые могут быть частью аномалий ICMP уровня 4.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

icmp_land

string

Аномалии типа Land для ICMP.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv4_csum_err

string

Аномалии, связанные с недопустимой контрольной суммой IP IPv4.

Варианты:

  • "drop"
  • "trap-to-host"

ipv4_land

string

Аномалии типа Land.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv4_optlsrr

string

Аномалии параметра свободной маршрутизации с записью источника.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv4_optrr

string

Аномалии параметра маршрутизации с записью маршрута.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv4_optsecurity

string

Аномалии параметра безопасности.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv4_optssrr

string

Аномалии параметра строгой маршрутизации с записью источника.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv4_optstream

string

Аномалии параметра потока.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv4_opttimestamp

string

Аномалии параметра временной метки.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv4_proto_err

string

Аномалии, связанные с недопустимым протоколом уровня 4.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv4_unknopt

string

Аномалии неизвестного параметра.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_daddr_err

string

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

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_land

string

Аномалии типа Land.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_optendpid

string

Аномалии идентификации конечной точки.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_opthomeaddr

string

Аномалии параметра домашнего адреса.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_optinvld

string

Аномалии недопустимого параметра. Аномалии недопустимого параметра.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_optjumbo

string

Аномалии параметров Jumbo.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_optnsap

string

Аномалии параметра адреса точки доступа к сетевой службе (NSAP).

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_optralert

string

Аномалии параметра оповещения маршрутизатора.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_opttunnel

string

Аномалии параметра ограничения инкапсуляции туннеля.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_proto_err

string

Аномалии недопустимого протокола уровня 4.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_saddr_err

string

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

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

ipv6_unknopt

string

Аномалии неизвестного параметра.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

tcp_csum_err

string

Аномалии, связанные с недопустимой контрольной суммой IPv4 TCP.

Варианты:

  • "drop"
  • "trap-to-host"

tcp_fin_noack

string

Аномалии SYN-флуда TCP с установленным флагом FIN без флага ACK.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

tcp_fin_only

string

Аномалии SYN-флуда TCP с установленным только флагом FIN.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

tcp_land

string

Аномалии типа Land для TCP.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

tcp_no_flag

string

Аномалии SYN-флуда TCP без установленных флагов.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

tcp_syn_data

string

Аномалии пакетов SYN-флуда TCP, содержащих данные.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

tcp_syn_fin

string

Аномалии SYN-флуда TCP с установленными флагами SYN/FIN.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

tcp_winnuke

string

Аномалии WinNuke для TCP.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

udp_csum_err

string

Аномалии, связанные с недопустимой контрольной суммой IPv4 UDP.

Варианты:

  • "drop"
  • "trap-to-host"

udp_land

string

Аномалии типа Land для UDP.

Варианты:

  • "allow"
  • "drop"
  • "trap-to-host"

garbage_session_collector

string

Включить/отключить сборщик неактивных сеансов.

Варианты:

  • "disable"
  • "enable"

hpe

dictionary

Конфигурация HPE.

arp_max

integer

Максимальная скорость передачи пакетов ARP (от 1 тыс. до 1 млрд пакетов/с).

enable_shaper

string

Включить/отключить механизм защиты хоста NPU (HPE) для формирования трафика по типу пакетов.

Варианты:

  • "disable"
  • "enable"

esp_max

integer

Максимальная скорость передачи пакетов ESP (от 1 тыс. до 1 млрд пакетов/с).

icmp_max

integer

Максимальная скорость передачи пакетов ICMP (от 1 тыс. до 1 млрд пакетов/с).

ip_frag_max

integer

Максимальная скорость передачи фрагментированных IP-пакетов (от 1 тыс. до 1 млрд пакетов/с).

ip_others_max

integer

Максимальная скорость передачи IP-пакетов других типов (типов, для которых нельзя задать отдельные параметры) (от 1 тыс. до 1 млрд пакетов/с).

l2_others_max

integer

Максимальная скорость передачи пакетов уровня 2, не являющихся пакетами ARP (от 1 тыс. до 1 млрд пакетов/с).

pri_type_max

integer

Максимальная скорость превышения для трафика с приоритетным типом (от 1K до 1G пакетов в секунду). Включает L2: HA, 802.3ad LACP, сигналы активности. L3: OSPF. L4_TCP: BGP. L4_UDP: IKE, SLBC, BFD.

sctp_max

integer

Максимальная скорость передачи пакетов SCTP (от 1K до 1G пакетов в секунду).

tcp_max

integer

Максимальная скорость передачи пакетов TCP (от 1K до 1G пакетов в секунду).

tcpfin_rst_max

integer

Максимальная скорость передачи пакетов TCP с флагом FIN или RST (от 1K до 1G пакетов в секунду).

tcpsyn_ack_max

integer

Максимальная скорость передачи пакетов TCP с флагами SYN и ACK (от 1K до 1G пакетов в секунду).

tcpsyn_max

integer

Максимальная скорость передачи пакетов TCP SYN (от 1K до 1G пакетов в секунду).

udp_max

integer

Максимальная скорость передачи пакетов UDP (от 1K до 1G пакетов в секунду).

ipsec_ob_hash_function

string

Задать хеш-функцию для исходящего трафика IPSec.

Варианты:

  • "global-hash"
  • "round-robin-global"

ipsec_outbound_hash

string

Включить или отключить хеш-функцию для исходящего трафика IPsec.

Варианты:

  • "disable"
  • "enable"

low_latency_mode

string

Включить или отключить режим низкой задержки.

Варианты:

  • "disable"
  • "enable"

name

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

Имя устройства.

per_session_accounting

string

Включить или отключить учет для каждого сеанса.

Варианты:

  • "disable"
  • "traffic-log-only"
  • "enable"

session_collector_interval

integer

Задать интервал очистки для сборщика неактивных сеансов (от 1 до 100 с).

session_timeout_fixed

string

{disable | enable} Переключение между фиксированными и случайными тайм-аутами обновления сеансов NP6.

Варианты:

  • "disable"
  • "enable"

session_timeout_interval

integer

Задать фиксированный тайм-аут обновления сеансов NP6 (от 0 до 1000 с).

session_timeout_random_range

integer

Задать диапазон случайного тайм-аута обновления сеансов NP6 (от 0 до 1000 с).

vdom

string

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

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

Примечания

Примечание

  • Устаревший fortiosapi объявлен устаревшим; для запуска плейбуков рекомендуется использовать httpapi
  • Модуль поддерживает check_mode.

Примеры

- name: Configure NP6 attributes.
  fortinet.fortios.fortios_system_np6:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      system_np6:
          fastpath: "disable"
          fp_anomaly:
              icmp_csum_err: "drop"
              icmp_frag: "allow"
              icmp_land: "allow"
              ipv4_csum_err: "drop"
              ipv4_land: "allow"
              ipv4_optlsrr: "allow"
              ipv4_optrr: "allow"
              ipv4_optsecurity: "allow"
              ipv4_optssrr: "allow"
              ipv4_optstream: "allow"
              ipv4_opttimestamp: "allow"
              ipv4_proto_err: "allow"
              ipv4_unknopt: "allow"
              ipv6_daddr_err: "allow"
              ipv6_land: "allow"
              ipv6_optendpid: "allow"
              ipv6_opthomeaddr: "allow"
              ipv6_optinvld: "allow"
              ipv6_optjumbo: "allow"
              ipv6_optnsap: "allow"
              ipv6_optralert: "allow"
              ipv6_opttunnel: "allow"
              ipv6_proto_err: "allow"
              ipv6_saddr_err: "allow"
              ipv6_unknopt: "allow"
              tcp_csum_err: "drop"
              tcp_fin_noack: "allow"
              tcp_fin_only: "allow"
              tcp_land: "allow"
              tcp_no_flag: "allow"
              tcp_syn_data: "allow"
              tcp_syn_fin: "allow"
              tcp_winnuke: "allow"
              udp_csum_err: "drop"
              udp_land: "allow"
          garbage_session_collector: "disable"
          hpe:
              arp_max: "200000"
              enable_shaper: "disable"
              esp_max: "200000"
              icmp_max: "200000"
              ip_frag_max: "200000"
              ip_others_max: "200000"
              l2_others_max: "200000"
              pri_type_max: "200000"
              sctp_max: "200000"
              tcp_max: "600000"
              tcpfin_rst_max: "600000"
              tcpsyn_ack_max: "600000"
              tcpsyn_max: "600000"
              udp_max: "600000"
          ipsec_ob_hash_function: "global-hash"
          ipsec_outbound_hash: "disable"
          low_latency_mode: "disable"
          name: "default_name_59"
          per_session_accounting: "disable"
          session_collector_interval: "64"
          session_timeout_fixed: "disable"
          session_timeout_interval: "40"
          session_timeout_random_range: "8"

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

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

Ключ

Описание

build

string

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

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

Пример: "1547"

http_method

string

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

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

Пример: "PUT"

http_status

string

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

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

Пример: "200"

mkey

string

Главный ключ (идентификатор), использованный при последнем обращении к 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_system_np6_module.html

Spec-Zone.ru

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