fortios_firewall_proxy_policy – Настройка политик прокси в Fortinet’s FortiOS и FortiGate
Новая версия с 2.8.
Краткое описание
- Этот модуль позволяет настроить FortiGate или FortiOS, предоставляя пользователю возможность настройки функций брандмауэра и категории proxy_policy. Примеры включают все опции и требуют корректировки в соответствии с источниками данных перед использованием. Тестировалось с FOS v6.0.2
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- fortiosapi>=0.9.8
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | ||
|---|---|---|---|---|
| firewall_proxy_policy - | Значение по умолчанию: null | Настройка правил прокси. | ||
| action - |
| Принять или отклонить трафик, соответствующий параметрам политики. | ||
| application-list - | Имя существующего списка приложений. Источник application.list.name. | |||
| av-profile - | Имя существующего профиля антивируса. Источник antivirus.profile.name. | |||
| comments - | Дополнительные комментарии. | |||
| disclaimer - |
| Настройка уведомления о веб-прокси: по домену, политике или пользователю. | ||
| dlp-sensor - | Имя существующего датчика DLP. Источник dlp.sensor.name. | |||
| dstaddr - | Объекты адресов назначения. | |||
| name - / обязательно | Имя адреса. Источник firewall.address.name firewall.addrgrp.name firewall.proxy-address.name firewall.proxy-addrgrp.name firewall.vip.name firewall.vipgrp.name firewall.vip46.name firewall.vipgrp46.name system.external-resource.name. | |||
| dstaddr-negate - |
| При включении адреса назначения сопоставляются со всеми адресами, КРОМЕ указанных адресов назначения. | ||
| dstaddr6 - | Объекты адресов назначения IPv6. | |||
| name - / обязательно | Имя адреса. Источник firewall.address6.name firewall.addrgrp6.name firewall.vip6.name firewall.vipgrp6.name firewall.vip64.name firewall.vipgrp64.name system.external-resource.name. | |||
| dstintf - | Имена интерфейсов назначения. | |||
| name - / обязательно | Имя интерфейса. Источник system.interface.name system.zone.name. | |||
| global-label - | Метка, отображаемая в глобальном веб-менеджере. | |||
| groups - | Имена объектов групп. | |||
| name - / обязательно | Имя группы. Источник user.group.name. | |||
| http-tunnel-auth - |
| Включить/выключить аутентификацию HTTP-туннеля. | ||
| icap-profile - | Имя существующего профиля ICAP. Источник icap.profile.name. | |||
| internet-service - |
| Включить/выключить использование Интернет-служб для этой политики. При включении адреса назначения и службы не используются. | ||
| internet-service-custom - | Настраиваемое имя Интернет-службы. | |||
| name - / обязательно | Настраиваемое имя. Источник firewall.internet-service-custom.name. | |||
| internet-service-id - | Идентификатор Интернет-службы. | |||
| id - / обязательно | Идентификатор Интернет-службы. Источник firewall.internet-service.id. | |||
| internet-service-negate - |
| При включении Интернет-службы сопоставляются со всеми интернет-службами, КРОМЕ выбранной Интернет-службы. | ||
| ips-sensor - | Имя существующего датчика IPS. Источник ips.sensor.name. | |||
| label - | Метка, отображаемая в графическом интерфейсе VDOM. | |||
| logtraffic - |
| Включить/выключить протоколирование трафика через политику. | ||
| logtraffic-start - |
| Включить/выключить начало протоколирования трафика политики. | ||
| policyid - / обязательно | Идентификатор политики. | |||
| poolname - | Имя объекта пула IP. | |||
| name - / обязательно | Имя пула IP. Источник firewall.ippool.name. | |||
| profile-group - | Имя группы профилей. Источник firewall.profile-group.name. | |||
| profile-protocol-options - | Имя существующего профиля опций протокола. Источник firewall.profile-protocol-options.name. | |||
| profile-type - |
| Определить, позволяет ли политика брандмауэра использовать только группы профилей безопасности или только отдельные профили. | ||
| proxy - |
| Тип явного прокси. | ||
| redirect-url - | URL перенаправления для дальнейшей обработки явного веб-прокси. | |||
| replacemsg-override-group - | Группа перезаписи сообщений замены аутентификации. Источник system.replacemsg-group.name. | |||
| scan-botnet-connections - |
| Включить/выключить сканирование соединений с серверами ботнета. | ||
| расписание - | Имя объекта расписания. Источник firewall.schedule.onetime.name firewall.schedule.recurring.name firewall.schedule.group.name. | |||
| сервис - | Имя объектов сервисов. | |||
| имя - / обязательно | Имя сервиса. Источник firewall.service.custom.name firewall.service.group.name. | |||
| service-negate - |
| При включении сервисы соответствуют любому сервису, КРОМЕ указанных сервисов назначения. | ||
| session-ttl - | TTL в секундах для сессий, принятых этой политикой (0 означает использование системного значения session TTL). | |||
| spamfilter-profile - | Имя существующего профиля фильтра спама. Источник spamfilter.profile.name. | |||
| srcaddr - | Объекты источника адреса (должны быть установлены при использовании веб-прокси). | |||
| имя - / обязательно | Имя адреса. Источник firewall.address.name firewall.addrgrp.name firewall.proxy-address.name firewall.proxy-addrgrp.name system .external-resource.name. | |||
| srcaddr-negate - |
| При включении адреса источника соответствуют любому адресу, КРОМЕ указанных адресов источника. | ||
| srcaddr6 - | Объекты IPv6 адреса источника. | |||
| имя - / обязательно | Имя адреса. Источник firewall.address6.name firewall.addrgrp6.name system.external-resource.name. | |||
| srcintf - | Имена интерфейсов источника. | |||
| имя - / обязательно | Имя интерфейса. Источник system.interface.name system.zone.name. | |||
| ssh-filter-profile - | Имя существующего профиля фильтра SSH. Источник ssh-filter.profile.name. | |||
| ssl-ssh-profile - | Имя существующего профиля SSL SSH. Источник firewall.ssl-ssh-profile.name. | |||
| состояние - |
| Указывает, нужно ли создать или удалить объект. | ||
| статус - |
| Включить/выключить активный статус политики. | ||
| прозрачный - |
| Включить, чтобы использовать IP-адрес клиента для подключения к серверу. | ||
| пользователи - | Имена объектов пользователей. | |||
| имя - / обязательно | Имя группы. Источник user.local.name. | |||
| utm-статус - |
| Включить использование профилей/сенсоров/списков UTM. | ||
| uuid - | Универсальный уникальный идентификатор (UUID; автоматически назначается, но может быть вручную сброшен). | |||
| waf-profile - | Имя существующего профиля брандмауэра веб-приложений. Источник waf.profile.name. | |||
| webcache - |
| Включить/выключить кэширование веб-страниц. | ||
| webcache-https - |
| Включить/выключить кэширование веб-страниц для HTTPS (Требуется включенный глубокий анализ в ssl-ssh-profile). | ||
| webfilter-profile - | Имя существующего профиля фильтра веб-страниц. Источник webfilter.profile.name. | |||
| webproxy-forward-server - | Имя сервера переадресации веб-прокси. Источник web-proxy.forward-server.name web-proxy.forward-server-group.name. | |||
| webproxy-profile - | Имя профиля веб-прокси. Источник web-proxy.profile.name. | |||
| хост - / обязательно | IP-адрес FortiOS или FortiGate. | |||
| https boolean |
| Указывает, должны ли запросы к FortiGate использовать протокол HTTPS. | ||
| пароль - | По умолчанию: "" | Пароль FortiOS или FortiGate. | ||
| имя_пользователя - / обязательно | Имя пользователя FortiOS или FortiGate. | |||
| vdom - | По умолчанию: "root" | Виртуальная область, из тех, которые определены ранее. VDOM — это виртуальный экземпляр FortiGate, который может быть настроен и использован как отдельный блок. | ||
Примечания
Примечание
- Требуется библиотека fortiosapi, разработанная Fortinet
- Запускается как local_action в вашем playbook
Примеры
- hosts: localhost
vars:
host: "192.168.122.40"
username: "admin"
password: ""
vdom: "root"
tasks:
- name: Configure proxy policies.
fortios_firewall_proxy_policy:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
vdom: "{{ vdom }}"
https: "False"
firewall_proxy_policy:
state: "present"
action: "accept"
application-list: "<your_own_value> (source application.list.name)"
av-profile: "<your_own_value> (source antivirus.profile.name)"
comments: "<your_own_value>"
disclaimer: "disable"
dlp-sensor: "<your_own_value> (source dlp.sensor.name)"
dstaddr:
-
name: "default_name_10 (source firewall.address.name firewall.addrgrp.name firewall.proxy-address.name firewall.proxy-addrgrp.name firewall.vip
.name firewall.vipgrp.name firewall.vip46.name firewall.vipgrp46.name system.external-resource.name)"
dstaddr-negate: "enable"
dstaddr6:
-
name: "default_name_13 (source firewall.address6.name firewall.addrgrp6.name firewall.vip6.name firewall.vipgrp6.name firewall.vip64.name firewall
.vipgrp64.name system.external-resource.name)"
dstintf:
-
name: "default_name_15 (source system.interface.name system.zone.name)"
global-label: "<your_own_value>"
groups:
-
name: "default_name_18 (source user.group.name)"
http-tunnel-auth: "enable"
icap-profile: "<your_own_value> (source icap.profile.name)"
internet-service: "enable"
internet-service-custom:
-
name: "default_name_23 (source firewall.internet-service-custom.name)"
internet-service-id:
-
id: "25 (source firewall.internet-service.id)"
internet-service-negate: "enable"
ips-sensor: "<your_own_value> (source ips.sensor.name)"
label: "<your_own_value>"
logtraffic: "all"
logtraffic-start: "enable"
policyid: "31"
poolname:
-
name: "default_name_33 (source firewall.ippool.name)"
profile-group: "<your_own_value> (source firewall.profile-group.name)"
profile-protocol-options: "<your_own_value> (source firewall.profile-protocol-options.name)"
profile-type: "single"
proxy: "explicit-web"
redirect-url: "<your_own_value>"
replacemsg-override-group: "<your_own_value> (source system.replacemsg-group.name)"
scan-botnet-connections: "disable"
schedule: "<your_own_value> (source firewall.schedule.onetime.name firewall.schedule.recurring.name firewall.schedule.group.name)"
service:
-
name: "default_name_43 (source firewall.service.custom.name firewall.service.group.name)"
service-negate: "enable"
session-ttl: "45"
spamfilter-profile: "<your_own_value> (source spamfilter.profile.name)"
srcaddr:
-
name: "default_name_48 (source firewall.address.name firewall.addrgrp.name firewall.proxy-address.name firewall.proxy-addrgrp.name system
.external-resource.name)"
srcaddr-negate: "enable"
srcaddr6:
-
name: "default_name_51 (source firewall.address6.name firewall.addrgrp6.name system.external-resource.name)"
srcintf:
-
name: "default_name_53 (source system.interface.name system.zone.name)"
ssh-filter-profile: "<your_own_value> (source ssh-filter.profile.name)"
ssl-ssh-profile: "<your_own_value> (source firewall.ssl-ssh-profile.name)"
status: "enable"
transparent: "enable"
users:
-
name: "default_name_59 (source user.local.name)"
utm-status: "enable"
uuid: "<your_own_value>"
waf-profile: "<your_own_value> (source waf.profile.name)"
webcache: "enable"
webcache-https: "disable"
webfilter-profile: "<your_own_value> (source webfilter.profile.name)"
webproxy-forward-server: "<your_own_value> (source web-proxy.forward-server.name web-proxy.forward-server-group.name)"
webproxy-profile: "<your_own_value> (source web-proxy.profile.name)"
Значения возврата
Общие значения возврата документированы здесь, следующие — поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| build строка | всегда | Номер сборки образа FortiGate Пример: 1547 |
| http_method строка | всегда | Последний метод, используемый для предоставления содержимого в FortiGate Пример: PUT |
| http_status строка | всегда | Последний результат, полученный от FortiGate после последней операции Пример: 200 |
| mkey строка | успех | Главный ключ (id), используемый в последнем вызове FortiGate Пример: id |
| name строка | всегда | Имя таблицы, используемой для выполнения запроса Пример: urlfilter |
| path строка | всегда | Путь к таблице, используемой для выполнения запроса Пример: webfilter |
| revision строка | всегда | Внутренний номер ревизии Пример: 17.0.2.10658 |
| serial строка | всегда | Серийный номер устройства Пример: FGVMEVYYQT3AB5352 |
| status строка | всегда | Указание результата операции Пример: успех |
| vdom строка | всегда | Используемый виртуальный домен Пример: root |
| version строка | всегда | Версия FortiGate Пример: v5.6.3 |
Статус
- Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
- Данный модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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_proxy_policy_module.html