Spec-Zone.ru › Ansible

модуль fortinet.fortios.fortios_wireless_controller_wids_profile – Настройка профилей системы обнаружения вторжений в беспроводную сеть (WIDS) в FortiOS и FortiGate от Fortinet.

Примечание

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

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

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

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

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

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

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

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

dictionary

Настройка профилей системы обнаружения вторжений в беспроводную сеть (WIDS).

adhoc_network

string

Включить или отключить обнаружение сетей ad hoc.

Варианты:

  • "enable"
  • "disable"

adhoc_valid_ssid

string

Включить или отключить обнаружение сетей ad hoc с использованием допустимого SSID.

Варианты:

  • "enable"
  • "disable"

air_jack

string

Включить или отключить обнаружение AirJack.

Варианты:

  • "enable"
  • "disable"

ap_auto_suppress

string

Включить или отключить автоматическое подавление несанкционированных точек доступа, подключённых к проводной сети.

Варианты:

  • "enable"
  • "disable"

ap_bgscan_disable_day

string

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

Варианты:

  • "sunday"
  • "monday"
  • "tuesday"
  • "wednesday"
  • "thursday"
  • "friday"
  • "saturday"

ap_bgscan_disable_end

string

Время окончания отключения фонового сканирования в 24-часовом формате чч:мм.

ap_bgscan_disable_schedules

list / elements=dictionary

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

name

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

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

ap_bgscan_disable_start

string

Время начала отключения фонового сканирования в 24-часовом формате чч:мм.

ap_bgscan_duration

integer

Время прослушивания канала при сканировании (10–1000 мс).

ap_bgscan_idle

integer

Время ожидания неактивности канала перед его сканированием (0–1000 мс).

ap_bgscan_intv

integer

Интервал между последовательными сканированиями каналов (1–600 с).

ap_bgscan_period

integer

Интервал между фоновыми сканированиями (10–3600 с).

ap_bgscan_report_intv

integer

Интервал между отчётами о фоновых сканированиях (15–600 с).

ap_fgscan_report_intv

integer

Интервал между отчётами о сканированиях в активном режиме (15–600 с).

ap_impersonation

string

Включить или отключить обнаружение имитации точки доступа.

Варианты:

  • "enable"
  • "disable"

ap_scan

string

Включить или отключить обнаружение несанкционированных точек доступа.

Варианты:

  • "disable"
  • "enable"

ap_scan_channel_list_2G_5G

list / elements=dictionary

Выбранный список каналов для сканирования точек доступа в диапазонах 2,4 и 5 ГГц.

chan

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

Номер канала.

ap_scan_channel_list_6G

list / elements=dictionary

Выбранный список каналов для сканирования точек доступа в диапазоне 6 ГГц.

chan

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

Номер канала 6 ГГц.

ap_scan_passive

string

Включить или отключить пассивное сканирование. Если параметр включён, запросы проб не отправляются ни на одном канале.

Варианты:

  • "enable"
  • "disable"

ap_scan_threshold

string

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

ap_spoofing

string

Включить или отключить обнаружение подмены точки доступа.

Варианты:

  • "enable"
  • "disable"

asleap_attack

string

Включить или отключить обнаружение атак Asleap.

Варианты:

  • "enable"
  • "disable"

assoc_flood_thresh

integer

Пороговое значение для обнаружения лавины кадров ассоциации.

assoc_flood_time

integer

Количество секунд, по истечении которых станция считается отключённой.

assoc_frame_flood

string

Включить или отключить обнаружение лавины кадров ассоциации.

Варианты:

  • "enable"
  • "disable"

auth_flood_thresh

integer

Пороговое значение для обнаружения лавины кадров аутентификации.

auth_flood_time

integer

Количество секунд, по истечении которых станция считается отключённой.

auth_frame_flood

string

Включить или отключить обнаружение лавины кадров аутентификации.

Варианты:

  • "enable"
  • "disable"

bcn_flood

string

Включить или отключить обнаружение лавины кадров маяков.

Варианты:

  • "enable"
  • "disable"

bcn_flood_thresh

integer

Пороговое значение для лавины кадров маяков.

bcn_flood_time

integer

Период окна обнаружения.

beacon_wrong_channel

string

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

Варианты:

  • "enable"
  • "disable"

block_ack_flood

string

Включить или отключить обнаружение лавины кадров подтверждения блока (Block ACK).

Варианты:

  • "enable"
  • "disable"

block_ack_flood_thresh

integer

Пороговое значение для лавины кадров подтверждения блока (Block ACK).

block_ack_flood_time

integer

Период окна обнаружения.

chan_based_mitm

string

Включить или отключить обнаружение атак типа «человек посередине» (MITM) на основе канала.

Варианты:

  • "enable"
  • "disable"

client_flood

string

Включить или отключить обнаружение лавины клиентских устройств.

Варианты:

  • "enable"
  • "disable"

client_flood_thresh

integer

Пороговое значение для лавины клиентских устройств.

client_flood_time

integer

Период окна обнаружения.

comment

string

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

cts_flood

string

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

Варианты:

  • "enable"
  • "disable"

cts_flood_thresh

integer

Пороговое значение для лавины кадров CTS.

cts_flood_time

integer

Период окна обнаружения.

deauth_broadcast

string

Включить или отключить обнаружение широковещательных кадров деаутентификации.

Варианты:

  • "enable"
  • "disable"

deauth_unknown_src_thresh

integer

Пороговое значение количества деаутентификаций неизвестных источников в секунду для DoS-атаки (0: без ограничений).

disassoc_broadcast

string

Включить/отключить обнаружение широковещательных кадров отмены ассоциации.

Варианты:

  • "enable"
  • "disable"

disconnect_station

string

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

Варианты:

  • "enable"
  • "disable"

eapol_fail_flood

string

Включить/отключить обнаружение флуд-атаки EAPOL-Failure (на точку доступа).

Варианты:

  • "enable"
  • "disable"

eapol_fail_intv

integer

Интервал обнаружения флуд-атаки EAPOL-Failure (1–3600 с).

eapol_fail_thresh

integer

Пороговое значение для флуд-атаки EAPOL-Failure за указанный интервал.

eapol_key_overflow

string

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

Варианты:

  • "enable"
  • "disable"

eapol_logoff_flood

string

Включить/отключить обнаружение флуд-атаки EAPOL-Logoff (на точку доступа).

Варианты:

  • "enable"
  • "disable"

eapol_logoff_intv

integer

Интервал обнаружения флуд-атаки EAPOL-Logoff (1–3600 с).

eapol_logoff_thresh

integer

Пороговое значение для флуд-атаки EAPOL-Logoff за указанный интервал.

eapol_pre_fail_flood

string

Включить/отключить обнаружение преждевременной флуд-атаки EAPOL-Failure (на станцию).

Варианты:

  • "enable"
  • "disable"

eapol_pre_fail_intv

integer

Интервал обнаружения преждевременной флуд-атаки EAPOL-Failure (1–3600 с).

eapol_pre_fail_thresh

integer

Пороговое значение для преждевременной флуд-атаки EAPOL-Failure за указанный интервал.

eapol_pre_succ_flood

string

Включить/отключить обнаружение преждевременной флуд-атаки EAPOL-Success (на станцию).

Варианты:

  • "enable"
  • "disable"

eapol_pre_succ_intv

integer

Интервал обнаружения преждевременной флуд-атаки EAPOL-Success (1–3600 с).

eapol_pre_succ_thresh

integer

Пороговое значение для преждевременной флуд-атаки EAPOL-Success за указанный интервал.

eapol_start_flood

string

Включить/отключить обнаружение флуд-атаки EAPOL-Start (на точку доступа).

Варианты:

  • "enable"
  • "disable"

eapol_start_intv

integer

Интервал обнаружения флуд-атаки EAPOL-Start (1–3600 с).

eapol_start_thresh

integer

Пороговое значение для флуд-атаки EAPOL-Start за указанный интервал.

eapol_succ_flood

string

Включить/отключить обнаружение флуд-атаки EAPOL-Success (на точку доступа).

Варианты:

  • "enable"
  • "disable"

eapol_succ_intv

integer

Интервал обнаружения флуд-атаки EAPOL-Success (1–3600 с).

eapol_succ_thresh

integer

Пороговое значение для флуд-атаки EAPOL-Success за указанный интервал.

fata_jack

string

Включить/отключить обнаружение FATA-Jack.

Варианты:

  • "enable"
  • "disable"

fuzzed_beacon

string

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

Варианты:

  • "enable"
  • "disable"

fuzzed_probe_request

string

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

Варианты:

  • "enable"
  • "disable"

fuzzed_probe_response

string

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

Варианты:

  • "enable"
  • "disable"

hotspotter_attack

string

Включить/отключить обнаружение атаки hotspotter.

Варианты:

  • "enable"
  • "disable"

ht_40mhz_intolerance

string

Включить/отключить обнаружение несовместимости с HT 40 МГц.

Варианты:

  • "enable"
  • "disable"

ht_greenfield

string

Включить/отключить обнаружение режима HT Greenfield.

Варианты:

  • "enable"
  • "disable"

invalid_addr_combination

string

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

Варианты:

  • "enable"
  • "disable"

invalid_mac_oui

string

Включить/отключить обнаружение недопустимого OUI-идентификатора MAC-адреса.

Варианты:

  • "enable"
  • "disable"

long_duration_attack

string

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

Варианты:

  • "enable"
  • "disable"

long_duration_thresh

integer

Пороговое значение для обнаружения длительной атаки (1000–32767 мкс).

malformed_association

string

Включить/отключить обнаружение некорректных запросов ассоциации.

Варианты:

  • "enable"
  • "disable"

malformed_auth

string

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

Варианты:

  • "enable"
  • "disable"

malformed_ht_ie

string

Включить/отключить обнаружение некорректных информационных элементов HT.

Варианты:

  • "enable"
  • "disable"

name

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

Имя профиля WIDS.

netstumbler

string

Включить/отключить обнаружение NetStumbler.

Варианты:

  • "enable"
  • "disable"

netstumbler_thresh

integer

Пороговое значение для NetStumbler.

netstumbler_time

integer

Период окна обнаружения.

null_ssid_probe_resp

string

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

Варианты:

  • "enable"
  • "disable"

omerta_attack

string

Включить/отключить обнаружение атаки Omerta.

Варианты:

  • "enable"
  • "disable"

overflow_ie

string

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

Варианты:

  • "enable"
  • "disable"

probe_flood

string

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

Варианты:

  • "enable"
  • "disable"

probe_flood_thresh

integer

Пороговое значение для флуд-атаки запросами зондирования.

probe_flood_time

integer

Период окна обнаружения.

pspoll_flood

string

Включить/отключить обнаружение флуд-атаки кадрами PS-Poll.

Варианты:

  • "enable"
  • "disable"

pspoll_flood_thresh

integer

Пороговое значение для флуд-атаки кадрами PS-Poll.

pspoll_flood_time

integer

Период окна обнаружения.

pwsave_dos_attack

string

Включить/отключить обнаружение DoS-атаки с использованием режима энергосбережения.

Варианты:

  • "enable"
  • "disable"

reassoc_flood

string

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

Варианты:

  • "enable"
  • "disable"

reassoc_flood_thresh

integer

Пороговое значение для флуд-атаки запросами повторной ассоциации.

reassoc_flood_time

integer

Период окна обнаружения.

risky_encryption

string

Включение/отключение обнаружения рискованного шифрования.

Варианты:

  • "enable"
  • "disable"

rts_flood

string

Включение/отключение обнаружения RTS-флуда.

Варианты:

  • "enable"
  • "disable"

rts_flood_thresh

integer

Пороговое значение для RTS-флуда.

rts_flood_time

integer

Длительность окна обнаружения.

sensor_mode

string

Сканирование ближайших Wi-Fi-станций.

Варианты:

  • "disable"
  • "foreign"
  • "both"

spoofed_deauth

string

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

Варианты:

  • "enable"
  • "disable"

unencrypted_valid

string

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

Варианты:

  • "enable"
  • "disable"

valid_client_misassociation

string

Включение/отключение обнаружения ошибочной ассоциации допустимого клиента.

Варианты:

  • "enable"
  • "disable"

valid_ssid_misuse

string

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

Варианты:

  • "enable"
  • "disable"

weak_wep_iv

string

Включение/отключение обнаружения слабого IV (вектора инициализации) WEP.

Варианты:

  • "enable"
  • "disable"

wellenreiter

string

Включение/отключение обнаружения Wellenreiter.

Варианты:

  • "enable"
  • "disable"

wellenreiter_thresh

integer

Пороговое значение для Wellenreiter.

wellenreiter_time

integer

Длительность окна обнаружения.

windows_bridge

string

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

Варианты:

  • "enable"
  • "disable"

wireless_bridge

string

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

Варианты:

  • "enable"
  • "disable"

wpa_ft_attack

string

Включение/отключение обнаружения атак WPA FT.

Варианты:

  • "enable"
  • "disable"

Примечания

Примечание

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

Примеры

- name: Configure wireless intrusion detection system (WIDS) profiles.
  fortinet.fortios.fortios_wireless_controller_wids_profile:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      wireless_controller_wids_profile:
          adhoc_network: "enable"
          adhoc_valid_ssid: "enable"
          air_jack: "enable"
          ap_auto_suppress: "enable"
          ap_bgscan_disable_day: "sunday"
          ap_bgscan_disable_end: "<your_own_value>"
          ap_bgscan_disable_schedules:
              -
                  name: "default_name_10 (source firewall.schedule.group.name firewall.schedule.recurring.name firewall.schedule.onetime.name)"
          ap_bgscan_disable_start: "<your_own_value>"
          ap_bgscan_duration: "30"
          ap_bgscan_idle: "20"
          ap_bgscan_intv: "3"
          ap_bgscan_period: "600"
          ap_bgscan_report_intv: "30"
          ap_fgscan_report_intv: "15"
          ap_impersonation: "enable"
          ap_scan: "disable"
          ap_scan_channel_list_2G_5G:
              -
                  chan: "<your_own_value>"
          ap_scan_channel_list_6G:
              -
                  chan: "<your_own_value>"
          ap_scan_passive: "enable"
          ap_scan_threshold: "<your_own_value>"
          ap_spoofing: "enable"
          asleap_attack: "enable"
          assoc_flood_thresh: "30"
          assoc_flood_time: "10"
          assoc_frame_flood: "enable"
          auth_flood_thresh: "30"
          auth_flood_time: "10"
          auth_frame_flood: "enable"
          bcn_flood: "enable"
          bcn_flood_thresh: "15"
          bcn_flood_time: "1"
          beacon_wrong_channel: "enable"
          block_ack_flood: "enable"
          block_ack_flood_thresh: "50"
          block_ack_flood_time: "1"
          chan_based_mitm: "enable"
          client_flood: "enable"
          client_flood_thresh: "30"
          client_flood_time: "10"
          comment: "Comment."
          cts_flood: "enable"
          cts_flood_thresh: "30"
          cts_flood_time: "10"
          deauth_broadcast: "enable"
          deauth_unknown_src_thresh: "10"
          disassoc_broadcast: "enable"
          disconnect_station: "enable"
          eapol_fail_flood: "enable"
          eapol_fail_intv: "1"
          eapol_fail_thresh: "10"
          eapol_key_overflow: "enable"
          eapol_logoff_flood: "enable"
          eapol_logoff_intv: "1"
          eapol_logoff_thresh: "10"
          eapol_pre_fail_flood: "enable"
          eapol_pre_fail_intv: "1"
          eapol_pre_fail_thresh: "10"
          eapol_pre_succ_flood: "enable"
          eapol_pre_succ_intv: "1"
          eapol_pre_succ_thresh: "10"
          eapol_start_flood: "enable"
          eapol_start_intv: "1"
          eapol_start_thresh: "10"
          eapol_succ_flood: "enable"
          eapol_succ_intv: "1"
          eapol_succ_thresh: "10"
          fata_jack: "enable"
          fuzzed_beacon: "enable"
          fuzzed_probe_request: "enable"
          fuzzed_probe_response: "enable"
          hotspotter_attack: "enable"
          ht_40mhz_intolerance: "enable"
          ht_greenfield: "enable"
          invalid_addr_combination: "enable"
          invalid_mac_oui: "enable"
          long_duration_attack: "enable"
          long_duration_thresh: "8200"
          malformed_association: "enable"
          malformed_auth: "enable"
          malformed_ht_ie: "enable"
          name: "default_name_86"
          netstumbler: "enable"
          netstumbler_thresh: "5"
          netstumbler_time: "30"
          null_ssid_probe_resp: "enable"
          omerta_attack: "enable"
          overflow_ie: "enable"
          probe_flood: "enable"
          probe_flood_thresh: "30"
          probe_flood_time: "1"
          pspoll_flood: "enable"
          pspoll_flood_thresh: "30"
          pspoll_flood_time: "1"
          pwsave_dos_attack: "enable"
          reassoc_flood: "enable"
          reassoc_flood_thresh: "30"
          reassoc_flood_time: "10"
          risky_encryption: "enable"
          rts_flood: "enable"
          rts_flood_thresh: "30"
          rts_flood_time: "10"
          sensor_mode: "disable"
          spoofed_deauth: "enable"
          unencrypted_valid: "enable"
          valid_client_misassociation: "enable"
          valid_ssid_misuse: "enable"
          weak_wep_iv: "enable"
          wellenreiter: "enable"
          wellenreiter_thresh: "5"
          wellenreiter_time: "30"
          windows_bridge: "enable"
          wireless_bridge: "enable"
          wpa_ft_attack: "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_wids_profile_module.html

Spec-Zone.ru

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