Spec-Zone.ru › Ansible 2.8

fmgr_secprof_spam – профиль фильтра спама для FMG

В версии 2.8.

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

Краткое описание

  • Управление профилями безопасности фильтра спама в FortiManager через API

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
adom
-
По умолчанию:
"root"
ADOM, к которому должна принадлежать конфигурация.
comment
-
Комментарий.
external
-
    Варианты:
  • disable
  • enable
Включить/выключить проверку внешней почты.
flow_based
-
    Варианты:
  • disable
  • enable
Включить/выключить фильтрацию спама на основе потоков.
gmail
-
ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМО ЗНАНИЕ API FMGR JSON!
Список нескольких дочерних объектов для добавления. Ожидается список словарей.
Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже.
Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ.
Этот объект ВЗАИМНО ИСКЛЮЧАЮЩ с его опциями.
Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON.
В СЛУЧАЕ СОМНЕНИЙ, ВМЕСТО ЭТОГО ИСПОЛЬЗУЙТЕ ПОДРАЗДЕЛЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
gmail_log
-
    Варианты:
  • disable
  • enable
Включить/выключить ведение журнала.
imap
-
ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМО ЗНАНИЕ API FMGR JSON!
Список нескольких дочерних объектов для добавления. Ожидается список словарей.
Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже.
Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ.
Этот объект ВЗАИМНО ИСКЛЮЧАЮЩ с его опциями.
Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON.
В СЛУЧАЕ СОМНЕНИЙ, ВМЕСТО ЭТОГО ИСПОЛЬЗУЙТЕ ПОДРАЗДЕЛЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
imap_action
-
    Варианты:
  • pass
  • tag
Действие для спам-письма.
imap_log
-
    Варианты:
  • disable
  • enable
Включить/выключить ведение журнала.
imap_tag_msg
-
Текст темы или заголовка, добавленный к спам-письму.
imap_tag_type
-
    Варианты:
  • subject
  • header
  • spaminfo
Пометить тему или заголовок спам-письма.
Опции на основе флагов. Укажите несколько в формате списка.
mapi
-
ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМО ЗНАНИЕ API FMGR JSON!
Список нескольких дочерних объектов для добавления. Ожидается список словарей.
Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже.
Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ.
Этот объект ВЗАИМНО ИСКЛЮЧАЮЩ с его опциями.
Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON.
В СЛУЧАЕ СОМНЕНИЙ, ВМЕСТО ЭТОГО ИСПОЛЬЗУЙТЕ ПОДРАЗДЕЛЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
mapi_action
-
    Варианты:
  • pass
  • discard
Действие для спам-письма.
mapi_log
-
    Варианты:
  • disable
  • enable
Включить/выключить ведение журнала.
mode
-
    Варианты:
  • add ←
  • set
  • delete
  • update
Устанавливает один из трех режимов управления объектом.
Позволяет использовать мягкие добавления вместо перезаписи существующих значений
msn_hotmail
-
ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМО ЗНАНИЕ API FMGR JSON!
Список нескольких дочерних объектов для добавления. Ожидается список словарей.
Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже.
Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ.
Этот объект ВЗАИМНО ИСКЛЮЧАЮЩ с его опциями.
Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON.
В СЛУЧАЕ СОМНЕНИЙ, ВМЕСТО ЭТОГО ИСПОЛЬЗУЙТЕ ПОДРАЗДЕЛЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
msn_hotmail_log
-
    Варианты:
  • disable
  • enable
Включить/выключить ведение журнала.
name
-
Имя профиля.
options
-
    Варианты:
  • bannedword
  • spamfsip
  • spamfssubmit
  • spamfschksum
  • spamfsurl
  • spamhelodns
  • spamraddrdns
  • spamrbl
  • spamhdrcheck
  • spamfsphish
  • spambwl
Нет
Опции на основе флагов. Укажите несколько в формате списка.
pop3
-
ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМО ЗНАНИЕ API FMGR JSON!
Список нескольких дочерних объектов для добавления. Ожидается список словарей.
Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже.
Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ.
Этот объект ВЗАИМНО ИСКЛЮЧАЮЩ с его опциями.
Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON.
В СЛУЧАЕ СОМНЕНИЙ, ВМЕСТО ЭТОГО ИСПОЛЬЗУЙТЕ ПОДРАЗДЕЛЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
pop3_action
-
    Варианты:
  • pass
  • tag
Действие для спам-письма.
pop3_log
-
    Варианты:
  • disable
  • enable
Включить/выключить ведение журнала.
pop3_tag_msg
-
Текст темы или заголовка, добавленный к спам-письму.
pop3_tag_type
-
    Варианты:
  • subject
  • header
  • spaminfo
Пометить тему или заголовок спам-письма.
Опции на основе флагов. Укажите несколько в формате списка.
replacemsg_group
-
Группа заменяющих сообщений.
smtp
-
ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМО ЗНАНИЕ API FMGR JSON!
Список нескольких дочерних объектов для добавления. Ожидается список словарей.
Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже.
Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ.
Этот объект ВЗАИМНО ИСКЛЮЧАЮЩ с его опциями.
Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON.
В СЛУЧАЕ СОМНЕНИЙ, ВМЕСТО ЭТОГО ИСПОЛЬЗУЙТЕ ПОДРАЗДЕЛЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
smtp_action
-
    Варианты:
  • pass
  • tag
  • discard
Действие для спам-письма.
smtp_hdrip
-
    Варианты:
  • disable
  • enable
Включить/выключить проверки IP-адресов заголовков SMTP для фильтров spamfsip, spamrbl и spambwl.
smtp_local_override
-
    Варианты:
  • disable
  • enable
Включить/выключить локальный фильтр для переопределения результатов удаленной проверки SMTP.
smtp_log
-
    Варианты:
  • disable
  • enable
Включить/выключить ведение журнала.
smtp_tag_msg
-
Текст темы или заголовка, добавленный к спам-письму.
smtp_tag_type
-
    Выбор:
  • subject
  • header
  • spaminfo
Тег темы или заголовка для спам-письма.
Параметры на основе флагов. Укажите несколько значений в виде списка.
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
-
ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМО ЗНАНИЕ API JSON FMGR!
Список нескольких дочерних объектов для добавления. Ожидается список словарей.
Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже.
Если предоставлено, все остальные префиксные подпараметры ИГНОРИРУЮТСЯ.
Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои параметры.
Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON.
В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДПАРАМЕТРЫ ДЛЯ СОЗДАНИЯ ОБЪЕКТОВ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
yahoo_mail_log
-
    Выбор:
  • выключить
  • включить
Включение/выключение ведения журнала.

Примечания

Примечание

  • Полная документация по адресу https://ftnt-ansible-docs.readthedocs.io/en/latest/.

Примеры

- name: DELETE Profile
  fmgr_secprof_spam:
    name: "Ansible_Spam_Filter_Profile"
    mode: "delete"

- name: Create FMGR_SPAMFILTER_PROFILE
  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
строка
 всегда
полный ответ API, включает код состояния и сообщение


Статус

  • Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
  • Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

  • 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.8/modules/fmgr_secprof_spam_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API