community.network.fmgr_secprof_av – Управление профилем безопасности

Примечание

Этот плагин является частью коллекции community.network (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.network.

Для использования в плейбуке укажите: community.network.fmgr_secprof_av.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управление группами профилей безопасности для объектов FortiManager

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
adom строка	По умолчанию: "root"	ADOM, к которому должна принадлежать конфигурация.
analytics_bl_filetype строка		Отправлять в FortiSandbox только файлы, соответствующие этому шаблону DLP.
analytics_db строка	Варианты: отключить включить	Включить/отключить использование базы данных подписей FortiSandbox для дополнения баз данных подписей AV.
analytics_max_upload строка		Максимальный размер файлов, которые можно загрузить в FortiSandbox (1 - 395 МБайт, по умолчанию = 10).
analytics_wl_filetype строка		Не отправлять в FortiSandbox файлы, соответствующие этому шаблону DLP.
av_block_log строка	Варианты: отключить включить	Включить/отключить протоколирование блокировки файлов AntiVirus.
av_virus_log строка	Варианты: отключить включить	Включить/отключить протоколирование AntiVirus.
comment строка		Комментарий.
content_disarm строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не параметры ansible, указанные ниже. При отправке все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЮЩИЙ со своими параметрами. Ожидается, что вы понимаете, что делаете с этими параметрами списков, и используете Руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
content_disarm_cover_page строка	Варианты: отключить включить	Включить/отключить вставку титульного листа в разоруженный документ.
content_disarm_detect_only строка	Варианты: отключить включить	Включить/отключить только обнаружение разоружаемых файлов, не изменяя содержимое.
content_disarm_office_embed строка	Варианты: отключить включить	Включить/отключить удаление встроенных объектов в документах Microsoft Office.
content_disarm_office_hylink строка	Варианты: отключить включить	Включить/отключить удаление гиперссылок в документах Microsoft Office.
content_disarm_office_linked строка	Варианты: отключить включить	Включить/отключить удаление связанных объектов в документах Microsoft Office.
content_disarm_office_macro строка	Варианты: отключить включить	Включить/отключить удаление макросов в документах Microsoft Office.
content_disarm_original_file_destination строка	Варианты: fortisandbox карантин удалить	Место назначения для отправки исходного файла, если активное содержимое удалено.
content_disarm_pdf_act_form строка	Варианты: отключить включить	Включить/отключить удаление действий, которые отправляют данные на другие цели в PDF-документах.
content_disarm_pdf_act_gotor строка	Варианты: отключить включить	Включить/отключить удаление ссылок на другие PDF-документы в PDF-документах.
content_disarm_pdf_act_java строка	Варианты: отключить включить	Включить/отключить удаление действий, которые выполняют JavaScript-код в PDF-документах.
content_disarm_pdf_act_launch строка	Варианты: отключить включить	Включить/отключить удаление ссылок на внешние приложения в PDF-документах.
content_disarm_pdf_act_movie строка	Варианты: отключить включить	Включить/отключить удаление встроенных видео в PDF-документах.
content_disarm_pdf_act_sound строка	Варианты: отключить включить	Включить/отключить удаление встроенных звуковых файлов в PDF-документах.
content_disarm_pdf_embedfile строка	Варианты: отключить включить	Включить/отключить удаление встроенных файлов в PDF-документах.
content_disarm_pdf_hyperlink строка	Варианты: отключить включить	Включить/отключить удаление гиперссылок из PDF-документов.
content_disarm_pdf_javacode строка	Варианты: отключить включить	Включить/отключить удаление JavaScript-кода из PDF-документов.
extended_log строка	Варианты: отключить включить	Включить/отключить расширенное протоколирование для антивируса.
ftgd_analytics строка	Варианты: отключить подозрительный все	Настройки для управления файлами, которые загружаются в FortiSandbox.
ftp строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не параметры ansible, указанные ниже. При отправке все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЮЩИЙ со своими параметрами. Ожидается, что вы понимаете, что делаете с этими параметрами списков, и используете Руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
ftp_archive_block строка	Варианты: шифрованный поврежденный многочастотный вложенный бомбардировка почтой необработанный частично поврежденный превышение лимита файлов таймаут	Выберите типы архивов для блокировки. Параметры на основе ФЛАГОВ. Укажите несколько в виде списка.
ftp_archive_log строка	Варианты: шифрованный поврежденный многочастотный вложенный бомбардировка почтой необработанный частично поврежденный превышение лимита файлов таймаут	Выберите типы архивов для протоколирования. Параметры на основе ФЛАГОВ. Укажите несколько в виде списка.
ftp_emulator строка	Варианты: отключить включить	Включить/отключить эмулятор вирусов.
ftp_options строка	Варианты: сканировать карантин avмонитор	Включить/отключить сканирование, мониторинг и карантин FTP AntiVirus. Параметры на основе ФЛАГОВ. Укажите несколько в виде списка.
ftp_outbreak_prevention строка	Варианты: выключено файлы полный архив	Включить службу FortiGuard по предотвращению вспышек вирусов.
http строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не параметры ansible, указанные ниже. При отправке все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЮЩИЙ со своими параметрами. Ожидается, что вы понимаете, что делаете с этими параметрами списков, и используете Руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
http_archive_block строка	Варианты: шифрованный поврежденный многочастотный вложенный бомбардировка почтой необработанный частично поврежденный превышение лимита файлов таймаут	Выберите типы архивов для блокировки. Параметры на основе ФЛАГОВ. Укажите несколько в виде списка.
http_archive_log строка	Варианты: шифрованный поврежденный многочастотный вложенный бомбардировка почтой необработанный частично поврежденный превышение лимита файлов таймаут	Выберите типы архивов для протоколирования. Параметры на основе ФЛАГОВ. Укажите несколько в виде списка.
http_content_disarm строка	Варианты: отключить включить	Включить разбор и восстановление содержимого для этого протокола.
http_emulator строка	Варианты: отключить включить	Включить/отключить эмулятор вирусов.
http_options строка	Варианты: сканировать карантин avмонитор	Включить/отключить сканирование, мониторинг и карантин HTTP AntiVirus. Параметры на основе ФЛАГОВ. Укажите несколько в виде списка.

http_outbreak_prevention string	Choices: disabled files full-archive	Включить службу FortiGuard Virus Outbreak Prevention.
imap string		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои параметры. Ожидается, что вы знаете, что делаете с этими параметрами списка и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДПАРАМЕТРЫ ДЛЯ СОЗДАНИЯ ОБЪЕКТОВ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
imap_archive_block string	Choices: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов для блокировки. Параметры на основе флагов. Укажите несколько в виде списка.
imap_archive_log string	Choices: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов для регистрации. Параметры на основе флагов. Укажите несколько в виде списка.
imap_content_disarm string	Choices: disable enable	Включить Content Disarm and Reconstruction для этого протокола.
imap_emulator string	Choices: disable enable	Включить/выключить эмулятор вирусов.
imap_executables string	Choices: default virus	Обрабатывать исполняемые файлы Windows как вирусы для целей блокировки или мониторинга.
imap_options string	Choices: scan quarantine avmonitor	Включить/выключить сканирование, мониторинг и карантин IMAP AntiVirus. Параметры на основе флагов. Укажите несколько в виде списка.
imap_outbreak_prevention string	Choices: disabled files full-archive	Включить службу FortiGuard Virus Outbreak Prevention.
inspection_mode string	Choices: proxy flow-based	Режим проверки.
mapi string		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои параметры. Ожидается, что вы знаете, что делаете с этими параметрами списка и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДПАРАМЕТРЫ ДЛЯ СОЗДАНИЯ ОБЪЕКТОВ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
mapi_archive_block string	Choices: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов для блокировки. Параметры на основе флагов. Укажите несколько в виде списка.
mapi_archive_log string	Choices: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов для регистрации. Параметры на основе флагов. Укажите несколько в виде списка.
mapi_emulator string	Choices: disable enable	Включить/выключить эмулятор вирусов.
mapi_executables string	Choices: default virus	Обрабатывать исполняемые файлы Windows как вирусы для целей блокировки или мониторинга.
mapi_options string	Choices: scan quarantine avmonitor	Включить/выключить сканирование, мониторинг и карантин MAPI AntiVirus. Параметры на основе флагов. Укажите несколько в виде списка.
mapi_outbreak_prevention string	Choices: disabled files full-archive	Включить службу FortiGuard Virus Outbreak Prevention.
mobile_malware_db string	Choices: disable enable	Включить/выключить использование базы данных сигнатур мобильных вредоносных программ.
mode string	Choices: add ← set delete update	Устанавливает один из трех режимов управления объектом. Позволяет использовать мягкое добавление вместо перезаписи существующих значений
nac_quar string		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои параметры. Ожидается, что вы знаете, что делаете с этими параметрами списка и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДПАРАМЕТРЫ ДЛЯ СОЗДАНИЯ ОБЪЕКТОВ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
nac_quar_expiry string		Срок карантина.
nac_quar_infected string	Choices: none quar-src-ip	Включить/выключить помещение зараженных хостов в список запрещенных пользователей.
nac_quar_log string	Choices: disable enable	Включить/выключить протоколирование карантина AntiVirus.
name string		Имя профиля.
nntp string		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои параметры. Ожидается, что вы знаете, что делаете с этими параметрами списка и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДПАРАМЕТРЫ ДЛЯ СОЗДАНИЯ ОБЪЕКТОВ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
nntp_archive_block string	Choices: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов для блокировки. Параметры на основе флагов. Укажите несколько в виде списка.
nntp_archive_log string	Choices: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов для регистрации. Параметры на основе флагов. Укажите несколько в виде списка.
nntp_emulator string	Choices: disable enable	Включить/выключить эмулятор вирусов.
nntp_options string	Choices: scan quarantine avmonitor	Включить/выключить сканирование, мониторинг и карантин NNTP AntiVirus. Параметры на основе флагов. Укажите несколько в виде списка.
nntp_outbreak_prevention string	Choices: disabled files full-archive	Включить службу FortiGuard Virus Outbreak Prevention.
pop3 string		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои параметры. Ожидается, что вы знаете, что делаете с этими параметрами списка и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДПАРАМЕТРЫ ДЛЯ СОЗДАНИЯ ОБЪЕКТОВ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
pop3_archive_block string	Choices: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов для блокировки. Параметры на основе флагов. Укажите несколько в виде списка.
pop3_archive_log string	Choices: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов для регистрации. Параметры на основе флагов. Укажите несколько в виде списка.

pop3_content_disarm string	Выборы: disable enable	Включить Content Disarm and Reconstruction для данного протокола.
pop3_emulator string	Выборы: disable enable	Включить/отключить эмулятор вирусов.
pop3_executables string	Выборы: default virus	Обрабатывать исполняемые файлы Windows как вирусы в целях блокировки или мониторинга.
pop3_options string	Выборы: scan quarantine avmonitor	Включить/отключить сканирование, мониторинг и карантин антивируса POP3. Параметры на основе флагов. Укажите несколько в виде списка.
pop3_outbreak_prevention string	Выборы: disabled files full-archive	Включить службу FortiGuard Virus Outbreak Prevention.
replacemsg_group string		Группа сообщений замены, настроенная для этого профиля.
scan_mode string	Выборы: quick full	Выберите режим полного сканирования или быстрого сканирования.
smb string		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API JSON FMGR! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не параметры ansible, указанные ниже. Если отправлено, все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМОИСКЛЮЧАЮЩ с его параметрами. Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДПАРАМЕТРЫ ВМЕСТО ЭТОГО, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С МНОЖЕСТВОМ ЗАДАЧ
smb_archive_block string	Выборы: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов, которые нужно заблокировать. Параметры на основе флагов. Укажите несколько в виде списка.
smb_archive_log string	Выборы: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов, которые нужно регистрировать. Параметры на основе флагов. Укажите несколько в виде списка.
smb_emulator string	Выборы: disable enable	Включить/отключить эмулятор вирусов.
smb_options string	Выборы: scan quarantine avmonitor	Включить/отключить сканирование, мониторинг и карантин антивируса SMB. Параметры на основе флагов. Укажите несколько в виде списка.
smb_outbreak_prevention string	Выборы: disabled files full-archive	Включить службу FortiGuard Virus Outbreak Prevention.
smtp string		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API JSON FMGR! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не параметры ansible, указанные ниже. Если отправлено, все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМОИСКЛЮЧАЮЩ с его параметрами. Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДПАРАМЕТРЫ ВМЕСТО ЭТОГО, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С МНОЖЕСТВОМ ЗАДАЧ
smtp_archive_block string	Выборы: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов, которые нужно заблокировать. Параметры на основе флагов. Укажите несколько в виде списка.
smtp_archive_log string	Выборы: encrypted corrupted multipart nested mailbomb unhandled partiallycorrupted fileslimit timeout	Выберите типы архивов, которые нужно регистрировать. Параметры на основе флагов. Укажите несколько в виде списка.
smtp_content_disarm string	Выборы: disable enable	Включить Content Disarm and Reconstruction для данного протокола.
smtp_emulator string	Выборы: disable enable	Включить/отключить эмулятор вирусов.
smtp_executables string	Выборы: default virus	Обрабатывать исполняемые файлы Windows как вирусы в целях блокировки или мониторинга.
smtp_options string	Выборы: scan quarantine avmonitor	Включить/отключить сканирование, мониторинг и карантин антивируса SMTP. Параметры на основе флагов. Укажите несколько в виде списка.
smtp_outbreak_prevention string	Выборы: disabled files full-archive	Включить службу FortiGuard Virus Outbreak Prevention.

Примечания

Примечание

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

Примеры

- name: DELETE Profile
  community.network.fmgr_secprof_av:
    name: "Ansible_AV_Profile"
    mode: "delete"

- name: CREATE Profile
  community.network.fmgr_secprof_av:
    name: "Ansible_AV_Profile"
    comment: "Created by Ansible Module TEST"
    mode: "set"
    inspection_mode: "proxy"
    ftgd_analytics: "everything"
    av_block_log: "enable"
    av_virus_log: "enable"
    scan_mode: "full"
    mobile_malware_db: "enable"
    ftp_archive_block: "encrypted"
    ftp_outbreak_prevention: "files"
    ftp_archive_log: "timeout"
    ftp_emulator: "disable"
    ftp_options: "scan"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Возвращённое значение	Описание
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_av_module.html