Модуль fortinet.fortios.fortios_firewall_ttl_policy — настройка политик TTL в 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_ttl_policy.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя параметры функции брандмауэра и категории ttl_policy. Примеры содержат все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием. Проверено на FOS v6.0.0
Требования
На хосте, выполняющем этот модуль, должны быть установлены следующие компоненты.
- ansible>=2.16
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Аутентификация на основе токена. Токен создаётся в графическом интерфейсе FortiGate. |
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
firewall_ttl_policy dictionary | Настройка политик TTL. |
|
action string |
Действие, которое будет выполнено с трафиком, соответствующим этой политике. Варианты:
|
|
id integer / обязательный |
Идентификатор. См. <a href=’#notes’>Примечания</a>. |
|
schedule string |
Объект расписания из доступных вариантов. Источник: firewall.schedule.onetime.name, firewall.schedule.recurring.name, firewall.schedule.group .name. |
|
service list / элементы=dictionary |
Объект или объекты службы из доступных вариантов. Несколько имён разделяются пробелом. |
|
name string / обязательный |
Имя службы. Источник: firewall.service.custom.name, firewall.service.group.name. |
|
srcaddr list / элементы=dictionary |
Объект или объекты исходного адреса из доступных вариантов. Несколько имён разделяются пробелом. |
|
name string / обязательный |
Имя адреса. Источник: firewall.address.name, firewall.addrgrp.name. |
|
srcintf string |
Имя исходного интерфейса из доступных интерфейсов. Источник: system.zone.name, system.sdwan.zone.name, system.interface.name. |
|
status string |
Включить или отключить эту политику TTL. Варианты:
|
|
ttl string |
Значение или диапазон для сопоставления со значением Time to Live пакета (формат: ttl[ - ttl_high], 1 - 255). |
member_path string | Путь к атрибуту элемента, над которым выполняется операция. Если атрибутов несколько, они разделяются символом косой черты. Параметр member_path можно использовать для выполнения операции с элементом. |
member_state string | Добавить или удалить элемент по указанному пути к атрибуту. Если задан member_state, параметр state игнорируется. Варианты:
|
state string / обязательный | Указывает, следует ли создать или удалить объект. Варианты:
|
vdom string | Виртуальный домен из числа предварительно заданных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
Примечания
Примечание
- Настоятельно рекомендуем использовать собственное значение id вместо 0. Значение ‘0’ — специальный заполнитель, позволяющий серверной части назначить объекту последний доступный номер, однако у этого способа есть ограничения. Подробности см. в разделе «Вопросы и ответы».
- Устаревший fortiosapi объявлен нерекомендуемым; для запуска сценариев предпочтительно использовать httpapi.
- Модуль поддерживает check_mode.
Примеры
- name: Configure TTL policies.
fortinet.fortios.fortios_firewall_ttl_policy:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
firewall_ttl_policy:
action: "accept"
id: "4"
schedule: "<your_own_value> (source firewall.schedule.onetime.name firewall.schedule.recurring.name firewall.schedule.group.name)"
service:
-
name: "default_name_7 (source firewall.service.custom.name firewall.service.group.name)"
srcaddr:
-
name: "default_name_9 (source firewall.address.name firewall.addrgrp.name)"
srcintf: "<your_own_value> (source system.zone.name system.sdwan.zone.name system.interface.name)"
status: "enable"
ttl: "<your_own_value>"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
build string | Номер сборки образа FortiGate Возвращается: всегда Пример: |
http_method string | Последний метод, использованный для передачи содержимого в FortiGate Возвращается: всегда Пример: |
http_status string | Последний результат, возвращённый FortiGate при выполнении последней операции Возвращается: всегда Пример: |
mkey string | Мастер-ключ (id), использованный при последнем вызове FortiGate Возвращается: при успехе Пример: |
name string | Имя таблицы, использованной для выполнения запроса Возвращается: всегда Пример: |
path string | Путь к таблице, использованной для выполнения запроса Возвращается: всегда Пример: |
revision string | Внутренний номер ревизии Возвращается: всегда Пример: |
serial string | Серийный номер устройства Возвращается: всегда Пример: |
status string | Результат операции Возвращается: всегда Пример: |
vdom string | Использованный виртуальный домен Возвращается: всегда Пример: |
version string | Версия FortiGate Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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_ttl_policy_module.html
