community.network.fmgr_secprof_waf – FortiManager веб-приложение брандмауэр профиль безопасности
Примечание
Этот плагин входит в коллекцию community.network (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install community.network.
Для использования в плейбуке укажите: community.network.fmgr_secprof_waf.
Обзор
- Управление профилями безопасности веб-приложений брандмауэра для FGT через FMG
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| address_list строка | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЮТСЯ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. При отправке все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои варианты. Мы ожидаем, что вы знаете, что делаете с этими параметрами списка и используете Руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| address_list_blocked_address строка | Заблокированный адрес. | |
| address_list_blocked_log строка |
| Включить/выключить логирование заблокированных адресов. variant | disable | Выключение. variant | enable | Включение. |
| address_list_severity строка |
| Уровень важности. variant | low | Низкий уровень важности. variant | medium | Средний уровень важности. variant | high | Высокий уровень важности. |
| address_list_status строка |
| Статус. variant | disable | Выключение. variant | enable | Включение. |
| address_list_trusted_address строка | Доверенный адрес. | |
| adom строка | Значение по умолчанию: "root" | ADOM, к которому должна принадлежать конфигурация. |
| comment строка | Комментарий. | |
| constraint строка | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЮТСЯ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. При отправке все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои варианты. Мы ожидаем, что вы знаете, что делаете с этими параметрами списка и используете Руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ ВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| constraint_content_length_action строка |
| Действие. variant | allow | Разрешить. variant | block | Заблокировать. |
| constraint_content_length_length строка | Длина содержимого HTTP в байтах (0 до 2147483647). | |
| constraint_content_length_log строка |
| Включить/выключить логирование. variant | disable | Выключение. variant | enable | Включение. |
| constraint_content_length_severity строка |
| Уровень важности. variant | low | Низкий уровень важности. variant | medium | Средний уровень важности. variant | high | Высокий уровень важности. |
| constraint_content_length_status строка |
| Включить/выключить ограничение. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_address строка | Адрес хоста. | |
| constraint_exception_content_length строка |
| Длина содержимого HTTP в запросе. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_header_length строка |
| Длина заголовка HTTP в запросе. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_hostname строка |
| Включить/выключить проверку имени хоста. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_line_length строка |
| Длина строки HTTP в запросе. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_malformed строка |
| Включить/выключить проверку некорректного запроса HTTP. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_max_cookie строка |
| Максимальное количество cookie в запросе HTTP. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_max_header_line строка |
| Максимальное количество строк заголовка HTTP. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_max_range_segment строка |
| Максимальное количество сегментов диапазона в строке HTTP диапазона. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_max_url_param строка |
| Максимальное количество параметров в URL. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_method строка |
| Включить/выключить проверку метода HTTP. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_param_length строка |
| Максимальная длина параметра в URL, запросе HTTP POST или теле запроса HTTP. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_pattern строка | Шаблон URL. | |
| constraint_exception_regex строка |
| Включить/выключить соответствие шаблону на основе регулярных выражений. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_url_param_length строка |
| Максимальная длина параметра в URL. variant | disable | Выключение. variant | enable | Включение. |
| constraint_exception_version строка |
| Включить/выключить проверку версии HTTP. variant | disable | Выключение. variant | enable | Включение. |
| constraint_header_length_action строка |
| Действие. variant | allow | Разрешить. variant | block | Заблокировать. |
| constraint_header_length_length строка | Длина заголовка HTTP в байтах (0 до 2147483647). | |
| constraint_header_length_log строка |
| Включить/выключить логирование. variant | disable | Выключение. variant | enable | Включение. |
| constraint_header_length_severity строка |
| Уровень важности. variant | low | Низкий уровень важности. variant | medium | Средний уровень важности. variant | high | Высокий уровень важности. |
| constraint_header_length_status строка |
| Включить/выключить ограничение. variant | disable | Выключение. variant | enable | Включение. |
| constraint_hostname_action строка |
| Действие для ограничения имени хоста. variant | allow | Разрешить. variant | block | Заблокировать. |
| constraint_hostname_log строка |
| Включить/выключить логирование. variant | disable | Выключение. variant | enable | Включение. |
| constraint_hostname_severity строка |
| Уровень важности. variant | low | Низкий уровень важности. variant | medium | Средний уровень важности. variant | high | Высокий уровень важности. |
| constraint_hostname_status string |
| Включить/выключить ограничение. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_line_length_action string |
| Действие. choice | allow | Разрешить. choice | block | Заблокировать. |
| constraint_line_length_length string | Длина HTTP строки в байтах (от 0 до 2147483647). | |
| constraint_line_length_log string |
| Включить/выключить протоколирование. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_line_length_severity string |
| Уровень серьезности. choice | low | Низкий уровень серьезности. choice | medium | Средний уровень серьезности. choice | high | Высокий уровень серьезности. |
| constraint_line_length_status string |
| Включить/выключить ограничение. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_malformed_action string |
| Действие. choice | allow | Разрешить. choice | block | Заблокировать. |
| constraint_malformed_log string |
| Включить/выключить протоколирование. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_malformed_severity string |
| Уровень серьезности. choice | low | Низкий уровень серьезности. choice | medium | Средний уровень серьезности. choice | high | Высокий уровень серьезности. |
| constraint_malformed_status string |
| Включить/выключить ограничение. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_max_cookie_action string |
| Действие. choice | allow | Разрешить. choice | block | Заблокировать. |
| constraint_max_cookie_log string |
| Включить/выключить протоколирование. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_max_cookie_max_cookie string | Максимальное количество куки в HTTP запросе (от 0 до 2147483647). | |
| constraint_max_cookie_severity string |
| Уровень серьезности. choice | low | Низкий уровень серьезности. choice | medium | Средний уровень серьезности. choice | high | Высокий уровень серьезности. |
| constraint_max_cookie_status string |
| Включить/выключить ограничение. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_max_header_line_action string |
| Действие. choice | allow | Разрешить. choice | block | Заблокировать. |
| constraint_max_header_line_log string |
| Включить/выключить протоколирование. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_max_header_line_max_header_line string | Максимальное количество HTTP заголовков (от 0 до 2147483647). | |
| constraint_max_header_line_severity string |
| Уровень серьезности. choice | low | Низкий уровень серьезности. choice | medium | Средний уровень серьезности. choice | high | Высокий уровень серьезности. |
| constraint_max_header_line_status string |
| Включить/выключить ограничение. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_max_range_segment_action string |
| Действие. choice | allow | Разрешить. choice | block | Заблокировать. |
| constraint_max_range_segment_log string |
| Включить/выключить протоколирование. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_max_range_segment_max_range_segment string | Максимальное количество сегментов диапазона в строке HTTP диапазона (от 0 до 2147483647). | |
| constraint_max_range_segment_severity string |
| Уровень серьезности. choice | low | Низкий уровень серьезности. choice | medium | Средний уровень серьезности. choice | high | Высокий уровень серьезности. |
| constraint_max_range_segment_status string |
| Включить/выключить ограничение. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_max_url_param_action string |
| Действие. choice | allow | Разрешить. choice | block | Заблокировать. |
| constraint_max_url_param_log string |
| Включить/выключить протоколирование. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_max_url_param_max_url_param string | Максимальное количество параметров в URL (от 0 до 2147483647). | |
| constraint_max_url_param_severity string |
| Уровень серьезности. choice | low | Низкий уровень серьезности. choice | medium | Средний уровень серьезности. choice | high | Высокий уровень серьезности. |
| constraint_max_url_param_status string |
| Включить/выключить ограничение. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_method_action string |
| Действие. choice | allow | Разрешить. choice | block | Заблокировать. |
| constraint_method_log string |
| Включить/выключить протоколирование. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_method_severity string |
| Уровень серьезности. choice | low | Низкий уровень серьезности. choice | medium | Средний уровень серьезности. choice | high | Высокий уровень серьезности. |
| constraint_method_status string |
| Включить/выключить ограничение. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_param_length_action string |
| Действие. choice | allow | Разрешить. choice | block | Заблокировать. |
| constraint_param_length_length string | Максимальная длина параметра в URL, HTTP POST запросе или HTTP теле в байтах (от 0 до 2147483647). | |
| constraint_param_length_log string |
| Включить/выключить протоколирование. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_param_length_severity string |
| Уровень серьезности. choice | low | Низкий уровень серьезности. choice | medium | Средний уровень серьезности. choice | high | Высокий уровень серьезности. |
| constraint_param_length_status string |
| Включить/выключить ограничение. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| constraint_url_param_length_action string |
| Действие. choice | allow | Разрешить. choice | block | Заблокировать. |
| constraint_url_param_length_length string | Максимальная длина параметра URL в байтах (0 до 2147483647). | |
| constraint_url_param_length_log string |
| Включить/выключить ведение журнала. choice | disable | Выключить настройку. choice | enable | Включить настройку. |
| constraint_url_param_length_severity string |
| Уровень важности. choice | low | Низкий уровень важности. choice | medium | Средний уровень важности. choice | high | Высокий уровень важности. |
| constraint_url_param_length_status string |
| Включить/выключить ограничение. choice | disable | Выключить настройку. choice | enable | Включить настройку. |
| constraint_version_action string |
| Действие. choice | allow | Разрешить. choice | block | Блокировать. |
| constraint_version_log string |
| Включить/выключить ведение журнала. choice | disable | Выключить настройку. choice | enable | Включить настройку. |
| constraint_version_severity string |
| Уровень важности. choice | low | Низкий уровень важности. choice | medium | Средний уровень важности. choice | high | Высокий уровень важности. |
| constraint_version_status string |
| Включить/выключить ограничение. choice | disable | Выключить настройку. choice | enable | Включить настройку. |
| extended_log string |
| Включить/выключить расширенное ведение журнала. choice | disable | Выключить настройку. choice | enable | Включить настройку. |
| external string |
| Отключить/Включить внешнюю проверку HTTP. choice | disable | Отключить внешнюю проверку. choice | enable | Включить внешнюю проверку. |
| method string | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидает список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои опции. Мы ожидаем, что вы знаете, что делаете с этими параметрами списка, и используете Руководство по JSON API. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДВАРИАНТЫ ВМЕСТО ЭТОГО, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| method_default_allowed_methods string |
| Методы. Варианты на основе флагов. Укажите несколько в виде списка. flag | delete | Метод HTTP DELETE. flag | get | Метод HTTP GET. flag | head | Метод HTTP HEAD. flag | options | Метод HTTP OPTIONS. flag | post | Метод HTTP POST. flag | put | Метод HTTP PUT. flag | trace | Метод HTTP TRACE. flag | others | Другие методы HTTP. flag | connect | Метод HTTP CONNECT. |
| method_log string |
| Включить/выключить ведение журнала. choice | disable | Выключить настройку. choice | enable | Включить настройку. |
| method_method_policy_address string | Адрес хоста. | |
| method_method_policy_allowed_methods string |
| Разрешенные методы. Варианты на основе флагов. Укажите несколько в виде списка. flag | delete | Метод HTTP DELETE. flag | get | Метод HTTP GET. flag | head | Метод HTTP HEAD. flag | options | Метод HTTP OPTIONS. flag | post | Метод HTTP POST. flag | put | Метод HTTP PUT. flag | trace | Метод HTTP TRACE. flag | others | Другие методы HTTP. flag | connect | Метод HTTP CONNECT. |
| method_method_policy_pattern string | Шаблон URL. | |
| method_method_policy_regex string |
| Включить/выключить сопоставление шаблонов на основе регулярных выражений. choice | disable | Отключить настройку. choice | enable | Включить настройку. |
| method_severity string |
| Уровень важности. choice | low | Низкий уровень важности choice | medium | Средний уровень важности choice | high | Высокий уровень важности |
| method_status string |
| Статус. choice | disable | Выключить настройку. choice | enable | Включить настройку. |
| mode string |
| Устанавливает один из трех режимов для управления объектом. Разрешает использовать мягкое добавление вместо перезаписи существующих значений |
| name string | Имя профиля WAF. | |
| signature string | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидает список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если отправлено, все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои опции. Мы ожидаем, что вы знаете, что делаете с этими параметрами списка, и используете Руководство по JSON API. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДВАРИАНТЫ ВМЕСТО ЭТОГО, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| signature_credit_card_detection_threshold string | Минимальное количество кредитных карт для обнаружения нарушения. | |
| signature_custom_signature_action string |
| Действие. choice | allow | Разрешить. choice | block | Блокировать. choice | erase | Удалить номера кредитных карт. |
| signature_custom_signature_case_sensitivity string |
| Чувствительность к регистру в шаблоне. choice | disable | Нечувствительность к регистру в шаблоне. choice | enable | Чувствительность к регистру в шаблоне. |
| signature_custom_signature_direction string |
| Направление трафика. choice | request | Сопоставить HTTP-запрос. choice | response | Сопоставить HTTP-ответ. |
| signature_custom_signature_log string |
| Включить/выключить ведение журнала. choice | disable | Выключить настройку. choice | enable | Включить настройку. |
| signature_custom_signature_name string | Имя подписи. | |
| signature_custom_signature_pattern string | Шаблон соответствия. | |
| signature_custom_signature_severity string |
| Уровень важности. choice | low | Низкий уровень важности. choice | medium | Средний уровень важности. choice | high | Высокий уровень важности. |
| signature_custom_signature_status string |
| Статус. choice | disable | Выключить настройку. choice | enable | Включить настройку. |
| signature_custom_signature_target string |
| Цель соответствия HTTP. Варианты на основе флагов. Укажите несколько в виде списка. flag | arg | Аргументы HTTP. flag | arg-name | Имена аргументов HTTP. flag | req-body | Тело HTTP-запроса. flag | req-cookie | Куки HTTP-запроса. flag | req-cookie-name | Имена куки HTTP-запроса. flag | req-filename | Имя файла HTTP-запроса. flag | req-header | Заголовки HTTP-запроса. flag | req-header-name | Имена заголовков HTTP-запроса. flag | req-raw-uri | Необработанный URI HTTP-запроса. flag | req-uri | URI HTTP-запроса. flag | resp-body | Тело HTTP-ответа. flag | resp-hdr | Заголовки HTTP-ответа. flag | resp-status | Статус HTTP-ответа. |
| signature_disabled_signature string | Выключенные подписи |
| signature_disabled_sub_class string | Подклассы сигнатуры, отключенные от проверки. | |
| signature_main_class_action string |
| Действие. выбор | allow | Разрешить. выбор | block | Заблокировать. выбор | erase | Удалить номера кредитных карт. |
| signature_main_class_log string |
| Включить/отключить логирование. выбор | disable | Отключить настройку. выбор | enable | Включить настройку. |
| signature_main_class_severity string |
| Уровень серьезности. выбор | low | Низкий уровень. выбор | medium | Средний уровень. выбор | high | Высокий уровень. |
| signature_main_class_status string |
| Статус. выбор | disable | Отключить настройку. выбор | enable | Включить настройку. |
| url_access string | ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! ТРЕБУЕТСЯ ЗНАНИЕ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если предоставлено, все остальные префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЮЩИЙ со своими параметрами. Мы ожидаем, что вы понимаете, что делаете с этими параметрами списка, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДВАРИАНТЫ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С НЕСКОЛЬКИМИ ЗАДАЧАМИ | |
| url_access_access_pattern_negate string |
| Включить/отключить отрицание совпадения. выбор | disable | Отключить настройку. выбор | enable | Включить настройку. |
| url_access_access_pattern_pattern string | Шаблон URL. | |
| url_access_access_pattern_regex string |
| Включить/отключить проверку шаблона на основе регулярных выражений. выбор | disable | Отключить настройку. выбор | enable | Включить настройку. |
| url_access_access_pattern_srcaddr string | Адрес источника. | |
| url_access_action string |
| Действие. выбор | bypass | Разрешить HTTP-запрос, также пропустить дальнейшее сканирование WAF. выбор | permit | Разрешить HTTP-запрос и продолжить дальнейшее сканирование WAF. выбор | block | Заблокировать HTTP-запрос. |
| url_access_address string | Адрес хоста. | |
| url_access_log string |
| Включить/отключить логирование. выбор | disable | Отключить настройку. выбор | enable | Включить настройку. |
| url_access_severity string |
| Уровень серьезности. выбор | low | Низкий уровень. выбор | medium | Средний уровень. выбор | high | Высокий уровень. |
Примечания
Примечание
- Полная документация по адресу https://ftnt-ansible-docs.readthedocs.io/en/latest/.
Примеры
- name: DELETE Profile
community.network.fmgr_secprof_waf:
name: "Ansible_WAF_Profile"
comment: "Created by Ansible Module TEST"
mode: "delete"
- name: CREATE Profile
community.network.fmgr_secprof_waf:
name: "Ansible_WAF_Profile"
comment: "Created by Ansible Module TEST"
mode: "set"
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| 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_waf_module.html