fortios_address - Управление объектами адресов брандмауэра fortios
Новая версия 2.4.
Обзор
- Этот модуль обеспечивает управление адресами брандмауэра на устройствах FortiOS.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| backup |
| Этот аргумент заставит модуль создать резервную копию текущего running-config с удаленного устройства перед внесением каких-либо изменений. Файл резервной копии записывается в папку i(backup). |
| backup_filename | Указывает имя файла резервной копии. Если опущено, имя файла будет отформатировано как HOST_config.ГГГГ-ММ-ДД@ЧЧ:ММ:СС | |
| backup_path | Указывает место хранения резервных копий. Требуется, если backup=yes. | |
| comment | свободный текст для описания адреса. | |
| config_file (добавлено в 2.4) | Путь к файлу конфигурации. Требуется, когда file_mode имеет значение True. | |
| country | Код страны из двух букв (например, FR). | |
| end_ip | Последний IP-адрес в диапазоне (используется только с type=iprange). | |
| file_mode (добавлено в 2.4) |
| Не подключаться к устройству, использовать только config_file в качестве входных и выходных данных. |
| host | Указывает DNS-имя хоста или IP-адрес для подключения к удаленному устройству fortios. Требуется, если file_mode имеет значение False. | |
| interface | По умолчанию: any | Имя интерфейса, к которому применяется адрес. |
| name обязательно | Имя адреса для добавления или удаления. | |
| password | Указывает пароль, используемый для аутентификации на удаленном устройстве. Требуется, если file_mode имеет значение True. | |
| start_ip | Первый IP-адрес в диапазоне (используется только с type=iprange). | |
| state обязательно |
| Указывает, нужно ли добавить или удалить адрес. |
| timeout | По умолчанию: 60 | Время ожидания в секундах для подключения к удаленному устройству. |
| type |
| Тип адреса. |
| username | Настраивает имя пользователя, используемое для аутентификации на удаленном устройстве. Требуется, если file_mode имеет значение True. | |
| value | Значение адреса, в зависимости от типа. Если type=fqdn, что-то вроде www.google.com. Если type=ipmask, можно использовать простой IP (192.168.0.1), IP+маска (192.168.0.1 255.255.255.0) или CIDR (192.168.0.1/32). | |
| vdom | Указывает, на каком vdom применить конфигурацию |
Примечания
Примечание
- Для этого модуля требуется библиотека netaddr python.
Примеры
- name: Register french addresses
fortios_address:
host: 192.168.0.254
username: admin
password: p4ssw0rd
state: present
name: "fromfrance"
type: geography
country: FR
comment: "French geoip address"
- name: Register some fqdn
fortios_address:
host: 192.168.0.254
username: admin
password: p4ssw0rd
state: present
name: "Ansible"
type: fqdn
value: www.ansible.com
comment: "Ansible website"
- name: Register google DNS
fortios_address:
host: 192.168.0.254
username: admin
password: p4ssw0rd
state: present
name: "google_dns"
type: ipmask
value: 8.8.8.8
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращено | Описание |
|---|---|---|
| change_string строка | только если конфигурация изменилась | Команды, выполненные модулем. |
| firewall_address_config строка | всегда | Полная строка конфигурации адресов брандмауэра. |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Автор
- Benjamin Jolivot (@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_address_module.html
