fortinet.fortios.fortios_system_np6 模块 – 在 Fortinet 的 FortiOS 和 FortiGate 中配置 NP6 属性。

注意

此模块是 fortinet.fortios 集合（版本 2.3.8）的一部分。

如果您正在使用 ansible 包，您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install fortinet.fortios。您需要进一步的要求才能使用此模块，请参阅 要求 了解详细信息。

要在 playbook 中使用它，请指定：fortinet.fortios.fortios_system_np6。

fortinet.fortios 2.0.0 中的新增功能

概要

  • 此模块能够通过允许用户设置和修改系统功能和 np6 类别来配置 FortiGate 或 FortiOS (FOS) 设备。示例包括在使用前需要调整为数据源的所有参数和值。使用 FOS v6.0.0 进行测试

要求

以下要求需要在执行此模块的主机上满足。

  • ansible>=2.15

参数

参数

注释

access_token

string

基于令牌的身份验证。从 Fortigate 的 GUI 生成。

enable_log

boolean

启用/禁用任务日志记录。

选择

  • false ←（默认）

  • true

member_path

string

要操作的成员属性路径。

如果存在多个属性，则用斜杠字符分隔。

用 member_path 标记的参数对于执行成员操作是合法的。

member_state

string

在指定的属性路径下添加或删除成员。

指定 member_state 时，将忽略 state 选项。

选择

  • "present"

  • "absent"

state

string / 必需

指示是否创建或删除对象。

选择

  • "present"

  • "absent"

system_np6

dictionary

配置 NP6 属性。

fastpath

string

启用/禁用 NP6 卸载（也称为快速路径）。

选择

  • "disable"

  • "enable"

fp_anomaly

dictionary

NP6 IPv4 异常保护。trap-to-host 将异常会话转发到 CPU。

icmp_csum_err

string

无效的 IPv4 ICMP 校验和异常。

选择

  • "drop"

  • "trap-to-host"

icmp_frag

string

可能是第 4 层 ICMP 异常一部分的第 3 层分段数据包。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

icmp_land

string

ICMP Land 异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv4_csum_err

string

无效的 IPv4 IP 校验和异常。

选择

  • "drop"

  • "trap-to-host"

ipv4_land

string

Land 异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv4_optlsrr

string

松散源记录路由选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv4_optrr

string

记录路由选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv4_optsecurity

string

安全选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv4_optssrr

string

严格源记录路由选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv4_optstream

string

流选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv4_opttimestamp

string

时间戳选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv4_proto_err

string

无效的第 4 层协议异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv4_unknopt

string

未知选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_daddr_err

string

目标地址为未指定或环回地址异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_land

string

Land 异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_optendpid

string

端点标识异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_opthomeaddr

string

家庭地址选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_optinvld

string

无效的选项异常。无效的选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_optjumbo

string

巨型选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_optnsap

string

网络服务接入点地址选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_optralert

string

路由器警告选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_opttunnel

string

隧道封装限制选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_proto_err

string

第 4 层无效协议异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_saddr_err

string

源地址作为多播异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

ipv6_unknopt

string

未知选项异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

tcp_csum_err

string

无效的 IPv4 TCP 校验和异常。

选择

  • "drop"

  • "trap-to-host"

tcp_fin_noack

string

设置了 FIN 标志但未设置 ACK 的 TCP SYN 洪泛异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

tcp_fin_only

string

仅设置了 FIN 标志的 TCP SYN 洪泛异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

tcp_land

string

TCP Land 异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

tcp_no_flag

string

未设置任何标志的 TCP SYN 洪泛异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

tcp_syn_data

string

带有数据的 TCP SYN 洪泛数据包异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

tcp_syn_fin

string

设置了 TCP SYN 洪泛 SYN/FIN 标志异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

tcp_winnuke

string

TCP WinNuke 异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

udp_csum_err

string

无效的 IPv4 UDP 校验和异常。

选择

  • "drop"

  • "trap-to-host"

udp_land

string

UDP Land 异常。

选择

  • "allow"

  • "drop"

  • "trap-to-host"

garbage_session_collector

string

启用/禁用垃圾会话收集器。

选择

  • "disable"

  • "enable"

hpe

dictionary

HPE 配置。

arp_max

integer

最大 ARP 数据包速率（1K - 1G pps）。

enable_shaper

string

为数据包类型整形器启用/禁用 NPU 主机保护引擎 (HPE)。

选择

  • "disable"

  • "enable"

esp_max

integer

最大 ESP 数据包速率（1K - 1G pps）。

icmp_max

integer

最大 ICMP 数据包速率（1K - 1G pps）。

ip_frag_max

integer

最大分段 IP 数据包速率（1K - 1G pps）。

ip_others_max

integer

其他数据包的最大 IP 数据包速率（无法使用其他选项设置的数据包类型）（1K - 1G pps）。

l2_others_max

integer

不是 ARP 数据包的 L2 数据包的最大 L2 数据包速率（1K - 1G pps）。

pri_type_max

integer

优先级类型流量的最大溢出速率（1K - 1G pps）。包括 L2：HA、802.3ad LACP、心跳。L3：OSPF。L4_TCP：BGP。L4_UDP：IKE、SLBC、BFD。

sctp_max

integer

最大 SCTP 数据包速率（1K - 1G pps）。

tcp_max

integer

最大 TCP 数据包速率（1K - 1G pps）。

tcpfin_rst_max

integer

最大 TCP 携带 FIN 或 RST 标志的数据包速率（1K - 1G pps）。

tcpsyn_ack_max

integer

最大 TCP 携带 SYN 和 ACK 标志的数据包速率（1K - 1G pps）。

tcpsyn_max

integer

最大 TCP SYN 数据包速率（1K - 1G pps）。

udp_max

integer

最大 UDP 数据包速率（1K - 1G pps）。

ipsec_ob_hash_function

string

设置 IPSec 出站的哈希函数。

选择

  • "global-hash"

  • "round-robin-global"

ipsec_outbound_hash

string

启用/禁用 IPsec 出站流量的哈希函数。

选择

  • "disable"

  • "enable"

low_latency_mode

string

启用/禁用低延迟模式。

选择

  • "disable"

  • "enable"

名称

string / 必需

设备名称。

per_session_accounting

string

启用/禁用按会话计费。

选择

  • "disable"

  • "traffic-log-only"

  • "enable"

session_collector_interval

integer

设置垃圾会话收集清理间隔（1 - 100 秒）。

session_timeout_fixed

string

{disable | enable} 切换使用固定超时或随机超时来刷新 NP6 会话。

选择

  • "disable"

  • "enable"

session_timeout_interval

integer

设置刷新 NP6 会话的固定超时时间（0 - 1000 秒）。

session_timeout_random_range

integer

设置刷新 NP6 会话的随机超时范围（0 - 1000 秒）。

vdom

string

虚拟域，在先前定义的那些之中。vdom 是 FortiGate 的虚拟实例，可以配置并用作不同的单元。

默认值： "root"

注释

注意

  • 传统的 fortiosapi 已被弃用，httpapi 是运行 playbook 的首选方式

  • 该模块支持 check_mode。

示例

- name: Configure NP6 attributes.
  fortinet.fortios.fortios_system_np6:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      system_np6:
          fastpath: "disable"
          fp_anomaly:
              icmp_csum_err: "drop"
              icmp_frag: "allow"
              icmp_land: "allow"
              ipv4_csum_err: "drop"
              ipv4_land: "allow"
              ipv4_optlsrr: "allow"
              ipv4_optrr: "allow"
              ipv4_optsecurity: "allow"
              ipv4_optssrr: "allow"
              ipv4_optstream: "allow"
              ipv4_opttimestamp: "allow"
              ipv4_proto_err: "allow"
              ipv4_unknopt: "allow"
              ipv6_daddr_err: "allow"
              ipv6_land: "allow"
              ipv6_optendpid: "allow"
              ipv6_opthomeaddr: "allow"
              ipv6_optinvld: "allow"
              ipv6_optjumbo: "allow"
              ipv6_optnsap: "allow"
              ipv6_optralert: "allow"
              ipv6_opttunnel: "allow"
              ipv6_proto_err: "allow"
              ipv6_saddr_err: "allow"
              ipv6_unknopt: "allow"
              tcp_csum_err: "drop"
              tcp_fin_noack: "allow"
              tcp_fin_only: "allow"
              tcp_land: "allow"
              tcp_no_flag: "allow"
              tcp_syn_data: "allow"
              tcp_syn_fin: "allow"
              tcp_winnuke: "allow"
              udp_csum_err: "drop"
              udp_land: "allow"
          garbage_session_collector: "disable"
          hpe:
              arp_max: "200000"
              enable_shaper: "disable"
              esp_max: "200000"
              icmp_max: "200000"
              ip_frag_max: "200000"
              ip_others_max: "200000"
              l2_others_max: "200000"
              pri_type_max: "200000"
              sctp_max: "200000"
              tcp_max: "600000"
              tcpfin_rst_max: "600000"
              tcpsyn_ack_max: "600000"
              tcpsyn_max: "600000"
              udp_max: "600000"
          ipsec_ob_hash_function: "global-hash"
          ipsec_outbound_hash: "disable"
          low_latency_mode: "disable"
          name: "default_name_59"
          per_session_accounting: "disable"
          session_collector_interval: "64"
          session_timeout_fixed: "disable"
          session_timeout_interval: "40"
          session_timeout_random_range: "8"

返回值

通用返回值记录在此处，以下是此模块独有的字段

键

描述

build

string

FortiGate 镜像的构建号

返回： 总是

示例： "1547"

http_method

string

最后一次用于将内容配置到 FortiGate 的方法

返回： 总是

示例： "PUT"

http_status

string

FortiGate 在上次操作中给出的最后结果

返回： 总是

示例： "200"

mkey

string

最后一次调用 FortiGate 时使用的主键（id）

返回： 成功

示例： "id"

名称

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)