fortios_log_disk_setting – Настройки для локального дискового ведения журнала в Fortinet’s FortiOS и FortiGate
Новая в версии 2.8.
Краткое описание
- Этот модуль позволяет настроить устройство FortiGate или FortiOS (FOS), позволяя пользователю устанавливать и изменять функцию log_disk и категорию настроек. Примеры включают все параметры и значения, которые необходимо настроить в источниках данных перед использованием. Тестировалось с FOS v6.0.5
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- fortiosapi>=0.9.8
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| host строка | IP-адрес FortiOS или FortiGate. | ||
| https булево |
| Указывает, должны ли запросы к FortiGate использовать протокол HTTPS. | |
| log_disk_setting словарь | По умолчанию: null | Настройки журналирования на локальном диске. | |
| 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-сервер для загрузки файлов журнала диска. | ||
| password строка | По умолчанию: "" | Пароль FortiOS или FortiGate. | |
| ssl_verify булево добавлено в 2.9 |
| Обеспечивает проверку сертификата FortiGate надёжным центром сертификации. | |
| username строка | Имя пользователя FortiOS или FortiGate. | ||
| vdom строка | По умолчанию: "root" | Виртуальный домен, из ранее определённых. VDOM — виртуальная инстанция FortiGate, которая может быть настроена и использована как отдельное устройство. | |
Примечания
Примечание
- Требуется библиотека fortiosapi, разработанная Fortinet
- Выполняется как local_action в вашем playbook
Примеры
- hosts: localhost
vars:
host: "192.168.122.40"
username: "admin"
password: ""
vdom: "root"
ssl_verify: "False"
tasks:
- name: Settings for local disk logging.
fortios_log_disk_setting:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
vdom: "{{ vdom }}"
https: "False"
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 |
Статус
- Данный модуль не гарантирует обратную совместимость. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Miguel Angel Munoz (@mamunozgonzalez)
- Nicolas Thomas (@thomnico)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/fortios_log_disk_setting_module.html