fortinet.fortios.fortios_wireless_controller_wtp – Настройка беспроводных точек завершения (WTP), то есть FortiAP или AP, управляемых FortiGate в FortiOS и FortiGate Fortinet.
Примечание
Этот плагин входит в коллекцию fortinet.fortios (версия 1.1.8).
Для его установки используйте: ansible-galaxy collection install fortinet.fortios.
Чтобы использовать его в playbook, укажите: fortinet.fortios.fortios_wireless_controller_wtp.
Введено в версии 2.8: of fortinet.fortios
Обзор
- Этот модуль способен настроить устройство FortiGate или FortiOS (FOS), позволяя пользователю задавать и изменять функцию wireless_controller и категорию wtp. Примеры включают все параметры и значения, которые необходимо настроить в источниках данных перед использованием. Тестировалось с FOS v6.0.0
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- ansible>=2.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |||
|---|---|---|---|---|---|
| access_token строка | Аутентификация на основе токена. Сгенерирован из графического интерфейса Fortigate. | ||||
| state строка добавлен в 2.9 fortinet.fortios |
| Указывает, нужно ли создать или удалить объект. Этот атрибут уже присутствовал в предыдущих версиях на более глубоком уровне. Он был вынесен на этот внешний уровень. | |||
| vdom строка | По умолчанию: "root" | Виртуальный домен, среди тех, которые были определены ранее. VDOM — это виртуальная инстанция FortiGate, которая может быть настроена и использована как отдельное устройство. | |||
| wireless_controller_wtp словарь | Настройка точек беспроводного доступа (WTP), то есть FortiAP или AP, которые будут управляться FortiGate. | ||||
| admin строка |
| Настройка того, как FortiGate, работающий как беспроводной контроллер, обнаруживает и управляет этим WTP, AP или FortiAP. | |||
| allowaccess строка |
| Управление доступом к управляемому WTP, FortiAP или AP. Отдельные записи через пробел. | |||
| bonjour_profile строка | Имя профиля Bonjour. Источник wireless-controller.bonjour-profile.name. | ||||
| coordinate_enable строка |
| Включить/выключить координаты WTP (оси X,Y). | |||
| coordinate_latitude строка | Координата широты WTP. | ||||
| coordinate_longitude строка | Координата долготы WTP. | ||||
| coordinate_x строка | Координата оси X. | ||||
| coordinate_y строка | Координата оси Y. | ||||
| image_download строка |
| Включить/выключить загрузку изображения WTP. | |||
| index целое число | Индекс (0 - 4294967295). | ||||
| ip_fragment_preventing строка |
| Метод предотвращения фрагментации IP для управляющих и данных пакетов CAPWAP. | |||
| lan словарь | Сопоставление портов LAN WTP. | ||||
| port1_mode строка |
| Режим порта LAN 1. | |||
| port1_ssid строка | Подключение порта LAN 1 к SSID. Источник wireless-controller.vap.name. | ||||
| port2_mode строка |
| Режим порта LAN 2. | |||
| port2_ssid строка | Подключение порта LAN 2 к SSID. Источник wireless-controller.vap.name. | ||||
| override_led_state string |
| Включить для переопределения настроек состояния светодиода профиля для этого FortiAP. Вам необходимо включить этот параметр, чтобы использовать команду led-state для выключения светодиодов FortiAP. | |||
| override_login_passwd_change string |
| Включить для переопределения настройки пароля входа в профиль WTP (административный пароль). | |||
| override_split_tunnel string |
| Включить/выключить переопределение настройки разделенного туннеля в профиле WTP. | |||
| override_wan_port_mode string |
| Включить/выключить переопределение wan-port-mode в профиле WTP. | |||
| radio_1 dictionary | Параметры конфигурации радио 1. | ||||
| auto_power_high integer | Максимальное значение автоматической мощности передачи в децибелах (дБ) измеряемой мощности, отнесенной к одному милливатту (мВт), или дБм (10 - 17 дБм). | ||||
| auto_power_level string |
| Включить/выключить автоматическую регулировку уровня мощности для предотвращения помех от соседних каналов. | |||
| auto_power_low integer | Минимальное значение автоматической мощности передачи в дБм (фактический диапазон мощности передачи зависит от типа платформы AP). | ||||
| band string |
| Диапазон Wi-Fi, в котором работает радио 1. | |||
| channel list / elements=string | Выбранный список беспроводных радиоканалов. | ||||
| chan string / required | Номер канала. | ||||
| override_analysis string |
| Включить для переопределения конфигурации анализа спектра профиля WTP. | |||
| override_band string |
| Включить для переопределения настройки диапазона профиля WTP. | |||
| override_channel string |
| Включить для переопределения настроек канала профиля WTP. | |||
| override_txpower string |
| Включить для переопределения конфигурации уровня мощности профиля WTP. | |||
| override_vaps string |
| Включить для переопределения настроек виртуальных точек доступа (VAP) профиля WTP. | |||
| power_level integer | Уровень мощности радио в процентах от максимальной мощности передачи (0 - 100). | ||||
| radio_id integer | radio-id | ||||
| spectrum_analysis string |
| Включить/выключить анализ спектра для поиска помех, которые могут негативно повлиять на беспроводную производительность. | |||
| vap_all string |
| Включить/выключить автоматическое наследование всех виртуальных точек доступа (VAP). | |||
| vaps list / elements=string | Вручную выбранный список виртуальных точек доступа (VAP). | ||||
| name string / required | Имя виртуальной точки доступа (VAP). Источник wireless-controller.vap-group.name wireless-controller.vap.name. | ||||
| radio_2 dictionary | Параметры конфигурации радио 2. | ||||
| auto_power_high integer | Максимальное значение автоматической мощности передачи в децибелах (дБ) измеряемой мощности, отнесенной к одному милливатту (мВт), или дБм (10 - 17 дБм). | ||||
| auto_power_level string |
| Включить/выключить автоматическую регулировку уровня мощности для предотвращения помех от соседних каналов. | |||
| auto_power_low integer | Минимальное значение автоматической мощности передачи в дБм (фактический диапазон мощности передачи зависит от типа платформы AP). | ||||
| band string |
| Диапазон Wi-Fi, в котором работает радио 1. | |||
| channel list / elements=string | Выбранный список беспроводных радиоканалов. | ||||
| chan string / required | Номер канала. | ||||
| override_analysis string |
| Включить для переопределения конфигурации анализа спектра профиля WTP. | |||
| override_band string |
| Включить для переопределения настройки диапазона профиля WTP. | |||
| override_channel string |
| Включить для переопределения настроек канала профиля WTP. | |||
| override_txpower string |
| Включить для переопределения конфигурации уровня мощности профиля WTP. | |||
| override_vaps string |
| Включить для переопределения настроек виртуальных точек доступа (VAP) профиля WTP. | |||
| power_level integer | Уровень мощности радио в процентах от максимальной мощности передачи (0 - 100). | ||||
| radio_id integer | radio-id | ||||
| spectrum_analysis string |
| Включить/выключить анализ спектра для поиска помех, которые могут негативно повлиять на беспроводную производительность. | |||
| vap_all string |
| Включить/выключить автоматическое наследование всех виртуальных точек доступа (VAP). | |||
| vaps список / элементы=строка | Вручную выбранный список виртуальных точек доступа (VAP). | ||||
| name строка / обязательно | Имя виртуальной точки доступа (VAP). Источник wireless-controller.vap-group.name wireless-controller.vap.name. | ||||
| split_tunneling_acl список / элементы=строка | Список фильтров ACL для разделенного туннелирования. | ||||
| dest_ip строка | IP-адрес и маска назначения для подсети разделенного туннелирования. | ||||
| id целое число / обязательно | Идентификатор. | ||||
| split_tunneling_acl_local_ap_subnet строка |
| Включить/выключить автоматическое добавление локальной подсети FortiAP в ACL разделенного туннелирования. | |||
| split_tunneling_acl_path строка |
| Путь ACL разделенного туннелирования - локальный/туннель. | |||
| state строка |
| Устарело Начиная с Ansible 2.9, рекомендуется использовать параметр 'state' верхнего уровня. Указывает, нужно ли создать или удалить объект. | |||
| tun_mtu_downlink целое число | MTU туннеля по нисходящему каналу в октетах. Установите значение 0 (по умолчанию), 576 или 1500. | ||||
| tun_mtu_uplink целое число | Максимальный размер пакета (MTU) туннеля по восходящему каналу в октетах (байтах по 8 бит). Установите значение 0 (по умолчанию), 576 или 1500. | ||||
| wan_port_mode строка |
| Включить/выключить использование порта WAN FortiAP в качестве порта LAN. | |||
| wtp_id строка | Идентификатор WTP. | ||||
| wtp_mode строка |
| Режим работы WTP, AP или FortiAP; нормальный (по умолчанию) или удаленный. SSID в режиме туннеля можно назначить AP в нормальном режиме, но не в удаленном, а SSID в режиме локального моста можно назначить AP как в нормальном, так и в удаленном режиме. | |||
| wtp_profile строка | Имя профиля WTP для применения к этому WTP, AP или FortiAP. Источник wireless-controller.wtp-profile.name. | ||||
Примечания
Примечание
- Устаревший fortiosapi устарел, httpapi является предпочтительным способом запуска playbooks
Примеры
- hosts: fortigates
collections:
- fortinet.fortios
connection: httpapi
vars:
vdom: "root"
ansible_httpapi_use_ssl: yes
ansible_httpapi_validate_certs: no
ansible_httpapi_port: 443
tasks:
- name: Configure Wireless Termination Points (WTPs), that is, FortiAPs or APs to be managed by FortiGate.
fortios_wireless_controller_wtp:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
wireless_controller_wtp:
admin: "discovered"
allowaccess: "telnet"
bonjour_profile: "<your_own_value> (source wireless-controller.bonjour-profile.name)"
coordinate_enable: "enable"
coordinate_latitude: "<your_own_value>"
coordinate_longitude: "<your_own_value>"
coordinate_x: "<your_own_value>"
coordinate_y: "<your_own_value>"
image_download: "enable"
index: "12"
ip_fragment_preventing: "tcp-mss-adjust"
lan:
port_mode: "offline"
port_ssid: "<your_own_value> (source wireless-controller.vap.name)"
port1_mode: "offline"
port1_ssid: "<your_own_value> (source wireless-controller.vap.name)"
port2_mode: "offline"
port2_ssid: "<your_own_value> (source wireless-controller.vap.name)"
port3_mode: "offline"
port3_ssid: "<your_own_value> (source wireless-controller.vap.name)"
port4_mode: "offline"
port4_ssid: "<your_own_value> (source wireless-controller.vap.name)"
port5_mode: "offline"
port5_ssid: "<your_own_value> (source wireless-controller.vap.name)"
port6_mode: "offline"
port6_ssid: "<your_own_value> (source wireless-controller.vap.name)"
port7_mode: "offline"
port7_ssid: "<your_own_value> (source wireless-controller.vap.name)"
port8_mode: "offline"
port8_ssid: "<your_own_value> (source wireless-controller.vap.name)"
led_state: "enable"
location: "<your_own_value>"
login_passwd: "<your_own_value>"
login_passwd_change: "yes"
mesh_bridge_enable: "default"
name: "default_name_38"
override_allowaccess: "enable"
override_ip_fragment: "enable"
override_lan: "enable"
override_led_state: "enable"
override_login_passwd_change: "enable"
override_split_tunnel: "enable"
override_wan_port_mode: "enable"
radio_1:
auto_power_high: "47"
auto_power_level: "enable"
auto_power_low: "49"
band: "802.11a"
channel:
-
chan: "<your_own_value>"
override_analysis: "enable"
override_band: "enable"
override_channel: "enable"
override_txpower: "enable"
override_vaps: "enable"
power_level: "58"
radio_id: "59"
spectrum_analysis: "enable"
vap_all: "enable"
vaps:
-
name: "default_name_63 (source wireless-controller.vap-group.name wireless-controller.vap.name)"
radio_2:
auto_power_high: "65"
auto_power_level: "enable"
auto_power_low: "67"
band: "802.11a"
channel:
-
chan: "<your_own_value>"
override_analysis: "enable"
override_band: "enable"
override_channel: "enable"
override_txpower: "enable"
override_vaps: "enable"
power_level: "76"
radio_id: "77"
spectrum_analysis: "enable"
vap_all: "enable"
vaps:
-
name: "default_name_81 (source wireless-controller.vap-group.name wireless-controller.vap.name)"
split_tunneling_acl:
-
dest_ip: "<your_own_value>"
id: "84"
split_tunneling_acl_local_ap_subnet: "enable"
split_tunneling_acl_path: "tunnel"
tun_mtu_downlink: "87"
tun_mtu_uplink: "88"
wan_port_mode: "wan-lan"
wtp_id: "<your_own_value>"
wtp_mode: "normal"
wtp_profile: "<your_own_value> (source wireless-controller.wtp-profile.name)"
Значения возврата
Общие значения возврата документированы здесь, следующие являются полями, уникальными для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| build строка | всегда | Номер сборки образа Fortigate Пример: 1547 |
| http_method строка | всегда | Последний метод, используемый для предоставления содержимого в FortiGate Пример: PUT |
| http_status строка | всегда | Последний результат, полученный от FortiGate при последней операции Пример: 200 |
| mkey строка | успех | Главный ключ (id), используемый в последнем вызове FortiGate Пример: id |
| name строка | всегда | Название таблицы, используемой для выполнения запроса Пример: urlfilter |
| path строка | всегда | Путь таблицы, используемой для выполнения запроса Пример: webfilter |
| revision строка | всегда | Внутренний номер ревизии Пример: 17.0.2.10658 |
| serial строка | всегда | Серийный номер устройства Пример: FGVMEVYYQT3AB5352 |
| status строка | всегда | Указание результата операции Пример: успех |
| 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)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/fortinet/fortios/fortios_wireless_controller_wtp_module.html