community.network.fmgr_secprof_spam – профиль фильтра спама для FMG
Примечание
Этот плагин входит в коллекцию community.network (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install community.network.
Для использования в плейбуке укажите: community.network.fmgr_secprof_spam.
Обзор
- Управление профилями безопасности фильтра спама в FortiManager через API
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| adom строка | По умолчанию: "root" | ADOM, к которому должна относиться конфигурация. |
| comment строка | Комментарий. | |
| external строка |
| Включить/выключить проверку внешней почты. |
| flow_based строка |
| Включить/выключить фильтрацию спама на основе потоков. |
| gmail строка | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, указанные ниже. Если отправлено, все остальные подпараметры с префиксом ИГНОРИРУЮТСЯ. Этот объект взаимоисключающий со своими параметрами. Мы предполагаем, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДОБРАННЫЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| gmail_log строка |
| Включить/выключить ведение журнала. |
| imap строка | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, указанные ниже. Если отправлено, все остальные подпараметры с префиксом ИГНОРИРУЮТСЯ. Этот объект взаимоисключающий со своими параметрами. Мы предполагаем, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДОБРАННЫЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| imap_action строка |
| Действие для спам-письма. |
| imap_log строка |
| Включить/выключить ведение журнала. |
| imap_tag_msg строка | Текст темы или заголовка, добавленный к спам-письму. | |
| imap_tag_type строка |
| Пометить тему или заголовок спам-письма. Параметры на основе флагов. Укажите несколько значений в виде списка. |
| mapi строка | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, указанные ниже. Если отправлено, все остальные подпараметры с префиксом ИГНОРИРУЮТСЯ. Этот объект взаимоисключающий со своими параметрами. Мы предполагаем, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДОБРАННЫЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| mapi_action строка |
| Действие для спам-письма. |
| mapi_log строка |
| Включить/выключить ведение журнала. |
| mode строка |
| Устанавливает один из трех режимов управления объектом. Разрешает использовать мягкие добавления вместо перезаписи существующих значений |
| msn_hotmail строка | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, указанные ниже. Если отправлено, все остальные подпараметры с префиксом ИГНОРИРУЮТСЯ. Этот объект взаимоисключающий со своими параметрами. Мы предполагаем, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДОБРАННЫЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| msn_hotmail_log строка |
| Включить/выключить ведение журнала. |
| name строка | Имя профиля. | |
| options строка |
| Нет Параметры на основе флагов. Укажите несколько значений в виде списка. |
| pop3 строка | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, указанные ниже. Если отправлено, все остальные подпараметры с префиксом ИГНОРИРУЮТСЯ. Этот объект взаимоисключающий со своими параметрами. Мы предполагаем, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДОБРАННЫЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| pop3_action строка |
| Действие для спам-письма. |
| pop3_log строка |
| Включить/выключить ведение журнала. |
| pop3_tag_msg строка | Текст темы или заголовка, добавленный к спам-письму. | |
| pop3_tag_type строка |
| Пометить тему или заголовок спам-письма. Параметры на основе флагов. Укажите несколько значений в виде списка. |
| replacemsg_group строка | Группа заменяющих сообщений. | |
| smtp строка | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, указанные ниже. Если отправлено, все остальные подпараметры с префиксом ИГНОРИРУЮТСЯ. Этот объект взаимоисключающий со своими параметрами. Мы предполагаем, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДОБРАННЫЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| smtp_action строка |
| Действие для спам-письма. |
| smtp_hdrip строка |
| Включить/выключить проверки IP заголовков SMTP для фильтров spamfsip, spamrbl и spambwl. |
| smtp_local_override строка |
| Включить/выключить локальный фильтр для переопределения результата проверки SMTP удаленного сервера. |
| smtp_log строка |
| Включить/выключить ведение журнала. |
| smtp_tag_msg строка | Текст темы или заголовка, добавленный к спам-письму. | |
| smtp_tag_type строка |
| Пометить тему или заголовок спам-письма. Параметры на основе флагов. Укажите несколько значений в виде списка. |
| spam_bwl_table строка | Идентификатор таблицы черного/белого списка антиспама. | |
| spam_bword_table строка | Идентификатор таблицы запрещенных слов антиспама. | |
| spam_bword_threshold строка | Порог запрещенных слов спама. | |
| spam_filtering строка |
| Включить/выключить фильтрацию спама. |
| spam_iptrust_table строка | Идентификатор таблицы доверия IP антиспама. | |
| spam_log строка |
| Включить/выключить ведение журнала спама для фильтрации почты. |
| spam_log_fortiguard_response строка |
| Включить/выключить ведение журнала ответа FortiGuard на спам. |
| spam_mheader_table строка | Идентификатор таблицы заголовков MIME антиспама. | |
| spam_rbl_table строка | Идентификатор таблицы DNSBL антиспама. |
| yahoo_mail string | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЮТСЯ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не параметры ansible, указанные ниже. Если предоставлено, все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои параметры. Мы ожидаем, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДПАРАМЕТРЫ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| yahoo_mail_log string |
| Включить/выключить ведение журнала. |
Примечания
Примечание
- Полная документация по адресу https://ftnt-ansible-docs.readthedocs.io/en/latest/.
Примеры
- name: DELETE Profile
community.network.fmgr_secprof_spam:
name: "Ansible_Spam_Filter_Profile"
mode: "delete"
- name: Create FMGR_SPAMFILTER_PROFILE
community.network.fmgr_secprof_spam:
host: "{{ inventory_hostname }}"
username: "{{ username }}"
password: "{{ password }}"
mode: "set"
adom: "root"
spam_log_fortiguard_response: "enable"
spam_iptrust_table:
spam_filtering: "enable"
spam_bword_threshold: 10
options: ["bannedword", "spamfsip", "spamfsurl", "spamrbl", "spamfsphish", "spambwl"]
name: "Ansible_Spam_Filter_Profile"
flow_based: "enable"
external: "enable"
comment: "Created by Ansible"
gmail_log: "enable"
spam_log: "enable"
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| api_result string | всегда | полный ответ API, включая код состояния и сообщение |
Авторы
- Luke Weighall (@lweighall)
- Andrew Welsh (@Ghilli3)
- Jim Huber (@p4r4n0y1ng)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/network/fmgr_secprof_spam_module.html