community.general.utm_proxy_exception – Создание, обновление или удаление исключения обратного прокси-сервера в Sophos UTM
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в книге задач, укажите: community.general.utm_proxy_exception.
Описание
- Создание, обновление или удаление записи исключения обратного прокси-сервера в SOPHOS UTM.
- Для работы с этим модулем необходимо включить REST-функциональность UTM.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| headers словарь | Словарь дополнительных заголовков для отправки в POST и PUT запросах. Необходим для некоторых модулей | |
| name строка / обязательно | Имя объекта. Будет использовано для идентификации записи | |
| op строка |
| Оператор, используемый с элементами параметра path |
| path список / элементы=строка | Значение по умолчанию: [] | Пути, для которых определяется исключение обратного прокси |
| skip_custom_threats_filters список / элементы=строка | Значение по умолчанию: [] | Список угроз, которые нужно пропустить |
| skip_threats_filter_categories список / элементы=строка | Значение по умолчанию: [] | Определение категорий угроз, которые нужно пропустить |
| skipav логическое значение |
| Пропустить сканирование антивирусом |
| skipbadclients логическое значение |
| Заблокировать клиентов с плохой репутацией |
| skipcookie логическое значение |
| Пропустить проверку подписи cookie |
| skipform логическое значение |
| Включить защиту форм |
| skipform_missingtoken логическое значение |
| Включить защиту форм с недостающими маркерами |
| skiphtmlrewrite логическое значение |
| Защита от SQL-инъекций |
| skiptft логическое значение |
| Включить строгий контроль типов файлов |
| skipurl логическое значение |
| Включить статическую защиту URL |
| source список / элементы=строка | Значение по умолчанию: [] | Определение категорий угроз, которые нужно пропустить |
| state строка |
| Желаемое состояние объекта. present создаст или обновит объектabsent удалит объект, если он был присутствовал |
| status логическое значение |
| Статус правила исключения |
| utm_host строка / обязательно | REST-точек доступа Sophos UTM. | |
| utm_port целое число | Значение по умолчанию: 4444 | Порт REST-интерфейса. |
| utm_protocol строка |
| Протокол REST-точек доступа. |
| utm_token строка / обязательно | Токен для идентификации в REST-API. См. https://www.sophos.com/en-us/medialibrary/PDFs/documentation/UTMonAWS/Sophos-UTM-RESTful-API.pdf?la=en, Глава 2.4.2. | |
| validate_certs логическое значение |
| Нужно ли проверять сертификат SSL REST-интерфейса. |
Примеры
- name: Create UTM proxy_exception
community.general.utm_proxy_exception:
utm_host: sophos.host.name
utm_token: abcdefghijklmno1234
name: TestExceptionEntry
backend: REF_OBJECT_STRING
state: present
- name: Remove UTM proxy_exception
community.general.utm_proxy_exception:
utm_host: sophos.host.name
utm_token: abcdefghijklmno1234
name: TestExceptionEntry
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| result сложный | успех | Объект utm, который был создан | |
| _locked логическое значение | успех | Заблокирован ли объект в данный момент | |
| _ref строка | успех | Идентификатор объекта | |
| _type строка | успех | Тип объекта | |
| comment строка | успех | Необязательная строка комментария | |
| name строка | успех | Имя объекта | |
| op строка | успех | Оператор, используемый с элементами параметра path | |
| path список / элементы=строка | успех | Пути, для которых определяется исключение обратного прокси | |
| skip_custom_threats_filters список / элементы=строка | успех | Список угроз, которые нужно пропустить | |
| skip_threats_filter_categories список / элементы=строка | успех | Определение категорий угроз, которые нужно пропустить | |
| skipav логическое значение | успех | Пропустить сканирование антивирусом | |
| skipbadclients логическое значение | успех | Заблокировать клиентов с плохой репутацией | |
| skipcookie логическое значение | успех | Пропустить проверку подписи cookie | |
| skipform логическое значение | успех | Включить защиту форм | |
| skipform_missingtoken логическое значение | успех | Включить защиту форм с недостающими маркерами | |
| skiphtmlrewrite логическое значение | успех | Защита от SQL-инъекций | |
| skiptft логическое значение | успех | Включить строгий контроль типов файлов | |
| skipurl логическое значение | успех | Включить статическую защиту URL | |
| source список / элементы=строка | успех | Определение категорий угроз, которые нужно пропустить | |
Авторы
- Sebastian Schenzel (@RickS-C137)
© 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/general/utm_proxy_exception_module.html
