модуль 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 | Включить или отключить ведение журнала для задачи. Варианты:
|
member_path string | Путь к атрибуту элемента, для которого выполняется операция. Если атрибутов несколько, они разделяются символом косой черты. Параметр с указанным member_path можно использовать для выполнения операции с элементом. |
member_state string | Добавить или удалить элемент по указанному пути атрибута. Если задан параметр member_state, параметр state игнорируется. Варианты:
|
state string / обязательный | Определяет, следует ли создать или удалить объект. Варианты:
|
vdom string | Виртуальный домен из числа предварительно определённых. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
wireless_controller_wids_profile dictionary | Настройка профилей системы обнаружения вторжений в беспроводную сеть (WIDS). |
|
adhoc_network string |
Включить или отключить обнаружение сетей ad hoc. Варианты:
|
|
adhoc_valid_ssid string |
Включить или отключить обнаружение сетей ad hoc с использованием допустимого SSID. Варианты:
|
|
air_jack string |
Включить или отключить обнаружение AirJack. Варианты:
|
|
ap_auto_suppress string |
Включить или отключить автоматическое подавление несанкционированных точек доступа, подключённых к проводной сети. Варианты:
|
|
ap_bgscan_disable_day string |
При необходимости отключите сканирование на один или несколько дней недели. Разделяйте дни пробелом. По умолчанию дни не заданы. Варианты:
|
|
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 |
Включить или отключить обнаружение имитации точки доступа. Варианты:
|
|
ap_scan string |
Включить или отключить обнаружение несанкционированных точек доступа. Варианты:
|
|
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 |
Включить или отключить пассивное сканирование. Если параметр включён, запросы проб не отправляются ни на одном канале. Варианты:
|
|
ap_scan_threshold string |
Минимальный уровень или пороговый уровень сигнала в дБм, необходимый для того, чтобы точка доступа сообщила об обнаруженной несанкционированной точке доступа (от -95 до -20). |
|
ap_spoofing string |
Включить или отключить обнаружение подмены точки доступа. Варианты:
|
|
asleap_attack string |
Включить или отключить обнаружение атак Asleap. Варианты:
|
|
assoc_flood_thresh integer |
Пороговое значение для обнаружения лавины кадров ассоциации. |
|
assoc_flood_time integer |
Количество секунд, по истечении которых станция считается отключённой. |
|
assoc_frame_flood string |
Включить или отключить обнаружение лавины кадров ассоциации. Варианты:
|
|
auth_flood_thresh integer |
Пороговое значение для обнаружения лавины кадров аутентификации. |
|
auth_flood_time integer |
Количество секунд, по истечении которых станция считается отключённой. |
|
auth_frame_flood string |
Включить или отключить обнаружение лавины кадров аутентификации. Варианты:
|
|
bcn_flood string |
Включить или отключить обнаружение лавины кадров маяков. Варианты:
|
|
bcn_flood_thresh integer |
Пороговое значение для лавины кадров маяков. |
|
bcn_flood_time integer |
Период окна обнаружения. |
|
beacon_wrong_channel string |
Включить или отключить обнаружение маяков на неправильном канале. Варианты:
|
|
block_ack_flood string |
Включить или отключить обнаружение лавины кадров подтверждения блока (Block ACK). Варианты:
|
|
block_ack_flood_thresh integer |
Пороговое значение для лавины кадров подтверждения блока (Block ACK). |
|
block_ack_flood_time integer |
Период окна обнаружения. |
|
chan_based_mitm string |
Включить или отключить обнаружение атак типа «человек посередине» (MITM) на основе канала. Варианты:
|
|
client_flood string |
Включить или отключить обнаружение лавины клиентских устройств. Варианты:
|
|
client_flood_thresh integer |
Пороговое значение для лавины клиентских устройств. |
|
client_flood_time integer |
Период окна обнаружения. |
|
comment string |
Комментарий. |
|
cts_flood string |
Включить или отключить обнаружение лавины кадров CTS. Варианты:
|
|
cts_flood_thresh integer |
Пороговое значение для лавины кадров CTS. |
|
cts_flood_time integer |
Период окна обнаружения. |
|
deauth_broadcast string |
Включить или отключить обнаружение широковещательных кадров деаутентификации. Варианты:
|
|
deauth_unknown_src_thresh integer |
Пороговое значение количества деаутентификаций неизвестных источников в секунду для DoS-атаки (0: без ограничений). |
|
disassoc_broadcast string |
Включить/отключить обнаружение широковещательных кадров отмены ассоциации. Варианты:
|
|
disconnect_station string |
Включить/отключить обнаружение отключения станции. Варианты:
|
|
eapol_fail_flood string |
Включить/отключить обнаружение флуд-атаки EAPOL-Failure (на точку доступа). Варианты:
|
|
eapol_fail_intv integer |
Интервал обнаружения флуд-атаки EAPOL-Failure (1–3600 с). |
|
eapol_fail_thresh integer |
Пороговое значение для флуд-атаки EAPOL-Failure за указанный интервал. |
|
eapol_key_overflow string |
Включить/отключить обнаружение переполнения ключа EAPOL. Варианты:
|
|
eapol_logoff_flood string |
Включить/отключить обнаружение флуд-атаки EAPOL-Logoff (на точку доступа). Варианты:
|
|
eapol_logoff_intv integer |
Интервал обнаружения флуд-атаки EAPOL-Logoff (1–3600 с). |
|
eapol_logoff_thresh integer |
Пороговое значение для флуд-атаки EAPOL-Logoff за указанный интервал. |
|
eapol_pre_fail_flood string |
Включить/отключить обнаружение преждевременной флуд-атаки EAPOL-Failure (на станцию). Варианты:
|
|
eapol_pre_fail_intv integer |
Интервал обнаружения преждевременной флуд-атаки EAPOL-Failure (1–3600 с). |
|
eapol_pre_fail_thresh integer |
Пороговое значение для преждевременной флуд-атаки EAPOL-Failure за указанный интервал. |
|
eapol_pre_succ_flood string |
Включить/отключить обнаружение преждевременной флуд-атаки EAPOL-Success (на станцию). Варианты:
|
|
eapol_pre_succ_intv integer |
Интервал обнаружения преждевременной флуд-атаки EAPOL-Success (1–3600 с). |
|
eapol_pre_succ_thresh integer |
Пороговое значение для преждевременной флуд-атаки EAPOL-Success за указанный интервал. |
|
eapol_start_flood string |
Включить/отключить обнаружение флуд-атаки EAPOL-Start (на точку доступа). Варианты:
|
|
eapol_start_intv integer |
Интервал обнаружения флуд-атаки EAPOL-Start (1–3600 с). |
|
eapol_start_thresh integer |
Пороговое значение для флуд-атаки EAPOL-Start за указанный интервал. |
|
eapol_succ_flood string |
Включить/отключить обнаружение флуд-атаки EAPOL-Success (на точку доступа). Варианты:
|
|
eapol_succ_intv integer |
Интервал обнаружения флуд-атаки EAPOL-Success (1–3600 с). |
|
eapol_succ_thresh integer |
Пороговое значение для флуд-атаки EAPOL-Success за указанный интервал. |
|
fata_jack string |
Включить/отключить обнаружение FATA-Jack. Варианты:
|
|
fuzzed_beacon string |
Включить/отключить обнаружение искаженных маяковых кадров. Варианты:
|
|
fuzzed_probe_request string |
Включить/отключить обнаружение искаженных запросов зондирования. Варианты:
|
|
fuzzed_probe_response string |
Включить/отключить обнаружение искаженных ответов на запросы зондирования. Варианты:
|
|
hotspotter_attack string |
Включить/отключить обнаружение атаки hotspotter. Варианты:
|
|
ht_40mhz_intolerance string |
Включить/отключить обнаружение несовместимости с HT 40 МГц. Варианты:
|
|
ht_greenfield string |
Включить/отключить обнаружение режима HT Greenfield. Варианты:
|
|
invalid_addr_combination string |
Включить/отключить обнаружение недопустимого сочетания адресов. Варианты:
|
|
invalid_mac_oui string |
Включить/отключить обнаружение недопустимого OUI-идентификатора MAC-адреса. Варианты:
|
|
long_duration_attack string |
Включить/отключить обнаружение длительной атаки на основе заданного пользователем порогового значения. Варианты:
|
|
long_duration_thresh integer |
Пороговое значение для обнаружения длительной атаки (1000–32767 мкс). |
|
malformed_association string |
Включить/отключить обнаружение некорректных запросов ассоциации. Варианты:
|
|
malformed_auth string |
Включить/отключить обнаружение некорректных кадров аутентификации. Варианты:
|
|
malformed_ht_ie string |
Включить/отключить обнаружение некорректных информационных элементов HT. Варианты:
|
|
name string / обязательный |
Имя профиля WIDS. |
|
netstumbler string |
Включить/отключить обнаружение NetStumbler. Варианты:
|
|
netstumbler_thresh integer |
Пороговое значение для NetStumbler. |
|
netstumbler_time integer |
Период окна обнаружения. |
|
null_ssid_probe_resp string |
Включить/отключить обнаружение ответов на запросы зондирования с пустым SSID. Варианты:
|
|
omerta_attack string |
Включить/отключить обнаружение атаки Omerta. Варианты:
|
|
overflow_ie string |
Включить/отключить обнаружение переполнения информационного элемента. Варианты:
|
|
probe_flood string |
Включить/отключить обнаружение флуд-атаки запросами зондирования. Варианты:
|
|
probe_flood_thresh integer |
Пороговое значение для флуд-атаки запросами зондирования. |
|
probe_flood_time integer |
Период окна обнаружения. |
|
pspoll_flood string |
Включить/отключить обнаружение флуд-атаки кадрами PS-Poll. Варианты:
|
|
pspoll_flood_thresh integer |
Пороговое значение для флуд-атаки кадрами PS-Poll. |
|
pspoll_flood_time integer |
Период окна обнаружения. |
|
pwsave_dos_attack string |
Включить/отключить обнаружение DoS-атаки с использованием режима энергосбережения. Варианты:
|
|
reassoc_flood string |
Включить/отключить обнаружение флуд-атаки запросами повторной ассоциации. Варианты:
|
|
reassoc_flood_thresh integer |
Пороговое значение для флуд-атаки запросами повторной ассоциации. |
|
reassoc_flood_time integer |
Период окна обнаружения. |
|
risky_encryption string |
Включение/отключение обнаружения рискованного шифрования. Варианты:
|
|
rts_flood string |
Включение/отключение обнаружения RTS-флуда. Варианты:
|
|
rts_flood_thresh integer |
Пороговое значение для RTS-флуда. |
|
rts_flood_time integer |
Длительность окна обнаружения. |
|
sensor_mode string |
Сканирование ближайших Wi-Fi-станций. Варианты:
|
|
spoofed_deauth string |
Включение/отключение обнаружения атак с поддельными кадрами деаутентификации. Варианты:
|
|
unencrypted_valid string |
Включение/отключение обнаружения допустимого незашифрованного трафика. Варианты:
|
|
valid_client_misassociation string |
Включение/отключение обнаружения ошибочной ассоциации допустимого клиента. Варианты:
|
|
valid_ssid_misuse string |
Включение/отключение обнаружения неправомерного использования допустимого SSID. Варианты:
|
|
weak_wep_iv string |
Включение/отключение обнаружения слабого IV (вектора инициализации) WEP. Варианты:
|
|
wellenreiter string |
Включение/отключение обнаружения Wellenreiter. Варианты:
|
|
wellenreiter_thresh integer |
Пороговое значение для Wellenreiter. |
|
wellenreiter_time integer |
Длительность окна обнаружения. |
|
windows_bridge string |
Включение/отключение обнаружения моста Windows. Варианты:
|
|
wireless_bridge string |
Включение/отключение обнаружения беспроводного моста. Варианты:
|
|
wpa_ft_attack string |
Включение/отключение обнаружения атак WPA FT. Варианты:
|
Примечания
Примечание
- Устаревший 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 Возвращается: всегда Пример: |
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_wids_profile_module.html