fortinet.fortios.fortios_log_disk_setting – Настройки локального дискового логирования в FortiOS и FortiGate Fortinet.
Примечание
Этот плагин является частью коллекции fortinet.fortios (версия 1.1.8).
Для его установки используйте: ansible-galaxy collection install fortinet.fortios.
Для использования в плейбуке укажите: fortinet.fortios.fortios_log_disk_setting.
Новое в версии 2.8: of fortinet.fortios
Обзор
- Этот модуль позволяет настроить устройство FortiGate или FortiOS (FOS), позволяя пользователю устанавливать и изменять функцию log_disk и категорию настроек. Примеры включают все параметры и значения, которые необходимо настроить в источниках данных перед использованием. Тестировалось с FOS v6.0.0
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- ansible>=2.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| access_token строка | Аутентификация на основе токена. Создается в веб-интерфейсе Fortigate. | ||
| log_disk_setting словарь | Настройки локального дискового логирования. | ||
| diskfull строка |
| Действие при заполнении диска. Система может перезаписывать старейшие журналы или останавливать логирование при заполнении диска. | |
| dlp_archive_quota целое число | Квота архива DLP (МБ). | ||
| full_final_warning_threshold целое число | Пороговое значение последнего предупреждения о заполнении журнала в процентах (3 - 100). | ||
| full_first_warning_threshold целое число | Пороговое значение первого предупреждения о заполнении журнала в процентах (1 - 98). | ||
| full_second_warning_threshold целое число | Пороговое значение второго предупреждения о заполнении журнала в процентах (2 - 99). | ||
| ips_archive строка |
| Включить/выключить архивирование пакетов IPS на локальный диск. | |
| log_quota целое число | Квота журнала на диске (МБ). | ||
| max_log_file_size целое число | Максимальный размер файла журнала перед сбросом (1 - 100 Мбайт). | ||
| max_policy_packet_capture_size целое число | Максимальный размер захвата пакетов политики в МБ (0 означает без ограничений). | ||
| maximum_log_age целое число | Удалить файлы журнала, старше (дней). | ||
| report_quota целое число | Квота отчётов (МБ). | ||
| roll_day строка |
| День недели, в который следует сбрасывать файл журнала. | |
| roll_schedule строка |
| Частота проверки файла журнала для сброса. | |
| roll_time строка | Время суток для сброса файла журнала (чч:мм). | ||
| source_ip строка | IP-адрес источника для загрузки файлов журнала диска. | ||
| status строка |
| Включить/выключить локальное дисковое логирование. | |
| upload строка |
| Включить/выключить загрузку файлов журнала при их сбросе. | |
| upload_delete_files строка |
| Удалить файлы журнала после загрузки. | |
| upload_destination строка |
| Тип сервера для загрузки файлов журнала. В настоящее время поддерживается только FTP. | |
| upload_ssl_conn строка |
| Включить/выключить зашифрованное FTPS-соединение для загрузки файлов журнала. | |
| uploaddir строка | Удаленный каталог на FTP-сервере для загрузки файлов журнала. | ||
| uploadip строка | IP-адрес FTP-сервера для загрузки файлов журнала. | ||
| uploadpass строка | Пароль для входа на FTP-сервер для загрузки файлов журнала диска. | ||
| uploadport целое число | TCP-порт для связи с FTP-сервером. | ||
| uploadsched строка |
| Установить расписание для загрузки файлов журнала на FTP-сервер. | |
| uploadtime строка | Время суток, в которое файлы журнала загружаются, если uploadsched включен (чч:мм или чч). | ||
| uploadtype строка |
| Типы файлов журнала для загрузки. Разделяйте несколько записей пробелом. | |
| uploaduser строка | Имя пользователя для входа на FTP-сервер для загрузки файлов журнала диска. | ||
| vdom строка | По умолчанию: "root" | Виртуальная область, среди тех, что определены ранее. VDOM — это виртуальная инстанция FortiGate, которую можно настроить и использовать как отдельное устройство. | |
Примечания
Примечание
- Модуль fortiosapi устарел, httpapi является предпочтительным способом запуска плейбуков.
Примеры
- 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: Settings for local disk logging.
fortios_log_disk_setting:
vdom: "{{ vdom }}"
log_disk_setting:
diskfull: "overwrite"
dlp_archive_quota: "4"
full_final_warning_threshold: "5"
full_first_warning_threshold: "6"
full_second_warning_threshold: "7"
ips_archive: "enable"
log_quota: "9"
max_log_file_size: "10"
max_policy_packet_capture_size: "11"
maximum_log_age: "12"
report_quota: "13"
roll_day: "sunday"
roll_schedule: "daily"
roll_time: "<your_own_value>"
source_ip: "84.230.14.43"
status: "enable"
upload: "enable"
upload_delete_files: "enable"
upload_destination: "ftp-server"
upload_ssl_conn: "default"
uploaddir: "<your_own_value>"
uploadip: "<your_own_value>"
uploadpass: "<your_own_value>"
uploadport: "26"
uploadsched: "disable"
uploadtime: "<your_own_value>"
uploadtype: "traffic"
uploaduser: "<your_own_value>"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/fortinet/fortios/fortios_log_disk_setting_module.html