fortios_firewall_ippool – Настройка IP-пулов IPv4 в FortiOS и FortiGate Fortinet
Новое в версии 2.8.
Описание
- Этот модуль позволяет настроить FortiGate или FortiOS, предоставляя пользователю возможность настраивать функции брандмауэра и категорию ippool. Примеры включают все опции и должны быть адаптированы к источникам данных перед использованием. Тестировалось с FOS v6.0.2
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- fortiosapi>=0.9.8
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| firewall_ippool - | По умолчанию: null | Настройка IP-пулов IPv4. | |
| arp-intf - | Выбор интерфейса из доступных вариантов, который будет отвечать на запросы ARP. (Если пусто, выбирается любой). Имя интерфейса системы источника. | ||
| arp-reply - |
| Включить/выключить ответы на запросы ARP при добавлении IP-пула в политику (по умолчанию = включено). | |
| associated-interface - | Имя связанного интерфейса. Имя интерфейса системы источника. | ||
| block-size - | Количество адресов в блоке (от 64 до 4096, по умолчанию = 128). | ||
| comments - | Комментарий. | ||
| endip - | Конечный IPv4-адрес (включительно) в диапазоне для пула адресов (формат xxx.xxx.xxx.xxx, По умолчанию: 0.0.0.0). | ||
| name - / обязательно | Имя IP-пула. | ||
| num-blocks-per-user - | Количество блоков адресов, которые может использовать пользователь (от 1 до 128, по умолчанию = 8). | ||
| pba-timeout - | Тайм-аут выделения блока портов (секунды). | ||
| permit-any-host - |
| Включить/выключить полный кон NAT. | |
| source-endip - | Конечный IPv4-адрес (включительно) в диапазоне исходных адресов, которые нужно перевести (формат xxx.xxx.xxx.xxx, По умолчанию: 0.0.0.0). | ||
| source-startip - | Первый IPv4-адрес (включительно) в диапазоне исходных адресов, которые нужно перевести (формат xxx.xxx.xxx.xxx, По умолчанию: 0.0.0.0). | ||
| startip - | Первый IPv4-адрес (включительно) в диапазоне для пула адресов (формат xxx.xxx.xxx.xxx, По умолчанию: 0.0.0.0). | ||
| state - |
| Указывает, нужно ли создать или удалить объект | |
| type - |
| Тип IP-пула (overload, one-to-one, фиксированный диапазон портов или выделение блока портов). | |
| host - / обязательно | IP-адрес FortiOS или FortiGate. | ||
| https boolean |
| Указывает, должны ли запросы к FortiGate использовать протокол HTTPS | |
| password - | По умолчанию: "" | Пароль FortiOS или FortiGate. | |
| username - / обязательно | Имя пользователя FortiOS или FortiGate. | ||
| vdom - | По умолчанию: "root" | Виртуальная область, среди тех, которые были определены ранее. ВД является виртуальным экземпляром FortiGate, который может быть настроен и использован как отдельное устройство. | |
Примечания
Примечание
- Требуется библиотека fortiosapi, разработанная Fortinet
- Выполнять как local_action в вашем playbook
Примеры
- hosts: localhost
vars:
host: "192.168.122.40"
username: "admin"
password: ""
vdom: "root"
tasks:
- name: Configure IPv4 IP pools.
fortios_firewall_ippool:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
vdom: "{{ vdom }}"
firewall_ippool:
state: "present"
arp-intf: "<your_own_value> (source system.interface.name)"
arp-reply: "disable"
associated-interface: "<your_own_value> (source system.interface.name)"
block-size: "6"
comments: "<your_own_value>"
endip: "<your_own_value>"
name: "default_name_9"
num-blocks-per-user: "10"
pba-timeout: "11"
permit-any-host: "disable"
source-endip: "<your_own_value>"
source-startip: "<your_own_value>"
startip: "<your_own_value>"
type: "overload"
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| build строка | всегда | Номер сборки образа FortiGate Пример: 1547 |
| http_method строка | всегда | Последний метод, используемый для предоставления содержимого в FortiGate Пример: PUT |
| http_status строка | всегда | Последний результат, предоставленный FortiGate после последней операции Пример: 200 |
| mkey строка | успех | Главный ключ (id), используемый в последнем вызове FortiGate Пример: key1 |
| name строка | всегда | Имя таблицы, используемой для выполнения запроса Пример: urlfilter |
| path строка | всегда | Путь к таблице, используемой для выполнения запроса Пример: webfilter |
| revision строка | всегда | Внутренний номер ревизии Пример: 17.0.2.10658 |
| serial строка | всегда | Серийный номер устройства Пример: FGVMEVYYQT3AB5352 |
| status строка | всегда | Указание результата операции Пример: успех |
| vdom строка | всегда | Используемый виртуальный домен Пример: root |
| version строка | всегда | Версия FortiGate Пример: v5.6.3 |
Статус
- Данный модуль не гарантирует обратную совместимость. [preview]
- Данный модуль поддерживается сообществом Ansible. [community]
Авторы
- Miguel Angel Munoz (@mamunozgonzalez)
- Nicolas Thomas (@thomnico)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/fortios_firewall_ippool_module.html
