fortinet.fortios.fortios_wireless_controller_vap 模块 – 在 Fortinet 的 FortiOS 和 FortiGate 中配置虚拟接入点 (VAP)。

注意

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

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

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

要在 playbook 中使用它,请指定:fortinet.fortios.fortios_wireless_controller_vap

fortinet.fortios 2.0.0 中的新增功能

概要

  • 此模块能够通过允许用户设置和修改 wireless_controller 功能和 vap 类别来配置 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"

state

字符串 / 必需

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

选项

  • "present"

  • "absent"

vdom

字符串

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

默认值: "root"

wireless_controller_vap

字典

配置虚拟接入点 (VAP)。

access_control_list

字符串

访问控制列表的配置文件名称。源 wireless-controller.access-control-list.name。

acct_interim_interval

整数

WiFi RADIUS 计费临时间隔(60 - 86400 秒)。

additional_akms

列表 / 元素=字符串

附加的 AKM。

选项

  • "akm6"

  • "akm24"

address_group

字符串

防火墙地址组名称。源 firewall.addrgrp.name。

address_group_policy

字符串

配置地址组中 MAC 地址的 MAC 地址过滤策略。

选项

  • "disable"

  • "allow"

  • "deny"

akm24_only

字符串

仅使用组相关哈希的 WPA3 SAE。

选项

  • "disable"

  • "enable"

alias

字符串

别名。

antivirus_profile

字符串

防病毒配置文件名称。源 antivirus.profile.name。

application_detection_engine

字符串

启用/禁用应用程序检测引擎。

选项

  • "enable"

  • "disable"

application_dscp_marking

字符串

启用/禁用基于应用程序属性的 DSCP 标记。

选项

  • "enable"

  • "disable"

application_list

字符串

应用程序控制列表名称。源 application.list.name。

application_report_intv

整数

应用程序报告间隔(30 - 864000 秒)。

atf_weight

整数

空中时间权重(百分比)。

auth

字符串

身份验证协议。

选项

  • "radius"

  • "usergroup"

  • "psk"

auth_cert

字符串

HTTPS 服务器证书。源 vpn.certificate.local.name。

auth_portal_addr

字符串

强制门户的地址。

beacon_advertising

列表 / 元素=字符串

Fortinet 信标广告 IE 数据。

选项

  • "name"

  • "model"

  • "serial-number"

beacon_protection

字符串

启用/禁用信标保护支持。

选项

  • "disable"

  • "enable"

broadcast_ssid

字符串

启用/禁用广播 SSID。

选项

  • "enable"

  • "disable"

broadcast_suppression

列表 / 元素=字符串

广播消息的可选抑制。例如,您可以将 DHCP 消息、ARP 广播等保留在无线网络之外。

选项

  • "dhcp-up"

  • "dhcp-down"

  • "dhcp-starvation"

  • "dhcp-ucast"

  • "arp-known"

  • "arp-unknown"

  • "arp-reply"

  • "arp-poison"

  • "arp-proxy"

  • "netbios-ns"

  • "netbios-ds"

  • "ipv6"

  • "all-other-mc"

  • "all-other-bc"

bss_color_partial

字符串

启用/禁用 802.11ax 部分 BSS 颜色。

选项

  • "enable"

  • "disable"

bstm_disassociation_imminent

字符串

启用/禁用在 BSTM 请求计时器达到后强制断开连接。

选项

  • "enable"

  • "disable"

bstm_load_balancing_disassoc_timer

整数

客户端因 AP 负载平衡而被迫断开连接之前自愿离开 AP 的时间间隔(0 到 30)。

bstm_rssi_disassoc_timer

整数

客户端因 RSSI 低而被迫断开连接之前自愿离开 AP 的时间间隔(0 到 2000)。

captive_portal

字符串

启用/禁用强制门户。

选项

  • "enable"

  • "disable"

captive_portal_ac_name

字符串

本地桥接强制门户 ac-name。

captive_portal_auth_timeout

整数

硬超时 - AP 将始终在超时后清除会话,而不管流量如何(0 - 864000 秒)。

captive_portal_fw_accounting

字符串

启用/禁用强制门户防火墙身份验证会话的 RADIUS 计费。

选项

  • "enable"

  • "disable"

captive_portal_macauth_radius_secret

字符串

访问 macauth RADIUS 服务器的密钥。

captive_portal_macauth_radius_server

字符串

强制门户外部 RADIUS 服务器域名或 IP 地址。

captive_portal_radius_secret

字符串

访问 RADIUS 服务器的密钥。

captive_portal_radius_server

字符串

访客门户 RADIUS 服务器域名或 IP 地址。

captive_portal_session_timeout_interval

整数

会话超时时间间隔(0 - 864000 秒)。

dhcp_address_enforcement

字符串

启用/禁用 DHCP 地址强制执行。

选项

  • "enable"

  • "disable"

dhcp_lease_time

整数

NAT IP 地址的 DHCP 租约时间(以秒为单位)。

dhcp_option43_insertion

字符串

启用/禁用 DHCP 选项 43 的插入。

选项

  • "enable"

  • "disable"

dhcp_option82_circuit_id_insertion

字符串

启用/禁用 DHCP 选项 82 电路 ID 插入。

选项

  • "style-1"

  • "style-2"

  • "style-3"

  • "disable"

dhcp_option82_insertion

字符串

启用/禁用 DHCP 选项 82 的插入。

选项

  • "enable"

  • "disable"

dhcp_option82_remote_id_insertion

字符串

启用/禁用 DHCP 选项 82 远程 ID 插入。

选项

  • "style-1"

  • "disable"

domain_name_stripping

字符串

启用/禁用从身份中删除域名。

选项

  • "disable"

  • "enable"

dynamic_vlan

字符串

启用/禁用动态 VLAN 分配。

选项

  • "enable"

  • "disable"

eap_reauth

字符串

为 WPA-Enterprise 安全启用/禁用 EAP 重新身份验证。

选项

  • "enable"

  • "disable"

eap_reauth_intv

整数

EAP 重新身份验证时间间隔(1800 - 864000 秒)。

eapol_key_retries

字符串

启用/禁用 EAPOL-Key 帧(消息 3/4 和组消息 1/2)的重传。

选项

  • "disable"

  • "enable"

encrypt

字符串

要使用的加密协议(仅当安全设置为 WPA 类型时可用)。

选项

  • "TKIP"

  • "AES"

  • "TKIP-AES"

external_fast_roaming

字符串

启用/禁用与非 FortiGate 管理的外部 AP 的快速漫游或预身份验证。

选项

  • "enable"

  • "disable"

external_logout

字符串

外部身份验证注销服务器的 URL。

external_web

字符串

外部身份验证 Web 服务器的 URL。

external_web_format

字符串

URL 查询参数检测。

选项

  • "auto-detect"

  • "no-query-string"

  • "partial-query-string"

fast_bss_transition

字符串

启用/禁用 802.11r 快速 BSS 转换 (FT)。

选项

  • "disable"

  • "enable"

fast_roaming

字符串

在客户端支持的情况下启用/禁用快速漫游或预身份验证。

选项

  • "enable"

  • "disable"

ft_mobility_domain

整数

FT 中的移动域标识符(1 - 65535)。

ft_over_ds

字符串

启用/禁用通过分发系统 (DS) 的 FT。

选项

  • "disable"

  • "enable"

ft_r0_key_lifetime

整数

FT 中 PMK-R0 密钥的生存期,1-65535 分钟。

gas_comeback_delay

整数

GAS 返回延迟(0 或 100 - 10000 毫秒)。

gas_fragmentation_limit

整数

GAS 分片限制 (512 - 4096)。

gtk_rekey

字符串

为 WPA 安全启用/禁用 GTK 重新密钥。

选项

  • "enable"

  • "disable"

gtk_rekey_intv

整数

GTK 重新密钥时间间隔(600 - 864000 秒)。

high_efficiency

字符串

启用/禁用 802.11ax 高效率。

选项

  • "enable"

  • "disable"

hotspot20_profile

字符串

Hotspot 2.0 配置文件名称。源 wireless-controller.hotspot20.hs-profile.name。

igmp_snooping

字符串

启用/禁用 IGMP 侦听。

选项

  • "enable"

  • "disable"

intra_vap_privacy

字符串

启用/禁用阻止同一 SSID 上的客户端之间的通信(称为 SSID 内隐私)。

选项

  • "enable"

  • "disable"

ip

字符串

本地独立 NAT 子网的 IP 地址和子网掩码。

ips_sensor

字符串

IPS 传感器名称。源 ips.sensor.name。

ipv6_rules

列表 / 元素=字符串

IPv6 数据包的可选规则。例如,您可以关闭无线网络上的 RA、RS 等。

选项

  • "drop-icmp6ra"

  • "drop-icmp6rs"

  • "drop-llmnr6"

  • "drop-icmp6mld2"

  • "drop-dhcp6s"

  • "drop-dhcp6c"

  • "ndp-proxy"

  • "drop-ns-dad"

  • "drop-ns-nondad"

key

字符串

WEP 密钥。

keyindex

整数

WEP 密钥索引 (1 - 4)。

l3_roaming

字符串

启用/禁用第 3 层漫游。

选项

  • "enable"

  • "disable"

l3_roaming_mode

字符串

选择传递第 3 层漫游流量的方式。

选项

  • "direct"

  • "indirect"

ldpc

字符串

VAP 低密度奇偶校验 (LDPC) 编码配置。

选项

  • "disable"

  • "rx"

  • "tx"

  • "rxtx"

local_authentication

字符串

启用/禁用 AP 本地身份验证。

选项

  • "enable"

  • "disable"

local_bridging

字符串

启用/禁用 FortiAP 上无线接口和以太网接口的桥接。

选项

  • "enable"

  • "disable"

local_lan

字符串

允许/拒绝发往 A 类、B 类或 C 类专用 IP 地址的流量。

选项

  • "allow"

  • "deny"

local_lan_partition

字符串

启用/禁用将客户端流量隔离到本地 LAN 端。

选项

  • "enable"

  • "disable"

local_standalone

字符串

启用/禁用 AP 本地独立。

选项

  • "enable"

  • "disable"

local_standalone_dns

字符串

启用/禁用 AP 本地独立 DNS。

选项

  • "enable"

  • "disable"

local_standalone_dns_ip

列表 / 元素=字符串

本地独立 DNS 的 IPv4 地址。

local_standalone_nat

字符串

启用/禁用 AP 本地独立 NAT 模式。

选项

  • "enable"

  • "disable"

mac_auth_bypass

字符串

启用/禁用 MAC 身份验证旁路。

选项

  • "enable"

  • "disable"

mac_called_station_delimiter

字符串

MAC 被叫站分隔符。

选项

  • "hyphen"

  • "single-hyphen"

  • "colon"

  • "none"

mac_calling_station_delimiter

字符串

MAC 主叫站分隔符。

选项

  • "hyphen"

  • "single-hyphen"

  • "colon"

  • "none"

mac_case

字符串

MAC 大小写。

选项

  • "uppercase"

  • "lowercase"

mac_filter

字符串

启用/禁用 MAC 过滤,以按 MAC 地址阻止无线客户端。

选项

  • "enable"

  • "disable"

mac_filter_list

list / elements=dictionary

创建用于 MAC 地址过滤的 MAC 地址列表。

id

integer / required

ID。请参阅 <a href=’#notes’>备注</a>。

mac

字符串

MAC 地址。

mac_filter_policy

字符串

拒绝或允许使用此 MAC 地址的客户端。

选项

  • "allow"

  • "deny"

mac_filter_policy_other

字符串

允许或阻止不在过滤器列表中的 MAC 地址的客户端。

选项

  • "allow"

  • "deny"

mac_password_delimiter

字符串

MAC 身份验证密码分隔符。

选项

  • "hyphen"

  • "single-hyphen"

  • "colon"

  • "none"

mac_username_delimiter

字符串

MAC 身份验证用户名分隔符。

选项

  • "hyphen"

  • "single-hyphen"

  • "colon"

  • "none"

max_clients

整数

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

max_clients_ap

整数

每个 AP 无线电可以同时连接到 VAP 的最大客户端数。

mbo

字符串

启用/禁用多频段操作。

选项

  • "disable"

  • "enable"

mbo_cell_data_conn_pref

字符串

MBO 蜂窝数据连接首选项(0、1 或 255)。

选项

  • "excluded"

  • "prefer-not"

  • "prefer-use"

me_disable_thresh

整数

当这么多客户端接收组播流量时,禁用组播增强。

mesh_backhaul

字符串

启用/禁用将此 VAP 用作 WiFi 网状回程。仅当安全设置为 WPA 类型或开放时,此条目才可用。

选项

  • "enable"

  • "disable"

mpsk

字符串

启用/禁用多个 PSK 身份验证。

选项

  • "enable"

  • "disable"

mpsk_concurrent_clients

整数

使用多个 PSK 身份验证中的同一密码连接的最大并发客户端数(0 - 65535)。

mpsk_key

list / elements=dictionary

多个 PSK 条目的列表。

comment

字符串

注释。

concurrent_clients

字符串

可以使用此预共享密钥连接的客户端数。

key_name

字符串 / 必需

预共享密钥名称。

mpsk_schedules

list / elements=dictionary

MPSK 密码的防火墙计划。仅当至少一个计划有效时,密码才会生效。

name

字符串 / 必需

计划名称。源 firewall.schedule.group.name firewall.schedule.recurring.name firewall.schedule.onetime.name。

passphrase

字符串

WPA 预共享密钥。

mpsk_profile

字符串

MPSK 配置文件名称。源 wireless-controller.mpsk-profile.name。

mu_mimo

字符串

启用/禁用多用户 MIMO。

选项

  • "enable"

  • "disable"

multicast_enhance

字符串

启用/禁用将组播转换为单播以提高性能。

选项

  • "enable"

  • "disable"

multicast_rate

字符串

组播速率(0、6000、12000 或 24000 kbps)。

选项

  • "0"

  • "6000"

  • "12000"

  • "24000"

nac

字符串

启用/禁用网络访问控制。

选项

  • "enable"

  • "disable"

nac_profile

字符串

NAC 配置文件名称。源 wireless-controller.nac-profile.name。

name

字符串 / 必需

虚拟 AP 名称。

nas_filter_rule

字符串

启用/禁用 NAS 筛选规则支持。

选项

  • "enable"

  • "disable"

neighbor_report_dual_band

字符串

启用/禁用双频段邻居报告。

选项

  • "disable"

  • "enable"

okc

字符串

启用/禁用机会密钥缓存 (OKC)。

选项

  • "disable"

  • "enable"

osen

字符串

启用/禁用 OSEN 作为密钥管理的一部分。

选项

  • "enable"

  • "disable"

owe_groups

列表 / 元素=字符串

OWE 组。

选项

  • "19"

  • "20"

  • "21"

owe_transition

字符串

启用/禁用 OWE 转换模式支持。

选项

  • "disable"

  • "enable"

owe_transition_ssid

字符串

OWE 转换模式对等 SSID。

passphrase

字符串

用于对 WiFi 用户进行身份验证的 WPA 预共享密钥 (PSK)。

pmf

字符串

受保护的管理帧 (PMF) 支持。

选项

  • "disable"

  • "enable"

  • "optional"

pmf_assoc_comeback_timeout

整数

受保护的管理帧 (PMF) 返回最大超时时间(1-20 秒)。

pmf_sa_query_retry_timeout

整数

受保护的管理帧 (PMF) SA 查询重试超时时间间隔(1 - 5 个 100 毫秒)。

port_macauth

字符串

启用/禁用 LAN 端口 MAC 身份验证。

选项

  • "disable"

  • "radius"

  • "address-group"

port_macauth_reauth_timeout

整数

LAN 端口 MAC 身份验证重新身份验证超时值。

port_macauth_timeout

整数

LAN 端口 MAC 身份验证空闲超时值。

portal_message_override_group

字符串

此 VAP 的替换消息组(仅当安全设置为访客门户类型时可用)。源 system.replacemsg-group.name。

portal_message_overrides

字典

单个消息覆盖。

auth_disclaimer_page

字符串

使用 portal-message-overrides 组中的消息覆盖 auth-disclaimer-page 消息。

auth_login_failed_page

字符串

使用 portal-message-overrides 组中的消息覆盖 auth-login-failed-page 消息。

auth_login_page

字符串

使用 portal-message-overrides 组中的消息覆盖 auth-login-page 消息。

auth_reject_page

字符串

使用 portal-message-overrides 组中的消息覆盖 auth-reject-page 消息。

portal_type

字符串

访客门户功能。配置访客门户如何验证用户身份以及是否包含免责声明。

选项

  • "auth"

  • "auth+disclaimer"

  • "disclaimer"

  • "email-collect"

  • "cmcc"

  • "cmcc-macauth"

  • "auth-mac"

  • "external-auth"

  • "external-macauth"

primary_wag_profile

字符串

主无线访问网关配置文件名称。源 wireless-controller.wag-profile.name。

probe_resp_suppression

字符串

启用/禁用探测响应抑制(以忽略弱信号)。

选项

  • "enable"

  • "disable"

probe_resp_threshold

字符串

AP 响应探测请求所需的最低信号电平/阈值(以 dBm 为单位)(-95 到 -20)。

ptk_rekey

字符串

为 WPA-Enterprise 安全启用/禁用 PTK 重新密钥。

选项

  • "enable"

  • "disable"

ptk_rekey_intv

整数

PTK 重新密钥时间间隔(600 - 864000 秒)。

qos_profile

字符串

服务质量配置文件名称。源 wireless-controller.qos-profile.name。

quarantine

字符串

启用/禁用站隔离。

选项

  • "enable"

  • "disable"

radio_2g_threshold

字符串

AP 响应在 2.4G 频段中接收数据包所需的最低信号电平/阈值(以 dBm 为单位)(-95 到 -20)。

radio_5g_threshold

字符串

AP 响应在 5G 频段中接收数据包所需的最低信号电平/阈值(以 dBm 为单位)(-95 到 -20)。

radio_sensitivity

字符串

启用/禁用软件无线电灵敏度(以忽略弱信号)。

选项

  • "enable"

  • "disable"

radius_mac_auth

字符串

启用/禁用客户端基于 RADIUS 的 MAC 身份验证。

选项

  • "enable"

  • "disable"

radius_mac_auth_block_interval

整数

如果客户端在特定时间间隔内被拒绝,则不再发送 RADIUS MAC 身份验证请求(0 或 30 - 864000 秒)。

radius_mac_auth_server

字符串

基于 RADIUS 的 MAC 身份验证服务器。源 user.radius.name。

radius_mac_auth_usergroups

list / elements=dictionary

允许进行 RADIUS MAC 身份验证的精选用户组。

name

字符串 / 必需

用户组名称。

radius_mac_mpsk_auth

字符串

为 MPSK 身份验证启用/禁用客户端基于 RADIUS 的 MAC 身份验证。

选项

  • "enable"

  • "disable"

radius_mac_mpsk_timeout

整数

RADIUS MAC MPSK 缓存超时时间间隔(0 或 300 - 864000)。

radius_server

字符串

用于对 WiFi 用户进行身份验证的 RADIUS 服务器。源 user.radius.name。

rates_11a

列表 / 元素=字符串

802.11a 的允许数据速率。

选项

  • "6"

  • "6-basic"

  • "9"

  • "9-basic"

  • "12"

  • "12-basic"

  • "18"

  • "18-basic"

  • "24"

  • "24-basic"

  • "36"

  • "36-basic"

  • "48"

  • "48-basic"

  • "54"

  • "54-basic"

  • "1"

  • "1-basic"

  • "2"

  • "2-basic"

  • "5.5"

  • "5.5-basic"

  • "11"

  • "11-basic"

rates_11ac_mcs_map

字符串

以逗号分隔的列表,其中包含空间流 1 到 8 的最大支持 VHT MCS。

rates_11ac_ss12

列表 / 元素=字符串

802.11ac 具有 1 或 2 个空间流的允许数据速率。

选项

  • "mcs0/1"

  • "mcs1/1"

  • "mcs2/1"

  • "mcs3/1"

  • "mcs4/1"

  • "mcs5/1"

  • "mcs6/1"

  • "mcs7/1"

  • "mcs8/1"

  • "mcs9/1"

  • "mcs10/1"

  • "mcs11/1"

  • "mcs0/2"

  • "mcs1/2"

  • "mcs2/2"

  • "mcs3/2"

  • "mcs4/2"

  • "mcs5/2"

  • "mcs6/2"

  • "mcs7/2"

  • "mcs8/2"

  • "mcs9/2"

  • "mcs10/2"

  • "mcs11/2"

rates_11ac_ss34

列表 / 元素=字符串

允许 802.11ac 在 3 或 4 个空间流下的数据速率。

选项

  • "mcs0/3"

  • "mcs1/3"

  • "mcs2/3"

  • "mcs3/3"

  • "mcs4/3"

  • "mcs5/3"

  • "mcs6/3"

  • "mcs7/3"

  • "mcs8/3"

  • "mcs9/3"

  • "mcs10/3"

  • "mcs11/3"

  • "mcs0/4"

  • "mcs1/4"

  • "mcs2/4"

  • "mcs3/4"

  • "mcs4/4"

  • "mcs5/4"

  • "mcs6/4"

  • "mcs7/4"

  • "mcs8/4"

  • "mcs9/4"

  • "mcs10/4"

  • "mcs11/4"

rates_11ax_mcs_map

字符串

以逗号分隔的列表,表示空间流 1 到 8 所支持的最大 HE MCS。

rates_11ax_ss12

列表 / 元素=字符串

允许 802.11ax 在 1 或 2 个空间流下的数据速率。

选项

  • "mcs0/1"

  • "mcs1/1"

  • "mcs2/1"

  • "mcs3/1"

  • "mcs4/1"

  • "mcs5/1"

  • "mcs6/1"

  • "mcs7/1"

  • "mcs8/1"

  • "mcs9/1"

  • "mcs10/1"

  • "mcs11/1"

  • "mcs0/2"

  • "mcs1/2"

  • "mcs2/2"

  • "mcs3/2"

  • "mcs4/2"

  • "mcs5/2"

  • "mcs6/2"

  • "mcs7/2"

  • "mcs8/2"

  • "mcs9/2"

  • "mcs10/2"

  • "mcs11/2"

rates_11ax_ss34

列表 / 元素=字符串

允许 802.11ax 在 3 或 4 个空间流下的数据速率。

选项

  • "mcs0/3"

  • "mcs1/3"

  • "mcs2/3"

  • "mcs3/3"

  • "mcs4/3"

  • "mcs5/3"

  • "mcs6/3"

  • "mcs7/3"

  • "mcs8/3"

  • "mcs9/3"

  • "mcs10/3"

  • "mcs11/3"

  • "mcs0/4"

  • "mcs1/4"

  • "mcs2/4"

  • "mcs3/4"

  • "mcs4/4"

  • "mcs5/4"

  • "mcs6/4"

  • "mcs7/4"

  • "mcs8/4"

  • "mcs9/4"

  • "mcs10/4"

  • "mcs11/4"

rates_11be_mcs_map

字符串

以逗号分隔的列表,表示 20MHz/40MHz/80MHz 带宽下支持 EHT-MCS 0-9、10-11、12-13 的最大 nss。

rates_11be_mcs_map_160

字符串

以逗号分隔的列表,表示 160MHz 带宽下支持 EHT-MCS 0-9、10-11、12-13 的最大 nss。

rates_11be_mcs_map_320

字符串

以逗号分隔的列表,表示 320MHz 带宽下支持 EHT-MCS 0-9、10-11、12-13 的最大 nss。

rates_11bg

列表 / 元素=字符串

允许 802.11b/g 的数据速率。

选项

  • "1"

  • "1-basic"

  • "2"

  • "2-basic"

  • "5.5"

  • "5.5-basic"

  • "11"

  • "11-basic"

  • "6"

  • "6-basic"

  • "9"

  • "9-basic"

  • "12"

  • "12-basic"

  • "18"

  • "18-basic"

  • "24"

  • "24-basic"

  • "36"

  • "36-basic"

  • "48"

  • "48-basic"

  • "54"

  • "54-basic"

rates_11n_ss12

列表 / 元素=字符串

允许 802.11n 在 1 或 2 个空间流下的数据速率。

选项

  • "mcs0/1"

  • "mcs1/1"

  • "mcs2/1"

  • "mcs3/1"

  • "mcs4/1"

  • "mcs5/1"

  • "mcs6/1"

  • "mcs7/1"

  • "mcs8/2"

  • "mcs9/2"

  • "mcs10/2"

  • "mcs11/2"

  • "mcs12/2"

  • "mcs13/2"

  • "mcs14/2"

  • "mcs15/2"

rates_11n_ss34

列表 / 元素=字符串

允许 802.11n 在 3 或 4 个空间流下的数据速率。

选项

  • "mcs16/3"

  • "mcs17/3"

  • "mcs18/3"

  • "mcs19/3"

  • "mcs20/3"

  • "mcs21/3"

  • "mcs22/3"

  • "mcs23/3"

  • "mcs24/4"

  • "mcs25/4"

  • "mcs26/4"

  • "mcs27/4"

  • "mcs28/4"

  • "mcs29/4"

  • "mcs30/4"

  • "mcs31/4"

roaming_acct_interim_update

字符串

启用/禁用在 WPA-Enterprise 安全漫游时使用临时更新而不是会计开始/停止。

选项

  • "enable"

  • "disable"

sae_groups

列表 / 元素=字符串

SAE 组。

选项

  • "19"

  • "20"

  • "21"

  • "1"

  • "2"

  • "5"

  • "14"

  • "15"

  • "16"

  • "17"

  • "18"

  • "27"

  • "28"

  • "29"

  • "30"

  • "31"

sae_h2e_only

字符串

使用仅哈希到元素机制进行 PWE 推导。

选项

  • "enable"

  • "disable"

sae_hnp_only

字符串

使用仅搜索和啄食机制进行 PWE 推导。

选项

  • "enable"

  • "disable"

sae_password

字符串

用于验证 WiFi 用户的 WPA3 SAE 密码。

sae_pk

字符串

启用/禁用 WPA3 SAE-PK。

选项

  • "enable"

  • "disable"

sae_private_key

字符串

用于 WPA3 SAE-PK 身份验证的私钥。

scan_botnet_connections

字符串

阻止或监视与僵尸网络服务器的连接或禁用僵尸网络扫描。

选项

  • "disable"

  • "monitor"

  • "block"

schedule

list / elements=dictionary

用于在 FortiAP 上启用此 VAP 的防火墙计划。当至少一个计划有效时,此 VAP 将被启用。用空格分隔多个计划名称。

name

字符串 / 必需

计划名称。源 firewall.schedule.group.name firewall.schedule.recurring.name firewall.schedule.onetime.name。

secondary_wag_profile

字符串

辅助无线接入网关配置文件名称。源 wireless-controller.wag-profile.name。

security

字符串

无线接口的安全模式。

选项

  • "open"

  • "wep64"

  • "wep128"

  • "wpa-personal"

  • "wpa-enterprise"

  • "wpa-only-personal"

  • "wpa-only-enterprise"

  • "wpa2-only-personal"

  • "wpa2-only-enterprise"

  • "wpa3-enterprise"

  • "wpa3-only-enterprise"

  • "wpa3-enterprise-transition"

  • "wpa3-sae"

  • "wpa3-sae-transition"

  • "owe"

  • "osen"

  • "captive-portal"

  • "wpa-personal+captive-portal"

  • "wpa-only-personal+captive-portal"

  • "wpa2-only-personal+captive-portal"

security_exempt_list

字符串

用于强制门户身份验证的可选安全豁免列表。源 user.security-exempt-list.name。

security_obsolete_option

字符串

启用/禁用过时的安全选项。

选项

  • "enable"

  • "disable"

security_redirect_url

字符串

用户通过强制门户身份验证后重定向的可选 URL。

selected_usergroups

list / elements=dictionary

允许进行身份验证的选择性用户组。

name

字符串 / 必需

用户组名称。源 user.group.name。

set_80211k

字符串

启用/禁用 802.11k 辅助漫游。

选项

  • "disable"

  • "enable"

set_80211v

字符串

启用/禁用 802.11v 辅助漫游。

选项

  • "disable"

  • "enable"

split_tunneling

字符串

启用/禁用拆分隧道。

选项

  • "enable"

  • "disable"

ssid

字符串

无线接口的 IEEE 802.11 服务集标识符 (SSID)。希望使用无线网络的用户必须将其计算机配置为访问此 SSID 名称。

sticky_client_remove

字符串

启用/禁用粘性客户端删除以保持 SSID 中信号良好的客户端。

选项

  • "enable"

  • "disable"

sticky_client_threshold_2g

字符串

AP 为 2G 客户端提供服务的所需最小信号电平/阈值(以 dBm 为单位)(-95 到 -20)。

sticky_client_threshold_5g

字符串

AP 为 5G 客户端提供服务的所需最小信号电平/阈值(以 dBm 为单位)(-95 到 -20)。

sticky_client_threshold_6g

字符串

AP 为 6G 客户端提供服务的所需最小信号电平/阈值(以 dBm 为单位)(-95 到 -20)。

target_wake_time

字符串

启用/禁用 802.11ax 目标唤醒时间。

选项

  • "enable"

  • "disable"

tkip_counter_measure

字符串

启用/禁用 TKIP 对策。

选项

  • "enable"

  • "disable"

tunnel_echo_interval

整数

向主隧道和辅助隧道对等方发送回显的时间间隔(1 - 65535 秒)。

tunnel_fallback_interval

整数

辅助隧道回退到主隧道的时间间隔(0 - 65535 秒)。

usergroup

list / elements=dictionary

用于验证 WiFi 用户的防火墙用户组。

name

字符串 / 必需

用户组名称。源 user.group.name。

utm_log

字符串

启用/禁用 UTM 日志记录。

选项

  • "enable"

  • "disable"

utm_profile

字符串

UTM 配置文件名称。源 wireless-controller.utm-profile.name。

utm_status

字符串

启用此选项可向 VAP 添加一个或多个安全配置文件(AV、IPS 等)。

选项

  • "enable"

  • "disable"

vdom

字符串

已将虚拟 AP 添加到的 VDOM 的名称。源 system.vdom.name。

vlan_auto

字符串

启用/禁用 SSID VLAN 接口的自动管理。

选项

  • "enable"

  • "disable"

vlan_name

list / elements=dictionary

用于将 VLAN 名称映射到 VLAN ID 的表。

name

字符串 / 必需

VLAN 名称。

vlan_id

列表 / 元素=整数

VLAN ID(最多 8 个 VLAN ID)。

vlan_pool

list / elements=dictionary

VLAN 池。

id

integer / required

ID。请参阅 <a href=’#notes’>备注</a>。

wtp_group

字符串

WTP 组名称。源 wireless-controller.wtp-group.name。

vlan_pooling

字符串

启用/禁用 VLAN 池,以允许将多个无线控制器 VLAN 分组到 VLAN 池中。当设置为 wtp-group 时,VLAN 池化会通过 wtp-group 的 VLAN 分配进行。

选项

  • "wtp-group"

  • "round-robin"

  • "hash"

  • "disable"

vlanid

整数

可选 VLAN ID。

voice_enterprise

字符串

启用/禁用 802.11k 和 802.11v 辅助的 Voice-Enterprise 漫游。

选项

  • "disable"

  • "enable"

webfilter_profile

字符串

WebFilter 配置文件名称。源 webfilter.profile.name。

注释

注意

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

  • 该模块支持 check_mode。

示例

- name: Configure Virtual Access Points (VAPs).
  fortinet.fortios.fortios_wireless_controller_vap:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      wireless_controller_vap:
          access_control_list: "<your_own_value> (source wireless-controller.access-control-list.name)"
          acct_interim_interval: "43200"
          additional_akms: "akm6"
          address_group: "<your_own_value> (source firewall.addrgrp.name)"
          address_group_policy: "disable"
          akm24_only: "disable"
          alias: "<your_own_value>"
          antivirus_profile: "<your_own_value> (source antivirus.profile.name)"
          application_detection_engine: "enable"
          application_dscp_marking: "enable"
          application_list: "<your_own_value> (source application.list.name)"
          application_report_intv: "120"
          atf_weight: "20"
          auth: "radius"
          auth_cert: "<your_own_value> (source vpn.certificate.local.name)"
          auth_portal_addr: "<your_own_value>"
          beacon_advertising: "name"
          beacon_protection: "disable"
          broadcast_ssid: "enable"
          broadcast_suppression: "dhcp-up"
          bss_color_partial: "enable"
          bstm_disassociation_imminent: "enable"
          bstm_load_balancing_disassoc_timer: "10"
          bstm_rssi_disassoc_timer: "200"
          captive_portal: "enable"
          captive_portal_ac_name: "<your_own_value>"
          captive_portal_auth_timeout: "0"
          captive_portal_fw_accounting: "enable"
          captive_portal_macauth_radius_secret: "<your_own_value>"
          captive_portal_macauth_radius_server: "<your_own_value>"
          captive_portal_radius_secret: "<your_own_value>"
          captive_portal_radius_server: "<your_own_value>"
          captive_portal_session_timeout_interval: "432000"
          dhcp_address_enforcement: "enable"
          dhcp_lease_time: "2400"
          dhcp_option43_insertion: "enable"
          dhcp_option82_circuit_id_insertion: "style-1"
          dhcp_option82_insertion: "enable"
          dhcp_option82_remote_id_insertion: "style-1"
          domain_name_stripping: "disable"
          dynamic_vlan: "enable"
          eap_reauth: "enable"
          eap_reauth_intv: "86400"
          eapol_key_retries: "disable"
          encrypt: "TKIP"
          external_fast_roaming: "enable"
          external_logout: "<your_own_value>"
          external_web: "<your_own_value>"
          external_web_format: "auto-detect"
          fast_bss_transition: "disable"
          fast_roaming: "enable"
          ft_mobility_domain: "1000"
          ft_over_ds: "disable"
          ft_r0_key_lifetime: "480"
          gas_comeback_delay: "500"
          gas_fragmentation_limit: "1024"
          gtk_rekey: "enable"
          gtk_rekey_intv: "86400"
          high_efficiency: "enable"
          hotspot20_profile: "<your_own_value> (source wireless-controller.hotspot20.hs-profile.name)"
          igmp_snooping: "enable"
          intra_vap_privacy: "enable"
          ip: "<your_own_value>"
          ips_sensor: "<your_own_value> (source ips.sensor.name)"
          ipv6_rules: "drop-icmp6ra"
          key: "<your_own_value>"
          keyindex: "1"
          l3_roaming: "enable"
          l3_roaming_mode: "direct"
          ldpc: "disable"
          local_authentication: "enable"
          local_bridging: "enable"
          local_lan: "allow"
          local_lan_partition: "enable"
          local_standalone: "enable"
          local_standalone_dns: "enable"
          local_standalone_dns_ip: "<your_own_value>"
          local_standalone_nat: "enable"
          mac_auth_bypass: "enable"
          mac_called_station_delimiter: "hyphen"
          mac_calling_station_delimiter: "hyphen"
          mac_case: "uppercase"
          mac_filter: "enable"
          mac_filter_list:
              -
                  id: "87"
                  mac: "<your_own_value>"
                  mac_filter_policy: "allow"
          mac_filter_policy_other: "allow"
          mac_password_delimiter: "hyphen"
          mac_username_delimiter: "hyphen"
          max_clients: "0"
          max_clients_ap: "0"
          mbo: "disable"
          mbo_cell_data_conn_pref: "excluded"
          me_disable_thresh: "32"
          mesh_backhaul: "enable"
          mpsk: "enable"
          mpsk_concurrent_clients: "32767"
          mpsk_key:
              -
                  comment: "Comment."
                  concurrent_clients: "<your_own_value>"
                  key_name: "<your_own_value>"
                  mpsk_schedules:
                      -
                          name: "default_name_106 (source firewall.schedule.group.name firewall.schedule.recurring.name firewall.schedule.onetime.name)"
                  passphrase: "<your_own_value>"
          mpsk_profile: "<your_own_value> (source wireless-controller.mpsk-profile.name)"
          mu_mimo: "enable"
          multicast_enhance: "enable"
          multicast_rate: "0"
          nac: "enable"
          nac_profile: "<your_own_value> (source wireless-controller.nac-profile.name)"
          name: "default_name_114"
          nas_filter_rule: "enable"
          neighbor_report_dual_band: "disable"
          okc: "disable"
          osen: "enable"
          owe_groups: "19"
          owe_transition: "disable"
          owe_transition_ssid: "<your_own_value>"
          passphrase: "<your_own_value>"
          pmf: "disable"
          pmf_assoc_comeback_timeout: "1"
          pmf_sa_query_retry_timeout: "2"
          port_macauth: "disable"
          port_macauth_reauth_timeout: "7200"
          port_macauth_timeout: "600"
          portal_message_override_group: "<your_own_value> (source system.replacemsg-group.name)"
          portal_message_overrides:
              auth_disclaimer_page: "<your_own_value>"
              auth_login_failed_page: "<your_own_value>"
              auth_login_page: "<your_own_value>"
              auth_reject_page: "<your_own_value>"
          portal_type: "auth"
          primary_wag_profile: "<your_own_value> (source wireless-controller.wag-profile.name)"
          probe_resp_suppression: "enable"
          probe_resp_threshold: "<your_own_value>"
          ptk_rekey: "enable"
          ptk_rekey_intv: "86400"
          qos_profile: "<your_own_value> (source wireless-controller.qos-profile.name)"
          quarantine: "enable"
          radio_2g_threshold: "<your_own_value>"
          radio_5g_threshold: "<your_own_value>"
          radio_sensitivity: "enable"
          radius_mac_auth: "enable"
          radius_mac_auth_block_interval: "0"
          radius_mac_auth_server: "<your_own_value> (source user.radius.name)"
          radius_mac_auth_usergroups:
              -
                  name: "default_name_150"
          radius_mac_mpsk_auth: "enable"
          radius_mac_mpsk_timeout: "86400"
          radius_server: "<your_own_value> (source user.radius.name)"
          rates_11a: "6"
          rates_11ac_mcs_map: "<your_own_value>"
          rates_11ac_ss12: "mcs0/1"
          rates_11ac_ss34: "mcs0/3"
          rates_11ax_mcs_map: "<your_own_value>"
          rates_11ax_ss12: "mcs0/1"
          rates_11ax_ss34: "mcs0/3"
          rates_11be_mcs_map: "<your_own_value>"
          rates_11be_mcs_map_160: "<your_own_value>"
          rates_11be_mcs_map_320: "<your_own_value>"
          rates_11bg: "1"
          rates_11n_ss12: "mcs0/1"
          rates_11n_ss34: "mcs16/3"
          roaming_acct_interim_update: "enable"
          sae_groups: "19"
          sae_h2e_only: "enable"
          sae_hnp_only: "enable"
          sae_password: "<your_own_value>"
          sae_pk: "enable"
          sae_private_key: "<your_own_value>"
          scan_botnet_connections: "disable"
          schedule:
              -
                  name: "default_name_176 (source firewall.schedule.group.name firewall.schedule.recurring.name firewall.schedule.onetime.name)"
          secondary_wag_profile: "<your_own_value> (source wireless-controller.wag-profile.name)"
          security: "open"
          security_exempt_list: "<your_own_value> (source user.security-exempt-list.name)"
          security_obsolete_option: "enable"
          security_redirect_url: "<your_own_value>"
          selected_usergroups:
              -
                  name: "default_name_183 (source user.group.name)"
          set_80211k: "disable"
          set_80211v: "disable"
          split_tunneling: "enable"
          ssid: "<your_own_value>"
          sticky_client_remove: "enable"
          sticky_client_threshold_2g: "<your_own_value>"
          sticky_client_threshold_5g: "<your_own_value>"
          sticky_client_threshold_6g: "<your_own_value>"
          target_wake_time: "enable"
          tkip_counter_measure: "enable"
          tunnel_echo_interval: "300"
          tunnel_fallback_interval: "7200"
          usergroup:
              -
                  name: "default_name_197 (source user.group.name)"
          utm_log: "enable"
          utm_profile: "<your_own_value> (source wireless-controller.utm-profile.name)"
          utm_status: "enable"
          vdom: "<your_own_value> (source system.vdom.name)"
          vlan_auto: "enable"
          vlan_name:
              -
                  name: "default_name_204"
                  vlan_id: "<your_own_value>"
          vlan_pool:
              -
                  id: "207"
                  wtp_group: "<your_own_value> (source wireless-controller.wtp-group.name)"
          vlan_pooling: "wtp-group"
          vlanid: "0"
          voice_enterprise: "disable"
          webfilter_profile: "<your_own_value> (source webfilter.profile.name)"

返回值

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

密钥

描述

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"

作者

  • Link Zheng (@chillancezen)

  • Jie Xue (@JieX19)

  • Hongbin Lu (@fgtdev-hblu)

  • Frank Shen (@frankshen01)

  • Miguel Angel Munoz (@mamunozgonzalez)

  • Nicolas Thomas (@thomnico)