Spec-Zone.ru › Ansible

Модуль fortinet.fortios.fortios_firewall_policy — настройка политик IPv4/IPv6 в Fortinet FortiOS и FortiGate.

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля требуются дополнительные компоненты. Подробности см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: fortinet.fortios.fortios_firewall_policy.

Добавлено в fortinet.fortios 2.0.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя параметры функций и категорий политик брандмауэра. Примеры содержат все параметры и значения, которые перед использованием необходимо адаптировать к источникам данных. Протестировано с FOS v6.0.0

Требования

Следующие требования должны быть выполнены на узле, выполняющем этот модуль.

  • ansible>=2.16

Параметры

Параметр

Комментарии

access_token

string

Аутентификация на основе токена. Создается в графическом интерфейсе Fortigate.

action

string

индикатор действия для перемещения объекта в списке

Варианты:

  • "move"

after

string

mkey целевого идентификатора

before

string

mkey целевого идентификатора

enable_log

boolean

Включить/отключить ведение журнала для задачи.

Варианты:

  • false ← (по умолчанию)
  • true

firewall_policy

dictionary

Настройка политик IPv4/IPv6.

action

string

Действие политики (accept/deny/ipsec).

Варианты:

  • "accept"
  • "deny"
  • "ipsec"

anti_replay

string

Включить/отключить проверку защиты от повторного воспроизведения.

Варианты:

  • "enable"
  • "disable"

app_category

list / elements=dictionary

Список идентификаторов категорий приложений.

id

integer / required

Идентификаторы категорий. См. <a href=’#notes’>Примечания</a>.

app_group

list / elements=dictionary

Имена групп приложений.

name

string / required

Имена групп приложений. Источник: application.group.name.

app_monitor

string

Включить/отключить метрики TCP приложений в журналах сеансов. При включении auto-asic-offload отключается.

Варианты:

  • "enable"
  • "disable"

application

list / elements=dictionary

Список идентификаторов приложений.

id

integer / required

Идентификаторы приложений. См. <a href=’#notes’>Примечания</a>.

application_list

string

Имя существующего списка приложений. Источник: application.list.name.

auth_cert

string

Сертификат HTTPS-сервера для аутентификации политики. Источник: vpn.certificate.local.name.

auth_path

string

Включить/отключить маршрутизацию на основе аутентификации.

Варианты:

  • "enable"
  • "disable"

auth_redirect_addr

string

Адрес перенаправления HTTP на HTTPS для аутентификации межсетевого экрана.

auto_asic_offload

string

Включить/отключить выгрузку трафика политики на ASIC.

Варианты:

  • "enable"
  • "disable"

av_profile

string

Имя существующего антивирусного профиля. Источник: antivirus.profile.name.

block_notification

string

Включить/отключить уведомление о блокировке.

Варианты:

  • "enable"
  • "disable"

captive_portal_exempt

string

Разрешить исключение некоторых пользователей из проверки через портал авторизации.

Варианты:

  • "enable"
  • "disable"

capture_packet

string

Включить/отключить захват пакетов.

Варианты:

  • "enable"
  • "disable"

casb_profile

string

Имя существующего профиля CASB. Источник: casb.profile.name.

cifs_profile

string

Имя существующего профиля CIFS. Источник: cifs.profile.name.

comments

string

Комментарий.

custom_log_fields

list / elements=dictionary

Пользовательские поля, добавляемые в сообщения журнала для этой политики.

field_id

string / required

Пользовательское поле журнала. Источник: log.custom-field.id.

decrypted_traffic_mirror

string

Зеркалирование расшифрованного трафика. Источник: firewall.decrypted-traffic-mirror.name.

delay_tcp_npu_session

string

Включить задержку сеанса TCP NPU, чтобы гарантировать порядок пакетов при трехэтапном рукопожатии.

Варианты:

  • "enable"
  • "disable"

devices

list / elements=dictionary

Имена устройств или групп устройств, соответствующих политике.

name

string / required

Имя устройства или группы. Источник: user.device.alias user.device-group.name user.device-category.name.

diameter_filter_profile

string

Имя существующего профиля фильтра Diameter. Источник: diameter-filter.profile.name.

diffserv_copy

string

Включить копирование значений DiffServ пакета из исходного направления сеанса в обратное направление.

Варианты:

  • "enable"
  • "disable"

diffserv_forward

string

Включить изменение значений DiffServ пакета на указанное значение diffservcode-forward.

Варианты:

  • "enable"
  • "disable"

diffserv_reverse

string

Включить изменение обратных (ответных) значений DiffServ пакета на указанное значение diffservcode-rev.

Варианты:

  • "enable"
  • "disable"

diffservcode_forward

string

Изменить значение DiffServ пакета на это значение.

diffservcode_rev

string

Изменить обратное (ответное) значение DiffServ пакета на это значение.

disclaimer

string

Включить/отключить уведомление об отказе от ответственности при аутентификации пользователя.

Варианты:

  • "enable"
  • "disable"

dlp_profile

string

Имя существующего профиля DLP. Источник: dlp.profile.name.

dlp_sensor

string

Имя существующего датчика DLP. Источник: dlp.sensor.name.

dnsfilter_profile

string

Имя существующего профиля фильтрации DNS. Источник: dnsfilter.profile.name.

dscp_match

string

Включить проверку DSCP.

Варианты:

  • "enable"
  • "disable"

dscp_negate

string

Включить инвертированное сопоставление DSCP.

Варианты:

  • "enable"
  • "disable"

dscp_value

string

Значение DSCP.

dsri

string

Включить DSRI, чтобы игнорировать ответы HTTP-сервера.

Варианты:

  • "enable"
  • "disable"

dstaddr

list / elements=dictionary

Адрес назначения IPv4 и имена групп адресов.

name

string / required

Имя адреса. Источник: firewall.address.name firewall.addrgrp.name firewall.vip.name firewall.vipgrp.name system.external-resource .name.

dstaddr6

list / elements=dictionary

Имя адреса назначения IPv6 и имена групп адресов.

name

string / required

Имя адреса. Источник: firewall.address6.name firewall.addrgrp6.name firewall.vip6.name firewall.vipgrp6.name system .external-resource.name.

dstaddr6_negate

string

Если параметр включен, dstaddr6 указывает, каким НЕ должен быть адрес назначения.

Варианты:

  • "enable"
  • "disable"

dstaddr_negate

string

Если параметр включен, dstaddr указывает, каким НЕ должен быть адрес назначения.

Варианты:

  • "enable"
  • "disable"

dstintf

list / elements=dictionary

Исходящий интерфейс.

name

string / required

Имя интерфейса. Источник: system.interface.name system.zone.name system.sdwan.zone.name.

dynamic_shaping

string

Включить/отключить динамическое управление трафиком, задаваемое через RADIUS.

Варианты:

  • "enable"
  • "disable"

email_collect

string

Включить/отключить сбор адресов электронной почты.

Варианты:

  • "enable"
  • "disable"

emailfilter_profile

string

Имя существующего профиля фильтрации электронной почты. Источник: emailfilter.profile.name.

fec

string

Включить/отключить прямую коррекцию ошибок для трафика, соответствующего этой политике на устройстве FEC.

Варианты:

  • "enable"
  • "disable"

file_filter_profile

string

Имя существующего профиля фильтрации файлов. Источник: file-filter.profile.name.

firewall_session_dirty

string

Способ обработки сеансов при изменении конфигурации этой политики брандмауэра.

Варианты:

  • "check-all"
  • "check-new"

fixedport

string

Включите, чтобы запретить преобразованию исходных адресов (NAT) изменять исходный порт сеанса.

Варианты:

  • "enable"
  • "disable"

fsso

string

Включить или отключить Fortinet Single Sign-On.

Варианты:

  • "enable"
  • "disable"

fsso_agent_for_ntlm

string

Агент FSSO для аутентификации NTLM. Источник: user.fsso.name.

fsso_groups

list / elements=dictionary

Названия групп FSSO.

name

string / required

Названия групп FSSO. Источник: user.adgrp.name.

geoip_anycast

string

Включить или отключить распознавание anycast IP-адресов с использованием географической базы данных IP-адресов.

Варианты:

  • "enable"
  • "disable"

geoip_match

string

Сопоставлять географический адрес на основе его физического или зарегистрированного местоположения.

Варианты:

  • "physical-location"
  • "registered-location"

global_label

string

Метка политики, отображаемая, когда графический интерфейс работает в режиме глобального представления.

groups

list / elements=dictionary

Названия групп пользователей, которые могут проходить аутентификацию по этой политике.

name

string / required

Имя группы. Источник: user.group.name.

gtp_profile

string

Профиль GTP. Источник: firewall.gtp.name.

http_policy_redirect

string

Перенаправлять трафик HTTP(S) в соответствующую политику прозрачного веб-прокси.

Варианты:

  • "enable"
  • "disable"
  • "legacy"

icap_profile

string

Имя существующего профиля ICAP. Источник: icap.profile.name.

identity_based_route

string

Имя правила маршрутизации на основе идентификаторов. Источник: firewall.identity-based-route.name.

inbound

string

IPsec VPN на основе политик: инициировать VPN может только трафик из удалённой сети.

Варианты:

  • "enable"
  • "disable"

inspection_mode

string

Режим проверки политики (потоковый или прокси). По умолчанию используется потоковый режим.

Варианты:

  • "proxy"
  • "flow"

internet_service

string

Включить или отключить использование интернет-сервисов для этой политики. Если параметр включён, адрес назначения и сервис не используются.

Варианты:

  • "enable"
  • "disable"

internet_service6

string

Включить или отключить использование интернет-сервисов IPv6 для этой политики. Если параметр включён, адрес назначения и сервис не используются.

Варианты:

  • "enable"
  • "disable"

internet_service6_custom

list / elements=dictionary

Имя пользовательского интернет-сервиса IPv6.

name

string / required

Имя пользовательского интернет-сервиса. Источник: firewall.internet-service-custom.name.

internet_service6_custom_group

list / elements=dictionary

Имя группы пользовательских интернет-сервисов IPv6.

name

string / required

Имя группы пользовательских интернет-сервисов IPv6. Источник: firewall.internet-service-custom-group.name.

internet_service6_fortiguard

list / elements=dictionary

Имя интернет-сервиса IPv6 FortiGuard.

name

string / required

Имя интернет-сервиса FortiGuard. Источник: firewall.internet-service-fortiguard.name.

internet_service6_group

list / elements=dictionary

Имя группы интернет-сервисов.

name

string / required

Имя группы интернет-сервисов. Источник: firewall.internet-service-group.name.

internet_service6_name

list / elements=dictionary

Имя интернет-сервиса IPv6.

name

string / required

Имя интернет-сервиса IPv6. Источник: firewall.internet-service-name.name.

internet_service6_negate

string

Если параметр включён, internet-service6 указывает, каким сервис НЕ должен быть.

Варианты:

  • "enable"
  • "disable"

internet_service6_src

string

Включить или отключить использование интернет-сервисов IPv6 в качестве источника для этой политики. Если параметр включён, адрес источника не используется.

Варианты:

  • "enable"
  • "disable"

internet_service6_src_custom

list / elements=dictionary

Имя пользовательского интернет-сервиса IPv6 для источника.

name

string / required

Имя пользовательского интернет-сервиса. Источник: firewall.internet-service-custom.name.

internet_service6_src_custom_group

list / elements=dictionary

Имя группы пользовательских интернет-сервисов IPv6 для источника.

name

string / required

Имя группы пользовательских интернет-сервисов IPv6. Источник: firewall.internet-service-custom-group.name.

internet_service6_src_fortiguard

list / elements=dictionary

Имя интернет-сервиса IPv6 FortiGuard для источника.

name

string / required

Имя интернет-сервиса FortiGuard. Источник: firewall.internet-service-fortiguard.name.

internet_service6_src_group

list / elements=dictionary

Имя группы интернет-сервисов IPv6 для источника.

name

string / required

Имя группы интернет-сервисов. Источник: firewall.internet-service-group.name.

internet_service6_src_name

list / elements=dictionary

Имя интернет-сервиса IPv6 для источника.

name

string / required

Имя интернет-сервиса. Источник: firewall.internet-service-name.name.

internet_service6_src_negate

string

Если параметр включён, internet-service6-src указывает, каким сервис НЕ должен быть.

Варианты:

  • "enable"
  • "disable"

internet_service_custom

list / elements=dictionary

Имя пользовательского интернет-сервиса.

name

string / required

Имя пользовательского интернет-сервиса. Источник: firewall.internet-service-custom.name.

internet_service_custom_group

list / elements=dictionary

Имя группы пользовательских интернет-сервисов.

name

string / required

Имя группы пользовательских интернет-сервисов. Источник: firewall.internet-service-custom-group.name.

internet_service_fortiguard

list / elements=dictionary

Имя интернет-сервиса FortiGuard.

name

string / required

Имя интернет-сервиса FortiGuard. Источник: firewall.internet-service-fortiguard.name.

internet_service_group

list / elements=dictionary

Имя группы интернет-сервисов.

name

string / required

Имя группы интернет-сервисов. Источник: firewall.internet-service-group.name.

internet_service_id

list / elements=dictionary

Идентификатор интернет-сервиса.

id

integer / required

Идентификатор интернет-сервиса. См. <a href=’#notes’>Примечания</a>. Источник: firewall.internet-service.id.

internet_service_name

list / elements=dictionary

Имя интернет-сервиса.

name

string / required

Имя интернет-сервиса. Источник: firewall.internet-service-name.name.

internet_service_negate

string

Если параметр включён, internet-service указывает, каким сервис НЕ должен быть.

Варианты:

  • "enable"
  • "disable"

internet_service_src

string

Включить или отключить использование интернет-сервисов в качестве источника для этой политики. Если параметр включён, адрес источника не используется.

Варианты:

  • "enable"
  • "disable"

internet_service_src_custom

list / elements=dictionary

Имя источника пользовательской интернет-службы.

name

string / required

Имя пользовательской интернет-службы. Источник: firewall.internet-service-custom.name.

internet_service_src_custom_group

list / elements=dictionary

Имя группы источников пользовательских интернет-служб.

name

string / required

Имя группы пользовательских интернет-служб. Источник: firewall.internet-service-custom-group.name.

internet_service_src_fortiguard

list / elements=dictionary

Имя источника интернет-службы FortiGuard.

name

string / required

Имя интернет-службы FortiGuard. Источник: firewall.internet-service-fortiguard.name.

internet_service_src_group

list / elements=dictionary

Имя группы источников интернет-служб.

name

string / required

Имя группы интернет-служб. Источник: firewall.internet-service-group.name.

internet_service_src_id

list / elements=dictionary

Идентификатор источника интернет-службы.

id

integer / required

Идентификатор интернет-службы. См. <a href=’#notes’>Примечания</a>. Источник: firewall.internet-service.id.

internet_service_src_name

list / elements=dictionary

Имя источника интернет-службы.

name

string / required

Имя интернет-службы. Источник: firewall.internet-service-name.name.

internet_service_src_negate

string

Если параметр включен, internet-service-src указывает, какой службой НЕ должен быть трафик.

Варианты:

  • "enable"
  • "disable"

ippool

string

Включите, чтобы использовать пулы IP-адресов для исходящего NAT.

Варианты:

  • "enable"
  • "disable"

ips_sensor

string

Имя существующего датчика IPS. Источник: ips.sensor.name.

ips_voip_filter

string

Имя существующего профиля VoIP (ips). Источник: voip.profile.name.

label

string

Метка политики, отображаемая в графическом интерфейсе в режиме просмотра разделов.

learning_mode

string

Включите, чтобы разрешить всё, но регистрировать все значимые данные для сбора сведений о безопасности. Будет создан отчет об обучении.

Варианты:

  • "enable"
  • "disable"

log_http_transaction

string

Включить или отключить журналирование HTTP-транзакций.

Варианты:

  • "enable"
  • "disable"

logtraffic

string

Включить или отключить журналирование. Регистрировать все сеансы или сеансы, относящиеся к профилям безопасности.

Варианты:

  • "all"
  • "utm"
  • "disable"

logtraffic_start

string

Записывать журналы при начале сеанса.

Варианты:

  • "enable"
  • "disable"

match_vip

string

Включите, чтобы сопоставлять пакеты, адреса назначения которых были изменены с помощью VIP.

Варианты:

  • "enable"
  • "disable"

match_vip_only

string

Включить или отключить сопоставление только тех пакетов, адреса назначения которых были изменены с помощью VIP.

Варианты:

  • "enable"
  • "disable"

mms_profile

string

Имя существующего профиля MMS. Источник: firewall.mms-profile.name.

name

string

Имя политики.

nat

string

Включить или отключить исходящий NAT.

Варианты:

  • "enable"
  • "disable"

nat46

string

Включить или отключить NAT46.

Варианты:

  • "enable"
  • "disable"

nat64

string

Включить или отключить NAT64.

Варианты:

  • "enable"
  • "disable"

natinbound

string

IPsec VPN на основе политик: применять NAT назначения к входящему трафику.

Варианты:

  • "enable"
  • "disable"

natip

string

IPsec VPN на основе политик: IP-адрес исходящего NAT для исходящего трафика.

natoutbound

string

IPsec VPN на основе политик: применять исходящий NAT к исходящему трафику.

Варианты:

  • "enable"
  • "disable"

network_service_dynamic

list / elements=dictionary

Имя динамической сетевой службы.

name

string / required

Имя динамической сетевой службы. Источник: firewall.network-service-dynamic.name.

network_service_src_dynamic

list / elements=dictionary

Имя динамического источника сетевой службы.

name

string / required

Имя динамической сетевой службы. Источник: firewall.network-service-dynamic.name.

np_acceleration

string

Включить или отключить ускорение сетевого процессора UTM.

Варианты:

  • "enable"
  • "disable"

ntlm

string

Включить или отключить аутентификацию NTLM.

Варианты:

  • "enable"
  • "disable"

ntlm_enabled_browsers

list / elements=dictionary

Значение HTTP-заголовка User-Agent для поддерживаемых браузеров.

user_agent_string

string / required

Строка агента пользователя.

ntlm_guest

string

Включить или отключить доступ гостевых пользователей по NTLM.

Варианты:

  • "enable"
  • "disable"

outbound

string

IPsec VPN на основе политик: инициировать VPN может только трафик из внутренней сети.

Варианты:

  • "enable"
  • "disable"

passive_wan_health_measurement

string

Включить или отключить пассивное измерение состояния WAN. При включении параметр auto-asic-offload отключается.

Варианты:

  • "enable"
  • "disable"

pcp_inbound

string

Включить или отключить входящий DNAT PCP.

Варианты:

  • "enable"
  • "disable"

pcp_outbound

string

Включить или отключить исходящий SNAT PCP.

Варианты:

  • "enable"
  • "disable"

pcp_poolname

list / elements=dictionary

Имена пулов PCP.

name

string / required

Имя пула PCP. Источник: system.pcp-server.pools.name.

per_ip_shaper

string

Формирователь трафика для каждого IP-адреса. Источник: firewall.shaper.per-ip-shaper.name.

permit_any_host

string

Включить или отключить NAT с полным конусом. Принимать UDP-пакеты от любого узла.

Варианты:

  • "enable"
  • "disable"

permit_stun_host

string

Принимать UDP-пакеты от любого узла STUN (Session Traversal Utilities for NAT).

Варианты:

  • "enable"
  • "disable"

pfcp_profile

string

Профиль PFCP. Источник: firewall.pfcp.name.

policy_expiry

string

Включить или отключить срок действия политики.

Варианты:

  • "enable"
  • "disable"

policy_expiry_date

string

Дата окончания срока действия политики (YYYY-MM-DD HH:MM:SS).

policy_expiry_date_utc

string

Дата и время окончания срока действия политики в формате эпохи.

policyid

integer / required

Идентификатор политики (0–4294967294). См. <a href=’#notes’>Примечания</a>.

poolname

list / elements=dictionary

Имена пулов IP-адресов.

name

string / required

Имя пула IP-адресов. Источник: firewall.ippool.name.

poolname6

list / elements=dictionary

Имена пулов IPv6.

name

string / обязательный

Имя пула IPv6. Источник: firewall.ippool6.name.

port_preserve

string

Включить или отключить сохранение исходного порта источника для source NAT, если он не использовался.

Варианты:

  • "enable"
  • "disable"

port_random

string

Включить или отключить случайный выбор порта источника для source NAT.

Варианты:

  • "enable"
  • "disable"

profile_group

string

Имя группы профилей. Источник: firewall.profile-group.name.

profile_protocol_options

string

Имя существующего профиля параметров протокола. Источник: firewall.profile-protocol-options.name.

profile_type

string

Указывает, разрешает ли политика брандмауэра использовать группы профилей безопасности или только отдельные профили.

Варианты:

  • "single"
  • "group"

radius_ip_auth_bypass

string

Включить обход аутентификации по IP-адресу. Обходимый IP-адрес должен быть получен от сервера RADIUS.

Варианты:

  • "enable"
  • "disable"

radius_mac_auth_bypass

string

Включить обход аутентификации по MAC-адресу. Обходимый MAC-адрес должен быть получен от сервера RADIUS.

Варианты:

  • "enable"
  • "disable"

redirect_url

string

URL, на который перенаправляются пользователи после просмотра и принятия уведомления об отказе от ответственности или прохождения аутентификации.

replacemsg_override_group

string

Переопределить группу сообщений замены по умолчанию для этой политики. Источник: system.replacemsg-group.name.

reputation_direction

string

Направление начального трафика, при котором применяется проверка репутации.

Варианты:

  • "source"
  • "destination"

reputation_direction6

string

Направление начального трафика IPv6, при котором применяется проверка репутации.

Варианты:

  • "source"
  • "destination"

reputation_minimum

integer

Минимальный уровень репутации для выполнения действия. Источник: firewall.internet-service-reputation.id.

reputation_minimum6

integer

Минимальный уровень репутации IPv6 для выполнения действия. Источник: firewall.internet-service-reputation.id.

rsso

string

Включить или отключить единую регистрацию RADIUS (RSSO).

Варианты:

  • "enable"
  • "disable"

rtp_addr

list / elements=dictionary

Имена адресов, если это политика NAT для RTP.

name

string / обязательный

Имя адреса. Источник: firewall.internet-service-custom-group.name firewall.addrgrp.name.

rtp_nat

string

Включить NAT для протокола реального времени (RTP).

Варианты:

  • "disable"
  • "enable"

saml_server

string

Имя сервера SAML. Источник: user.saml.name.

scan_botnet_connections

string

Блокировать или отслеживать подключения к серверам ботнетов либо отключить проверку на наличие ботнетов.

Варианты:

  • "disable"
  • "block"
  • "monitor"

schedule

string

Имя расписания. Источник: firewall.schedule.onetime.name firewall.schedule.recurring.name firewall.schedule.group.name.

schedule_timeout

string

Включить принудительное завершение текущих сеансов по истечении срока действия объекта расписания. Если отключено, сеансы завершаются при отсутствии активности.

Варианты:

  • "enable"
  • "disable"

scim

string

Включить или отключить SCIM.

Варианты:

  • "enable"
  • "disable"

scim_groups

list / elements=dictionary

Имена групп SCIM.

name

string / обязательный

Имена групп SCIM.

scim_users

list / elements=dictionary

Имена пользователей SCIM.

name

string / обязательный

Имена пользователей SCIM.

sctp_filter_profile

string

Имя существующего профиля фильтрации SCTP. Источник: sctp-filter.profile.name.

send_deny_packet

string

Включить отправку ответа, если сеанс отклонен или заблокирован политикой брандмауэра.

Варианты:

  • "disable"
  • "enable"

service

list / elements=dictionary

Имена служб и групп служб.

name

string / обязательный

Имена служб и групп служб. Источник: firewall.service.custom.name firewall.service.group.name.

service_negate

string

Если параметр включен, service задает службу, которой НЕ должна быть служба.

Варианты:

  • "enable"
  • "disable"

session_ttl

string

Время жизни (TTL) в секундах для сеансов, разрешенных этой политикой (0 означает использование системного значения).

sgt

list / elements=dictionary

Теги групп безопасности.

id

integer / обязательный

Тег группы безопасности (1–65535). См. <a href=’#notes’>Примечания</a>.

sgt_check

string

Включить или отключить проверку тегов групп безопасности (SGT).

Варианты:

  • "enable"
  • "disable"

spamfilter_profile

string

Имя существующего профиля фильтрации спама. Источник: spamfilter.profile.name.

src_vendor_mac

list / elements=dictionary

Идентификатор MAC-адреса производителя источника.

id

integer / обязательный

Идентификатор MAC-адреса производителя. См. <a href=’#notes’>Примечания</a>. Источник: firewall.vendor-mac.id.

srcaddr

list / elements=dictionary

Имена исходных IPv4-адресов и групп адресов.

name

string / обязательный

Имя адреса. Источник: firewall.address.name firewall.addrgrp.name system.external-resource.name.

srcaddr6

list / elements=dictionary

Имя исходного IPv6-адреса и имена групп адресов.

name

string / обязательный

Имя адреса. Источник: firewall.address6.name system.external-resource.name firewall.addrgrp6.name.

srcaddr6_negate

string

Если параметр включен, srcaddr6 задает адрес, которым НЕ должен быть адрес источника.

Варианты:

  • "enable"
  • "disable"

srcaddr_negate

string

Если параметр включен, srcaddr задает адрес, которым НЕ должен быть адрес источника.

Варианты:

  • "enable"
  • "disable"

srcintf

list / elements=dictionary

Входящий интерфейс.

name

string / обязательный

Имя интерфейса. Источник: system.interface.name system.zone.name system.sdwan.zone.name.

ssh_filter_profile

string

Имя существующего профиля фильтрации SSH. Источник: ssh-filter.profile.name.

ssh_policy_redirect

string

Перенаправлять трафик SSH в соответствующую политику прозрачного прокси.

Варианты:

  • "enable"
  • "disable"

ssl_mirror

string

Включить копирование расшифрованного SSL-трафика на интерфейс FortiGate (называется зеркалированием SSL).

Варианты:

  • "enable"
  • "disable"

ssl_mirror_intf

list / elements=dictionary

Имя интерфейса зеркалирования SSL.

name

string / обязательный

Имя интерфейса зеркалирования. Источник: system.interface.name system.zone.name.

ssl_ssh_profile

string

Имя существующего профиля SSL SSH. Источник: firewall.ssl-ssh-profile.name.

status

string

Включить или отключить эту политику.

Варианты:

  • "enable"
  • "disable"

tcp_mss_receiver

integer

Максимальный размер сегмента TCP (MSS) для получателя.

tcp_mss_sender

integer

Максимальный размер сегмента TCP (MSS) для отправителя.

tcp_session_without_syn

string

Включить или отключить создание сеанса TCP без флага SYN.

Варианты:

  • "all"
  • "data-only"
  • "disable"

telemetry_profile

string

Имя существующего профиля телеметрии. Источник: telemetry-controller.profile.name.

timeout_send_rst

string

Включить/отключить отправку пакетов RST по истечении срока действия сеансов TCP.

Варианты:

  • "enable"
  • "disable"

tos

string

Значение ToS (Type of Service), используемое для сравнения.

tos_mask

string

Для сравнения используются ненулевые позиции битов, а нулевые позиции игнорируются.

tos_negate

string

Включить инвертированное сопоставление TOS.

Варианты:

  • "enable"
  • "disable"

traffic_shaper

string

Формирователь трафика. Источник: firewall.shaper.traffic-shaper.name.

traffic_shaper_reverse

string

Формирователь обратного трафика. Источник: firewall.shaper.traffic-shaper.name.

url_category

list / elements=dictionary

Список идентификаторов категорий URL.

id

integer / обязательный

Идентификатор категории URL. См. <a href=’#notes’>примечания</a>.

users

list / elements=dictionary

Имена отдельных пользователей, которые могут проходить аутентификацию по этой политике.

name

string / обязательный

Имена отдельных пользователей, которые могут проходить аутентификацию по этой политике. Источник: user.local.name user.certificate.name.

utm_status

string

Включить добавление одного или нескольких профилей безопасности (AV, IPS и т. д.) в политику брандмауэра.

Варианты:

  • "enable"
  • "disable"

uuid

string

Универсальный уникальный идентификатор (UUID; назначается автоматически, но может быть сброшен вручную).

videofilter_profile

string

Имя существующего профиля VideoFilter. Источник: videofilter.profile.name.

virtual_patch_profile

string

Имя существующего профиля virtual-patch. Источник: virtual-patch.profile.name.

vlan_cos_fwd

integer

Приоритет пользователя для прямого направления VLAN: 255 — без изменений, 0 — наименьший, 7 — наибольший.

vlan_cos_rev

integer

Приоритет пользователя для обратного направления VLAN: 255 — без изменений, 0 — наименьший, 7 — наибольший.

vlan_filter

string

Разрешенные диапазоны VLAN

voip_profile

string

Имя существующего профиля VoIP (voipd). Источник: voip.profile.name.

vpntunnel

string

Политика на основе IPsec VPN: имя фазы 1 IPsec VPN. Источник: vpn.ipsec.phase1.name vpn.ipsec.manualkey.name.

waf_profile

string

Имя существующего профиля брандмауэра веб-приложений. Источник: waf.profile.name.

wanopt

string

Включить/отключить оптимизацию WAN.

Варианты:

  • "enable"
  • "disable"

wanopt_detection

string

Режим автоматического обнаружения оптимизации WAN.

Варианты:

  • "active"
  • "passive"
  • "off"

wanopt_passive_opt

string

Параметры пассивного режима оптимизации WAN. Этот параметр определяет, какой IP-адрес будет использоваться для подключения к серверу.

Варианты:

  • "default"
  • "transparent"
  • "non-transparent"

wanopt_peer

string

Пир оптимизации WAN. Источник: wanopt.peer.peer-host-id.

wanopt_profile

string

Профиль оптимизации WAN. Источник: wanopt.profile.name.

wccp

string

Включить/отключить перенаправление трафика, соответствующего этой политике, на настроенный сервер WCCP.

Варианты:

  • "enable"
  • "disable"

webcache

string

Включить/отключить веб-кэш.

Варианты:

  • "enable"
  • "disable"

webcache_https

string

Включить/отключить веб-кэш для HTTPS.

Варианты:

  • "disable"
  • "enable"

webfilter_profile

string

Имя существующего профиля веб-фильтра. Источник: webfilter.profile.name.

webproxy_forward_server

string

Имя сервера перенаправления Webproxy. Источник: web-proxy.forward-server.name web-proxy.forward-server-group.name.

webproxy_profile

string

Имя профиля Webproxy. Источник: web-proxy.profile.name.

wsso

string

Включить/отключить единую регистрацию WiFi (WSSO).

Варианты:

  • "enable"
  • "disable"

ztna_device_ownership

string

Включить/отключить владение устройством в модели нулевого доверия.

Варианты:

  • "enable"
  • "disable"

ztna_ems_tag

list / elements=dictionary

Имена исходных тегов ztna-ems-tag.

name

string / обязательный

Имя адреса. Источник: firewall.address.name firewall.addrgrp.name.

ztna_ems_tag_negate

string

Если параметр включен, ztna-ems-tag указывает, какими НЕ должны быть теги.

Варианты:

  • "enable"
  • "disable"

ztna_ems_tag_secondary

list / elements=dictionary

Имена исходных тегов ztna-ems-tag-secondary.

name

string / обязательный

Имя адреса. Источник: firewall.address.name firewall.addrgrp.name.

ztna_geo_tag

list / elements=dictionary

Имена исходных тегов ztna-geo-tag.

name

string / обязательный

Имя адреса. Источник: firewall.address.name firewall.addrgrp.name.

ztna_policy_redirect

string

Перенаправлять трафик ZTNA в соответствующую политику proxy-policy для Access-Proxy.

Варианты:

  • "enable"
  • "disable"

ztna_status

string

Включить/отключить доступ с нулевым доверием.

Варианты:

  • "enable"
  • "disable"

ztna_tags_match_logic

string

Логика сопоставления тегов ZTNA.

Варианты:

  • "or"
  • "and"

member_path

string

Путь к атрибуту элемента, над которым выполняется операция.

Если атрибутов несколько, они разделяются символом косой черты.

Параметр с признаком member_path предназначен для выполнения операции над элементом.

member_state

string

Добавить или удалить элемент по указанному пути атрибута.

Если указан member_state, параметр state игнорируется.

Варианты:

  • "present"
  • "absent"

self

string

mkey идентификатора самого объекта

state

string

Указывает, следует ли создать или удалить объект.

Варианты:

  • "present"
  • "absent"

vdom

string

Виртуальный домен из числа определенных ранее. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство.

По умолчанию: "root"

Примечания

Примечание

  • Настоятельно рекомендуем использовать собственное значение policyid вместо 0. Значение «0» — это специальный заполнитель, позволяющий серверной части назначить объекту последний доступный номер, но у этого способа есть ограничения. Подробнее см. в разделе «Вопросы и ответы».
  • Устаревший fortiosapi объявлен нерекомендуемым; для запуска плейбуков предпочтительно использовать httpapi.
  • Измените порядок объектов, переместив self после (перед) другим объектом.
  • При перемещении объекта необходимо указать только один параметр: [after, before].
  • Модуль поддерживает check_mode.

Примеры

- name: Configure IPv4/IPv6 policies.
  fortinet.fortios.fortios_firewall_policy:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      firewall_policy:
          action: "accept"
          anti_replay: "enable"
          app_category:
              -
                  id: "6"
          app_group:
              -
                  name: "default_name_8 (source application.group.name)"
          app_monitor: "enable"
          application:
              -
                  id: "11"
          application_list: "<your_own_value> (source application.list.name)"
          auth_cert: "<your_own_value> (source vpn.certificate.local.name)"
          auth_path: "enable"
          auth_redirect_addr: "<your_own_value>"
          auto_asic_offload: "enable"
          av_profile: "<your_own_value> (source antivirus.profile.name)"
          block_notification: "enable"
          captive_portal_exempt: "enable"
          capture_packet: "enable"
          casb_profile: "<your_own_value> (source casb.profile.name)"
          cifs_profile: "<your_own_value> (source cifs.profile.name)"
          comments: "<your_own_value>"
          custom_log_fields:
              -
                  field_id: "<your_own_value> (source log.custom-field.id)"
          decrypted_traffic_mirror: "<your_own_value> (source firewall.decrypted-traffic-mirror.name)"
          delay_tcp_npu_session: "enable"
          devices:
              -
                  name: "default_name_29 (source user.device.alias user.device-group.name user.device-category.name)"
          diameter_filter_profile: "<your_own_value> (source diameter-filter.profile.name)"
          diffserv_copy: "enable"
          diffserv_forward: "enable"
          diffserv_reverse: "enable"
          diffservcode_forward: "<your_own_value>"
          diffservcode_rev: "<your_own_value>"
          disclaimer: "enable"
          dlp_profile: "<your_own_value> (source dlp.profile.name)"
          dlp_sensor: "<your_own_value> (source dlp.sensor.name)"
          dnsfilter_profile: "<your_own_value> (source dnsfilter.profile.name)"
          dscp_match: "enable"
          dscp_negate: "enable"
          dscp_value: "<your_own_value>"
          dsri: "enable"
          dstaddr:
              -
                  name: "default_name_45 (source firewall.address.name firewall.addrgrp.name firewall.vip.name firewall.vipgrp.name system.external-resource
                    .name)"
          dstaddr_negate: "enable"
          dstaddr6:
              -
                  name: "default_name_48 (source firewall.address6.name firewall.addrgrp6.name firewall.vip6.name firewall.vipgrp6.name system
                    .external-resource.name)"
          dstaddr6_negate: "enable"
          dstintf:
              -
                  name: "default_name_51 (source system.interface.name system.zone.name system.sdwan.zone.name)"
          dynamic_shaping: "enable"
          email_collect: "enable"
          emailfilter_profile: "<your_own_value> (source emailfilter.profile.name)"
          fec: "enable"
          file_filter_profile: "<your_own_value> (source file-filter.profile.name)"
          firewall_session_dirty: "check-all"
          fixedport: "enable"
          fsso: "enable"
          fsso_agent_for_ntlm: "<your_own_value> (source user.fsso.name)"
          fsso_groups:
              -
                  name: "default_name_62 (source user.adgrp.name)"
          geoip_anycast: "enable"
          geoip_match: "physical-location"
          global_label: "<your_own_value>"
          groups:
              -
                  name: "default_name_67 (source user.group.name)"
          gtp_profile: "<your_own_value> (source firewall.gtp.name)"
          http_policy_redirect: "enable"
          icap_profile: "<your_own_value> (source icap.profile.name)"
          identity_based_route: "<your_own_value> (source firewall.identity-based-route.name)"
          inbound: "enable"
          inspection_mode: "proxy"
          internet_service: "enable"
          internet_service_custom:
              -
                  name: "default_name_76 (source firewall.internet-service-custom.name)"
          internet_service_custom_group:
              -
                  name: "default_name_78 (source firewall.internet-service-custom-group.name)"
          internet_service_fortiguard:
              -
                  name: "default_name_80 (source firewall.internet-service-fortiguard.name)"
          internet_service_group:
              -
                  name: "default_name_82 (source firewall.internet-service-group.name)"
          internet_service_id:
              -
                  id: "84 (source firewall.internet-service.id)"
          internet_service_name:
              -
                  name: "default_name_86 (source firewall.internet-service-name.name)"
          internet_service_negate: "enable"
          internet_service_src: "enable"
          internet_service_src_custom:
              -
                  name: "default_name_90 (source firewall.internet-service-custom.name)"
          internet_service_src_custom_group:
              -
                  name: "default_name_92 (source firewall.internet-service-custom-group.name)"
          internet_service_src_fortiguard:
              -
                  name: "default_name_94 (source firewall.internet-service-fortiguard.name)"
          internet_service_src_group:
              -
                  name: "default_name_96 (source firewall.internet-service-group.name)"
          internet_service_src_id:
              -
                  id: "98 (source firewall.internet-service.id)"
          internet_service_src_name:
              -
                  name: "default_name_100 (source firewall.internet-service-name.name)"
          internet_service_src_negate: "enable"
          internet_service6: "enable"
          internet_service6_custom:
              -
                  name: "default_name_104 (source firewall.internet-service-custom.name)"
          internet_service6_custom_group:
              -
                  name: "default_name_106 (source firewall.internet-service-custom-group.name)"
          internet_service6_fortiguard:
              -
                  name: "default_name_108 (source firewall.internet-service-fortiguard.name)"
          internet_service6_group:
              -
                  name: "default_name_110 (source firewall.internet-service-group.name)"
          internet_service6_name:
              -
                  name: "default_name_112 (source firewall.internet-service-name.name)"
          internet_service6_negate: "enable"
          internet_service6_src: "enable"
          internet_service6_src_custom:
              -
                  name: "default_name_116 (source firewall.internet-service-custom.name)"
          internet_service6_src_custom_group:
              -
                  name: "default_name_118 (source firewall.internet-service-custom-group.name)"
          internet_service6_src_fortiguard:
              -
                  name: "default_name_120 (source firewall.internet-service-fortiguard.name)"
          internet_service6_src_group:
              -
                  name: "default_name_122 (source firewall.internet-service-group.name)"
          internet_service6_src_name:
              -
                  name: "default_name_124 (source firewall.internet-service-name.name)"
          internet_service6_src_negate: "enable"
          ippool: "enable"
          ips_sensor: "<your_own_value> (source ips.sensor.name)"
          ips_voip_filter: "<your_own_value> (source voip.profile.name)"
          label: "<your_own_value>"
          learning_mode: "enable"
          log_http_transaction: "enable"
          logtraffic: "all"
          logtraffic_start: "enable"
          match_vip: "enable"
          match_vip_only: "enable"
          mms_profile: "<your_own_value> (source firewall.mms-profile.name)"
          name: "default_name_137"
          nat: "enable"
          nat46: "enable"
          nat64: "enable"
          natinbound: "enable"
          natip: "<your_own_value>"
          natoutbound: "enable"
          network_service_dynamic:
              -
                  name: "default_name_145 (source firewall.network-service-dynamic.name)"
          network_service_src_dynamic:
              -
                  name: "default_name_147 (source firewall.network-service-dynamic.name)"
          np_acceleration: "enable"
          ntlm: "enable"
          ntlm_enabled_browsers:
              -
                  user_agent_string: "<your_own_value>"
          ntlm_guest: "enable"
          outbound: "enable"
          passive_wan_health_measurement: "enable"
          pcp_inbound: "enable"
          pcp_outbound: "enable"
          pcp_poolname:
              -
                  name: "default_name_158 (source system.pcp-server.pools.name)"
          per_ip_shaper: "<your_own_value> (source firewall.shaper.per-ip-shaper.name)"
          permit_any_host: "enable"
          permit_stun_host: "enable"
          pfcp_profile: "<your_own_value> (source firewall.pfcp.name)"
          policy_expiry: "enable"
          policy_expiry_date: "<your_own_value>"
          policy_expiry_date_utc: "<your_own_value>"
          policyid: "<you_own_value>"
          poolname:
              -
                  name: "default_name_168 (source firewall.ippool.name)"
          poolname6:
              -
                  name: "default_name_170 (source firewall.ippool6.name)"
          port_preserve: "enable"
          port_random: "enable"
          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"
          radius_ip_auth_bypass: "enable"
          radius_mac_auth_bypass: "enable"
          redirect_url: "<your_own_value>"
          replacemsg_override_group: "<your_own_value> (source system.replacemsg-group.name)"
          reputation_direction: "source"
          reputation_direction6: "source"
          reputation_minimum: "0"
          reputation_minimum6: "0"
          rsso: "enable"
          rtp_addr:
              -
                  name: "default_name_186 (source firewall.internet-service-custom-group.name firewall.addrgrp.name)"
          rtp_nat: "disable"
          saml_server: "<your_own_value> (source user.saml.name)"
          scan_botnet_connections: "disable"
          schedule: "<your_own_value> (source firewall.schedule.onetime.name firewall.schedule.recurring.name firewall.schedule.group.name)"
          schedule_timeout: "enable"
          scim: "enable"
          scim_groups:
              -
                  name: "default_name_194"
          scim_users:
              -
                  name: "default_name_196"
          sctp_filter_profile: "<your_own_value> (source sctp-filter.profile.name)"
          send_deny_packet: "disable"
          service:
              -
                  name: "default_name_200 (source firewall.service.custom.name firewall.service.group.name)"
          service_negate: "enable"
          session_ttl: "<your_own_value>"
          sgt:
              -
                  id: "204"
          sgt_check: "enable"
          spamfilter_profile: "<your_own_value> (source spamfilter.profile.name)"
          src_vendor_mac:
              -
                  id: "208 (source firewall.vendor-mac.id)"
          srcaddr:
              -
                  name: "default_name_210 (source firewall.address.name firewall.addrgrp.name system.external-resource.name)"
          srcaddr_negate: "enable"
          srcaddr6:
              -
                  name: "default_name_213 (source firewall.address6.name system.external-resource.name firewall.addrgrp6.name)"
          srcaddr6_negate: "enable"
          srcintf:
              -
                  name: "default_name_216 (source system.interface.name system.zone.name system.sdwan.zone.name)"
          ssh_filter_profile: "<your_own_value> (source ssh-filter.profile.name)"
          ssh_policy_redirect: "enable"
          ssl_mirror: "enable"
          ssl_mirror_intf:
              -
                  name: "default_name_221 (source system.interface.name system.zone.name)"
          ssl_ssh_profile: "<your_own_value> (source firewall.ssl-ssh-profile.name)"
          status: "enable"
          tcp_mss_receiver: "0"
          tcp_mss_sender: "0"
          tcp_session_without_syn: "all"
          telemetry_profile: "<your_own_value> (source telemetry-controller.profile.name)"
          timeout_send_rst: "enable"
          tos: "<your_own_value>"
          tos_mask: "<your_own_value>"
          tos_negate: "enable"
          traffic_shaper: "<your_own_value> (source firewall.shaper.traffic-shaper.name)"
          traffic_shaper_reverse: "<your_own_value> (source firewall.shaper.traffic-shaper.name)"
          url_category:
              -
                  id: "235"
          users:
              -
                  name: "default_name_237 (source user.local.name user.certificate.name)"
          utm_status: "enable"
          uuid: "<your_own_value>"
          videofilter_profile: "<your_own_value> (source videofilter.profile.name)"
          virtual_patch_profile: "<your_own_value> (source virtual-patch.profile.name)"
          vlan_cos_fwd: "255"
          vlan_cos_rev: "255"
          vlan_filter: "<your_own_value>"
          voip_profile: "<your_own_value> (source voip.profile.name)"
          vpntunnel: "<your_own_value> (source vpn.ipsec.phase1.name vpn.ipsec.manualkey.name)"
          waf_profile: "<your_own_value> (source waf.profile.name)"
          wanopt: "enable"
          wanopt_detection: "active"
          wanopt_passive_opt: "default"
          wanopt_peer: "<your_own_value> (source wanopt.peer.peer-host-id)"
          wanopt_profile: "<your_own_value> (source wanopt.profile.name)"
          wccp: "enable"
          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)"
          wsso: "enable"
          ztna_device_ownership: "enable"
          ztna_ems_tag:
              -
                  name: "default_name_262 (source firewall.address.name firewall.addrgrp.name)"
          ztna_ems_tag_negate: "enable"
          ztna_ems_tag_secondary:
              -
                  name: "default_name_265 (source firewall.address.name firewall.addrgrp.name)"
          ztna_geo_tag:
              -
                  name: "default_name_267 (source firewall.address.name firewall.addrgrp.name)"
          ztna_policy_redirect: "enable"
          ztna_status: "enable"
          ztna_tags_match_logic: "or"

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

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

Ключ

Описание

build

string

Номер сборки образа FortiGate

Возвращается: всегда

Пример: "1547"

http_method

string

Последний метод, использованный для передачи конфигурации в FortiGate

Возвращается: всегда

Пример: "PUT"

http_status

string

Последний результат, полученный от FortiGate при выполнении последней операции

Возвращается: всегда

Пример: "200"

mkey

string

Мастер-ключ (идентификатор), использованный при последнем вызове FortiGate

Возвращается: при успешном выполнении

Пример: "id"

name

string

Имя таблицы, использованной для выполнения запроса

Возвращается: всегда

Пример: "urlfilter"

path

string

Путь к таблице, использованной для выполнения запроса

Возвращается: всегда

Пример: "webfilter"

revision

string

Внутренний номер редакции

Возвращается: всегда

Пример: "17.0.2.10658"

serial

string

Серийный номер устройства

Возвращается: всегда

Пример: "FGVMEVYYQT3AB5352"

status

string

Результат выполнения операции

Возвращается: всегда

Пример: "success"

vdom

string

Используемый виртуальный домен

Возвращается: всегда

Пример: "root"

version

string

Версия FortiGate

Возвращается: всегда

Пример: "v5.6.3"

Авторы

  • Link Zheng (@chillancezen)
  • Jie Xue (@JieX19)
  • Hongbin Lu (@fgtdev-hblu)
  • Frank Shen (@frankshen01)
  • Miguel Angel Munoz (@mamunozgonzalez)
  • Nicolas Thomas (@thomnico)

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

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

© 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/fortios/fortios_firewall_policy_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API