Модуль fortinet.fortimanager.fmgr_pkg_firewall_consolidated_policy — Настройка объединённых политик IPv4/IPv6.
Примечание
Этот модуль входит в коллекцию fortinet.fortimanager (версия 2.14.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortimanager.
Чтобы использовать её в плейбуке, укажите: fortinet.fortimanager.fmgr_pkg_firewall_consolidated_policy.
Добавлено в fortinet.fortimanager 2.1.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiManager.
- В примерах приведены все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием.
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Токен для доступа к FortiManager без использования имени пользователя и пароля. |
adom string / обязательный | Параметр (adom) в запрошенном URL. |
bypass_validation boolean | Устанавливайте значение True только в том случае, если схема модуля отличается от структуры API FortiManager. Модуль продолжит выполнение без проверки параметров. Варианты:
|
enable_log boolean | Включить/отключить ведение журнала для задачи. Варианты:
|
forticloud_access_token string | Аутентификация клиента Ansible с помощью токена доступа к API FortiCloud. |
pkg string / обязательный | Параметр (pkg) в запрошенном URL. |
pkg_firewall_consolidated_policy dictionary | Набор параметров верхнего уровня. |
|
_policy_block integer |
Назначенный блок политик. |
|
action string |
Действие политики Варианты:
|
|
app_category aliases: app-category any |
(список или строка) Список идентификаторов категорий приложений. |
|
app_group aliases: app-group any |
(список или строка) Имена групп приложений. |
|
application any |
(список) Список идентификаторов приложений. |
|
application_list aliases: application-list string |
Имя существующего списка приложений. |
|
auto_asic_offload aliases: auto-asic-offload string |
Включить/отключить выгрузку обработки профилей безопасности на процессоры CP. Варианты:
|
|
av_profile aliases: av-profile string |
Имя существующего антивирусного профиля. |
|
captive_portal_exempt aliases: captive-portal-exempt string |
Разрешить освобождение некоторых пользователей от прохождения портала авторизации. Варианты:
|
|
cifs_profile aliases: cifs-profile string |
Имя существующего профиля CIFS. |
|
comments string |
Комментарий. |
|
diffserv_forward aliases: diffserv-forward string |
Включить изменение значений DiffServ пакетов на указанное значение diffservcode-forward. Варианты:
|
|
diffserv_reverse aliases: diffserv-reverse string |
Включить изменение обратного направления пакетов Варианты:
|
|
diffservcode_forward aliases: diffservcode-forward string |
Изменить значение DiffServ пакетов на это значение. |
|
diffservcode_rev aliases: diffservcode-rev string |
Изменить обратное направление пакетов |
|
dlp_sensor aliases: dlp-sensor string |
Имя существующего датчика DLP. |
|
dnsfilter_profile aliases: dnsfilter-profile string |
Имя существующего профиля DNS-фильтрации. |
|
dstaddr4 any |
(список или строка) Имя адреса назначения IPv4 и имена групп адресов. |
dstaddr6 any | (список или строка) Имя адреса назначения IPv6 и имена групп адресов. |
|
dstaddr_negate aliases: dstaddr-negate string |
Если параметр включен, dstaddr задает адрес назначения, которым адрес НЕ должен быть. Варианты:
|
|
dstintf any |
(список или строка) Исходящий интерфейс |
|
emailfilter_profile aliases: emailfilter-profile string |
Имя существующего профиля фильтрации электронной почты. |
|
fixedport string |
Включить, чтобы запретить source NAT изменять исходный порт сеанса. Варианты:
|
|
fsso_groups aliases: fsso-groups any |
(список или строка) Имена групп FSSO. |
|
global_label aliases: global-label string |
Метка политики, отображаемая в графическом интерфейсе в режиме глобального просмотра. |
|
groups any |
(список или строка) Имена групп пользователей, которые могут пройти аутентификацию с помощью этой политики. |
|
http_policy_redirect aliases: http-policy-redirect string |
Перенаправление HTTP Варианты:
|
|
icap_profile aliases: icap-profile string |
Имя существующего профиля ICAP. |
|
inbound string |
IPsec VPN на основе политик Варианты:
|
|
inspection_mode aliases: inspection-mode string |
Режим проверки политики Варианты:
|
|
internet_service aliases: internet-service string |
Включить/отключить использование интернет-сервисов для этой политики. Варианты:
|
|
internet_service_custom aliases: internet-service-custom any |
(список или строка) Имя пользовательского интернет-сервиса. |
|
internet_service_custom_group aliases: internet-service-custom-group any |
(список или строка) Имя группы пользовательских интернет-сервисов. |
|
internet_service_group aliases: internet-service-group any |
(список или строка) Имя группы интернет-сервисов. |
|
internet_service_id aliases: internet-service-id any |
(список или строка) Идентификатор интернет-сервиса. |
|
internet_service_negate aliases: internet-service-negate string |
Если параметр включен, internet-service задает сервис, которым НЕ должен быть указанный сервис. Варианты:
|
|
internet_service_src aliases: internet-service-src string |
Включить/отключить использование интернет-сервисов в качестве источника для этой политики. Варианты:
|
|
internet_service_src_custom aliases: internet-service-src-custom any |
(список или строка) Имя пользовательского исходного интернет-сервиса. |
|
internet_service_src_custom_group aliases: internet-service-src-custom-group any |
(список или строка) Имя группы пользовательских исходных интернет-сервисов. |
|
internet_service_src_group aliases: internet-service-src-group any |
(список или строка) Имя группы исходных интернет-сервисов. |
|
internet_service_src_id aliases: internet-service-src-id any |
(список или строка) Идентификатор исходного интернет-сервиса. |
|
internet_service_src_negate aliases: internet-service-src-negate string |
Если параметр включен, internet-service-src задает сервис, которым НЕ должен быть указанный сервис. Варианты:
|
|
ippool string |
Включить использование пулов IP-адресов для source NAT. Варианты:
|
|
ips_sensor aliases: ips-sensor string |
Имя существующего датчика IPS. |
|
logtraffic string |
Включить или отключить ведение журнала. Варианты:
|
|
logtraffic_start псевдонимы: logtraffic-start string |
Записывать журналы при запуске сеанса. Варианты:
|
|
mms_profile псевдонимы: mms-profile string |
Имя существующего профиля MMS. |
|
name string |
Имя политики. |
|
nat string |
Включить/отключить исходный NAT. Варианты:
|
|
outbound string |
Политика VPN IPsec на основе политики Варианты:
|
|
per_ip_shaper псевдонимы: per-ip-shaper string |
Формирователь трафика для каждого IP-адреса. |
|
policyid integer / обязательный |
Идентификатор политики |
|
poolname4 any |
(list or str) Имена пулов IPv4. |
|
poolname6 any |
(list or str) Имена пулов IPv6. |
|
profile_group псевдонимы: profile-group string |
Имя группы профилей. |
|
profile_protocol_options псевдонимы: profile-protocol-options string |
Имя существующего профиля параметров протокола. |
|
profile_type псевдонимы: profile-type string |
Определяет, разрешает ли политика брандмауэра группы профилей безопасности или только отдельные профили. Варианты:
|
|
schedule string |
Имя расписания. |
|
service any |
(list or str) Имена служб и групп служб. |
|
service_negate псевдонимы: service-negate string |
Если параметр включен, service указывает, чем служба НЕ должна быть. Варианты:
|
|
session_ttl псевдонимы: session-ttl integer |
Время жизни (TTL) в секундах для сеансов, разрешенных этой политикой |
|
srcaddr4 any |
(list or str) Имя исходного адреса IPv4 и имена групп адресов. |
|
srcaddr6 any |
(list or str) Имя исходного адреса IPv6 и имена групп адресов. |
|
srcaddr_negate псевдонимы: srcaddr-negate string |
Если параметр включен, srcaddr указывает, чем исходный адрес НЕ должен быть. Варианты:
|
|
srcintf any |
(list or str) Входящий интерфейс |
|
ssh_filter_profile псевдонимы: ssh-filter-profile string |
Имя существующего профиля фильтрации SSH. |
|
ssh_policy_redirect псевдонимы: ssh-policy-redirect string |
Перенаправлять трафик SSH в соответствующую политику прозрачного прокси-сервера. Варианты:
|
|
ssl_ssh_profile псевдонимы: ssl-ssh-profile string |
Имя существующего профиля SSL SSH. |
|
status string |
Включить или отключить эту политику. Варианты:
|
|
tcp_mss_receiver псевдонимы: tcp-mss-receiver integer |
Максимальный размер сегмента TCP для получателя |
|
tcp_mss_sender псевдонимы: tcp-mss-sender integer |
Максимальный размер сегмента TCP для отправителя |
|
traffic_shaper псевдонимы: traffic-shaper string |
Формирователь трафика. |
|
traffic_shaper_reverse псевдонимы: traffic-shaper-reverse string |
Формирователь обратного трафика. |
|
url_category псевдонимы: url-category any |
(list or str) Список идентификаторов категорий URL. |
|
users any |
(list or str) Имена отдельных пользователей, которые могут проходить аутентификацию с помощью этой политики. |
|
utm_status псевдонимы: utm-status string |
Включить добавление одного или нескольких профилей безопасности Варианты:
|
|
uuid string |
Универсальный уникальный идентификатор |
|
voip_profile псевдонимы: voip-profile string |
Имя существующего профиля VoIP. |
|
vpntunnel string |
Политика VPN IPsec на основе политики |
|
waf_profile псевдонимы: waf-profile string |
Имя существующего профиля веб-брандмауэра приложений. |
|
wanopt string |
Включить/отключить оптимизацию WAN. Варианты:
|
|
wanopt_detection псевдонимы: wanopt-detection string |
Режим автоматического обнаружения оптимизации WAN. Варианты:
|
|
wanopt_passive_opt псевдонимы: wanopt-passive-opt string |
Параметры пассивного режима оптимизации WAN. Варианты:
|
|
wanopt_peer псевдонимы: wanopt-peer string |
Узел-партнер оптимизации WAN. |
|
wanopt_profile псевдонимы: wanopt-profile string |
Профиль оптимизации WAN. |
|
webcache string |
Включить/отключить веб-кэш. Варианты:
|
|
webcache_https псевдонимы: webcache-https string |
Включить/отключить веб-кэш для HTTPS. Варианты:
|
|
webfilter_profile псевдонимы: webfilter-profile string |
Имя существующего профиля веб-фильтрации. |
|
webproxy_forward_server псевдонимы: webproxy-forward-server string |
Имя сервера пересылки веб-прокси. |
|
webproxy_profile псевдонимы: webproxy-profile string |
Имя профиля веб-прокси. |
proposed_method string | Переопределенный метод для базового запроса Json RPC. Варианты:
|
rc_failed list / элементы=integer | Список кодов rc, для которых будут переопределены условия сбоя. |
rc_succeeded list / элементы=integer | Список кодов rc, для которых будут переопределены условия успешного выполнения. |
revision_note string | Примечание об изменении, которое можно указать при создании или обновлении объекта. |
state string / обязательный | Указание на создание, обновление или удаление объекта. Варианты:
|
workspace_locking_adom string | ADOM, который нужно заблокировать для FortiManager, работающего в режиме рабочей области. Значением может быть global, а также другие ADOM, включая root. |
workspace_locking_timeout integer | Максимальное время в секундах ожидания снятия блокировки рабочей области другим пользователем. По умолчанию: |
Примечания
Примечание
- Начиная с версии 2.4.0, все входные аргументы именуются в соответствии с соглашением об именовании с подчёркиванием (snake_case). Замените аргументы, например «var-name», на «var_name». Старые имена аргументов по-прежнему доступны, но вы будете получать предупреждения об устаревании. Это предупреждение можно игнорировать, установив deprecation_warnings=False в ansible.cfg.
- В этом модуле FortiManager поддерживается работа в режиме блокировки рабочей области; для этого предназначены параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout.
- Обычно выполнение модуля может завершиться ошибкой, если возвращается ненулевой код rc. Условия завершения с ошибкой или успехом также можно переопределить с помощью параметров rc_failed и rc_succeeded
- Чтобы создать или обновить объект, используйте директиву state present.
- Чтобы удалить объект, используйте директиву state absent.
Примеры
- name: Example playbook (generated based on argument schema)
hosts: fortimanagers
connection: httpapi
gather_facts: false
tasks:
- name: Configure consolidated IPv4/IPv6 policies.
fortinet.fortimanager.fmgr_pkg_firewall_consolidated_policy:
# workspace_locking_adom: <global or your adom name>
adom: <your own value>
pkg: <your own value>
state: present # <value in [present, absent]>
pkg_firewall_consolidated_policy:
policyid: 0 # Required variable, 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>
# 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>
# 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 dictionary | Результат запроса. Возвращается: всегда |
|
request_url string |
Полный URL запроса. Возвращается: всегда Пример: |
|
response_code integer |
Статус запроса API. Возвращается: всегда Пример: |
|
response_data list / elements=string |
Ответ API. Возвращается: всегда |
|
response_message string |
Описание ответа API. Возвращается: всегда Пример: |
|
system_information dictionary |
Информация о целевой системе. Возвращается: всегда |
rc integer | Статус запроса. Возвращается: всегда Пример: |
version_check_warning list / elements=string | Предупреждение о том, что используемые в плейбуке параметры не поддерживаются текущей версией FortiManager. Возвращается: при сложном условии |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortimanager/fmgr_pkg_firewall_consolidated_policy_module.html