Модуль fortinet.fortimanager.fmgr_pm_config_pblock_firewall_consolidated_policy – Настройка объединённых политик IPv4/IPv6.

Примечание

Этот модуль входит в коллекцию fortinet.fortimanager (версия 2.7.0).

Возможная установка этой коллекции, если используется пакет ansible. Она не входит в ansible-core. Для проверки установки, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install fortinet.fortimanager.

Для использования в плейбуке укажите: fortinet.fortimanager.fmgr_pm_config_pblock_firewall_consolidated_policy.

Добавлен в fortinet.fortimanager 2.2.0

Обзор
Параметры
Примечания
Примеры
Значения возврата

Обзор

Этот модуль способен настраивать устройство FortiManager.
Примеры включают все параметры и значения, которые необходимо скорректировать перед использованием, обращаясь к источникам данных.

Параметры

Параметр	Комментарии
access_token строка	Токен для доступа к FortiManager без использования имени пользователя и пароля.
adom строка / обязательно	Параметр (adom) в запрошенном URL.
bypass_validation булево	Устанавливается в True только тогда, когда схема модуля отличается от структуры API FortiManager, модуль продолжает выполняться без проверки параметров. Варианты: `false` ← (по умолчанию) `true`
enable_log булево	Включить/выключить ведение журнала для задачи. Варианты: `false` ← (по умолчанию) `true`
forticloud_access_token строка	Авторизовать клиента Ansible с помощью токена доступа к API forticloud.
pblock строка / обязательно	Параметр (pblock) в запрошенном URL.
pm_config_pblock_firewall_consolidated_policy словарь	Настройка параметров верхнего уровня.
_policy_block целое число	Назначенный блок политики.
action строка	Действие политики Варианты: `"deny"` `"accept"` `"ipsec"`
app_category любой	(список) Устарело, пожалуйста, переименуйте на app_category. Категория приложений.
app_group любой	(список) Устарело, пожалуйста, переименуйте на app_group. Группа приложений.
application любой	(список) Приложение.
application_list строка	Устарело, пожалуйста, переименуйте на application_list. Название существующего списка приложений.
auto_asic_offload строка	Устарело, пожалуйста, переименуйте на auto_asic_offload. Включить/выключить отгрузку трафика политики ASIC. Варианты: `"disable"` `"enable"`
av_profile строка	Устарело, пожалуйста, переименуйте на av_profile. Название существующего профиля антивируса.
captive_portal_exempt строка	Устарело, пожалуйста, переименуйте на captive_portal_exempt. Включить освобождение некоторых пользователей от портала captive. Варианты: `"disable"` `"enable"`
cifs_profile строка	Устарело, пожалуйста, переименуйте на cifs_profile. Название существующего профиля CIFS.
comments строка	Комментарий.
diffserv_forward строка	Устарело, пожалуйста, переименуйте на diffserv_forward. Включить изменение значений DiffServ пакетов до указанного diffservcode-f… Варианты: `"disable"` `"enable"`

diffserv-reverse string	Устарело, пожалуйста, переименуйте на diffserv_reverse. Включить для изменения пакетов в обратном направлении Варианты: `"disable"` `"enable"`
diffservcode-forward string	Устарело, пожалуйста, переименуйте на diffservcode_forward. Изменить DiffServ пакетов на это значение.
diffservcode-rev string	Устарело, пожалуйста, переименуйте на diffservcode_rev. Изменить пакеты в обратном направлении
dlp-sensor string	Устарело, пожалуйста, переименуйте на dlp_sensor. Название существующего датчика DLP.
dnsfilter-profile string	Устарело, пожалуйста, переименуйте на dnsfilter_profile. Название существующего профиля фильтра DNS.
dstaddr-negate string	Устарело, пожалуйста, переименуйте на dstaddr_negate. При включении dstaddr указывает, что адрес назначения НЕ должен быть. Варианты: `"disable"` `"enable"`
dstaddr4 any	(список) Название и имена групп адресов назначения IPv4.
dstaddr6 any	(список) Название и имена групп адресов назначения IPv6.
dstintf any	(список) Исходящие
emailfilter-profile string	Устарело, пожалуйста, переименуйте на emailfilter_profile. Название существующего профиля фильтра электронной почты.
fixedport string	Включить, чтобы предотвратить изменение исходного порта сеанса при NAT. Варианты: `"disable"` `"enable"`
fsso-groups any	(список) Устарело, пожалуйста, переименуйте на fsso_groups. Имена групп FSSO.
global-label string	Устарело, пожалуйста, переименуйте на global_label. Метка политики, которая отображается, когда интерфейс GUI находится в режиме "Глобальный вид".
groups any	(список) Имена пользовательских групп, которые могут пройти аутентификацию с этой политикой.
http-policy-redirect string	Устарело, пожалуйста, переименуйте на http_policy_redirect. Перенаправление HTTP Варианты: `"disable"` `"enable"`
icap-profile string	Устарело, пожалуйста, переименуйте на icap_profile. Название существующего профиля ICAP.
inbound string	Политика IPsec VPN Варианты: `"disable"` `"enable"`
inspection-mode string	Устарело, пожалуйста, переименуйте на inspection_mode. Режим проверки политики Варианты: `"proxy"` `"flow"`
internet-service string	Устарело, пожалуйста, переименуйте на internet_service. Включить/выключить использование Интернет-служб для этой политики. Варианты: `"disable"` `"enable"`

internet-service-custom any	(list) Устарело, переименуйте в internet_service_custom. Название пользовательской интернет-службы.
internet-service-custom-group any	(list) Устарело, переименуйте в internet_service_custom_group. Название группы пользовательских интернет-служб.
internet-service-group any	(list) Устарело, переименуйте в internet_service_group. Название группы интернет-служб.
internet-service-id any	(list) Устарело, переименуйте в internet_service_id. Идентификатор интернет-службы.
internet-service-negate string	Устарело, переименуйте в internet_service_negate. При включении internet-service указывает, чем служба быть НЕ должна. Варианты: `"disable"` `"enable"`
internet-service-src string	Устарело, переименуйте в internet_service_src. Включить/отключить использование интернет-служб в источнике для этой политики. Варианты: `"disable"` `"enable"`
internet-service-src-custom any	(list) Устарело, переименуйте в internet_service_src_custom. Название пользовательской интернет-службы источника.
internet-service-src-custom-group any	(list) Устарело, переименуйте в internet_service_src_custom_group. Название группы пользовательских интернет-служб источника.
internet-service-src-group any	(list) Устарело, переименуйте в internet_service_src_group. Название группы интернет-служб источника.
internet-service-src-id any	(list) Устарело, переименуйте в internet_service_src_id. Идентификатор интернет-службы источника.
internet-service-src-negate string	Устарело, переименуйте в internet_service_src_negate. При включении internet-service-src указывает, чем служба … Варианты: `"disable"` `"enable"`
ippool string	Включить для использования пулов IP-адресов для исходного NAT. Варианты: `"disable"` `"enable"`
ips-sensor string	Устарело, переименуйте в ips_sensor. Название существующего датчика IPS.
logtraffic string	Включить или отключить ведение журнала. Варианты: `"disable"` `"all"` `"utm"`
logtraffic-start string	Устарело, переименуйте в logtraffic_start. Записывать логи при запуске сессии. Варианты: `"disable"` `"enable"`
mms-profile string	Устарело, переименуйте в mms_profile. Название существующего профиля MMS.
name string	Имя политики.
nat string	Включить/отключить исходный NAT. Варианты: `"disable"` `"enable"`

outbound string	Политика IPsec VPN Варианты: `"disable"` `"enable"`
per-ip-shaper string	Устарело, переименуйте на per_ip_shaper. Ограничивает трафик по каждому IP.
policyid integer / обязательно	Идентификатор политики
poolname4 any	(список) Имена пулов IPv4.
poolname6 any	(список) Имена пулов IPv6.
profile-group string	Устарело, переименуйте на profile_group. Название группы профилей.
profile-protocol-options string	Устарело, переименуйте на profile_protocol_options. Название существующего профиля параметров протоколов.
profile-type string	Устарело, переименуйте на profile_type. Определяет, позволяет ли политика брандмауэра использовать группы профилей безопасности или... Варианты: `"single"` `"group"`
schedule string	Название расписания.
service any	(список) Имена служб и групп служб.
service-negate string	Устарело, переименуйте на service_negate. Если включено, service указывает, какой сервис НЕ должен быть. Варианты: `"disable"` `"enable"`
session-ttl integer	Устарело, переименуйте на session_ttl. Время жизни сессии в секундах, принимаемой этой политикой
srcaddr-negate string	Устарело, переименуйте на srcaddr_negate. Если включено, srcaddr указывает, какой источник адреса НЕ должен быть. Варианты: `"disable"` `"enable"`
srcaddr4 any	(список) Имя и имена групп адресов источника IPv4.
srcaddr6 any	(список) Имя и имена групп адресов источника IPv6.
srcintf any	(список) Входящие
ssh-filter-profile string	Устарело, переименуйте на ssh_filter_profile. Название существующего профиля фильтра SSH.
ssh-policy-redirect string	Устарело, переименуйте на ssh_policy_redirect. Перенаправление трафика SSH на соответствующую политику прозрачного прокси. Варианты: `"disable"` `"enable"`
ssl-ssh-profile string	Устарело, переименуйте на ssl_ssh_profile. Название существующего профиля SSL SSH.
status string	Включить или отключить эту политику. Варианты: `"disable"` `"enable"`

tcp-mss-receiver integer	Устарело, переименуйте в tcp_mss_receiver. Максимальный размер сегмента TCP для получателя
tcp-mss-sender integer	Устарело, переименуйте в tcp_mss_sender. Максимальный размер сегмента TCP для отправителя
traffic-shaper string	Устарело, переименуйте в traffic_shaper. Формирователь трафика.
traffic-shaper-reverse string	Устарело, переименуйте в traffic_shaper_reverse. Обратный формирователь трафика.
url-category any	(list) Устарело, переименуйте в url_category. Категория URL.
users any	(list) Имена отдельных пользователей, которые могут пройти аутентификацию с помощью этой политики.
utm-status string	Устарело, переименуйте в utm_status. Включить для добавления одного или нескольких профилей безопасности Варианты: `"disable"` `"enable"`
uuid string	Универсальный уникальный идентификатор
voip-profile string	Устарело, переименуйте в voip_profile. Имя существующего профиля VoIP.
vpntunnel string	IPsec VPN на основе политик
waf-profile string	Устарело, переименуйте в waf_profile. Имя существующего профиля брандмауэра веб-приложений.
wanopt string	Включить/отключить оптимизацию WAN. Варианты: `"disable"` `"enable"`
wanopt-detection string	Устарело, переименуйте в wanopt_detection. Режим автоматического обнаружения оптимизации WAN. Варианты: `"active"` `"passive"` `"off"`
wanopt-passive-opt string	Устарело, переименуйте в wanopt_passive_opt. Параметры пассивного режима оптимизации WAN. Варианты: `"default"` `"transparent"` `"non-transparent"`
wanopt-peer string	Устарело, переименуйте в wanopt_peer. Пэр оптимизации WAN.
wanopt-profile string	Устарело, переименуйте в wanopt_profile. Профили оптимизации WAN.
webcache string	Включить/отключить веб-кэш. Варианты: `"disable"` `"enable"`
webcache-https string	Устарело, переименуйте в webcache_https. Включить/отключить веб-кэш для HTTPS. Варианты: `"disable"` `"enable"`
webfilter-profile string	Устарело, переименуйте в webfilter_profile. Имя существующего профиля веб-фильтра.
webproxy-forward-server string	Устарело, переименуйте в webproxy_forward_server. Имя сервера переадресации Webproxy.

webproxy-profile string	Устаревшее, пожалуйста, переименуйте на webproxy_profile. Имя профиля веб-прокси.
proposed_method string	Переопределённый метод для базового запроса Json RPC. Варианты: `"update"` `"set"` `"add"`
rc_failed list / элементы=целое число	Список rc-кодов, с которыми будут переопределены условия для отказа.
rc_succeeded list / элементы=целое число	Список rc-кодов, с которыми будут переопределены условия для успеха.
state string / обязательно	Директива для создания, обновления или удаления объекта. Варианты: `"present"` `"absent"`
workspace_locking_adom string	ADOM для блокировки при работе FortiManager в режиме рабочего пространства; значение может быть глобальным и другими, включая root.
workspace_locking_timeout integer	Максимальное время в секундах ожидания, пока другой пользователь не разблокирует рабочее пространство. По умолчанию: `300`

Примечания

Примечание

Начиная с версии 2.4.0, все входные аргументы имеют имя с использованием нижнего подчеркивания (snake_case). Пожалуйста, измените аргументы, такие как «var-name», на «var_name». Старые имена аргументов по-прежнему доступны, но вы получите предупреждения об устаревании. Вы можете проигнорировать это предупреждение, установив deprecation_warnings=False в ansible.cfg.
В этом модуле FortiManager поддерживается работа в режиме блокировки рабочего пространства; параметры workspace_locking_adom и workspace_locking_timeout помогают в этом.
Для создания или обновления объекта используйте директиву state present.
Для удаления объекта используйте директиву state absent.
Обычно выполнение одного модуля может завершиться ошибкой, если возвращается ненулевой rc. Вы также можете переопределить условия для отказа или успеха с помощью параметров rc_failed и rc_succeeded.

Примеры

- name: Example playbook (generated based on argument schema)
  hosts: fortimanagers
  connection: httpapi
  vars:
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_httpapi_port: 443
  tasks:
    - name: Configure consolidated IPv4/IPv6 policies.
      fortinet.fortimanager.fmgr_pm_config_pblock_firewall_consolidated_policy:
        # bypass_validation: false
        workspace_locking_adom: <value in [global, custom adom including root]>
        workspace_locking_timeout: 300
        # rc_succeeded: [0, -2, -3, ...]
        # rc_failed: [-2, -3, ...]
        adom: <your own value>
        pblock: <your own value>
        state: present # <value in [present, absent]>
        pm_config_pblock_firewall_consolidated_policy:
          _policy_block: <integer>
          action: <value in [deny, accept, ipsec]>
          app_category: <list or string>
          app_group: <list or string>
          application: <list or integer>
          application_list: <string>
          auto_asic_offload: <value in [disable, enable]>
          av_profile: <string>
          captive_portal_exempt: <value in [disable, enable]>
          cifs_profile: <string>
          comments: <string>
          diffserv_forward: <value in [disable, enable]>
          diffserv_reverse: <value in [disable, enable]>
          diffservcode_forward: <string>
          diffservcode_rev: <string>
          dlp_sensor: <string>
          dnsfilter_profile: <string>
          dstaddr_negate: <value in [disable, enable]>
          dstaddr4: <list or string>
          dstaddr6: <list or string>
          dstintf: <list or string>
          emailfilter_profile: <string>
          fixedport: <value in [disable, enable]>
          fsso_groups: <list or string>
          global_label: <string>
          groups: <list or string>
          http_policy_redirect: <value in [disable, enable]>
          icap_profile: <string>
          inbound: <value in [disable, enable]>
          inspection_mode: <value in [proxy, flow]>
          internet_service: <value in [disable, enable]>
          internet_service_custom: <list or string>
          internet_service_custom_group: <list or string>
          internet_service_group: <list or string>
          internet_service_id: <list or string>
          internet_service_negate: <value in [disable, enable]>
          internet_service_src: <value in [disable, enable]>
          internet_service_src_custom: <list or string>
          internet_service_src_custom_group: <list or string>
          internet_service_src_group: <list or string>
          internet_service_src_id: <list or string>
          internet_service_src_negate: <value in [disable, enable]>
          ippool: <value in [disable, enable]>
          ips_sensor: <string>
          logtraffic: <value in [disable, all, utm]>
          logtraffic_start: <value in [disable, enable]>
          mms_profile: <string>
          name: <string>
          nat: <value in [disable, enable]>
          outbound: <value in [disable, enable]>
          per_ip_shaper: <string>
          policyid: <integer>
          poolname4: <list or string>
          poolname6: <list or string>
          profile_group: <string>
          profile_protocol_options: <string>
          profile_type: <value in [single, group]>
          schedule: <string>
          service: <list or string>
          service_negate: <value in [disable, enable]>
          session_ttl: <integer>
          srcaddr_negate: <value in [disable, enable]>
          srcaddr4: <list or string>
          srcaddr6: <list or string>
          srcintf: <list or string>
          ssh_filter_profile: <string>
          ssh_policy_redirect: <value in [disable, enable]>
          ssl_ssh_profile: <string>
          status: <value in [disable, enable]>
          tcp_mss_receiver: <integer>
          tcp_mss_sender: <integer>
          traffic_shaper: <string>
          traffic_shaper_reverse: <string>
          url_category: <list or string>
          users: <list or string>
          utm_status: <value in [disable, enable]>
          uuid: <string>
          voip_profile: <string>
          vpntunnel: <string>
          waf_profile: <string>
          wanopt: <value in [disable, enable]>
          wanopt_detection: <value in [active, passive, off]>
          wanopt_passive_opt: <value in [default, transparent, non-transparent]>
          wanopt_peer: <string>
          wanopt_profile: <string>
          webcache: <value in [disable, enable]>
          webcache_https: <value in [disable, enable]>
          webfilter_profile: <string>
          webproxy_forward_server: <string>
          webproxy_profile: <string>

Значения возврата

Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
meta словарь	Результат запроса. Возвращается: всегда
request_url строка	Полный URL запроса. Возвращается: всегда Пример: `"/sys/login/user"`
response_code целое число	Статус запроса API. Возвращается: всегда Пример: `0`
response_data список / элементы=строка	Ответ API. Возвращается: всегда
response_message строка	Описание результата ответа API. Возвращается: всегда Пример: `"OK."`
system_information словарь	Информация о целевой системе. Возвращается: всегда
rc целое число	Статус запроса. Возвращается: всегда Пример: `0`
version_check_warning список / элементы=строка	Предупреждение, если параметры, используемые в плейбуке, не поддерживаются текущей версией FortiManager. Возвращается: сложное

Авторы

Xinwei Du (@dux-fortinet)
Xing Li (@lix-fortinet)
Jie Xue (@JieX19)
Link Zheng (@chillancezen)
Frank Shen (@fshen01)
Hongbin Lu (@fgtdev-hblu)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/fortinet/fortimanager/fmgr_pm_config_pblock_firewall_consolidated_policy_module.html