Модуль community.general.utm_proxy_exception — создание, обновление или удаление исключения reverse_proxy в Sophos UTM
Примечание
Этот модуль входит в коллекцию community.general (версия 12.6.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить коллекцию, используйте: ansible-galaxy collection install community.general.
Чтобы использовать её в плейбуке, укажите: community.general.utm_proxy_exception.
Краткое описание
- Создание, обновление или удаление исключения reverse_proxy в SOPHOS UTM.
- Для работы этого модуля необходимо активировать REST-интерфейс UTM.
Параметры
Параметр | Описание |
|---|---|
headers dictionary | Словарь дополнительных заголовков, отправляемых в запросах POST и PUT. Требуется для некоторых модулей. По умолчанию: |
name string / обязательный | Имя объекта, идентифицирующее запись. |
op string | Операнд, используемый для элементов параметра path. Варианты:
|
path list / elements=string | Пути, для которых задано исключение в reverse proxy. По умолчанию: |
skip_custom_threats_filters list / elements=string | Список угроз, которые следует пропускать. По умолчанию: |
skip_threats_filter_categories list / elements=string | Определяет категории угроз, которые следует пропускать. По умолчанию: |
skipav boolean | Пропускать антивирусное сканирование. Варианты:
|
skipbadclients boolean | Блокировать клиентов с плохой репутацией. Варианты:
|
skipcookie boolean | Пропускать проверку подписи файлов cookie. Варианты:
|
skipform boolean | Включить усиленную защиту форм. Варианты:
|
skipform_missingtoken boolean | Включить усиленную защиту форм при отсутствии токенов. Варианты:
|
skiphtmlrewrite boolean | Защита от SQL-инъекций. Варианты:
|
skiptft boolean | Включить проверку фактического типа файла. Варианты:
|
skipurl boolean | Включить усиленную защиту статических URL. Варианты:
|
source list / elements=string | Определяет категории угроз, которые следует пропускать. По умолчанию: |
state string | Требуемое состояние объекта.
Варианты:
|
status boolean | Состояние набора правил исключения. Варианты:
|
utm_host string / обязательный | Конечная точка REST-интерфейса Sophos UTM. |
utm_port integer | Порт REST-интерфейса. По умолчанию: |
utm_protocol string | Протокол конечной точки REST-интерфейса. Варианты:
|
utm_token string / обязательный | Токен для идентификации в REST API. См. https://www.sophos.com/en-us/medialibrary/PDFs/documentation/UTMonAWS/Sophos-UTM-RESTful-API.pdf?la=en, глава 2.4.2. |
validate_certs boolean | Следует ли проверять SSL-сертификат REST-интерфейса. Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: отсутствует | Может работать в режиме |
diff_mode | Поддержка: отсутствует | В режиме diff возвращает сведения об изменениях (или о том, что может потребоваться изменить в |
Примеры
- 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 complex | Созданный объект UTM. Возвращается: при успешном выполнении |
|
_locked boolean |
Заблокирован ли объект в данный момент. Возвращается: при успешном выполнении |
|
_ref string |
Ссылочное имя объекта. Возвращается: при успешном выполнении |
|
_type string |
Тип объекта. Возвращается: при успешном выполнении |
|
comment string |
Необязательный комментарий. Возвращается: при успешном выполнении |
|
name string |
Имя объекта. Возвращается: при успешном выполнении |
|
op string |
Операнд, используемый для элементов параметра path. Возвращается: при успешном выполнении |
|
path list / elements=string |
Пути, для которых задано исключение в reverse proxy. Возвращается: при успешном выполнении |
|
skip_custom_threats_filters list / elements=string |
Список угроз, которые следует пропускать. Возвращается: при успешном выполнении |
|
skip_threats_filter_categories list / elements=string |
Определяет категории угроз, которые следует пропускать. Возвращается: при успешном выполнении |
|
skipav boolean |
Пропускать антивирусное сканирование. Возвращается: при успешном выполнении |
|
skipbadclients boolean |
Блокировать клиентов с плохой репутацией. Возвращается: при успешном выполнении |
|
skipcookie boolean |
Пропускать проверку подписи файлов cookie. Возвращается: при успешном выполнении |
|
skipform boolean |
Включить усиленную защиту форм. Возвращается: при успешном выполнении |
|
skipform_missingtoken boolean |
Включить усиленную защиту форм при отсутствии токенов. Возвращается: при успешном выполнении |
|
skiphtmlrewrite boolean |
Защита от SQL-инъекций. Возвращается: при успешном выполнении |
|
skiptft boolean |
Включить проверку фактического типа файла. Возвращается: при успешном выполнении |
|
skipurl boolean |
Включить усиленную защиту статических URL. Возвращается: при успешном выполнении |
|
source list / elements=string |
Определяет категории угроз, которые следует пропускать. Возвращается: при успешном выполнении |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/utm_proxy_exception_module.html