Spec-Zone.ru › Ansible

Модуль 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.

Варианты:

  • "AND" ← (по умолчанию)
  • "OR"

path

list / elements=string

Пути, для которых задано исключение в reverse proxy.

По умолчанию: []

skip_custom_threats_filters

list / elements=string

Список угроз, которые следует пропускать.

По умолчанию: []

skip_threats_filter_categories

list / elements=string

Определяет категории угроз, которые следует пропускать.

По умолчанию: []

skipav

boolean

Пропускать антивирусное сканирование.

Варианты:

  • false ← (по умолчанию)
  • true

skipbadclients

boolean

Блокировать клиентов с плохой репутацией.

Варианты:

  • false ← (по умолчанию)
  • true

skipcookie

boolean

Пропускать проверку подписи файлов cookie.

Варианты:

  • false ← (по умолчанию)
  • true

skipform

boolean

Включить усиленную защиту форм.

Варианты:

  • false ← (по умолчанию)
  • true

skipform_missingtoken

boolean

Включить усиленную защиту форм при отсутствии токенов.

Варианты:

  • false ← (по умолчанию)
  • true

skiphtmlrewrite

boolean

Защита от SQL-инъекций.

Варианты:

  • false ← (по умолчанию)
  • true

skiptft

boolean

Включить проверку фактического типа файла.

Варианты:

  • false ← (по умолчанию)
  • true

skipurl

boolean

Включить усиленную защиту статических URL.

Варианты:

  • false ← (по умолчанию)
  • true

source

list / elements=string

Определяет категории угроз, которые следует пропускать.

По умолчанию: []

state

string

Требуемое состояние объекта.

present создаёт или обновляет объект.

absent удаляет объект, если он существует.

Варианты:

  • "absent"
  • "present" ← (по умолчанию)

status

boolean

Состояние набора правил исключения.

Варианты:

  • false
  • true ← (по умолчанию)

utm_host

string / обязательный

Конечная точка REST-интерфейса Sophos UTM.

utm_port

integer

Порт REST-интерфейса.

По умолчанию: 4444

utm_protocol

string

Протокол конечной точки REST-интерфейса.

Варианты:

  • "http"
  • "https" ← (по умолчанию)

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-интерфейса.

Варианты:

  • false
  • true ← (по умолчанию)

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: отсутствует

Может работать в режиме check_mode и возвращать прогноз изменения состояния, не изменяя целевой объект.

diff_mode

Поддержка: отсутствует

В режиме diff возвращает сведения об изменениях (или о том, что может потребоваться изменить в check_mode).

Примеры

- 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

Определяет категории угроз, которые следует пропускать.

Возвращается: при успешном выполнении

Авторы

  • Sebastian Schenzel (@RickS-C137)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Задать вопрос
  • Сообщить об ошибке
  • Предложить новую функцию
  • Связь

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API