fortinet.fortios.fortios_firewall_vip6 模块 – 在 Fortinet FortiOS 和 FortiGate 中配置 IPv6 的虚拟 IP。
注意
此模块是 fortinet.fortios 集合(版本 2.3.8)的一部分。
如果您正在使用 ansible
包,您可能已经安装了这个集合。它不包含在 ansible-core
中。要检查是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install fortinet.fortios
。您需要其他要求才能使用此模块,有关详细信息,请参阅要求。
要在剧本中使用它,请指定:fortinet.fortios.fortios_firewall_vip6
。
fortinet.fortios 2.0.0 中的新功能
概要
该模块能够通过允许用户设置和修改防火墙功能和 vip6 类别来配置 FortiGate 或 FortiOS (FOS) 设备。示例包括所有参数和值,需要在使用前调整为数据源。在 FOS v6.0.0 上测试过。
要求
执行此模块的主机需要以下要求。
ansible>=2.15
参数
参数 |
注释 |
---|---|
基于令牌的身份验证。从 Fortigate 的 GUI 生成。 |
|
启用/禁用任务的日志记录。 选择
|
|
为 IPv6 配置虚拟 IP。 |
|
启用/禁用添加 NAT64 路由。 选择
|
|
启用以响应此虚拟 IP 地址的 ARP 请求。默认启用。 选择
|
|
GUI 上图标的颜色。 |
|
注释。 |
|
启用/禁用使用外部 IPv6 地址的低 32 位作为映射的 IPv4 地址。 选择
|
|
外部接口上的 IPv6 地址或地址范围,您想要将其映射到目标网络上的地址或地址范围。 |
|
您想要映射到目标网络上的端口号范围的传入端口号范围。 |
|
启用/禁用 HTTP2 支持。 选择
|
|
启用/禁用 HTTP3/QUIC 支持。 选择
|
|
客户端 Web 浏览器应保留 Cookie 的时间(以分钟为单位)。默认为 60 分钟。0 = 无时间限制。 |
|
HTTP Cookie 持久性应应用到的域。 |
|
启用/禁用从 HTTP 中的主机字段使用 HTTP Cookie 域。 选择
|
|
要接受的 HTTP Cookie 的生成。更改会使所有现有 Cookie 失效。 |
|
将 HTTP Cookie 持久性限制到指定的路径。 |
|
控制跨虚拟服务器共享 Cookie。使用 same-ip 表示一个虚拟服务器的 Cookie 可以被另一个服务器使用。禁用会停止 Cookie 共享。 选择
|
|
对于 HTTP 多路复用,启用以在 XForwarded-For HTTP 标头中添加原始客户端 IP 地址。 选择
|
|
对于 HTTP 多路复用,输入自定义 HTTPS 标头名称。原始客户端 IP 地址会添加到此标头中。如果为空,则使用 X-Forwarded-For。 |
|
启用/禁用 HTTP 多路复用。 选择
|
|
启用/禁用将 HTTP 重定向到 HTTPS。 选择
|
|
启用/禁用验证插入的 HTTPS Cookie 是否安全。 选择
|
|
自定义定义的 ID。 |
|
映射的 IP 地址范围。指定起始 IP 地址,后跟一个空格和结束 IP 地址。 |
|
目标网络上的 IPv4 端口号范围,外部端口号范围映射到该范围。 |
|
用于将会话分配给真实服务器的方法。 选择
|
|
格式为 startIP-endIP 的映射 IPv6 地址范围。 |
|
目标网络上的端口号范围,外部端口号范围映射到该范围。 |
|
不完整连接的最大数量。 |
|
用于轮询以确定虚拟服务器的连接状态的运行状况检查监控器的名称。 |
|
运行状况监控器名称。源 firewall.ldb-monitor.name。 |
|
虚拟 ip6 名称。 |
|
启用/禁用 DNAT64。 选择
|
|
启用/禁用 DNAT66。 选择
|
|
启用以对来自 mappedip 的流量执行 SNAT 到所有出口接口的 extip。 选择
|
|
启用/禁用此 FortiGate 设备响应此虚拟 IP 地址的 NDP 请求的能力。 选择
|
|
启用此选项以添加 Microsoft Outlook Web Access 的 Front-End-Https 标头。 选择
|
|
配置如何确保客户端每次发出属于同一会话的请求时都连接到同一服务器。 选择
|
|
启用端口转发。 选择
|
|
转发数据包时使用的协议。 选择
|
|
QUIC 设置。 |
|
ACK 延迟指数 (1 - 20)。 |
|
活动连接 ID 限制 (1 - 8)。 |
|
启用/禁用主动迁移。 选择
|
|
启用/禁用 grease QUIC 位。 选择
|
|
最大 ACK 延迟,以毫秒为单位 (1 - 16383)。 |
|
最大数据报帧大小,以字节为单位 (1 - 1500)。 |
|
最大空闲超时时间,以毫秒为单位 (1 - 60000)。 |
|
最大 UDP 负载大小,以字节为单位 (1200 - 1500)。 |
|
选择此服务器负载均衡 VIP 将流量分配到的实际服务器。 |
|
只有此 IP 范围内的客户端才能连接到此实际服务器。 |
|
启用此选项可在转发流量之前检查实际服务器的响应能力。 选择
|
|
系统在主动-备用模式下重新激活先前关闭的活动服务器之前等待的时间(以秒为单位)。这是为了防止任何抖动问题。 |
|
HTTP 标头中的 HTTP 服务器域名。 |
|
实际服务器 ID。请参见 <a href=’#notes’>备注</a>。 |
|
实际服务器的 IP 地址。 |
|
可以定向到实际服务器的最大活动连接数。达到此限制后,会话将被发送到其他实际服务器。 |
|
在轮询以确定虚拟服务器的连接状态时使用的运行状况检查监视器的名称。来源 firewall.ldb-monitor.name。 |
|
运行状况监控器名称。源 firewall.ldb-monitor.name。 |
|
与实际服务器通信的端口。如果启用了端口转发,则为必填项。 |
|
将实际服务器的状态设置为 active 以使其可以接受流量,或设置为 standby 或 disabled 以不发送流量。 选择
|
|
启用/禁用从虚拟服务器到实际服务器的主机名/IP 转换。 选择
|
|
实际服务器的权重。如果启用了加权负载均衡,则权重最高的服务器将获得更多连接。 |
|
虚拟服务器(也称为服务器负载均衡虚拟 IP)要进行负载均衡的协议。 选择
|
|
源 IP6 过滤器 (x:x:x:x:x:x:x:x/x)。使用空格分隔地址。 |
|
源过滤器范围。 |
|
启用/禁用使用“src-filter”来匹配反向 SNAT 规则的目标。 选择
|
|
启用/禁用 SSL 密钥交换的 FFDHE 密码套件。 选择
|
|
根据加密强度允许用于 SSL 会话的加密算法。 选择
|
|
用于 SSL 握手的证书的名称。来源 vpn.certificate.local.name。 |
|
用于 SSL 握手的证书的名称。 |
|
证书列表。来源 vpn.certificate.local.name。 |
|
客户端可以接受的 SSL/TLS 密码套件,按优先级排序。 |
|
密码套件名称。 选择
|
|
SSL/TLS 密码套件优先级。请参见 <a href=’#notes’>备注</a>。 |
|
密码套件可以使用的 SSL/TLS 版本。 选择
|
|
启用/禁用对防止客户端连接降级攻击的支持 (RFC 7507)。 选择
|
|
触发客户端重新密钥之前的最大数据长度(以 MB 为单位)(0 = 禁用)。 |
|
允许、拒绝或要求对客户端会话进行安全重新协商,以符合 RFC 5746。 选择
|
|
要保留的最大客户端到 FortiGate SSL 会话状态数。 |
|
保留客户端到 FortiGate SSL 会话状态的分钟数。 |
|
如何为客户端和 FortiGate 之间的 SSL 连接段过期 SSL 会话。 选择
|
|
在用于 SSL 会话 RSA 加密的 Diffie-Hellman 交换中使用的位数。 选择
|
|
启用/禁用在响应中包含 HPKP 标头。 选择
|
|
Web 浏览器应保留 HPKP 的分钟数。 |
|
用于生成备份 HPKP pin 的证书。来源 vpn.certificate.local.name vpn.certificate.ca.name。 |
|
指示 HPKP 标头适用于所有子域。 选择
|
|
用于生成主要 HPKP pin 的证书。来源 vpn.certificate.local.name vpn.certificate.ca.name。 |
|
用于报告 HPKP 违规的 URL。 |
|
启用/禁用在响应中包含 HSTS 标头。 选择
|
|
客户端应遵守 HSTS 设置的秒数。 |
|
指示 HSTS 标头适用于所有子域。 选择
|
|
启用此选项可在回复的 Location HTTP 标头字段中将 HTTP 替换为 HTTPS。 选择
|
|
启用/禁用位置转换的 HTTP 主机匹配。 选择
|
|
客户端可以接受的最高 SSL/TLS 版本。 选择
|
|
客户端可以接受的最低 SSL/TLS 版本。 选择
|
|
在客户端和 FortiGate 之间(半)或从客户端到 FortiGate 以及从 FortiGate 到服务器(全)应用 SSL 卸载。 选择
|
|
选择可用于 SSL 完全正向保密 (PFS) 的密码套件。适用于客户端和服务器会话。 选择
|
|
启用/禁用发送空片段以避免 CBC IV 攻击(仅限 SSL 3.0 和 TLS 1.0)。可能需要禁用以兼容旧系统。 选择
|
|
根据加密强度允许用于 SSL 完全模式会话服务器端的加密算法。 选择
|
|
要提供给服务器的 SSL/TLS 密码套件,按优先级排序。 |
|
密码套件名称。 选择
|
|
SSL/TLS 密码套件优先级。请参见 <a href=’#notes’>备注</a>。 |
|
密码套件可以使用的 SSL/TLS 版本。 选择
|
|
服务器可以接受的最高 SSL/TLS 版本。默认情况下使用客户端设置。 选择
|
|
服务器可以接受的最低 SSL/TLS 版本。默认情况下使用客户端设置。 选择
|
|
启用/禁用安全重新协商以符合 RFC 5746。 选择
|
|
要保留的最大 FortiGate 到服务器 SSL 会话状态数。 |
|
保留 FortiGate 到服务器 SSL 会话状态的分钟数。 |
|
如何为服务器和 FortiGate 之间的 SSL 连接段过期 SSL 会话。 选择
|
|
配置静态 NAT 服务器负载均衡 VIP 或访问代理。 选择
|
|
通用唯一标识符 (UUID;自动分配,但可以手动重置)。 |
|
启用此选项可添加 HTTP 标头以指示 WebLogic 服务器的 SSL 卸载。 选择
|
|
启用此选项可添加 HTTP 标头以指示 WebSphere 服务器的 SSL 卸载。 选择
|
|
要操作的成员属性路径。 如果存在多个属性,则用斜杠字符分隔。 标有 member_path 的参数可用于执行成员操作。 |
|
在指定的属性路径下添加或删除成员。 指定 member_state 时,将忽略 state 选项。 选择
|
|
指示是创建还是删除对象。 选择
|
|
虚拟域,在先前定义的虚拟域中。vdom 是 FortiGate 的虚拟实例,可以配置并用作不同的单元。 默认值: |
备注
注意
旧版 fortiosapi 已弃用,httpapi 是运行 playbook 的首选方式
该模块支持 check_mode。
示例
- name: Configure virtual IP for IPv6.
fortinet.fortios.fortios_firewall_vip6:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
firewall_vip6:
add_nat64_route: "disable"
arp_reply: "disable"
color: "0"
comment: "Comment."
embedded_ipv4_address: "disable"
extip: "<your_own_value>"
extport: "<your_own_value>"
h2_support: "enable"
h3_support: "enable"
http_cookie_age: "60"
http_cookie_domain: "<your_own_value>"
http_cookie_domain_from_host: "disable"
http_cookie_generation: "0"
http_cookie_path: "<your_own_value>"
http_cookie_share: "disable"
http_ip_header: "enable"
http_ip_header_name: "<your_own_value>"
http_multiplex: "enable"
http_redirect: "enable"
https_cookie_secure: "disable"
id: "23"
ipv4_mappedip: "<your_own_value>"
ipv4_mappedport: "<your_own_value>"
ldb_method: "static"
mappedip: "<your_own_value>"
mappedport: "<your_own_value>"
max_embryonic_connections: "1000"
monitor:
-
name: "default_name_31 (source firewall.ldb-monitor.name)"
name: "default_name_32"
nat_source_vip: "disable"
nat64: "disable"
nat66: "disable"
ndp_reply: "disable"
outlook_web_access: "disable"
persistence: "none"
portforward: "disable"
protocol: "tcp"
quic:
ack_delay_exponent: "3"
active_connection_id_limit: "2"
active_migration: "enable"
grease_quic_bit: "enable"
max_ack_delay: "25"
max_datagram_frame_size: "1500"
max_idle_timeout: "30000"
max_udp_payload_size: "1500"
realservers:
-
client_ip: "<your_own_value>"
healthcheck: "disable"
holddown_interval: "300"
http_host: "myhostname"
id: "55"
ip: "<your_own_value>"
max_connections: "0"
monitor:
-
name: "default_name_59 (source firewall.ldb-monitor.name)"
port: "0"
status: "active"
translate_host: "enable"
weight: "1"
server_type: "http"
src_filter:
-
range: "<your_own_value>"
src_vip_filter: "disable"
ssl_accept_ffdhe_groups: "enable"
ssl_algorithm: "high"
ssl_certificate: "<your_own_value> (source vpn.certificate.local.name)"
ssl_certificate_dict:
-
name: "default_name_72 (source vpn.certificate.local.name)"
ssl_cipher_suites:
-
cipher: "TLS-AES-128-GCM-SHA256"
priority: "<you_own_value>"
versions: "ssl-3.0"
ssl_client_fallback: "disable"
ssl_client_rekey_count: "0"
ssl_client_renegotiation: "allow"
ssl_client_session_state_max: "1000"
ssl_client_session_state_timeout: "30"
ssl_client_session_state_type: "disable"
ssl_dh_bits: "768"
ssl_hpkp: "disable"
ssl_hpkp_age: "5184000"
ssl_hpkp_backup: "<your_own_value> (source vpn.certificate.local.name vpn.certificate.ca.name)"
ssl_hpkp_include_subdomains: "disable"
ssl_hpkp_primary: "<your_own_value> (source vpn.certificate.local.name vpn.certificate.ca.name)"
ssl_hpkp_report_uri: "<your_own_value>"
ssl_hsts: "disable"
ssl_hsts_age: "5184000"
ssl_hsts_include_subdomains: "disable"
ssl_http_location_conversion: "enable"
ssl_http_match_host: "enable"
ssl_max_version: "ssl-3.0"
ssl_min_version: "ssl-3.0"
ssl_mode: "half"
ssl_pfs: "require"
ssl_send_empty_frags: "enable"
ssl_server_algorithm: "high"
ssl_server_cipher_suites:
-
cipher: "TLS-AES-128-GCM-SHA256"
priority: "<you_own_value>"
versions: "ssl-3.0"
ssl_server_max_version: "ssl-3.0"
ssl_server_min_version: "ssl-3.0"
ssl_server_renegotiation: "enable"
ssl_server_session_state_max: "100"
ssl_server_session_state_timeout: "60"
ssl_server_session_state_type: "disable"
type: "static-nat"
uuid: "<your_own_value>"
weblogic_server: "disable"
websphere_server: "disable"
返回值
通用返回值记录在 此处,以下是此模块独有的字段
键 |
描述 |
---|---|
FortiGate 映像的构建版本号 已返回: 始终 示例: |
|
上次用于将内容置备到 FortiGate 的方法 已返回: 始终 示例: |
|
FortiGate在上次操作中给出的最后结果 已返回: 始终 示例: |
|
上次调用FortiGate时使用的主密钥(ID) 返回: success 示例: |
|
用于满足请求的表名 已返回: 始终 示例: |
|
用于满足请求的表的路径 已返回: 始终 示例: |
|
内部修订号 已返回: 始终 示例: |
|
设备的序列号 已返回: 始终 示例: |
|
操作结果的指示 已返回: 始终 示例: |
|
使用的虚拟域 已返回: 始终 示例: |
|
FortiGate 的版本 已返回: 始终 示例: |