Spec-Zone.ru › Ansible

модуль fortinet.fortios.fortios_wireless_controller_setting — конфигурация беспроводного контроллера VDOM в 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_setting.

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

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя параметры функции wireless_controller и категории setting. Перед использованием необходимо изменить все параметры и значения в примерах в соответствии с источниками данных. Проверено с 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"

vdom

string

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

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

wireless_controller_setting

dictionary

Конфигурация беспроводного контроллера VDOM.

account_id

string

Идентификатор учетной записи клиента FortiCloud.

country

string

Страна или регион, в котором находится FortiGate. Страна определяет доступные диапазоны и каналы 802.11.

Варианты:

  • "--"
  • "AF"
  • "AL"
  • "DZ"
  • "AS"
  • "AO"
  • "AR"
  • "AM"
  • "AU"
  • "AT"
  • "AZ"
  • "BS"
  • "BH"
  • "BD"
  • "BB"
  • "BY"
  • "BE"
  • "BZ"
  • "BJ"
  • "BM"
  • "BT"
  • "BO"
  • "BA"
  • "BW"
  • "BR"
  • "BN"
  • "BG"
  • "BF"
  • "KH"
  • "CM"
  • "KY"
  • "CF"
  • "TD"
  • "CL"
  • "CN"
  • "CX"
  • "CO"
  • "CG"
  • "CD"
  • "CR"
  • "HR"
  • "CY"
  • "CZ"
  • "DK"
  • "DJ"
  • "DM"
  • "DO"
  • "EC"
  • "EG"
  • "SV"
  • "ET"
  • "EE"
  • "GF"
  • "PF"
  • "FO"
  • "FJ"
  • "FI"
  • "FR"
  • "GA"
  • "GE"
  • "GM"
  • "DE"
  • "GH"
  • "GI"
  • "GR"
  • "GL"
  • "GD"
  • "GP"
  • "GU"
  • "GT"
  • "GY"
  • "HT"
  • "HN"
  • "HK"
  • "HU"
  • "IS"
  • "IN"
  • "ID"
  • "IQ"
  • "IE"
  • "IM"
  • "IL"
  • "IT"
  • "CI"
  • "JM"
  • "JO"
  • "KZ"
  • "KE"
  • "KR"
  • "KW"
  • "LA"
  • "LV"
  • "LB"
  • "LS"
  • "LR"
  • "LY"
  • "LI"
  • "LT"
  • "LU"
  • "MO"
  • "MK"
  • "MG"
  • "MW"
  • "MY"
  • "MV"
  • "ML"
  • "MT"
  • "MH"
  • "MQ"
  • "MR"
  • "MU"
  • "YT"
  • "MX"
  • "FM"
  • "MD"
  • "MC"
  • "MN"
  • "MA"
  • "MZ"
  • "MM"
  • "NA"
  • "NP"
  • "NL"
  • "AN"
  • "AW"
  • "NZ"
  • "NI"
  • "NE"
  • "NG"
  • "NO"
  • "MP"
  • "OM"
  • "PK"
  • "PW"
  • "PA"
  • "PG"
  • "PY"
  • "PE"
  • "PH"
  • "PL"
  • "PT"
  • "PR"
  • "QA"
  • "RE"
  • "RO"
  • "RU"
  • "RW"
  • "BL"
  • "KN"
  • "LC"
  • "MF"
  • "PM"
  • "VC"
  • "SA"
  • "SN"
  • "RS"
  • "ME"
  • "SL"
  • "SG"
  • "SK"
  • "SI"
  • "SO"
  • "ZA"
  • "ES"
  • "LK"
  • "SR"
  • "SZ"
  • "SE"
  • "CH"
  • "TW"
  • "TZ"
  • "TH"
  • "TL"
  • "TG"
  • "TT"
  • "TN"
  • "TR"
  • "TM"
  • "AE"
  • "TC"
  • "UG"
  • "UA"
  • "GB"
  • "US"
  • "PS"
  • "UY"
  • "UZ"
  • "VU"
  • "VE"
  • "VN"
  • "VI"
  • "WF"
  • "YE"
  • "ZM"
  • "ZW"
  • "JP"
  • "CA"
  • "IR"
  • "KP"
  • "SD"
  • "SY"
  • "ZB"

darrp_optimize

integer

Время выполнения оптимизаций DARRP (Distributed Automatic Radio Resource Provisioning, распределенное автоматическое выделение радиоресурсов) (0–86400 с).

darrp_optimize_schedules

list / elements=dictionary

Расписания брандмауэра для запуска DARRP. DARRP будет запускаться периодически в соответствии с параметром darrp-optimize в рамках указанных расписаний. Несколько имен расписаний разделяются пробелом.

name

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

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

device_holdoff

integer

Нижний предел времени создания устройства для идентификации в минутах (0–60).

device_idle

integer

Верхний предел времени простоя устройства для идентификации в минутах (0–14400).

device_weight

integer

Верхний предел достоверности идентификации устройства (0–255).

duplicate_ssid

string

Включить/отключить возможность использования одинакового имени SSID виртуальными точками доступа (VAP) в одном VDOM.

Варианты:

  • "enable"
  • "disable"

fake_ssid_action

list / elements=string

Действия при обнаружении поддельного SSID.

Варианты:

  • "log"
  • "suppress"

fapc_compatibility

string

Включить/отключить совместимость с серией FAP-C.

Варианты:

  • "enable"
  • "disable"

firmware_provision_on_authorization

string

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

Варианты:

  • "enable"
  • "disable"

offending_ssid

list / elements=dictionary

Настройка подозрительного SSID.

action

list / elements=string

Действия при обнаружении подозрительного SSID.

Варианты:

  • "log"
  • "suppress"

id

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

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

ssid_pattern

string

Задать шаблон подозрительного SSID (без учета регистра). Например: word, word*, *word, wo*rd.

phishing_ssid_detect

string

Включить/отключить обнаружение фишинговых SSID.

Варианты:

  • "enable"
  • "disable"

rolling_wtp_upgrade

string

Включить/отключить поэтапное обновление WTP.

Варианты:

  • "enable"
  • "disable"

wfa_compatibility

string

Включить/отключить совместимость с WFA.

Варианты:

  • "enable"
  • "disable"

Примечания

Примечание

  • Устаревший fortiosapi объявлен нерекомендуемым; для запуска плейбуков предпочтительно использовать httpapi
  • Модуль поддерживает check_mode.

Примеры

- name: VDOM wireless controller configuration.
  fortinet.fortios.fortios_wireless_controller_setting:
      vdom: "{{ vdom }}"
      wireless_controller_setting:
          account_id: "<your_own_value>"
          country: "--"
          darrp_optimize: "86400"
          darrp_optimize_schedules:
              -
                  name: "default_name_7 (source firewall.schedule.group.name firewall.schedule.recurring.name firewall.schedule.onetime.name)"
          device_holdoff: "5"
          device_idle: "1440"
          device_weight: "1"
          duplicate_ssid: "enable"
          fake_ssid_action: "log"
          fapc_compatibility: "enable"
          firmware_provision_on_authorization: "enable"
          offending_ssid:
              -
                  action: "log"
                  id: "17"
                  ssid_pattern: "<your_own_value>"
          phishing_ssid_detect: "enable"
          rolling_wtp_upgrade: "enable"
          wfa_compatibility: "enable"

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ

Описание

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_setting_module.html

Spec-Zone.ru

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