fortios_alertemail_setting – Настройка параметров уведомлений по электронной почте в Fortinet’s FortiOS и FortiGate
Новая версия 2.9.
Описание
- Этот модуль позволяет настроить устройство FortiGate или FortiOS (FOS), позволяя пользователю устанавливать и изменять функцию alertemail и категорию настроек. В примерах указаны все параметры и значения, которые необходимо скорректировать в источниках данных перед использованием. Тестировалось с FOS v6.0.5
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- fortiosapi>=0.9.8
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| alertemail_setting словарь | По умолчанию: null | Настройка параметров оповещающей электронной почты. | |
| admin_login_logs строка |
| Включение/выключение логов входа/выхода администратора в логах оповещающей электронной почты. | |
| alert_interval целое число | Интервал оповещения в минутах. | ||
| amc_interface_bypass_mode строка |
| Включение/выключение режима обхода интерфейса карты Fortinet Advanced Mezzanine Card (AMC) в логах оповещающей электронной почты. | |
| antivirus_logs строка |
| Включение/выключение логов антивируса в логах оповещающей электронной почты. | |
| configuration_changes_logs строка |
| Включение/выключение логов изменений конфигурации в логах оповещающей электронной почты. | |
| critical_interval целое число | Интервал критического оповещения в минутах. | ||
| debug_interval целое число | Интервал отладки оповещения в минутах. | ||
| email_interval целое число | Интервал отправки оповещающих электронных писем (1 - 99999 мин). | ||
| emergency_interval целое число | Интервал экстренного оповещения в минутах. | ||
| error_interval целое число | Интервал оповещения об ошибках в минутах. | ||
| FDS_license_expiring_days целое число | Количество дней, за которое отправляется оповещающее электронное письмо перед истечением срока действия лицензии FortiGuard (1 - 100 дней). | ||
| FDS_license_expiring_warning строка |
| Включение/выключение предупреждений об истечении срока действия лицензии FortiGuard в оповещающей электронной почте. | |
| FDS_update_logs строка |
| Включение/выключение логов обновлений FortiGuard в оповещающей электронной почте. | |
| filter_mode строка |
| Как фильтровать сообщения журнала, которые отправляются по оповещающей электронной почте. | |
| FIPS_CC_errors строка |
| Включение/выключение логов ошибок FIPS и Common Criteria в оповещающей электронной почте. | |
| firewall_authentication_failure_logs строка |
| Включение/выключение логов отказа в аутентификации брандмауэра в логах оповещающей электронной почты. | |
| fortiguard_log_quota_warning строка |
| Включение/выключение предупреждений о квотах журналов FortiCloud в оповещающей электронной почте. | |
| FSSO_disconnect_logs строка |
| Включение/выключение регистрации отключения агента-коллектора FSSO. | |
| HA_logs строка |
| Включение/выключение логов HA в оповещающей электронной почте. | |
| information_interval целое число | Интервал оповещения об информации в минутах. | ||
| IPS_logs строка |
| Включение/выключение логов IPS в оповещающей электронной почте. | |
| IPsec_errors_logs строка |
| Включение/выключение логов ошибок IPsec в оповещающей электронной почте. | |
| local_disk_usage целое число | Процент использования диска, при котором отправляется оповещающая электронная почта (1 - 99 процентов). | ||
| log_disk_usage_warning строка |
| Включение/выключение предупреждений об использовании диска в оповещающей электронной почте. | |
| mailto1 строка | Адрес электронной почты для отправки оповещающего письма (обычно системному администратору) (макс. 64 символа). | ||
| mailto2 строка | Дополнительный второй адрес электронной почты для отправки оповещающего письма (макс. 64 символа). | ||
| mailto3 строка | Дополнительный третий адрес электронной почты для отправки оповещающего письма (макс. 64 символа). | ||
| notification_interval целое число | Интервал оповещения в минутах. | ||
| PPP_errors_logs строка |
| Включение/выключение логов ошибок PPP в оповещающей электронной почте. | |
| severity строка |
| Минимальный уровень серьезности для регистрации. | |
| ssh_logs строка |
| Включение/выключение логов SSH в оповещающей электронной почте. | |
| sslvpn_authentication_errors_logs строка |
| Включение/выключение логов ошибок аутентификации SSL-VPN в оповещающей электронной почте. | |
| username строка | Имя, отображаемое в поле Отправитель: оповещающих электронных писем (макс. 36 символов). | ||
| violation_traffic_logs строка |
| Включение/выключение логов нарушения трафика в оповещающей электронной почте. | |
| warning_interval целое число | Интервал предупреждающего оповещения в минутах. | ||
| webfilter_logs строка |
| Включение/выключение логов веб-фильтра в оповещающей электронной почте. | |
| host строка | IP-адрес FortiOS или FortiGate. | ||
| https логический |
| Указывает, должны ли запросы к FortiGate использовать протокол HTTPS. | |
| password строка | По умолчанию: "" | Пароль FortiOS или FortiGate. | |
| ssl_verify логический |
| Обеспечивает проверку сертификата FortiGate у надлежащего центра сертификации. | |
| username строка | Имя пользователя FortiOS или FortiGate. | ||
| vdom строка | По умолчанию: "root" | Виртуальная область, определённая ранее. VDOM — виртуальная инстанция FortiGate, которую можно настроить и использовать как отдельное устройство. | |
Примечания
Примечание
- Требует библиотеку fortiosapi, разработанную Fortinet
- Выполняется как local_action в вашем плейбуке
Примеры
- hosts: localhost
vars:
host: "192.168.122.40"
username: "admin"
password: ""
vdom: "root"
ssl_verify: "False"
tasks:
- name: Configure alert email settings.
fortios_alertemail_setting:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
vdom: "{{ vdom }}"
https: "False"
alertemail_setting:
admin_login_logs: "enable"
alert_interval: "4"
amc_interface_bypass_mode: "enable"
antivirus_logs: "enable"
configuration_changes_logs: "enable"
critical_interval: "8"
debug_interval: "9"
email_interval: "10"
emergency_interval: "11"
error_interval: "12"
FDS_license_expiring_days: "13"
FDS_license_expiring_warning: "enable"
FDS_update_logs: "enable"
filter_mode: "category"
FIPS_CC_errors: "enable"
firewall_authentication_failure_logs: "enable"
fortiguard_log_quota_warning: "enable"
FSSO_disconnect_logs: "enable"
HA_logs: "enable"
information_interval: "22"
IPS_logs: "enable"
IPsec_errors_logs: "enable"
local_disk_usage: "25"
log_disk_usage_warning: "enable"
mailto1: "<your_own_value>"
mailto2: "<your_own_value>"
mailto3: "<your_own_value>"
notification_interval: "30"
PPP_errors_logs: "enable"
severity: "emergency"
ssh_logs: "enable"
sslvpn_authentication_errors_logs: "enable"
username: "<your_own_value>"
violation_traffic_logs: "enable"
warning_interval: "37"
webfilter_logs: "enable"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| 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_alertemail_setting_module.html