community.network.fmgr_secprof_voip – Профили безопасности VOIP в FMG

Примечание

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

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

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

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
adom строка	По умолчанию: "root"	ADOM, к которому должна принадлежать конфигурация.
comment строка		Комментарий.
mode строка	Варианты: add ← set delete update	Устанавливает один из трех режимов управления объектом. Позволяет использовать мягкое добавление вместо перезаписи существующих значений
name строка		Имя профиля.
sccp строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМОИСКЛЮЧАЮЩ с его опциями. Мы ожидаем, что вы знаете, что делаете с этими параметрами списка и используете руководство по API JSON. В случае сомнений, используйте нижеперечисленные подварианты для создания объектов с несколькими задачами
sccp_block_mcast строка	Варианты: disable enable	Включить/выключить блокирование многоадресных RTP-соединений. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sccp_log_call_summary строка	Варианты: disable enable	Включить/выключить протоколирование сводки вызовов SCCP. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sccp_log_violations строка	Варианты: disable enable	Включить/выключить протоколирование нарушений SCCP. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sccp_max_calls строка		Максимальное количество вызовов в минуту на один клиент SCCP (максимум 65535).
sccp_status строка	Варианты: disable enable	Включить/выключить SCCP. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sccp_verify_header строка	Варианты: disable enable	Включить/выключить проверку содержимого заголовка SCCP. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМОИСКЛЮЧАЮЩ с его опциями. Мы ожидаем, что вы знаете, что делаете с этими параметрами списка и используете руководство по API JSON. В случае сомнений, используйте нижеперечисленные подварианты для создания объектов с несколькими задачами
sip_ack_rate строка		Лимит скорости запросов ACK (в секунду, на политику).
sip_block_ack строка	Варианты: disable enable	Включить/выключить блокирование запросов ACK. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_bye строка	Варианты: disable enable	Включить/выключить блокирование запросов BYE. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_cancel строка	Варианты: disable enable	Включить/выключить блокирование запросов CANCEL. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_geo_red_options строка	Варианты: disable enable	Включить/выключить блокирование запросов OPTIONS, но запросы OPTIONS всё ещё уведомляют о дублировании. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_info строка	Варианты: disable enable	Включить/выключить блокирование запросов INFO. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_invite строка	Варианты: disable enable	Включить/выключить блокирование запросов INVITE. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_long_lines строка	Варианты: disable enable	Включить/выключить блокирование запросов с заголовками, превышающими максимальную длину строки. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_message строка	Варианты: disable enable	Включить/выключить блокирование запросов MESSAGE. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_notify строка	Варианты: disable enable	Включить/выключить блокирование запросов NOTIFY. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_options строка	Варианты: disable enable	Включить/выключить блокирование запросов OPTIONS и отсутствие OPTIONS в качестве уведомляющего сообщения для дублирования. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_prack строка	Варианты: disable enable	Включить/выключить блокирование запросов prack. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_publish строка	Варианты: disable enable	Включить/выключить блокирование запросов PUBLISH. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_refer строка	Варианты: disable enable	Включить/выключить блокирование запросов REFER. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_register строка	Варианты: disable enable	Включить/выключить блокирование запросов REGISTER. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_subscribe строка	Варианты: disable enable	Включить/выключить блокирование запросов SUBSCRIBE. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_unknown строка	Варианты: disable enable	Заблокировать нераспознанные SIP-запросы (включено по умолчанию). выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_block_update строка	Варианты: disable enable	Включить/выключить блокирование запросов UPDATE. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_bye_rate строка		Лимит скорости запросов BYE (в секунду, на политику).
sip_call_keepalive строка		Продолжать отслеживание вызовов без RTP в течение указанного количества минут.
sip_cancel_rate строка		Лимит скорости запросов CANCEL (в секунду, на политику).
sip_contact_fixup строка	Варианты: disable enable	Исправить контакт в любом случае, даже если IP\|порт контакта не совпадает с IP\|портом сессии. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_hnt_restrict_source_ip строка	Варианты: disable enable	Включить/выключить ограничение исходного IP-адреса RTP для соответствия исходному IP-адресу SIP при включенном HNT. выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_hosted_nat_traversal строка	Варианты: disable enable	NAT-проброс хоста (HNT). выбор \| disable \| Выключено. выбор \| enable \| Включено.
sip_info_rate строка		Лимит скорости запросов INFO (в секунду, на политику).
sip_invite_rate строка		Лимит скорости запросов INVITE (в секунду, на политику).
sip_ips_rtp строка	Варианты: disable enable	Включить/выключить разрешение IPS для RTP. выбор \| disable \| Выключено. выбор \| enable \| Включено.

sip_log_call_summary string	Choices: disable enable	Включить/выключить протоколирование сводки вызова SIP. choice \| disable \| Выключить режим. choice \| enable \| Включить режим.
sip_log_violations string	Choices: disable enable	Включить/выключить протоколирование нарушений SIP. choice \| disable \| Выключить режим. choice \| enable \| Включить режим.
sip_malformed_header_allow string	Choices: pass discard respond	Действие для некорректного заголовка Allow. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_call_id string	Choices: pass discard respond	Действие для некорректного заголовка Call-ID. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_contact string	Choices: pass discard respond	Действие для некорректного заголовка Contact. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_content_length string	Choices: pass discard respond	Действие для некорректного заголовка Content-Length. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_content_type string	Choices: pass discard respond	Действие для некорректного заголовка Content-Type. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_cseq string	Choices: pass discard respond	Действие для некорректного заголовка CSeq. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_expires string	Choices: pass discard respond	Действие для некорректного заголовка Expires. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_from string	Choices: pass discard respond	Действие для некорректного заголовка From. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_max_forwards string	Choices: pass discard respond	Действие для некорректного заголовка Max-Forwards. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_p_asserted_identity string	Choices: pass discard respond	Действие для некорректного заголовка P-Asserted-Identity. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_rack string	Choices: pass discard respond	Действие для некорректного заголовка RAck. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_record_route string	Choices: pass discard respond	Действие для некорректного заголовка Record-Route. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_route string	Choices: pass discard respond	Действие для некорректного заголовка Route. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_rseq string	Choices: pass discard respond	Действие для некорректного заголовка RSeq. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_a string	Choices: pass discard respond	Действие для некорректной строки SDP a. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_b string	Choices: pass discard respond	Действие для некорректной строки SDP b. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_c string	Choices: pass discard respond	Действие для некорректной строки SDP c. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_i string	Choices: pass discard respond	Действие для некорректной строки SDP i. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_k string	Choices: pass discard respond	Действие для некорректной строки SDP k. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_m string	Choices: pass discard respond	Действие для некорректной строки SDP m. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_o string	Choices: pass discard respond	Действие для некорректной строки SDP o. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_r string	Choices: pass discard respond	Действие для некорректной строки SDP r. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_s string	Choices: pass discard respond	Действие для некорректной строки SDP s. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_t string	Choices: pass discard respond	Действие для некорректной строки SDP t. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_v string	Choices: pass discard respond	Действие для некорректной строки SDP v. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_sdp_z string	Choices: pass discard respond	Действие для некорректной строки SDP z. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.
sip_malformed_header_to string	Choices: pass discard respond	Действие для некорректного заголовка To. choice \| pass \| Пропустить некорректные сообщения. choice \| discard \| Отбросить некорректные сообщения. choice \| respond \| Ответить с кодом ошибки.

sip_malformed_header_via строка	Варианты: пропустить отбросить ответить	Действие для некорректного заголовка VIA. выбор \| пропустить \| Пропустить сообщения с ошибками. выбор \| отбросить \| Отбросить сообщения с ошибками. выбор \| ответить \| Отправить ответ с кодом ошибки.
sip_malformed_request_line строка	Варианты: пропустить отбросить ответить	Действие для некорректной строки запроса. выбор \| пропустить \| Пропустить сообщения с ошибками. выбор \| отбросить \| Отбросить сообщения с ошибками. выбор \| ответить \| Отправить ответ с кодом ошибки.
sip_max_body_length строка		Максимальная длина тела сообщения SIP (0 — без ограничения).
sip_max_dialogs строка		Максимальное количество одновременных вызовов/диалогов (на политику).
sip_max_idle_dialogs строка		Максимальное количество установленных, но неактивных диалогов для сохранения (на политику).
sip_max_line_length строка		Максимальная длина строки заголовка SIP (от 78 до 4096).
sip_message_rate строка		Предел скорости запросов MESSAGE (в секунду, на политику).
sip_nat_trace строка	Варианты: отключить включить	Включить/отключить сохранение исходного IP-адреса в строке SDP. выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_no_sdp_fixup строка	Варианты: отключить включить	Включить/отключить отключение исправления SDP. выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_notify_rate строка		Предел скорости запросов NOTIFY (в секунду, на политику).
sip_open_contact_pinhole строка	Варианты: отключить включить	Включить/отключить открытие проходного порта для порта контакта не-REGISTER. выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_open_record_route_pinhole строка	Варианты: отключить включить	Включить/отключить открытие проходного порта для порта Record-Route. выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_open_register_pinhole строка	Варианты: отключить включить	Включить/отключить открытие проходного порта для порта контакта REGISTER. выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_open_via_pinhole строка	Варианты: отключить включить	Включить/отключить открытие проходного порта для порта Via. выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_options_rate строка		Предел скорости запросов OPTIONS (в секунду, на политику).
sip_prack_rate строка		Предел скорости запросов PRACK (в секунду, на политику).
sip_preserve_override строка	Варианты: отключить включить	Переопределить строку i для сохранения исходных IPS (по умолчанию \| добавить). выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_provisional_invite_expiry_time строка		Срок действия временного INVITE (от 10 до 3600 сек).
sip_publish_rate строка		Предел скорости запросов PUBLISH (в секунду, на политику).
sip_refer_rate строка		Предел скорости запросов REFER (в секунду, на политику).
sip_register_contact_trace строка	Варианты: отключить включить	Включить/отключить отслеживание исходного IP/порта в заголовке контакта запросов REGISTER. выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_register_rate строка		Предел скорости запросов REGISTER (в секунду, на политику).
sip_rfc2543_branch строка	Варианты: отключить включить	Включить/отключить поддержку ветвей, совместимых с RFC 2543. выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_rtp строка	Варианты: отключить включить	Включить/отключить создание проходных портов для трафика RTP для прохождения через брандмауэр. выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_ssl_algorithm строка	Варианты: высокий средний низкий	Относительная сила алгоритмов шифрования, принимаемых при согласовании. выбор \| высокий \| Высокое шифрование. Разрешены только AES и ChaCha. выбор \| средний \| Среднее шифрование. Разрешены AES, ChaCha, 3DES и RC4. выбор \| низкий \| Низкое шифрование. Разрешены AES, ChaCha, 3DES, RC4 и DES.
sip_ssl_auth_client строка		Требовать сертификат клиента и аутентифицировать его с узлом/группой узлов.
sip_ssl_auth_server строка		Аутентифицировать сертификат сервера с узлом/группой узлов.
sip_ssl_client_certificate строка		Имя сертификата, которое предлагается серверу при запросе.
sip_ssl_client_renegotiation строка	Варианты: разрешить запретить безопасный	Разрешить/заблокировать переподключение клиента сервером. выбор \| разрешить \| Разрешить переподключение SSL-клиента. выбор \| запретить \| Прервать любое SSL-соединение, пытающееся переподключиться. выбор \| безопасный \| Отклонить любое SSL-соединение, которое не предлагает указание безопасного переподключения RFC 5746.
sip_ssl_max_version строка	Варианты: ssl-3.0 tls-1.0 tls-1.1 tls-1.2	Наивысшая версия SSL/TLS для согласования. выбор \| ssl-3.0 \| SSL 3.0. выбор \| tls-1.0 \| TLS 1.0. выбор \| tls-1.1 \| TLS 1.1. выбор \| tls-1.2 \| TLS 1.2.
sip_ssl_min_version строка	Варианты: ssl-3.0 tls-1.0 tls-1.1 tls-1.2	Наименьшая версия SSL/TLS для согласования. выбор \| ssl-3.0 \| SSL 3.0. выбор \| tls-1.0 \| TLS 1.0. выбор \| tls-1.1 \| TLS 1.1. выбор \| tls-1.2 \| TLS 1.2.
sip_ssl_mode строка	Варианты: выкл полный	Режим SSL/TLS для шифрования и дешифрования трафика. выбор \| выкл \| Без SSL. выбор \| полный \| SSL от клиента к FortiGate и от FortiGate к серверу.
sip_ssl_pfs строка	Варианты: требовать запретить разрешить	SSL Perfect Forward Secrecy. выбор \| требовать \| PFS обязателен. выбор \| запретить \| PFS отклонен. выбор \| разрешить \| PFS разрешен.
sip_ssl_send_empty_frags строка	Варианты: отключить включить	Отправлять пустые фрагменты для предотвращения атаки на CBC IV (только SSL 3.0 и TLS 1.0). выбор \| отключить \| Не отправлять пустые фрагменты. выбор \| включить \| Отправить пустые фрагменты.
sip_ssl_server_certificate строка		Имя сертификата, возвращаемого клиенту в каждом SSL-соединении.
sip_status строка	Варианты: отключить включить	Включить/отключить SIP. выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_strict_register строка	Варианты: отключить включить	Включить/отключить, чтобы разрешить подключение только регистратору. выбор \| отключить \| Отключить. выбор \| включить \| Включить.
sip_subscribe_rate строка		Предел скорости запросов SUBSCRIBE (в секунду, на политику).
sip_unknown_header строка	Варианты: пропустить отбросить ответить	Действие для неизвестного заголовка SIP. выбор \| пропустить \| Пропустить сообщения с ошибками. выбор \| отбросить \| Отбросить сообщения с ошибками. выбор \| ответить \| Отправить ответ с кодом ошибки.
sip_update_rate строка		Предел скорости запросов UPDATE (в секунду, на политику).

Примечания

Примечание

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

Примеры

- name: DELETE Profile
  community.network.fmgr_secprof_voip:
    name: "Ansible_VOIP_Profile"
    mode: "delete"

- name: Create FMGR_VOIP_PROFILE
  community.network.fmgr_secprof_voip:
    mode: "set"
    adom: "root"
    name: "Ansible_VOIP_Profile"
    comment: "Created by Ansible"
    sccp: {block-mcast: "enable", log-call-summary: "enable", log-violations: "enable", status: "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_voip_module.html