fortinet.fortios.fortios_system_settings 模块 – 配置 Fortinet 的 FortiOS 和 FortiGate 中的 VDOM 设置。
注意
此模块是 fortinet.fortios 集合 (版本 2.3.8) 的一部分。
如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install fortinet.fortios。您需要其他要求才能使用此模块，请参阅 要求 获取详细信息。
要在 playbook 中使用它，请指定： fortinet.fortios.fortios_system_settings。
fortinet.fortios 2.0.0 中的新增功能
概要
此模块能够通过允许用户设置和修改系统功能和设置类别来配置 FortiGate 或 FortiOS (FOS) 设备。示例包括所有参数，在使用前需要将值调整为数据源。在 FOS v6.0.0 上测试。
要求
执行此模块的主机需要以下要求。
ansible>=2.15
参数
参数 |
注释 |
|---|---|
基于令牌的身份验证。从 FortiGate 的 GUI 生成。 |
|
启用/禁用任务的日志记录。 选项
|
|
要操作的成员属性路径。 如果有多个属性，则用斜杠字符分隔。 标有 member_path 的参数对于执行成员操作是合法的。 |
|
在指定的属性路径下添加或删除成员。 当指定 member_state 时，将忽略 state 选项。 选项
|
|
配置 VDOM 设置。 |
|
启用/禁用链路中断路径。 选项
|
|
启用/禁用允许接口子网使用重叠的 IP 地址。 选项
|
|
启用/禁用应用程序带宽跟踪。 选项
|
|
启用/禁用 IPv4 非对称路由。 选项
|
|
启用/禁用非对称 IPv6 路由。 选项
|
|
启用/禁用非对称 ICMPv6 路由。 选项
|
|
启用/禁用 ICMP 非对称路由。 选项
|
|
启用/禁用辅助会话。 选项
|
|
启用/禁用所有接口上的双向转发检测 (BFD)。 选项
|
|
BFD 期望的最小传输间隔 (1 - 100000 毫秒)。 |
|
BFD 检测乘数 (1 - 50)。 |
|
启用后，无需强制验证 BFD 数据包的源端口。 选项
|
|
BFD 需要的最小接收间隔 (1 - 100000 毫秒)。 |
|
启用/禁用阻止 land 攻击。 选项
|
|
启用/禁用中央 NAT。 选项
|
|
VDOM 注释。 |
|
启用/禁用 PCI DSS 合规性检查。 选项
|
|
合并防火墙模式。 选项
|
|
启用/禁用基于应用程序默认端口的策略服务执行。 选项
|
|
默认策略过期时间（天）（0 - 365 天）。 |
|
配置 FortiGate 在接受流量的策略不包含 VoIP 配置文件时如何处理 VoIP 流量。 选项
|
|
启用/禁用通过发送 ICMP 通信禁止数据包来拒绝 TCP。 选项
|
|
启用/禁用检测未知的 ESP 数据包。 选项
|
|
用于 NAT 模式管理访问的接口。源 system.interface.name。 |
|
DHCPv6 服务器 IPv6 地址。 |
|
启用/禁用 DHCP 代理。 选项
|
|
指定到达服务器的出站接口。源 system.interface.name。 |
|
指定如何选择到达服务器的出站接口。 选项
|
|
DHCP 服务器 IPv4 地址。 |
|
已发现设备的超时时间 (1 - 365 天)。 |
|
启用/禁用由动态地址更新引起的脏会话检查。 选项
|
|
等成本多路径 (ECMP) 下一跳的最大数量。设置为 1 以禁用 ECMP 路由 (1 - 255)。 |
|
启用/禁用使用 DNS 验证由受限门户收集的电子邮件地址。 选项
|
|
启用/禁用由外部资源更新引起的脏会话检查。 选项
|
|
选择如何管理受防火墙策略配置更改影响的会话。 选项
|
|
启用/禁用由 FQDN 更新引起的脏会话检查。 选项
|
|
启用/禁用每次发夹流量通过 FortiGate 时检查匹配策略。 选项
|
|
透明模式 IPv4 默认网关 IP 地址。 |
|
透明模式 IPv6 默认网关 IP 地址。 |
|
启用/禁用 FGSP 上的 GTP 非对称流量处理。 选项
|
|
启用/禁用 GTP 监控模式（VDOM 级别）。 选项
|
|
启用/禁用 GUI 上的高级策略配置。 选项
|
|
启用/禁用 GUI 中的高级无线功能。 选项
|
|
启用/禁用 GUI 上的策略命名要求。 选项
|
|
启用/禁用 GUI 上的防病毒功能。 选项
|
|
启用/禁用 GUI 上的 FortiAP 配置文件。 选项
|
|
启用/禁用 GUI 上的应用程序控制。 选项
|
|
启用/禁用 GUI 上的 Inline-CASB。 选项
|
|
GUI 上策略列表的默认显示列。 |
|
选择列名。 |
|
启用/禁用 GUI 上的高级 DHCP 选项。 选项
|
|
启用/禁用GUI上的DLP。 选项
|
|
启用/禁用GUI上的数据丢失防护。 选项
|
|
启用/禁用GUI上的DNS数据库设置。 选项
|
|
启用/禁用GUI上的DNS过滤。 选项
|
|
启用/禁用GUI上的域名和IP信誉。 选项
|
|
启用/禁用GUI上的DoS策略。 选项
|
|
启用/禁用创建动态地址以管理已知设备。 选项
|
|
启用/禁用GUI上的RADIUS单点登录(RSSO)。 选项
|
|
启用/禁用GUI上的动态路由。 选项
|
|
启用/禁用GUI上的电子邮件收集。 选项
|
|
启用/禁用GUI上的终端控制。 选项
|
|
启用/禁用GUI上的高级终端控制选项。 选项
|
|
强制执行GUI中选定表的更改摘要。 选项
|
|
启用/禁用GUI上的显式代理。 选项
|
|
启用/禁用GUI上的文件过滤器。 选项
|
|
启用/禁用GUI上的FortiAP分段隧道。 选项
|
|
启用/禁用GUI上的FortiExtender。 选项
|
|
启用/禁用GUI上管理通用分组无线业务(GPRS)协议。 选项
|
|
启用/禁用GUI上的ICAP。 选项
|
|
启用/禁用GUI上的隐式防火墙策略。 选项
|
|
启用/禁用GUI上的IPS。 选项
|
|
启用/禁用GUI上的服务器负载均衡。 选项
|
|
启用/禁用GUI上的本地入站策略。 选项
|
|
启用/禁用GUI上的本地报表。 选项
|
|
启用/禁用GUI上的组播防火墙策略。 选项
|
|
启用/禁用在GUI上向策略添加多个接口。 选项
|
|
启用/禁用GUI上的多个UTM配置文件。 选项
|
|
启用/禁用GUI上的NAT46和NAT64设置。 选项
|
|
启用/禁用GUI上的对象颜色。 选项
|
|
启用/禁用GUI上的运营技术功能。 选项
|
|
启用/禁用GUI上的策略免责声明。 选项
|
|
启用/禁用GUI上的基于策略的IPsec VPN。 选项
|
|
启用/禁用GUI上的策略免责声明。 选项
|
|
启用/禁用GUI上的防火墙策略学习模式。 选项
|
|
启用/禁用GUI上的代理功能。 选项
|
|
启用/禁用GUI上的替换消息组。 选项
|
|
启用/禁用GUI上的路由标签地址。 选项
|
|
启用/禁用GUI上的安全配置文件组。 选项
|
|
启用/禁用GUI上的反垃圾邮件。 选项
|
|
启用/禁用GUI上的SSL-VPN设置页面。 选项
|
|
启用/禁用GUI上的SSL-VPN个人书签管理。 选项
|
|
启用/禁用GUI上的SSL-VPN领域。 选项
|
|
启用/禁用GUI上的交换机控制器。 选项
|
|
启用/禁用GUI上的威胁权重。 选项
|
|
启用/禁用GUI上的流量整形。 选项
|
|
启用/禁用GUI上的视频过滤。 选项
|
|
启用/禁用GUI上的虚拟补丁。 选项
|
|
启用/禁用GUI上的VoIP配置文件。 选项
|
|
启用/禁用GUI上的IPsec VPN设置页面。 选项
|
|
启用/禁用GUI上的Web应用程序防火墙。 选项
|
|
启用/禁用GUI上的SD-WAN。 选项
|
|
启用/禁用GUI上的广域网优化和Web缓存。 选项
|
|
启用/禁用GUI上的Web过滤。 选项
|
|
启用/禁用GUI上的高级Web过滤。 选项
|
|
启用/禁用GUI上的无线控制器。 选项
|
|
启用/禁用GUI上的零信任网络访问功能。 选项
|
|
启用/禁用H323直连模式。 选项
|
|
将HTTP流量卸载到FortiWeb或FortiCache。 选项
|
|
配置IKE ASN.1区分名称格式约定。 选项
|
|
启用/禁用基于IKE策略的路由(PBR)。 选项
|
|
IKE/IPsec流量的UDP端口。 |
|
启用/禁用IKE快速崩溃检测(RFC 6290)。 选项
|
|
启用/禁用IKEv2会话恢复(RFC 5723)。 选项
|
|
IKE/IPsec流量的TCP端口。 |
|
启用/禁用隐式允许DNS流量。 选项
|
|
检测模式（基于代理或基于流）。 选项
|
|
FortiGate单元存储的元组条目（协议、端口、IP地址、应用程序ID）的最大数量 (0 - 4294967295)。较小的值会限制FortiGate单元了解Internet应用程序。 |
|
启用/禁用Internet服务数据库缓存。 选项
|
|
IP地址和网络掩码。 |
|
NAT模式的IPv6地址前缀。 |
|
要连接的控制器IP地址或FQDN。 |
|
启用/禁用链路断开访问流量。 选项
|
|
启用/禁用此VDOM的链路层发现协议(LLDP)接收，或将全局设置应用于此VDOM。 选项
|
|
启用/禁用此VDOM的链路层发现协议(LLDP)传输，或将全局设置应用于此VDOM。 选项
|
|
以IPv4地址形式表示的本地位置ID。 |
|
透明模式下MAC地址的持续时间 (300 - 8640000 秒)。 |
|
透明模式IPv4管理IP地址和网络掩码。 |
|
透明模式IPv6管理IP地址和网络掩码。 |
|
启用/禁用组播转发。 选项
|
|
启用/禁用允许组播流量通过FortiGate而无需策略检查。 选项
|
|
启用/禁用防止FortiGate更改转发组播数据包的TTL。 选项
|
|
启用/禁用NAT46中强制IPv4数据包转发。 选项
|
|
启用/禁用NAT46 IPv6分片头生成。 选项
|
|
启用/禁用NAT64中强制IPv6数据包转发。 选项
|
|
下一代防火墙(NGFW)模式。 选项
|
|
防火墙操作模式（NAT或透明）。 选项
|
|
启用/禁用PFCP监控模式（VDOM级别）。 选项
|
|
配置防火墙策略卸载级别。 选项
|
|
启用/禁用对PRP尾部的操作。 选项
|
|
SCCP代理监控SCCP流量的TCP端口 (0 - 65535)。 |
|
启用/禁用无需SCTP INIT即可创建SCTP会话。 选项
|
|
启用/禁用在会话表中包含被拒绝的会话。 选项
|
|
启用/禁用SIP内核会话帮助程序为端口5060创建预期。 选项
|
|
启用/禁用SIP会话帮助程序处理SIP会话，除非SIP会话被SIP应用层网关(ALG)接受。 选项
|
|
启用/禁用在使用NAT时记录原始SIP源IP地址。 选项
|
|
SIP代理监控SIP SSL/TLS流量的TCP端口 (0 - 65535)。 |
|
SIP代理监控SIP流量的TCP端口 (0 - 65535)。 |
|
SIP代理监控SIP流量的UDP端口 (0 - 65535)。 |
|
启用/禁用回环流量的源NAT (SNAT)。 选项
|
|
SSL/SSH检测的配置文件。来源firewall.ssl-ssh-profile.name。 |
|
启用/禁用此VDOM。 选项
|
|
启用/禁用严格的源验证。 选项
|
|
启用/禁用允许没有SYN标志的TCP会话。 选项
|
|
启用/禁用将反垃圾邮件标签转换为UTF-8以更好地支持非ASCII字符。 选项
|
|
IPv4等成本多路径(ECMP)路由和负载均衡模式。 选项
|
|
VDOM类型（流量、局域网扩展或管理员）。 选项
|
|
启用/禁用一种或多种类型的VPN的周期性VPN日志统计信息。用空格分隔名称。 选项
|
|
发送VPN日志统计信息的周期 (0或60 - 86400 秒)。 |
|
启用/禁用WCCP缓存引擎。 选项
|
|
虚拟域，在之前定义的那些虚拟域中。VDOM是FortiGate的虚拟实例，可以将其配置并用作不同的单元。 默认值： |
注释
注意
旧版fortiosapi已弃用，httpapi是运行playbook的首选方法。
示例
- name: Configure VDOM settings.
fortinet.fortios.fortios_system_settings:
vdom: "{{ vdom }}"
system_settings:
allow_linkdown_path: "enable"
allow_subnet_overlap: "enable"
application_bandwidth_tracking: "disable"
asymroute: "enable"
asymroute_icmp: "enable"
asymroute6: "enable"
asymroute6_icmp: "enable"
auxiliary_session: "enable"
bfd: "enable"
bfd_desired_min_tx: "250"
bfd_detect_mult: "3"
bfd_dont_enforce_src_port: "enable"
bfd_required_min_rx: "250"
block_land_attack: "disable"
central_nat: "enable"
comments: "<your_own_value>"
compliance_check: "enable"
consolidated_firewall_mode: "enable"
default_app_port_as_service: "enable"
default_policy_expiry_days: "30"
default_voip_alg_mode: "proxy-based"
deny_tcp_with_icmp: "enable"
detect_unknown_esp: "enable"
device: "<your_own_value> (source system.interface.name)"
dhcp_proxy: "enable"
dhcp_proxy_interface: "<your_own_value> (source system.interface.name)"
dhcp_proxy_interface_select_method: "auto"
dhcp_server_ip: "<your_own_value>"
dhcp6_server_ip: "<your_own_value>"
discovered_device_timeout: "28"
dyn_addr_session_check: "enable"
ecmp_max_paths: "255"
email_portal_check_dns: "disable"
ext_resource_session_check: "enable"
firewall_session_dirty: "check-all"
fqdn_session_check: "enable"
fw_session_hairpin: "enable"
gateway: "<your_own_value>"
gateway6: "<your_own_value>"
gtp_asym_fgsp: "disable"
gtp_monitor_mode: "enable"
gui_advanced_policy: "enable"
gui_advanced_wireless_features: "enable"
gui_allow_unnamed_policy: "enable"
gui_antivirus: "enable"
gui_ap_profile: "enable"
gui_application_control: "enable"
gui_casb: "enable"
gui_default_policy_columns:
-
name: "default_name_52"
gui_dhcp_advanced: "enable"
gui_dlp: "enable"
gui_dlp_profile: "enable"
gui_dns_database: "enable"
gui_dnsfilter: "enable"
gui_domain_ip_reputation: "enable"
gui_dos_policy: "enable"
gui_dynamic_device_os_id: "enable"
gui_dynamic_profile_display: "enable"
gui_dynamic_routing: "enable"
gui_email_collection: "enable"
gui_endpoint_control: "enable"
gui_endpoint_control_advanced: "enable"
gui_enforce_change_summary: "disable"
gui_explicit_proxy: "enable"
gui_file_filter: "enable"
gui_fortiap_split_tunneling: "enable"
gui_fortiextender_controller: "enable"
gui_gtp: "enable"
gui_icap: "enable"
gui_implicit_policy: "enable"
gui_ips: "enable"
gui_load_balance: "enable"
gui_local_in_policy: "enable"
gui_local_reports: "enable"
gui_multicast_policy: "enable"
gui_multiple_interface_policy: "enable"
gui_multiple_utm_profiles: "enable"
gui_nat46_64: "enable"
gui_object_colors: "enable"
gui_ot: "enable"
gui_per_policy_disclaimer: "enable"
gui_policy_based_ipsec: "enable"
gui_policy_disclaimer: "enable"
gui_policy_learning: "enable"
gui_proxy_inspection: "enable"
gui_replacement_message_groups: "enable"
gui_route_tag_address_creation: "enable"
gui_security_profile_group: "enable"
gui_spamfilter: "enable"
gui_sslvpn: "enable"
gui_sslvpn_personal_bookmarks: "enable"
gui_sslvpn_realms: "enable"
gui_switch_controller: "enable"
gui_threat_weight: "enable"
gui_traffic_shaping: "enable"
gui_videofilter: "enable"
gui_virtual_patch_profile: "enable"
gui_voip_profile: "enable"
gui_vpn: "enable"
gui_waf_profile: "enable"
gui_wan_load_balancing: "enable"
gui_wanopt_cache: "enable"
gui_webfilter: "enable"
gui_webfilter_advanced: "enable"
gui_wireless_controller: "enable"
gui_ztna: "enable"
h323_direct_model: "disable"
http_external_dest: "fortiweb"
ike_dn_format: "with-space"
ike_policy_route: "enable"
ike_port: "500"
ike_quick_crash_detect: "enable"
ike_session_resume: "enable"
ike_tcp_port: "4500"
implicit_allow_dns: "enable"
inspection_mode: "proxy"
internet_service_app_ctrl_size: "32768"
internet_service_database_cache: "disable"
ip: "<your_own_value>"
ip6: "<your_own_value>"
lan_extension_controller_addr: "<your_own_value>"
link_down_access: "enable"
lldp_reception: "enable"
lldp_transmission: "enable"
location_id: "<your_own_value>"
mac_ttl: "300"
manageip: "<your_own_value>"
manageip6: "<your_own_value>"
multicast_forward: "enable"
multicast_skip_policy: "enable"
multicast_ttl_notchange: "enable"
nat46_force_ipv4_packet_forwarding: "enable"
nat46_generate_ipv6_fragment_header: "enable"
nat64_force_ipv6_packet_forwarding: "enable"
ngfw_mode: "profile-based"
opmode: "nat"
pfcp_monitor_mode: "enable"
policy_offload_level: "disable"
prp_trailer_action: "enable"
sccp_port: "2000"
sctp_session_without_init: "enable"
ses_denied_traffic: "enable"
sip_expectation: "enable"
sip_helper: "enable"
sip_nat_trace: "enable"
sip_ssl_port: "5061"
sip_tcp_port: "<your_own_value>"
sip_udp_port: "<your_own_value>"
snat_hairpin_traffic: "enable"
ssl_ssh_profile: "<your_own_value> (source firewall.ssl-ssh-profile.name)"
status: "enable"
strict_src_check: "enable"
tcp_session_without_syn: "enable"
utf8_spam_tagging: "enable"
v4_ecmp_mode: "source-ip-based"
vdom_type: "traffic"
vpn_stats_log: "ipsec"
vpn_stats_period: "600"
wccp_cache_engine: "enable"
返回值
常见的返回值已记录此处，以下是此模块特有的字段。
键 |
描述 |
|---|---|
FortiGate镜像的版本号。 返回：始终 示例： |
|
上次用于将内容置备到FortiGate的方法。 返回：始终 示例： |
|
FortiGate上次操作的最后结果 返回：始终 示例： |
|
上次调用FortiGate时使用的主密钥(ID) 返回： 成功 示例： |
|
用于满足请求的表名称 返回：始终 示例： |
|
用于满足请求的表路径 返回：始终 示例： |
|
内部版本号 返回：始终 示例： |
|
设备序列号 返回：始终 示例： |
|
操作结果指示 返回：始终 示例： |
|
使用的虚拟域 返回：始终 示例： |
|
FortiGate版本 返回：始终 示例： |