fortios_ipv4_policy - Управление объектами политики IPv4 на устройствах брандмауэра Fortinet FortiOS
Новая версия с 2.3.
Обзор
- Этот модуль обеспечивает управление политиками IPv4 брандмауэра на устройствах FortiOS.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| application_list | Указывает имя приложения управления. | |
| av_profile | Указывает имя профиля антивируса. | |
| backup |
| Этот аргумент заставит модуль создать резервную копию текущего running-config с удаленного устройства перед внесением каких-либо изменений. Файл резервной копии записывается в папку i(backup). |
| backup_filename | Указывает имя файла резервной копии. Если имя не указано, оно будет отформатировано как HOST_config.ГГГГ-ММ-ДД@ЧЧ:ММ:СС | |
| backup_path | Указывает место хранения резервных копий. Требуется, если backup=да. | |
| comment | Свободный текст для описания политики. | |
| config_file (добавлен в 2.4) | Путь к файлу конфигурации. Требуется, когда file_mode имеет значение True. | |
| dst_addr | Указывает имя(а) объекта адреса назначения (или группы). Требуется, когда state=present. | |
| dst_addr_negate |
нет | Инвертировать параметр адреса назначения. |
| dst_intf | Значение по умолчанию: любой | Указывает имя(а) интерфейса назначения. |
| file_mode (добавлен в 2.4) |
| Не подключаться к устройству, использовать только config_file в качестве входных и выходных данных. |
| fixedport |
нет | Использовать фиксированный порт для nat. |
| host | Указывает имя хоста DNS или IP-адрес для подключения к удаленному устройству fortios. Требуется, когда file_mode имеет значение False. | |
| id обязательно | Идентификатор политики. Предупреждение: номер идентификатора политики отличается от номера последовательности политики. Идентификатор политики — это номер, присвоенный при создании политики. Номер последовательности представляет собой порядок, в котором Fortigate оценивает правило для принудительного применения политики, а также порядок, в котором правила перечислены в интерфейсе и командной строке. Эти два числа не обязательно коррелируют: этот модуль основан на идентификаторе политики. ПОДСКАЗКА: идентификатор политики можно просмотреть в интерфейсе, добавив «ID» в столбцы отображения. | |
| ips_sensor | Указывает имя профиля датчика IPS. | |
| logtraffic (добавлен в 2.4) |
| Регистрирует сессии, соответствующие политике. |
| logtraffic_start (добавлен в 2.4) |
нет | Также регистрирует начало сессии. |
| nat |
нет | Включить или отключить Nat. |
| password | Указывает пароль, используемый для аутентификации на удаленном устройстве. Требуется, когда file_mode имеет значение True. | |
| policy_action |
| Указывает действие политики «принять» или «отклонить». Требуется, когда state=present. Псевдонимы: action |
| poolname | Указывает имя пула NAT. | |
| schedule | Значение по умолчанию: всегда | определяет расписание политики. |
| service | Указывает(и) службу(ы) политики, может быть списком (например: ['MAIL','DNS']). Требуется, когда state=present. Псевдонимы: services | |
| service_negate |
нет | Инвертировать определенные в значении service службы политики. |
| src_addr | Указывает имя(а) объекта адреса источника (или группы). Требуется, когда state=present. | |
| src_addr_negate |
нет | Инвертировать параметр адреса источника. |
| src_intf | Значение по умолчанию: любой | Указывает имя(а) интерфейса источника. |
| state |
| Указывает, нужно ли добавлять или удалять политику id. |
| timeout | Значение по умолчанию: 60 | Время ожидания в секундах для подключения к удаленному устройству. |
| username | Настраивает имя пользователя, используемое для аутентификации на удаленном устройстве. Требуется, когда file_mode имеет значение True. | |
| vdom | Указывает, на какой vdom применить конфигурацию | |
| webfilter_profile | Указывает имя профиля Webfilter. |
Примечания
Примечание
- Для этого модуля требуется библиотека pyFG.
Примеры
- name: Allow external DNS call
fortios_ipv4_policy:
host: 192.168.0.254
username: admin
password: password
id: 42
src_addr: internal_network
dst_addr: all
service: dns
nat: True
state: present
policy_action: accept
logtraffic: disable
- name: Public Web
fortios_ipv4_policy:
host: 192.168.0.254
username: admin
password: password
id: 42
src_addr: all
dst_addr: webservers
services:
- http
- https
state: present
policy_action: accept
- name: Some Policy
fortios_ipv4_policy:
host: 192.168.0.254
username: admin
password: password
id: 42
comment: "no comment (created by ansible)"
src_intf: vl1000
src_addr:
- some_serverA
- some_serverB
dst_intf:
- vl2000
- vl3000
dst_addr: all
services:
- HTTP
- HTTPS
nat: True
state: present
policy_action: accept
logtraffic: disable
tags:
- policy
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| change_string строка | только если конфигурация изменена | Команды, выполненные модулем |
| firewall_address_config строка | всегда | Полная строка конфигурации адресов брандмауэра |
| msg_error_list строка | только при ошибке | Список ошибок, возвращенных командной строкой (используйте -vvv для лучшей читабельности). |
Статус
Этот модуль помечен как предварительная версия, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- Бенжамен Жоливо (@bjolivot)
Подсказка
Если вы заметили какие-либо проблемы в этом документе, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/fortios_ipv4_policy_module.html
