Spec-Zone.ru › Ansible

модуль fortinet.fortimanager.fmgr_pkg_firewall_dospolicy6 – Настройка политик защиты от DoS-атак IPv6.

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortimanager.

Чтобы использовать её в плейбуке, укажите: fortinet.fortimanager.fmgr_pkg_firewall_dospolicy6.

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

  • Обзор
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Этот модуль предназначен для настройки устройства FortiManager.
  • Примеры содержат все параметры и значения, которые необходимо скорректировать с учётом источников данных перед использованием.

Параметры

Параметр

Комментарии

access_token

строка

Токен для доступа к FortiManager без использования имени пользователя и пароля.

adom

строка / обязательный

Параметр (adom) в запрошенном URL.

bypass_validation

логический

Устанавливайте значение True только в том случае, если схема модуля отличается от структуры API FortiManager; модуль продолжит выполнение без проверки параметров.

Варианты:

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

enable_log

логический

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

Варианты:

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

forticloud_access_token

строка

Аутентификация клиента Ansible с помощью токена доступа к API forticloud.

pkg

строка / обязательный

Параметр (pkg) в запрошенном URL.

pkg_firewall_dospolicy6

словарь

Набор параметров верхнего уровня.

anomaly

список / элементы=словарь

Аномалия.

action

строка

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

Варианты:

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

log

строка

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

Варианты:

  • "disable"
  • "enable"

name

строка

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

quarantine

строка

Способ помещения в карантин.

Варианты:

  • "none"
  • "attacker"
  • "both"
  • "interface"

quarantine_expiry

псевдонимы: quarantine-expiry

строка

Длительность карантина: от 1 минуты до 364 дней, 23 часов и 59 минут с текущего момента.

quarantine_log

псевдонимы: quarantine-log

строка

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

Варианты:

  • "disable"
  • "enable"

status

строка

Включить/отключить активное состояние этого датчика аномалий.

Варианты:

  • "disable"
  • "enable"

synproxy-tcp-mss

строка

Устаревший параметр; переименуйте его в synproxy_tcp_mss. Определяет максимальный размер сегмента TCP

Варианты:

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

synproxy-tcp-sack

строка

Устаревший параметр; переименуйте его в synproxy_tcp_sack. Включает/отключает выборочные подтверждения TCP

Варианты:

  • "disable"
  • "enable"

synproxy-tcp-timestamp

строка

Устаревший параметр; переименуйте его в synproxy_tcp_timestamp. Включает/отключает параметр временной метки TCP для пакетов, на которые отвечает…

Варианты:

  • "disable"
  • "enable"

synproxy-tcp-window

строка

Устаревший параметр; переименуйте его в synproxy_tcp_window. Определяет размер окна TCP для пакетов, на которые отвечает модуль syn proxy…

Варианты:

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

synproxy-tcp-windowscale

строка

Устаревший параметр; переименуйте его в synproxy_tcp_windowscale. Определяет значение параметра масштабирования окна TCP для пакетов, на которые отвечает…

Варианты:

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

synproxy-tos

строка

Устаревший параметр; переименуйте его в synproxy_tos. Определяет значение кода дифференцированного обслуживания TCP

Варианты:

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

synproxy-ttl

строка

Устаревший параметр; переименуйте его в synproxy_ttl. Определяет время жизни

Варианты:

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

synproxy_tcp_mss

строка

Определяет максимальный размер сегмента TCP

Варианты:

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

synproxy_tcp_sack

строка

Включает/отключает выборочные подтверждения TCP

Варианты:

  • "disable"
  • "enable"

synproxy_tcp_timestamp

строка

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

Варианты:

  • "disable"
  • "enable"

synproxy_tcp_window

строка

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

Варианты:

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

synproxy_tcp_windowscale

строка

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

Варианты:

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

synproxy_tos

строка

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

Варианты:

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

synproxy_ttl

строка

Определяет время жизни

Варианты:

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

threshold

целое число

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

threshold_default

псевдонимы: threshold(default)

целое число

Пороговое значение

comments

строка

Комментарий.

dstaddr

любой тип

(список или строка) Имя адреса назначения из доступных адресов.

interface

строка

Имя входящего интерфейса из доступных интерфейсов.

name

строка

Имя политики.

policyid

целое число / обязательный

Идентификатор политики.

service

любой тип

(список или строка) Объект службы из доступных вариантов.

srcaddr

любой тип

(список или строка) Имя исходного адреса из доступных адресов.

status

строка

Включить/отключить эту политику.

Варианты:

  • "disable"
  • "enable"

uuid

строка

Универсальный уникальный идентификатор

proposed_method

строка

Метод, переопределяющий метод для базового запроса Json RPC.

Варианты:

  • "update"
  • "set"
  • "add"

rc_failed

список / элементы=целое число

Список кодов rc, переопределяющий условия сбоя.

rc_succeeded

список / элементы=целое число

Список кодов rc, переопределяющий условия успешного выполнения.

revision_note

строка

Примечание об изменении, которое можно указать при создании или обновлении объекта.

state

строка / обязательный

Директива для создания, обновления или удаления объекта.

Варианты:

  • "present"
  • "absent"

workspace_locking_adom

строка

ADOM, который необходимо заблокировать для FortiManager, работающего в режиме workspace. Значением может быть global или другое значение, включая root.

workspace_locking_timeout

целое число

Максимальное время в секундах ожидания освобождения блокировки workspace другим пользователем.

По умолчанию: 300

Примечания

Примечание

  • Начиная с версии 2.4.0, имена всех входных аргументов соответствуют соглашению об именовании с подчёркиваниями (snake_case). Измените аргументы, например “var-name”, на “var_name”. Старые имена аргументов по-прежнему доступны, но будут выдаваться предупреждения об устаревании. Чтобы игнорировать это предупреждение, установите deprecation_warnings=False в ansible.cfg.
  • Этот модуль FortiManager поддерживает работу в режиме блокировки workspace; для этого используются параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout.
  • Обычно выполнение модуля завершается ошибкой, если возвращается ненулевой код rc. Также можно переопределить условия сбоя или успешного выполнения с помощью параметров rc_failed и rc_succeeded.
  • Чтобы создать или обновить объект, используйте директиву state present.
  • Чтобы удалить объект, используйте директиву state absent.

Примеры

- name: Example playbook
  hosts: fortimanagers
  gather_facts: false
  connection: httpapi
  vars:
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_httpapi_port: 443
  tasks:
    - name: Configure IPv6 DoS policies.
      fortinet.fortimanager.fmgr_pkg_firewall_dospolicy6:
        bypass_validation: false
        adom: ansible
        pkg: ansible # package name
        state: present
        pkg_firewall_dospolicy6:
          comments: "ansible-comment"
          interface: "sslvpn_tun_intf"
          policyid: 1
          status: enable

- name: Gathering fortimanager facts
  hosts: fortimanagers
  gather_facts: false
  connection: httpapi
  vars:
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_httpapi_port: 443
  tasks:
    - name: Retrieve all the IPv6 DoS policies
      fortinet.fortimanager.fmgr_fact:
        facts:
          selector: "pkg_firewall_dospolicy6"
          params:
            adom: "ansible"
            pkg: "ansible" # package name
            DoS_policy6: "your_value"

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

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

Ключ

Описание

meta

словарь

Результат запроса.

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

request_url

строка

Полный URL запроса.

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

Пример: "/sys/login/user"

response_code

целое число

Статус запроса API.

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

Пример: 0

response_data

список / элементы=строка

Ответ API.

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

response_message

строка

Текстовое описание ответа API.

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

Пример: "OK."

system_information

словарь

Информация о целевой системе.

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

rc

целое число

Статус запроса.

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

Пример: 0

version_check_warning

список / элементы=строка

Предупреждение о том, что используемые в сценарии параметры не поддерживаются текущей версией FortiManager.

Возвращается: при сложном результате

Авторы

  • Xinwei Du (@dux-fortinet)
  • Xing Li (@lix-fortinet)
  • Jie Xue (@JieX19)
  • Link Zheng (@chillancezen)
  • Frank Shen (@fshen01)
  • Hongbin Lu (@fgtdev-hblu)

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

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

© 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/fortimanager/fmgr_pkg_firewall_dospolicy6_module.html

Spec-Zone.ru

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