Модуль fortinet.fortios.fortios_wireless_controller_global — настройка глобальных параметров беспроводного контроллера в 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_global.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя параметры функции wireless_controller и категории global. В примерах представлены все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием. Проверено с FOS v6.0.0
Требования
На узле, на котором выполняется этот модуль, должны быть установлены следующие компоненты.
- ansible>=2.16
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Аутентификация на основе токена. Создаётся в графическом интерфейсе FortiGate. |
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
member_path string | Путь к атрибуту элемента, над которым выполняется операция. Если атрибутов несколько, они разделяются косой чертой. Параметр member_path можно использовать для выполнения операции над элементом. |
member_state string | Добавить или удалить элемент по указанному пути атрибута. Если задан параметр member_state, параметр state игнорируется. Варианты:
|
vdom string | Виртуальный домен из числа ранее определённых. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
wireless_controller_global dictionary | Настройка глобальных параметров беспроводного контроллера. |
|
acd_process_count integer |
Настройка количества демонов cw_acd для поддержки многоядерных процессоров. |
|
ap_log_server string |
Включить или отключить настройку FortiGate для перенаправления сообщений журнала событий беспроводной сети или отправку FortiAP сообщений журнала UTM на сервер syslog. Варианты:
|
|
ap_log_server_ip string |
IP-адрес, на который FortiGate или FortiAP отправляет сообщения журнала. |
|
ap_log_server_port integer |
Порт, на который FortiGate или FortiAP отправляет сообщения журнала. |
|
control_message_offload list / elements=string |
Настройка разгрузки канала передачи данных для управляющих сообщений CAPWAP. Варианты:
|
|
data_ethernet_II string |
Настройка беспроводного контроллера для использования кадров Ethernet II или 802.3 в режиме туннеля данных 802.3. Варианты:
|
|
dfs_lab_test string |
Включить или отключить режим лабораторного тестирования сертификата DFS. Варианты:
|
|
discovery_mc_addr string |
Многоадресный IP-адрес для обнаружения точек доступа. |
|
discovery_mc_addr6 string |
Многоадресный IPv6-адрес для обнаружения точек доступа. |
|
fiapp_eth_type integer |
Тип Ethernet для пакетов Fortinet Inter-Access Point Protocol (IAPP), или IEEE 802.11f (0–65535). |
|
image_download string |
Включить или отключить загрузку образа WTP при подключении. Варианты:
|
|
ipsec_base_ip string |
Базовый IP-адрес для туннелей VPN IPsec между точками доступа и беспроводным контроллером. |
|
link_aggregation string |
Включить или отключить вычисление хеша передачи CAPWAP для балансировки нагрузки сеансов между узлами агрегации каналов. Варианты:
|
|
location string |
Описание местоположения беспроводного контроллера. |
|
max_ble_device integer |
Максимальное количество BLE-устройств, сохраняемых на контроллере. |
|
max_clients integer |
Максимальное количество клиентов, которые могут подключаться одновременно. |
|
max_retransmit integer |
Максимальное количество повторных передач туннельного пакета (0–64). |
|
max_rogue_ap integer |
Максимальное количество несанкционированных точек доступа, сохраняемых на контроллере. |
|
max_rogue_ap_wtp integer |
Максимальное количество сведений WTP о несанкционированных точках доступа, сохраняемых на контроллере (1–16). |
|
max_rogue_sta integer |
Максимальное количество несанкционированных станций, сохраняемых на контроллере. |
|
max_sta_cap integer |
Максимальное количество сведений о возможностях станций, сохраняемых на контроллере. |
|
max_sta_cap_wtp integer |
Максимальное количество сведений WTP о возможностях станций, сохраняемых на контроллере (1–16). |
|
max_sta_offline integer |
Максимальное количество сведений об отключённых станциях, сохраняемых на контроллере. |
|
max_sta_offline_ip2mac integer |
Максимальное количество записей ip2mac для отключённых станций, сохраняемых на контроллере. |
|
max_wids_entry integer |
Максимальное количество записей WIDS, сохраняемых на контроллере. |
|
mesh_eth_type integer |
Идентификатор Ethernet Mesh, включаемый в пакеты магистрального канала (0–65535). |
|
nac_interval integer |
Интервал в секундах между проверками контроля доступа к сети Wi-Fi (NAC) (10–600). |
|
name string |
Имя беспроводного контроллера. |
|
rogue_scan_mac_adjacency integer |
Максимальная числовая разница между значениями Ethernet- и беспроводного MAC-адреса точки доступа для её обнаружения как несанкционированной (0–31). |
|
rolling_wtp_upgrade string |
Включить или отключить последовательное обновление WTP. Варианты:
|
|
rolling_wtp_upgrade_threshold string |
Минимальный уровень сигнала/порог в дБм, необходимый для включения управляемого WTP в последовательное обновление WTP (от -95 до -20). |
|
tunnel_mode string |
Совместимый или строгий режим туннеля. Варианты:
|
|
wpad_process_count integer |
Количество процессов демона wpad для поддержки многоядерных процессоров. |
|
string |
Включить или отключить совместное использование WTP между VDOM. Варианты:
|
Примечания
Примечание
- Устаревший fortiosapi объявлен устаревшим; предпочтительный способ запуска сценариев — httpapi.
- Модуль поддерживает check_mode.
Примеры
- 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>"
discovery_mc_addr6: "<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"
max_sta_offline: "0"
max_sta_offline_ip2mac: "0"
max_wids_entry: "0"
mesh_eth_type: "8755"
nac_interval: "120"
name: "default_name_30"
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 string | Номер сборки образа FortiGate Возвращается: всегда Пример: |
http_method string | Последний метод, использованный для передачи содержимого в FortiGate Возвращается: всегда Пример: |
http_status string | Результат последней операции, возвращённый FortiGate Возвращается: всегда Пример: |
mkey string | Мастер-ключ (идентификатор), использованный при последнем вызове FortiGate Возвращается: при успехе Пример: |
name string | Имя таблицы, использованной для выполнения запроса Возвращается: всегда Пример: |
path string | Путь к таблице, использованной для выполнения запроса Возвращается: всегда Пример: |
revision string | Внутренний номер ревизии Возвращается: всегда Пример: |
serial string | Серийный номер устройства Возвращается: всегда Пример: |
status string | Результат операции Возвращается: всегда Пример: |
vdom string | Используемый виртуальный домен Возвращается: всегда Пример: |
version string | Версия FortiGate Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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_global_module.html