модуль fortinet.fortios.fortios_wireless_controller_timers — настройка таймеров CAPWAP в 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_timers.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя параметры функции wireless_controller и категории timers. В примерах приведены все параметры и значения, которые необходимо скорректировать в соответствии с источниками данных перед использованием. Проверено с 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_timers dictionary | Настройка таймеров CAPWAP. |
|
ap_reboot_wait_interval1 integer |
Время ожидания в минутах перед перезагрузкой точки доступа, если контроллер не обнаружен (5–65535). |
|
ap_reboot_wait_interval2 integer |
Время ожидания в минутах перед перезагрузкой точки доступа, если контроллер не обнаружен, а в предыдущем сеансе на точку доступа были переданы автономные SSID (5–65535). |
|
ap_reboot_wait_time string |
Время перезагрузки точки доступа, если контроллер не обнаружен, а в предыдущем сеансе на точку доступа были переданы автономные SSID; формат hh :mm. |
|
auth_timeout integer |
Время, по истечении которого клиент считается не прошедшим аутентификацию RADIUS и подключение прерывается (5–30 сек.). |
|
ble_device_cleanup integer |
Время в минутах, в течение которого сохраняются данные BLE-устройства после его исчезновения. |
|
ble_scan_report_intv integer |
Интервал между отчетами Bluetooth Low Energy (BLE) (10–3600 сек.). |
|
client_idle_rehome_timeout integer |
Время, по истечении которого клиент считается неактивным и отключается от домашнего контроллера (2–3600 сек.). |
|
client_idle_timeout integer |
Время, по истечении которого клиент считается неактивным и время ожидания истекает (20–3600 сек.). |
|
darrp_day string |
День недели, в который выполняется оптимизация DARRP. Варианты:
|
|
darrp_optimize integer |
Время выполнения оптимизации Dynamic Automatic Radio Resource Provisioning (DARRP) (0–86400 сек.). |
|
darrp_time list / elements=dictionary |
Время выполнения оптимизации DARRP (можно указать до 8 значений). |
|
time string / обязательный |
Время. |
|
discovery_interval integer |
Интервал между запросами обнаружения (2–180 сек.). |
|
drma_interval integer |
Интервал расписания динамического назначения радиорежима (DRMA) в минутах (1–1440). |
|
echo_interval integer |
Интервал между эхо-запросами, отправляемыми управляемым WTP, точкой доступа или FortiAP (1–255 сек.). |
|
fake_ap_log integer |
Интервал между записями в журнале о поддельных точках доступа, если настроено периодическое ведение такого журнала (1–1440 мин.). |
|
ipsec_intf_cleanup integer |
Время, в течение которого интерфейсы VPN IPsec остаются активными после отключения сеансов WTP (30–3600 сек.). |
|
nat_session_keep_alive integer |
Максимальный интервал в секундах между управляющими запросами, отправляемыми управляемым WTP, точкой доступа или FortiAP (0–255 сек.). |
|
radio_stats_interval integer |
Интервал между отчетами о радиопараметрах (1–255 сек.). |
|
rogue_ap_cleanup integer |
Время в минутах, в течение которого сохраняются данные о несанкционированной точке доступа после ее исчезновения. |
|
rogue_ap_log integer |
Интервал между записями сообщений о несанкционированных точках доступа, если настроено периодическое ведение такого журнала (0–1440 мин.). |
|
rogue_sta_cleanup integer |
Время в минутах, в течение которого сохраняются данные о несанкционированной станции после ее исчезновения. |
|
sta_cap_cleanup integer |
Время в минутах, в течение которого сохраняются данные о возможностях станции после ее исчезновения. |
|
sta_capability_interval integer |
Интервал между отчетами о возможностях станции (1–255 сек.). |
|
sta_locate_timer integer |
Интервал между очистками сведений о присутствии клиентов, которые позволяют удалять клиентов из списка, если они больше не присутствуют (0–86400 сек.). |
|
sta_offline_cleanup integer |
Время в секундах, в течение которого сохраняются данные о станции в автономном режиме после ее исчезновения. |
|
sta_offline_ip2mac_cleanup integer |
Время в секундах, в течение которого сохраняются данные Ip2mac автономной станции после ее исчезновения. |
|
sta_stats_interval integer |
Интервал между отчетами о клиентах (станциях) (1–255 сек.). |
|
vap_stats_interval integer |
Интервал между отчетами о виртуальных точках доступа (VAP) (1–255 сек.). |
|
wids_entry_cleanup integer |
Время в минутах, в течение которого сохраняется запись WIDS после ее исчезновения. |
Примечания
Примечание
- Устаревшая библиотека fortiosapi объявлена нерекомендуемой; для запуска сценариев предпочтительно использовать httpapi
- Модуль поддерживает check_mode.
Примеры
- name: Configure CAPWAP timers.
fortinet.fortios.fortios_wireless_controller_timers:
vdom: "{{ vdom }}"
wireless_controller_timers:
ap_reboot_wait_interval1: "0"
ap_reboot_wait_interval2: "0"
ap_reboot_wait_time: "<your_own_value>"
auth_timeout: "5"
ble_device_cleanup: "60"
ble_scan_report_intv: "30"
client_idle_rehome_timeout: "20"
client_idle_timeout: "300"
darrp_day: "sunday"
darrp_optimize: "43200"
darrp_time:
-
time: "<your_own_value>"
discovery_interval: "5"
drma_interval: "60"
echo_interval: "30"
fake_ap_log: "1"
ipsec_intf_cleanup: "120"
nat_session_keep_alive: "0"
radio_stats_interval: "15"
rogue_ap_cleanup: "0"
rogue_ap_log: "0"
rogue_sta_cleanup: "0"
sta_cap_cleanup: "0"
sta_capability_interval: "30"
sta_locate_timer: "1800"
sta_offline_cleanup: "300"
sta_offline_ip2mac_cleanup: "300"
sta_stats_interval: "10"
vap_stats_interval: "15"
wids_entry_cleanup: "0"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, относящиеся только к этому модулю:
Ключ | Описание |
|---|---|
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_timers_module.html