fortinet.fortios.fortios_wireless_controller_global 模块 – 在 Fortinet 的 FortiOS 和 FortiGate 中配置无线控制器全局设置。

注意

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

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

要安装它，请使用： ansible-galaxy collection install fortinet.fortios。您需要其他要求才能使用此模块，请参阅 要求 以了解详情。

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

fortinet.fortios 2.0.0 中的新增功能

概要

  • 此模块能够通过允许用户设置和修改 wireless_controller 功能和全局类别来配置 FortiGate 或 FortiOS (FOS) 设备。示例包括所有参数，使用前需要将值调整到数据源。已在 FOS v6.0.0 上测试。

要求

执行此模块的主机需要以下要求。

  • ansible>=2.15

参数

参数

注释

access_token

字符串

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

enable_log

布尔值

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

选项

  • false ← (默认)

  • true

member_path

字符串

要操作的成员属性路径。

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

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

member_state

字符串

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

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

选项

  • "present"

  • "absent"

vdom

字符串

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

默认： "root"

wireless_controller_global

字典

配置无线控制器全局设置。

acd_process_count

整数

为多核 CPU 支持配置 cw_acd 守护程序的数量。

ap_log_server

字符串

启用/禁用将 FortiGate 配置为重定向无线事件日志消息或 FortiAP 将 UTM 日志消息发送到 syslog 服务器。

选项

  • "enable"

  • "disable"

ap_log_server_ip

字符串

FortiGate 或 FortiAP 发送日志消息到的 IP 地址。

ap_log_server_port

整数

FortiGate 或 FortiAP 发送日志消息到的端口。

control_message_offload

列表 / 元素=字符串

配置 CAPWAP 控制消息数据通道卸载。

选项

  • "ebp-frame"

  • "aeroscout-tag"

  • "ap-list"

  • "sta-list"

  • "sta-cap-list"

  • "stats"

  • "aeroscout-mu"

  • "sta-health"

  • "spectral-analysis"

data_ethernet_II

字符串

配置无线控制器使用以太网 II 或 802.3 帧以及 802.3 数据隧道模式。

选项

  • "enable"

  • "disable"

dfs_lab_test

字符串

启用/禁用 DFS 证书实验室测试模式。

选项

  • "enable"

  • "disable"

discovery_mc_addr

字符串

AP 发现的多播 IP 地址。

fiapp_eth_type

整数

Fortinet 互连接入点协议 (IAPP) 或 IEEE 802.11f 数据包的以太网类型 (0 - 65535)。

image_download

字符串

启用/禁用加入时的 WTP 镜像下载。

选项

  • "enable"

  • "disable"

ipsec_base_ip

字符串

接入点和无线控制器之间 IPsec VPN 隧道的基本 IP 地址。

字符串

启用/禁用计算 CAPWAP 传输哈希以将会话负载均衡到链路聚合节点。

选项

  • "enable"

  • "disable"

location

字符串

无线控制器的地理位置描述。

max_ble_device

整数

控制器上存储的最大 BLE 设备数量。

max_clients

整数

可以同时连接的最大客户端数量。

max_retransmit

整数

隧道数据包重传的最大次数 (0 - 64)。

max_rogue_ap

整数

控制器上存储的最大 Rogue AP 数量。

max_rogue_ap_wtp

整数

控制器上存储的 Rogue AP 的 wtp 信息的最大数量 (1 - 16)。

max_rogue_sta

整数

控制器上存储的最大 Rogue 站点数量。

max_sta_cap

整数

控制器上存储的最大站点 cap 数量。

max_sta_cap_wtp

整数

控制器上存储的站点 cap 的 wtp 信息的最大数量 (1 - 16)。

mesh_eth_type

整数

包含在回程数据包中的网状以太网标识符 (0 - 65535)。

nac_interval

整数

两次 WiFi 网络访问控制 (NAC) 检查之间的间隔（秒）(10 - 600)。

name

字符串

无线控制器的名称。

rogue_scan_mac_adjacency

整数

AP 的以太网和无线 MAC 值之间的最大数值差异，以匹配 Rogue 检测 (0 - 31)。

rolling_wtp_upgrade

字符串

启用/禁用滚动式 WTP 升级。

选项

  • "enable"

  • "disable"

rolling_wtp_upgrade_threshold

字符串

需要进行滚动式 WTP 升级的受管 WTP 的最小信号电平/阈值（dBm）(-95 到 -20)。

tunnel_mode

字符串

兼容/严格的隧道模式。

选项

  • "compatible"

  • "strict"

wpad_process_count

整数

用于多核 CPU 支持的 Wpad 守护程序进程数。

wtp_share

字符串

启用/禁用在 VDOM 之间共享 WTP。

选项

  • "enable"

  • "disable"

备注

注意

  • 旧版 fortiosapi 已弃用，httpapi 是运行 playbook 的首选方法。

示例

- name: Configure wireless controller global settings.
  fortinet.fortios.fortios_wireless_controller_global:
      vdom: "{{ vdom }}"
      wireless_controller_global:
          acd_process_count: "0"
          ap_log_server: "enable"
          ap_log_server_ip: "<your_own_value>"
          ap_log_server_port: "0"
          control_message_offload: "ebp-frame"
          data_ethernet_II: "enable"
          dfs_lab_test: "enable"
          discovery_mc_addr: "<your_own_value>"
          fiapp_eth_type: "5252"
          image_download: "enable"
          ipsec_base_ip: "<your_own_value>"
          link_aggregation: "enable"
          location: "<your_own_value>"
          max_ble_device: "0"
          max_clients: "0"
          max_retransmit: "3"
          max_rogue_ap: "0"
          max_rogue_ap_wtp: "16"
          max_rogue_sta: "0"
          max_sta_cap: "0"
          max_sta_cap_wtp: "8"
          mesh_eth_type: "8755"
          nac_interval: "120"
          name: "default_name_26"
          rogue_scan_mac_adjacency: "7"
          rolling_wtp_upgrade: "enable"
          rolling_wtp_upgrade_threshold: "<your_own_value>"
          tunnel_mode: "compatible"
          wpad_process_count: "0"
          wtp_share: "enable"

返回值

常用的返回值已在此处记录，以下是此模块特有的字段。

键

描述

build

字符串

FortiGate镜像的构建编号

返回： 始终

示例： "1547"

http_method

字符串

上次用于将内容置入FortiGate的方法

返回： 始终

示例： "PUT"

http_status

字符串

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

返回： 始终

示例： "200"

mkey

字符串

上次调用FortiGate时使用的主密钥（ID）

返回： 成功

示例： "id"

name

字符串

用于满足请求的表名称

返回： 始终

示例： "urlfilter"

path

字符串

用于满足请求的表的路径

返回： 始终

示例： "webfilter"

revision

字符串

内部修订号

返回： 始终

示例： "17.0.2.10658"

serial

字符串

设备的序列号

返回： 始终

示例： "FGVMEVYYQT3AB5352"

status

字符串

操作结果指示

返回： 始终

示例： "success"

vdom

字符串

使用的虚拟域

返回： 始终

示例： "root"

version

字符串

FortiGate的版本

返回： 始终

示例： "v5.6.3"

作者

  • 郑连 (@chillancezen)

  • 薛杰 (@JieX19)

  • 卢洪宾 (@fgtdev-hblu)

  • 沈峰 (@frankshen01)

  • Miguel Angel Munoz (@mamunozgonzalez)

  • Nicolas Thomas (@thomnico)