community.network.fmgr_secprof_ssl_ssh – Управление профилями безопасности SSL и SSH в FortiManager

Примечание

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

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

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

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

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

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
adom строка	По умолчанию: "root"	ADOM, к которому должна относиться конфигурация.
caname строка		Сертификат CA, используемый для SSL-инспекции.
comment строка		Дополнительные комментарии.
ftps строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. При отправке все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМОИСКЛЮЧАЮЩИЙ с его опциями. Мы ожидаем, что вы понимаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ВОСПОЛЬЗУЙТЕСЬ НИЖЕУКАЗАННЫМИ ПОДВАРИАНТАМИ, ЧТОБЫ СОЗДАВАТЬ ОБЪЕКТЫ С МНОЖЕСТВОМ ЗАДАЧ
ftps_allow_invalid_server_cert строка	Варианты: disable enable	При включении разрешает SSL-сессии, валидация серверного сертификата которых не удалась. выбор \| disable \| Отключить. выбор \| enable \| Включить.
ftps_client_cert_request строка	Варианты: bypass inspect block	Действие в зависимости от сбоя запроса сертификата клиента. выбор \| bypass \| Пропустить. выбор \| inspect \| Проверить. выбор \| block \| Заблокировать.
ftps_ports строка		Порты для сканирования (1-65535, по умолчанию = 443).
ftps_status строка	Варианты: disable deep-inspection	Настройка состояния проверки протокола. выбор \| disable \| Отключить. выбор \| deep-inspection \| Полная SSL-инспекция.
ftps_unsupported_ssl строка	Варианты: bypass inspect block	Действие в зависимости от того, что используемое SSL-шифрование не поддерживается. выбор \| bypass \| Пропустить. выбор \| inspect \| Проверить. выбор \| block \| Заблокировать.
ftps_untrusted_cert строка	Варианты: allow block ignore	Разрешить, игнорировать или заблокировать серверный сертификат ненадежной SSL-сессии. выбор \| allow \| Разрешить ненадежный серверный сертификат. выбор \| block \| Заблокировать соединение при обнаружении ненадежного серверного сертификата. выбор \| ignore \| Всегда считать серверный сертификат надежным.
https строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. При отправке все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМОИСКЛЮЧАЮЩИЙ с его опциями. Мы ожидаем, что вы понимаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ВОСПОЛЬЗУЙТЕСЬ НИЖЕУКАЗАННЫМИ ПОДВАРИАНТАМИ, ЧТОБЫ СОЗДАВАТЬ ОБЪЕКТЫ С МНОЖЕСТВОМ ЗАДАЧ
https_allow_invalid_server_cert строка	Варианты: disable enable	При включении разрешает SSL-сессии, валидация серверного сертификата которых не удалась. выбор \| disable \| Отключить. выбор \| enable \| Включить.
https_client_cert_request строка	Варианты: bypass inspect block	Действие в зависимости от сбоя запроса сертификата клиента. выбор \| bypass \| Пропустить. выбор \| inspect \| Проверить. выбор \| block \| Заблокировать.
https_ports строка		Порты для сканирования (1-65535, по умолчанию = 443).
https_status строка	Варианты: disable certificate-inspection deep-inspection	Настройка состояния проверки протокола. выбор \| disable \| Отключить. выбор \| certificate-inspection \| Проверить только SSL-рукопожатие. выбор \| deep-inspection \| Полная SSL-инспекция.
https_unsupported_ssl строка	Варианты: bypass inspect block	Действие в зависимости от того, что используемое SSL-шифрование не поддерживается. выбор \| bypass \| Пропустить. выбор \| inspect \| Проверить. выбор \| block \| Заблокировать.
https_untrusted_cert строка	Варианты: allow block ignore	Разрешить, игнорировать или заблокировать серверный сертификат ненадежной SSL-сессии. выбор \| allow \| Разрешить ненадежный серверный сертификат. выбор \| block \| Заблокировать соединение при обнаружении ненадежного серверного сертификата. выбор \| ignore \| Всегда считать серверный сертификат надежным.
imaps строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. При отправке все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМОИСКЛЮЧАЮЩИЙ с его опциями. Мы ожидаем, что вы понимаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ВОСПОЛЬЗУЙТЕСЬ НИЖЕУКАЗАННЫМИ ПОДВАРИАНТАМИ, ЧТОБЫ СОЗДАВАТЬ ОБЪЕКТЫ С МНОЖЕСТВОМ ЗАДАЧ
imaps_allow_invalid_server_cert строка	Варианты: disable enable	При включении разрешает SSL-сессии, валидация серверного сертификата которых не удалась. выбор \| disable \| Отключить. выбор \| enable \| Включить.
imaps_client_cert_request строка	Варианты: bypass inspect block	Действие в зависимости от сбоя запроса сертификата клиента. выбор \| bypass \| Пропустить. выбор \| inspect \| Проверить. выбор \| block \| Заблокировать.
imaps_ports строка		Порты для сканирования (1-65535, по умолчанию = 443).
imaps_status строка	Варианты: disable deep-inspection	Настройка состояния проверки протокола. выбор \| disable \| Отключить. выбор \| deep-inspection \| Полная SSL-инспекция.
imaps_unsupported_ssl строка	Варианты: bypass inspect block	Действие в зависимости от того, что используемое SSL-шифрование не поддерживается. выбор \| bypass \| Пропустить. выбор \| inspect \| Проверить. выбор \| block \| Заблокировать.
imaps_untrusted_cert строка	Варианты: allow block ignore	Разрешить, игнорировать или заблокировать серверный сертификат ненадежной SSL-сессии. выбор \| allow \| Разрешить ненадежный серверный сертификат. выбор \| block \| Заблокировать соединение при обнаружении ненадежного серверного сертификата. выбор \| ignore \| Всегда считать серверный сертификат надежным.
mapi_over_https строка	Варианты: disable enable	Включить/отключить инспекцию MAPI через HTTPS. выбор \| disable \| Отключить инспекцию MAPI через HTTPS. выбор \| enable \| Включить инспекцию MAPI через HTTPS.
mode строка	Варианты: добавить ← изменить удалить обновить	Устанавливает один из трех режимов управления объектом. Разрешает использование мягких добавлений вместо перезаписи существующих значений
name строка		Имя.
pop3s строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. При отправке все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМОИСКЛЮЧАЮЩИЙ с его опциями. Мы ожидаем, что вы понимаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ВОСПОЛЬЗУЙТЕСЬ НИЖЕУКАЗАННЫМИ ПОДВАРИАНТАМИ, ЧТОБЫ СОЗДАВАТЬ ОБЪЕКТЫ С МНОЖЕСТВОМ ЗАДАЧ
pop3s_allow_invalid_server_cert строка	Варианты: disable enable	При включении разрешает SSL-сессии, валидация серверного сертификата которых не удалась. выбор \| disable \| Отключить. выбор \| enable \| Включить.
pop3s_client_cert_request строка	Варианты: bypass inspect block	Действие в зависимости от сбоя запроса сертификата клиента. выбор \| bypass \| Пропустить. выбор \| inspect \| Проверить. выбор \| block \| Заблокировать.
pop3s_ports строка		Порты для сканирования (1-65535, по умолчанию = 443).
pop3s_status строка	Варианты: disable deep-inspection	Настройка состояния проверки протокола. выбор \| disable \| Отключить. выбор \| deep-inspection \| Полная SSL-инспекция.

pop3s_unsupported_ssl строка	Варианты: bypass inspect block	Действие, выполняемое при обнаружении неподдерживаемого шифрования SSL. выбор \| bypass \| Пропустить. выбор \| inspect \| Проверить. выбор \| block \| Блокировать.
pop3s_untrusted_cert строка	Варианты: allow block ignore	Разрешить, игнорировать или заблокировать сертифиакт сервера SSL-соединения, не являющийся доверенным. выбор \| allow \| Разрешить недоверенный сертификат сервера. выбор \| block \| Блокировать соединение при обнаружении недоверенного сертификата сервера. выбор \| ignore \| Считать сертификат сервера доверенным всегда.
rpc_over_https строка	Варианты: disable enable	Включить/выключить проверку RPC через HTTPS. выбор \| disable \| Отключить проверку RPC через HTTPS. выбор \| enable \| Включить проверку RPC через HTTPS.
server_cert строка		Сертификат, используемый SSL-проверкой для замены сертификата сервера.
server_cert_mode строка	Варианты: re-sign replace	Переподписать или заменить сертификат сервера. выбор \| re-sign \| Несколько клиентов, подключающихся к нескольким серверам. выбор \| replace \| Защита SSL-сервера.
smtps строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЮЩИЙ со своими параметрами. Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДОБРАННЫЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
smtps_allow_invalid_server_cert строка	Варианты: disable enable	При включении разрешает SSL-сессии, проверка сертификата сервера которых завершилась неудачно. выбор \| disable \| Отключить. выбор \| enable \| Включить.
smtps_client_cert_request строка	Варианты: bypass inspect block	Действие в зависимости от неудачи запроса клиентского сертификата. выбор \| bypass \| Пропустить. выбор \| inspect \| Проверить. выбор \| block \| Блокировать.
smtps_ports строка		Порты для сканирования (1-65535, по умолчанию = 443).
smtps_status строка	Варианты: disable deep-inspection	Настройка статуса проверки протокола. выбор \| disable \| Отключить. выбор \| deep-inspection \| Полная проверка SSL.
smtps_unsupported_ssl строка	Варианты: bypass inspect block	Действие, выполняемое при обнаружении неподдерживаемого шифрования SSL. выбор \| bypass \| Пропустить. выбор \| inspect \| Проверить. выбор \| block \| Блокировать.
smtps_untrusted_cert строка	Варианты: allow block ignore	Разрешить, игнорировать или заблокировать сертифиакт сервера SSL-соединения, не являющийся доверенным. выбор \| allow \| Разрешить недоверенный сертификат сервера. выбор \| block \| Блокировать соединение при обнаружении недоверенного сертификата сервера. выбор \| ignore \| Считать сертификат сервера доверенным всегда.
ssh строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЮЩИЙ со своими параметрами. Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДОБРАННЫЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
ssh_inspect_all строка	Варианты: disable deep-inspection	Уровень проверки SSL. выбор \| disable \| Отключить. выбор \| deep-inspection \| Полная проверка SSL.
ssh_ports строка		Порты для сканирования (1-65535, по умолчанию = 443).
ssh_ssh_algorithm строка	Варианты: compatible high-encryption	Относительная сила алгоритмов шифрования, принимаемых во время переговоров. выбор \| compatible \| Разрешить более широкий набор алгоритмов шифрования для наилучшей совместимости. выбор \| high-encryption \| Разрешить только шифры AES-CTR, AES-GCM и алгоритмы с высоким уровнем шифрования.
ssh_ssh_policy_check строка	Варианты: disable enable	Включить/выключить проверку политики SSH. выбор \| disable \| Отключить проверку политики SSH. выбор \| enable \| Включить проверку политики SSH.
ssh_ssh_tun_policy_check строка	Варианты: disable enable	Включить/выключить проверку политики SSH-туннеля. выбор \| disable \| Отключить проверку политики SSH-туннеля. выбор \| enable \| Включить проверку политики SSH-туннеля.
ssh_status строка	Варианты: disable deep-inspection	Настройка статуса проверки протокола. выбор \| disable \| Отключить. выбор \| deep-inspection \| Полная проверка SSL.
ssh_unsupported_version строка	Варианты: block bypass	Действие в зависимости от неподдерживаемой версии SSH. выбор \| block \| Блокировать. выбор \| bypass \| Пропустить.
ssl строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЮЩИЙ со своими параметрами. Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДОБРАННЫЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
ssl_allow_invalid_server_cert строка	Варианты: disable enable	При включении разрешает SSL-сессии, проверка сертификата сервера которых завершилась неудачно. выбор \| disable \| Отключить. выбор \| enable \| Включить.
ssl_anomalies_log строка	Варианты: disable enable	Включить/выключить протоколирование аномалий SSL. выбор \| disable \| Отключить протоколирование аномалий SSL. выбор \| enable \| Включить протоколирование аномалий SSL.
ssl_client_cert_request строка	Варианты: bypass inspect block	Действие в зависимости от неудачи запроса клиентского сертификата. выбор \| bypass \| Пропустить. выбор \| inspect \| Проверить. выбор \| block \| Блокировать.
ssl_exempt строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЮЩИЙ со своими параметрами. Ожидается, что вы знаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ПОДОБРАННЫЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
ssl_exempt_address строка		Объект IPv4-адреса.
ssl_exempt_address6 строка		Объект IPv6-адреса.
ssl_exempt_fortiguard_category строка		Идентификатор категории FortiGuard.
ssl_exempt_regex строка		Исключить сервера по регулярному выражению.
ssl_exempt_type строка	Варианты: fortiguard-category address address6 wildcard-fqdn regex	Тип объекта адреса (IPv4 или IPv6) или категории FortiGuard. выбор \| fortiguard-category \| Категория FortiGuard. выбор \| address \| IPv4-адрес брандмауэра. выбор \| address6 \| IPv6-адрес брандмауэра. выбор \| wildcard-fqdn \| Полное доменное имя с символами подстановки. выбор \| regex \| Регулярное выражение для полного доменного имени.
ssl_exempt_wildcard_fqdn строка		Исключить сервера по доменному имени с символами подстановки.
ssl_exemptions_log строка	Варианты: disable enable	Включить/выключить протоколирование исключений SSL. выбор \| disable \| Отключить протоколирование исключений SSL. выбор \| enable \| Включить протоколирование исключений SSL.

ssl_inspect_all string	Choices: disable certificate-inspection deep-inspection	Уровень инспекции SSL. choice \| disable \| Отключить. choice \| certificate-inspection \| Проверить только рукопожатие SSL. choice \| deep-inspection \| Полная инспекция SSL.
ssl_server string		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, указанные ниже. Если передан, все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект взаимоисключающий со своими опциями. Ожидается, что вы знаете, что делаете с этими параметрами списка и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДВАРИАНТЫ ВМЕСТО ЭТОГО, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
ssl_server_ftps_client_cert_request string	Choices: bypass inspect block	Действие в случае сбоя запроса сертификата клиента во время рукопожатия FTPS. choice \| bypass \| Пропустить. choice \| inspect \| Проверить. choice \| block \| Заблокировать.
ssl_server_https_client_cert_request string	Choices: bypass inspect block	Действие в случае сбоя запроса сертификата клиента во время рукопожатия HTTPS. choice \| bypass \| Пропустить. choice \| inspect \| Проверить. choice \| block \| Заблокировать.
ssl_server_imaps_client_cert_request string	Choices: bypass inspect block	Действие в случае сбоя запроса сертификата клиента во время рукопожатия IMAPS. choice \| bypass \| Пропустить. choice \| inspect \| Проверить. choice \| block \| Заблокировать.
ssl_server_ip string		IPv4-адрес сервера SSL.
ssl_server_pop3s_client_cert_request string	Choices: bypass inspect block	Действие в случае сбоя запроса сертификата клиента во время рукопожатия POP3S. choice \| bypass \| Пропустить. choice \| inspect \| Проверить. choice \| block \| Заблокировать.
ssl_server_smtps_client_cert_request string	Choices: bypass inspect block	Действие в случае сбоя запроса сертификата клиента во время рукопожатия SMTPS. choice \| bypass \| Пропустить. choice \| inspect \| Проверить. choice \| block \| Заблокировать.
ssl_server_ssl_other_client_cert_request string	Choices: bypass inspect block	Действие в случае сбоя запроса сертификата клиента во время рукопожатия протокола SSL. choice \| bypass \| Пропустить. choice \| inspect \| Проверить. choice \| block \| Заблокировать.
ssl_unsupported_ssl string	Choices: bypass inspect block	Действие в случае использования неподдерживаемого шифрования SSL. choice \| bypass \| Пропустить. choice \| inspect \| Проверить. choice \| block \| Заблокировать.
ssl_untrusted_cert string	Choices: allow block ignore	Разрешить, пропустить или заблокировать недоверенный сертификат сервера SSL. choice \| allow \| Разрешить недоверенный сертификат сервера. choice \| block \| Заблокировать соединение при обнаружении недоверенного сертификата сервера. choice \| ignore \| Всегда считать сертификат сервера доверенным.
untrusted_caname string		Недоверенный сертификат CA, используемый для инспекции SSL.
use_ssl_server string	Choices: disable enable	Включить/выключить использование таблицы сервера SSL для SSL-оффлоадинга. choice \| disable \| Не использовать конфигурацию сервера SSL. choice \| enable \| Использовать конфигурацию сервера SSL.
whitelist string	Choices: disable enable	Включить/выключить исключение серверов с помощью белого списка FortiGuard. choice \| disable \| Отключить настройку. choice \| enable \| Включить настройку.

Примечания

Примечание

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

Примеры

- name: DELETE Profile
  community.network.fmgr_secprof_ssl_ssh:
    name: Ansible_SSL_SSH_Profile
    mode: delete

- name: CREATE Profile
  community.network.fmgr_secprof_ssl_ssh:
    name: Ansible_SSL_SSH_Profile
    comment: "Created by Ansible Module TEST"
    mode: set
    mapi_over_https: enable
    rpc_over_https: enable
    server_cert_mode: replace
    ssl_anomalies_log: enable
    ssl_exemptions_log: enable
    use_ssl_server: enable
    whitelist: 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_ssl_ssh_module.html