Spec-Zone.ru › Ansible

модуль fortinet.fortios.fortios_wireless_controller_vap – настройка виртуальных точек доступа (VAP) в Fortinet FortiOS и FortiGate.

Примечание

Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_wireless_controller_vap.

Добавлено в fortinet.fortios 2.0.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя функцию wireless_controller и категорию vap. Перед использованием необходимо скорректировать все параметры и значения в примерах с учетом источников данных. Проверено на FOS v6.0.0

Требования

На хосте, выполняющем этот модуль, должны быть установлены следующие компоненты.

  • ansible>=2.16

Параметры

Параметр

Комментарии

access_token

string

Аутентификация на основе токена. Создается в графическом интерфейсе FortiGate.

enable_log

boolean

Включить/отключить ведение журнала для задачи.

Варианты:

  • false ← (по умолчанию)
  • true

member_path

string

Путь к атрибуту элемента, над которым выполняется операция.

Если атрибутов несколько, они разделяются косой чертой.

Параметр с отметкой member_path можно использовать для выполнения операций с элементами.

member_state

string

Добавить или удалить элемент по указанному пути к атрибуту.

Если указан member_state, параметр state игнорируется.

Варианты:

  • "present"
  • "absent"

state

string / обязательный

Указывает, нужно ли создать или удалить объект.

Варианты:

  • "present"
  • "absent"

vdom

string

Виртуальный домен из числа предварительно определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство.

По умолчанию: "root"

wireless_controller_vap

dictionary

Настройка виртуальных точек доступа (VAP).

access_control_list

string

Имя профиля списка контроля доступа. Источник: wireless-controller.access-control-list.name.

acct_interim_interval

integer

Интервал промежуточной отправки данных учета Wi-Fi RADIUS (60–86400 с).

additional_akms

list / elements=string

Дополнительные AKM.

Варианты:

  • "akm6"
  • "akm24"

address_group

string

Имя группы адресов брандмауэра. Источник: firewall.addrgrp.name.

address_group_policy

string

Настройка политики фильтрации MAC-адресов, входящих в группу адресов.

Варианты:

  • "disable"
  • "allow"
  • "deny"

akm24_only

string

WPA3 SAE только с хешированием, зависящим от группы.

Варианты:

  • "disable"
  • "enable"

alias

string

Псевдоним.

antivirus_profile

string

Имя профиля Antivirus. Источник: antivirus.profile.name.

application_detection_engine

string

Включить/отключить механизм обнаружения приложений.

Варианты:

  • "enable"
  • "disable"

application_dscp_marking

string

Включить/отключить маркировку DSCP на основе атрибутов приложения.

Варианты:

  • "enable"
  • "disable"

application_list

string

Имя списка контроля приложений. Источник: application.list.name.

application_report_intv

integer

Интервал формирования отчета о приложениях (30–864000 с).

atf_weight

integer

Вес airtime в процентах.

auth

string

Протокол аутентификации.

Варианты:

  • "radius"
  • "usergroup"
  • "psk"

auth_cert

string

Сертификат HTTPS-сервера. Источник: vpn.certificate.local.name.

auth_portal_addr

string

Адрес портала авторизации.

beacon_advertising

list / elements=string

Данные IE для рекламы маяковых кадров Fortinet.

Варианты:

  • "name"
  • "model"
  • "serial-number"

beacon_protection

string

Включить/отключить поддержку защиты маяковых кадров.

Варианты:

  • "disable"
  • "enable"

broadcast_ssid

string

Включить/отключить широковещательную передачу SSID.

Варианты:

  • "enable"
  • "disable"

broadcast_suppression

list / elements=string

Необязательная фильтрация широковещательных сообщений. Например, можно исключить из беспроводной сети сообщения 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

string

Включить/отключить частичное окрашивание BSS в 802.11ax.

Варианты:

  • "enable"
  • "disable"

bstm_disassociation_imminent

string

Включить/отключить принудительное отключение после истечения таймера запроса BSTM.

Варианты:

  • "enable"
  • "disable"

bstm_load_balancing_disassoc_timer

integer

Интервал, в течение которого клиент может добровольно отключиться от точки доступа до принудительного отключения из-за балансировки нагрузки точки доступа (от 0 до 30).

bstm_rssi_disassoc_timer

integer

Интервал, в течение которого клиент может добровольно отключиться от точки доступа до принудительного отключения из-за низкого RSSI (от 0 до 2000).

called_station_id_type

string

Формат атрибута RADIUS Called-Station-Id.

Варианты:

  • "mac"
  • "ip"
  • "apname"

captive_network_assistant_bypass

string

Включить/отключить обход Captive Network Assistant.

Варианты:

  • "enable"
  • "disable"

captive_portal

string

Включить/отключить портал авторизации.

Варианты:

  • "enable"
  • "disable"

captive_portal_ac_name

string

Имя AC портала авторизации с локальным мостовым подключением.

captive_portal_auth_timeout

integer

Жесткий тайм-аут — точка доступа всегда завершает сеанс по истечении тайм-аута независимо от наличия трафика (0–864000 с).

captive_portal_fw_accounting

string

Включить/отключить учет RADIUS для сеанса аутентификации брандмауэра на портале авторизации.

Варианты:

  • "enable"
  • "disable"

captive_portal_macauth_radius_secret

string

Секретный ключ для доступа к серверу RADIUS с аутентификацией по MAC-адресу.

captive_portal_macauth_radius_server

string

Доменное имя или IP-адрес внешнего сервера RADIUS для портала авторизации.

captive_portal_radius_secret

string

Секретный ключ для доступа к серверу RADIUS.

captive_portal_radius_server

string

Доменное имя или IP-адрес сервера RADIUS для портала авторизации.

captive_portal_session_timeout_interval

integer

Интервал тайм-аута сеанса (0–864000 с).

dhcp_address_enforcement

string

Включить/отключить контроль адресов DHCP.

Варианты:

  • "enable"
  • "disable"

dhcp_lease_time

integer

Срок аренды DHCP в секундах для NAT IP-адреса.

dhcp_option43_insertion

string

Включить/отключить добавление параметра DHCP 43.

Варианты:

  • "enable"
  • "disable"

dhcp_option82_circuit_id_insertion

string

Включить/отключить добавление circuit-id параметра DHCP 82.

Варианты:

  • "style-1"
  • "style-2"
  • "style-3"
  • "disable"

dhcp_option82_insertion

string

Включить/отключить добавление параметра DHCP 82.

Варианты:

  • "enable"
  • "disable"

dhcp_option82_remote_id_insertion

string

Включить/отключить добавление remote-id параметра DHCP 82.

Варианты:

  • "style-1"
  • "disable"

domain_name_stripping

string

Включить/отключить удаление доменного имени из идентификатора.

Варианты:

  • "disable"
  • "enable"

dynamic_vlan

string

Включить/отключить динамическое назначение VLAN.

Варианты:

  • "enable"
  • "disable"

eap_reauth

string

Включить/отключить повторную аутентификацию EAP для защиты WPA-Enterprise.

Варианты:

  • "enable"
  • "disable"

eap_reauth_intv

integer

Интервал повторной аутентификации EAP (1800–864000 с).

eapol_key_retries

string

Включить/отключить повторную передачу кадров EAPOL-Key (сообщение 3/4 и групповое сообщение 1/2).

Варианты:

  • "disable"
  • "enable"

encrypt

string

Используемый протокол шифрования (доступен только, если для параметра security задан тип WPA).

Варианты:

  • "TKIP"
  • "AES"
  • "TKIP-AES"

external_fast_roaming

string

Включение/отключение быстрого роуминга или предварительной аутентификации с внешними точками доступа, не управляемыми FortiGate.

Варианты:

  • "enable"
  • "disable"

external_logout

string

URL сервера выхода из системы внешней аутентификации.

external_pre_auth

string

Включение/отключение предварительной аутентификации с внешними точками доступа, не управляемыми FortiGate.

Варианты:

  • "enable"
  • "disable"

external_web

string

URL веб-сервера внешней аутентификации.

external_web_format

string

Определение параметров запроса URL.

Варианты:

  • "auto-detect"
  • "no-query-string"
  • "partial-query-string"

fast_bss_transition

string

Включение/отключение быстрого перехода BSS (FT) по стандарту 802.11r.

Варианты:

  • "disable"
  • "enable"

fast_roaming

string

Включение/отключение быстрого роуминга или предварительной аутентификации, если это поддерживается клиентами.

Варианты:

  • "enable"
  • "disable"

ft_mobility_domain

integer

Идентификатор домена мобильности в FT (1–65535).

ft_over_ds

string

Включение/отключение FT через систему распределения (DS).

Варианты:

  • "disable"
  • "enable"

ft_r0_key_lifetime

integer

Срок действия ключа PMK-R0 в FT, 1–65535 минут.

gas_comeback_delay

integer

Задержка возврата GAS (0 или 100–10000 миллисекунд).

gas_fragmentation_limit

integer

Предел фрагментации GAS (512–4096).

gtk_rekey

string

Включение/отключение повторной генерации GTK для защиты WPA.

Варианты:

  • "enable"
  • "disable"

gtk_rekey_intv

integer

Интервал повторной генерации GTK (600–864000 с).

high_efficiency

string

Включение/отключение режима высокой эффективности 802.11ax.

Варианты:

  • "enable"
  • "disable"

hotspot20_profile

string

Имя профиля Hotspot 2.0. Источник: wireless-controller.hotspot20.hs-profile.name.

igmp_snooping

string

Включение/отключение отслеживания IGMP.

Варианты:

  • "enable"
  • "disable"

intra_vap_privacy

string

Включение/отключение блокировки обмена данными между клиентами одной и той же сети SSID (так называемая изоляция клиентов в пределах SSID).

Варианты:

  • "enable"
  • "disable"

ip

string

IP-адрес и маска подсети для локальной автономной подсети NAT.

ips_sensor

string

Имя датчика IPS. Источник: ips.sensor.name.

ipv6_rules

list / elements=string

Необязательные правила для пакетов IPv6. Например, можно запретить передачу RA, RS и других пакетов в беспроводной сети.

Варианты:

  • "drop-icmp6ra"
  • "drop-icmp6rs"
  • "drop-llmnr6"
  • "drop-icmp6mld2"
  • "drop-dhcp6s"
  • "drop-dhcp6c"
  • "ndp-proxy"
  • "drop-ns-dad"
  • "drop-ns-nondad"

key

string

Ключ WEP.

keyindex

integer

Индекс ключа WEP (1–4).

l3_roaming

string

Включение/отключение роуминга уровня 3.

Варианты:

  • "enable"
  • "disable"

l3_roaming_mode

string

Выбор способа передачи трафика роуминга уровня 3.

Варианты:

  • "direct"
  • "indirect"

ldpc

string

Настройка кодирования VAP с проверкой на четность низкой плотности (LDPC).

Варианты:

  • "disable"
  • "rx"
  • "tx"
  • "rxtx"

local_authentication

string

Включение/отключение локальной аутентификации точки доступа.

Варианты:

  • "enable"
  • "disable"

local_bridging

string

Включение/отключение моста между беспроводными и Ethernet-интерфейсами на FortiAP.

Варианты:

  • "enable"
  • "disable"

local_lan

string

Разрешение/запрет трафика, адресованного частному IP-адресу класса A, B или C.

Варианты:

  • "allow"
  • "deny"

local_lan_partition

string

Включение/отключение изоляции клиентского трафика в сегменте локальной сети.

Варианты:

  • "enable"
  • "disable"

local_standalone

string

Включение/отключение автономного режима точки доступа.

Варианты:

  • "enable"
  • "disable"

local_standalone_dns

string

Включение/отключение локального DNS в автономном режиме точки доступа.

Варианты:

  • "enable"
  • "disable"

local_standalone_dns_ip

list / elements=string

Адреса IPv4 для локального DNS в автономном режиме.

local_standalone_nat

string

Включение/отключение режима локального NAT в автономном режиме точки доступа.

Варианты:

  • "enable"
  • "disable"

mac_auth_bypass

string

Включение/отключение обхода аутентификации MAC.

Варианты:

  • "enable"
  • "disable"

mac_called_station_delimiter

string

Разделитель MAC-адреса вызываемой станции.

Варианты:

  • "hyphen"
  • "single-hyphen"
  • "colon"
  • "none"

mac_calling_station_delimiter

string

Разделитель MAC-адреса вызывающей станции.

Варианты:

  • "hyphen"
  • "single-hyphen"
  • "colon"
  • "none"

mac_case

string

Регистр символов MAC-адреса.

Варианты:

  • "uppercase"
  • "lowercase"

mac_filter

string

Включение/отключение фильтрации MAC для блокировки беспроводных клиентов по MAC-адресу.

Варианты:

  • "enable"
  • "disable"

mac_filter_list

list / elements=dictionary

Создание списка MAC-адресов для фильтрации по MAC-адресу.

id

integer / обязательный

Идентификатор. См. <a href=’#notes’>Примечания</a>.

mac

string

MAC-адрес.

mac_filter_policy

string

Запретить или разрешить подключение клиента с этим MAC-адресом.

Варианты:

  • "allow"
  • "deny"

mac_filter_policy_other

string

Разрешить или заблокировать клиентов с MAC-адресами, отсутствующими в списке фильтрации.

Варианты:

  • "allow"
  • "deny"

mac_password_delimiter

string

Разделитель пароля для аутентификации MAC.

Варианты:

  • "hyphen"
  • "single-hyphen"
  • "colon"
  • "none"

mac_username_delimiter

string

Разделитель имени пользователя для аутентификации MAC.

Варианты:

  • "hyphen"
  • "single-hyphen"
  • "colon"
  • "none"

max_clients

integer

Максимальное количество клиентов, которые могут одновременно подключиться к VAP.

max_clients_ap

integer

Максимальное количество клиентов, которые могут одновременно подключиться к VAP на одну радиостанцию точки доступа.

mbo

string

Включение/отключение многодиапазонной работы.

Варианты:

  • "disable"
  • "enable"

mbo_cell_data_conn_pref

string

Предпочтение подключения к сотовой сети передачи данных MBO (0, 1 или 255).

Варианты:

  • "excluded"
  • "prefer-not"
  • "prefer-use"

me_disable_thresh

integer

Отключать оптимизацию многоадресной рассылки, когда такое количество клиентов принимает многоадресный трафик.

mesh_backhaul

string

Включение или отключение использования этой VAP в качестве транзитного соединения Wi-Fi mesh. Эта запись доступна только при выборе типа безопасности WPA или открытого режима.

Варианты:

  • "enable"
  • "disable"

mlo

string

Включение или отключение Multi-Link Operation в Wi-Fi 7.

Варианты:

  • "disable"
  • "enable"

mpsk

string

Включение или отключение аутентификации с несколькими предварительно общими ключами (PSK).

Варианты:

  • "enable"
  • "disable"

mpsk_concurrent_clients

integer

Максимальное число одновременно подключенных клиентов, использующих одну и ту же парольную фразу при аутентификации с несколькими PSK (0–65535).

mpsk_key

list / elements=dictionary

Список записей нескольких PSK.

comment

string

Комментарий.

concurrent_clients

string

Количество клиентов, которые могут подключиться с использованием этого предварительно общего ключа.

key_name

string / обязательный

Имя предварительно общего ключа.

mpsk_schedules

list / elements=dictionary

Расписание брандмауэра для парольной фразы MPSK. Парольная фраза будет действовать, только если действительно хотя бы одно расписание.

name

string / обязательный

Имя расписания. Источник: firewall.schedule.group.name, firewall.schedule.recurring.name, firewall.schedule.onetime.name.

passphrase

string

Предварительно общий ключ WPA.

mpsk_profile

string

Имя профиля MPSK. Источник: wireless-controller.mpsk-profile.name.

mu_mimo

string

Включение или отключение многопользовательского MIMO.

Варианты:

  • "enable"
  • "disable"

multicast_enhance

string

Включение или отключение преобразования многоадресного трафика в одноадресный для повышения производительности.

Варианты:

  • "enable"
  • "disable"

multicast_rate

string

Скорость многоадресной передачи (0, 6000, 12000 или 24000 кбит/с).

Варианты:

  • "0"
  • "6000"
  • "12000"
  • "24000"

nac

string

Включение или отключение контроля сетевого доступа.

Варианты:

  • "enable"
  • "disable"

nac_profile

string

Имя профиля NAC. Источник: wireless-controller.nac-profile.name.

name

string / обязательный

Имя виртуальной точки доступа.

nas_filter_rule

string

Включение или отключение поддержки правил фильтрации NAS.

Варианты:

  • "enable"
  • "disable"

neighbor_report_dual_band

string

Включение или отключение отчета о соседних точках доступа в двух диапазонах.

Варианты:

  • "disable"
  • "enable"

okc

string

Включение или отключение кэширования ключей по запросу (OKC).

Варианты:

  • "disable"
  • "enable"

osen

string

Включение или отключение OSEN в качестве средства управления ключами.

Варианты:

  • "enable"
  • "disable"

owe_groups

list / elements=string

Группы OWE.

Варианты:

  • "19"
  • "20"
  • "21"

owe_transition

string

Включение или отключение поддержки режима перехода OWE.

Варианты:

  • "disable"
  • "enable"

owe_transition_ssid

string

SSID узла-партнера для режима перехода OWE.

passphrase

string

Предварительно общий ключ WPA (PSK), используемый для аутентификации пользователей Wi-Fi.

pmf

string

Поддержка защищенных кадров управления (PMF).

Варианты:

  • "disable"
  • "enable"
  • "optional"

pmf_assoc_comeback_timeout

integer

Максимальный тайм-аут ожидания повторного подключения для защищенных кадров управления (PMF) (1–20 с).

pmf_sa_query_retry_timeout

integer

Интервал тайм-аута повторной попытки запроса SA для защищенных кадров управления (PMF) (1–5 единиц по 100 мс).

port_macauth

string

Включение или отключение MAC-аутентификации порта LAN.

Варианты:

  • "disable"
  • "radius"
  • "address-group"

port_macauth_reauth_timeout

integer

Значение тайм-аута повторной аутентификации MAC-адреса порта LAN.

port_macauth_timeout

integer

Значение тайм-аута бездействия для MAC-аутентификации порта LAN.

portal_message_override_group

string

Группа сообщений для замены сообщений этой VAP (доступна только при выборе типа безопасности с порталом авторизации). Источник: system.replacemsg-group.name.

portal_message_overrides

dictionary

Переопределение отдельных сообщений.

auth_disclaimer_page

string

Заменить сообщение auth-disclaimer-page сообщением из группы portal-message-overrides.

auth_login_failed_page

string

Заменить сообщение auth-login-failed-page сообщением из группы portal-message-overrides.

auth_login_page

string

Заменить сообщение auth-login-page сообщением из группы portal-message-overrides.

auth_reject_page

string

Заменить сообщение auth-reject-page сообщением из группы portal-message-overrides.

portal_type

string

Функциональность портала авторизации. Настройте способ аутентификации пользователей порталом авторизации и наличие уведомления об отказе от ответственности.

Варианты:

  • "auth"
  • "auth+disclaimer"
  • "disclaimer"
  • "email-collect"
  • "cmcc"
  • "cmcc-macauth"
  • "auth-mac"
  • "external-auth"
  • "external-macauth"

pre_auth

string

Включение или отключение предварительной аутентификации, если она поддерживается клиентами.

Варианты:

  • "enable"
  • "disable"

primary_wag_profile

string

Имя основного профиля беспроводного шлюза доступа. Источник: wireless-controller.wag-profile.name.

probe_resp_suppression

string

Включение или отключение подавления ответов на запросы зондирования (для игнорирования слабых сигналов).

Варианты:

  • "enable"
  • "disable"

probe_resp_threshold

string

Минимальный уровень/порог сигнала в дБм, необходимый для ответа точки доступа на запросы зондирования (от -95 до -20).

ptk_rekey

string

Включение или отключение повторного создания PTK для защиты WPA-Enterprise.

Варианты:

  • "enable"
  • "disable"

ptk_rekey_intv

integer

Интервал повторного создания PTK (600–864000 с).

qos_profile

string

Имя профиля качества обслуживания. Источник: wireless-controller.qos-profile.name.

quarantine

string

Включение или отключение помещения станции в карантин.

Варианты:

  • "enable"
  • "disable"

radio_2g_threshold

string

Минимальный уровень/порог сигнала в дБм, необходимый для приема пакета точкой доступа в диапазоне 2,4 ГГц (от -95 до -20).

radio_5g_threshold

string

Минимальный уровень/порог сигнала в дБм, необходимый для приема пакета точкой доступа в диапазоне 5 ГГц (от -95 до -20).

radio_sensitivity

string

Включение или отключение программной настройки чувствительности радиоприемника (для игнорирования слабых сигналов).

Варианты:

  • "enable"
  • "disable"

radius_mac_auth

string

Включение или отключение MAC-аутентификации клиентов на основе RADIUS.

Варианты:

  • "enable"
  • "disable"

radius_mac_auth_block_interval

integer

Не отправлять повторный запрос MAC-аутентификации RADIUS, если клиенту было отказано в доступе в течение указанного интервала (0 или 30–864000 секунд).

radius_mac_auth_server

string

Сервер MAC-аутентификации на основе RADIUS. Источник: user.radius.name.

radius_mac_auth_usergroups

list / elements=dictionary

Выбранные группы пользователей, которым разрешена MAC-аутентификация RADIUS.

name

string / обязательный

Имя группы пользователей. Источник: user.group.name.

radius_mac_mpsk_auth

string

Включение или отключение аутентификации клиентов по MAC-адресу на основе RADIUS для аутентификации MPSK.

Варианты:

  • "enable"
  • "disable"

radius_mac_mpsk_timeout

integer

Интервал тайм-аута кэша RADIUS MAC MPSK (0 или 300–864000).

radius_server

string

Сервер RADIUS для аутентификации пользователей Wi-Fi. Источник: user.radius.name.

rates_11a

list / elements=string

Допустимые скорости передачи данных для 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

string

Список максимальных поддерживаемых значений VHT MCS для пространственных потоков с 1-го по 8-й, разделённый запятыми.

rates_11ac_ss12

list / elements=string

Допустимые скорости передачи данных для 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

list / elements=string

Допустимые скорости передачи данных для 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

string

Список максимальных поддерживаемых значений HE MCS для пространственных потоков с 1-го по 8-й, разделённый запятыми.

rates_11ax_ss12

list / elements=string

Допустимые скорости передачи данных для 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

list / elements=string

Допустимые скорости передачи данных для 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

string

Список максимальных значений NSS, поддерживающих EHT-MCS 0–9, 10–11, 12–13 для полосы пропускания 20/40/80 МГц, разделённый запятыми.

rates_11be_mcs_map_160

string

Список максимальных значений NSS, поддерживающих EHT-MCS 0–9, 10–11, 12–13 для полосы пропускания 160 МГц, разделённый запятыми.

rates_11be_mcs_map_320

string

Список максимальных значений NSS, поддерживающих EHT-MCS 0–9, 10–11, 12–13 для полосы пропускания 320 МГц, разделённый запятыми.

rates_11bg

list / elements=string

Допустимые скорости передачи данных для 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

list / elements=string

Допустимые скорости передачи данных для 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

list / elements=string

Допустимые скорости передачи данных для 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

string

Включение или отключение использования промежуточного обновления учётных данных вместо начала/завершения учёта при роуминге для защиты WPA-Enterprise.

Варианты:

  • "enable"
  • "disable"

sae_groups

list / elements=string

Группы SAE.

Варианты:

  • "19"
  • "20"
  • "21"
  • "1"
  • "2"
  • "5"
  • "14"
  • "15"
  • "16"
  • "17"
  • "18"
  • "27"
  • "28"
  • "29"
  • "30"
  • "31"

sae_h2e_only

string

Использовать для получения PWE только механизм hash-to-element.

Варианты:

  • "enable"
  • "disable"

sae_hnp_only

string

Использовать для получения PWE только механизм перебора вариантов (hunting-and-pecking).

Варианты:

  • "enable"
  • "disable"

sae_password

string

Пароль WPA3 SAE для аутентификации пользователей Wi-Fi.

sae_pk

string

Включение или отключение WPA3 SAE-PK.

Варианты:

  • "enable"
  • "disable"

sae_private_key

string

Закрытый ключ для аутентификации WPA3 SAE-PK.

scan_botnet_connections

string

Блокировать или отслеживать подключения к серверам ботнетов либо отключить сканирование ботнетов.

Варианты:

  • "disable"
  • "monitor"
  • "block"

schedule

list / elements=dictionary

Расписания межсетевого экрана для включения этой VAP на FortiAP. VAP будет включена, если действительно хотя бы одно из расписаний. Разделяйте несколько имён расписаний пробелом.

name

string / обязательный

Имя расписания. Источник: firewall.schedule.group.name, firewall.schedule.recurring.name, firewall.schedule.onetime.name.

secondary_wag_profile

string

Имя вторичного профиля шлюза беспроводного доступа. Источник: wireless-controller.wag-profile.name.

security

string

Режим безопасности беспроводного интерфейса.

Варианты:

  • "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

string

Необязательный список исключений безопасности для аутентификации на портале доступа. Источник: user.security-exempt-list.name.

security_obsolete_option

string

Включение или отключение устаревших параметров безопасности.

Варианты:

  • "enable"
  • "disable"

security_redirect_url

string

Необязательный URL для перенаправления пользователей после успешной аутентификации на портале доступа.

selected_usergroups

list / elements=dictionary

Выбранные группы пользователей, которым разрешена аутентификация.

name

string / обязательный

Имя группы пользователей. Источник: user.group.name.

set_80211k

string

Включение или отключение роуминга с поддержкой 802.11k.

Варианты:

  • "disable"
  • "enable"

set_80211v

string

Включение или отключение роуминга с поддержкой 802.11v.

Варианты:

  • "disable"
  • "enable"

split_tunneling

string

Включение или отключение раздельного туннелирования.

Варианты:

  • "enable"
  • "disable"

ssid

string

Идентификатор набора служб (SSID) IEEE 802.11 для беспроводного интерфейса. Пользователям, желающим подключиться к беспроводной сети, необходимо настроить компьютеры для доступа к сети с этим именем SSID.

sticky_client_remove

string

Включение или отключение удаления «липких» клиентов для поддержания в SSID клиентов с хорошим уровнем сигнала.

Варианты:

  • "enable"
  • "disable"

sticky_client_threshold_2g

string

Минимальный уровень/порог сигнала в дБм, необходимый для обслуживания клиента 2G точкой доступа (-95–-20).

sticky_client_threshold_5g

string

Минимальный уровень/порог сигнала в дБм, необходимый для обслуживания клиента 5G точкой доступа (-95–-20).

sticky_client_threshold_6g

string

Минимальный уровень/порог сигнала в дБм, необходимый для обслуживания клиента 6G точкой доступа (-95–-20).

target_wake_time

string

Включить или отключить целевое время пробуждения 802.11ax.

Варианты:

  • "enable"
  • "disable"

tkip_counter_measure

string

Включить или отключить контрмеры TKIP.

Варианты:

  • "enable"
  • "disable"

tunnel_echo_interval

integer

Интервал отправки эхо-запросов основному и вторичному узлам туннеля (1–65535 с).

tunnel_fallback_interval

integer

Интервал переключения вторичного туннеля на основной (0–65535 с).

usergroup

list / elements=dictionary

Группа пользователей брандмауэра для аутентификации пользователей Wi-Fi.

name

string / обязательный

Имя группы пользователей. Источник: user.group.name.

utm_log

string

Включить или отключить ведение журналов UTM.

Варианты:

  • "enable"
  • "disable"

utm_profile

string

Имя профиля UTM. Источник: wireless-controller.utm-profile.name.

utm_status

string

Включить добавление к VAP одного или нескольких профилей безопасности (AV, IPS и т. д.).

Варианты:

  • "enable"
  • "disable"

vdom

string

Имя VDOM, в который добавлена виртуальная точка доступа. Источник: system.vdom.name.

vlan_auto

string

Включить или отключить автоматическое управление интерфейсом VLAN SSID.

Варианты:

  • "enable"
  • "disable"

vlan_name

list / elements=dictionary

Таблица сопоставления имени VLAN с идентификатором VLAN.

name

string / обязательный

Имя VLAN.

vlan_id

list / elements=integer

Идентификаторы VLAN (не более 8).

vlan_pool

list / elements=dictionary

Пул VLAN.

id

integer / обязательный

Идентификатор. См. <a href=’#notes’>примечания</a>.

wtp_group

string

Имя группы WTP. Источник: wireless-controller.wtp-group.name.

vlan_pooling

string

Включить или отключить объединение VLAN в пулы, позволяющее группировать несколько VLAN контроллера беспроводной сети. Если задано значение wtp-group, VLAN объединяются в пулы с назначением VLAN по группе wtp-group.

Варианты:

  • "wtp-group"
  • "round-robin"
  • "hash"
  • "disable"

vlanid

integer

Необязательный идентификатор VLAN.

voice_enterprise

string

Включить или отключить роуминг Voice-Enterprise с поддержкой 802.11k и 802.11v.

Варианты:

  • "disable"
  • "enable"

webfilter_profile

string

Имя профиля WebFilter. Источник: webfilter.profile.name.

Примечания

Примечание

  • Устаревшая fortiosapi объявлена нерекомендуемой; предпочтительный способ запуска плейбуков — httpapi
  • Модуль поддерживает 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"
          called_station_id_type: "mac"
          captive_network_assistant_bypass: "enable"
          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_pre_auth: "enable"
          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: "90"
                  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"
          mlo: "disable"
          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_110 (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_118"
          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"
          pre_auth: "enable"
          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_155 (source user.group.name)"
          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_181 (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_188 (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_202 (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_209"
                  vlan_id: "<your_own_value>"
          vlan_pool:
              -
                  id: "212"
                  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

string

Номер сборки образа FortiGate

Возвращается: всегда

Пример: "1547"

http_method

string

Последний метод, использованный для передачи содержимого в FortiGate

Возвращается: всегда

Пример: "PUT"

http_status

string

Последний результат, возвращенный FortiGate для последней выполненной операции

Возвращается: всегда

Пример: "200"

mkey

string

Главный ключ (идентификатор), использованный при последнем вызове FortiGate

Возвращается: при успешном выполнении

Пример: "id"

name

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)

Ссылки на коллекцию

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortios/fortios_wireless_controller_vap_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API