Модуль fortinet.fortimanager.fmgr_pkg_firewall_consolidated_policy — Настройка консолидированных правил IPv4/IPv6.

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить, используйте: ansible-galaxy collection install fortinet.fortimanager.

Чтобы использовать в playbook, укажите: fortinet.fortimanager.fmgr_pkg_firewall_consolidated_policy.

Новое в fortinet.fortimanager 2.1.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.
pkg строка / обязательно	Параметр (pkg) в запрошенном URL.
pkg_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. Включить/выключить передачу обработки профиля безопасности в процессоры CP. Варианты: `"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 строка	Устарело, пожалуйста, переименуйте на 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. Метка для политики, которая отображается, когда графический интерфейс находится в режиме глобального просмотра.
groups any	(список или строка) Имена групп пользователей, которые могут пройти аутентификацию с помощью этой политики.
http-policy-redirect string	Устарело, переименуйте в http_policy_redirect. Перенаправить HTTP Варианты: `"disable"` `"enable"`
icap-profile string	Устарело, переименуйте в icap_profile. Имя существующего профиля ICAP.
inbound string	VPN на основе политики IPsec Варианты: `"disable"` `"enable"`
inspection-mode string	Устарело, переименуйте в inspection_mode. Режим проверки политик Варианты: `"proxy"` `"flow"`
internet-service string	Устарело, переименуйте в internet_service. Включить/отключить использование интернет-сервисов для этой политики. Варианты: `"disable"` `"enable"`
internet-service-custom any	(список или строка) Устарело, переименуйте в internet_service_custom. Имя пользовательского интернет-сервиса.
internet-service-custom-group any	(список или строка) Устарело, переименуйте в internet_service_custom_group. Имя группы пользовательских интернет-сервисов.

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

poolname6 any	(list or str) Имена пулов IPv6.
profile-group string	Устарело, переименуйте в profile_group. Имя группы профилей.
profile-protocol-options string	Устарело, переименуйте в profile_protocol_options. Имя существующего профиля параметров протокола.
profile-type string	Устарело, переименуйте в profile_type. Определяет, разрешает ли политика брандмауэра группы профилей безопасности или… Варианты: `"single"` `"group"`
schedule string	Имя расписания.
service any	(list or str) Имена сервиса и группы сервисов.
service-negate string	Устарело, переименуйте в service_negate. При включении service указывает, чем сервис НЕ должен быть. Варианты: `"disable"` `"enable"`
session-ttl integer	Устарело, переименуйте в session_ttl. TTL в секундах для сессий, принятых этой политикой
srcaddr-negate string	Устарело, переименуйте в srcaddr_negate. При включении srcaddr указывает, чем исходный адрес НЕ должен быть. Варианты: `"disable"` `"enable"`
srcaddr4 any	(list or str) Имя исходного IPv4-адреса и имена групп адресов.
srcaddr6 any	(list or str) Имя исходного IPv6-адреса и имена групп адресов.
srcintf any	(list or str) Входящий
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 or str) Устарело, переименуйте в url_category. Список ID категорий URL.

users any	(список или строка) Имена отдельных пользователей, которые могут пройти аутентификацию с помощью этой политики.
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-profile string	Устарело, переименуйте в webproxy_profile. Имя профиля веб-прокси.
proposed_method string	Переопределённый метод для базового запроса Json RPC. Варианты: `"update"` `"set"` `"add"`
rc_failed list / elements=integer	Список кодов rc, с помощью которых будут переопределены условия сбоя.
rc_succeeded list / elements=integer	Список кодов rc, с помощью которых будут переопределены условия успеха.
state string / required	Директива для создания, обновления или удаления объекта. Варианты: `"present"` `"absent"`

workspace_locking_adom строка	ADOM, который следует заблокировать для FortiManager, работающего в режиме рабочей области; значение может быть глобальным и другими, включая root.
workspace_locking_timeout целое число	Максимальное время в секундах ожидания, пока другой пользователь не разблокирует рабочую область. По умолчанию: `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_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_pkg_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>
        pkg: <your own value>
        state: present # <value in [present, absent]>
        pkg_firewall_consolidated_policy:
          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>
          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>
          dstaddr4: <list or string>
          dstaddr6: <list or string>
          dstintf: <list or string>
          emailfilter_profile: <string>
          fixedport: <value in [disable, enable]>
          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_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>
          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>
          session_ttl: <integer>
          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>
          captive_portal_exempt: <value in [disable, enable]>
          dstaddr_negate: <value in [disable, enable]>
          fsso_groups: <list or string>
          global_label: <string>
          internet_service_negate: <value in [disable, enable]>
          internet_service_src_negate: <value in [disable, enable]>
          service_negate: <value in [disable, enable]>
          srcaddr_negate: <value in [disable, enable]>
          _policy_block: <integer>

Возвращаемые значения

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

Ключ	Описание
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_pkg_firewall_consolidated_policy_module.html