utm_proxy_location – создание, обновление или удаление записи расположения обратного прокси-сервера в Sophos UTM

Новая в версии 2.8.

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

Описание

Создание, обновление или удаление записи расположения обратного прокси-сервера в SOPHOS UTM.
Для работы с этим модулем необходимо активировать REST-возможности UTM.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
access_control строка	Варианты: 0 ← 1	включить или выключить контроль доступа для расположения
allowed_networks список	Значение по умолчанию: "REF_NetworkAny"	Список разрешённых сетей
auth_profile -		Имя профиля авторизации
backend -	Значение по умолчанию: []	Список бэкендов, подключённых к этому расположению
be_path -		Путь к бэкенду
comment -		Необязательная строка комментария
denied_networks -	Значение по умолчанию: []	Список запрещённых сетевых ссылок
headers словарь		Словарь дополнительных заголовков, которые отправляются в запросах POST и PUT. Необходим для некоторых модулей
hot_standby булево	Варианты: нет ← да	Активировать режим горячего резервирования
name - / обязательно		Имя объекта. Используется для идентификации записи
path -	Значение по умолчанию: "/"	Путь расположения
state строка	Варианты: отсутствует есть ←	Желаемое состояние объекта. `present` создаст или обновит объект `absent` удалит объект, если он был
status булево	Варианты: нет да ←	Активно ли расположение
stickysession_id -	Значение по умолчанию: "ROUTEID"	Идентификатор stickysession
stickysession_status булево	Варианты: нет ← да	Включить stickysession
utm_host строка / обязательно		REST-точка входа Sophos UTM.
utm_port целое число	Значение по умолчанию: 4444	Порт REST-интерфейса.
utm_protocol строка	Варианты: http https ←	Протокол 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-интерфейса.
websocket_passthrough булево	Варианты: нет ← да	Включить прохождение через websocket

Примеры

- name: Create UTM proxy_location
  utm_proxy_backend:
    utm_host: sophos.host.name
    utm_token: abcdefghijklmno1234
    name: TestLocationEntry
    backend: REF_OBJECT_STRING
    state: present

- name: Remove UTM proxy_location
  utm_proxy_backend:
    utm_host: sophos.host.name
    utm_token: abcdefghijklmno1234
    name: TestLocationEntry
    state: absent

Возвращаемые значения

Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:

Ключ		Возвращаемое значение	Описание
result complex		success	Объект utm, который был создан
	_locked boolean		Заблокирован ли объект в данный момент
	_ref string		Имя ссылки объекта
	_type string		Тип объекта
	access_control string		Использовать состояние управления доступом
	allowed_networks list		Список разрешенных имен ссылок на сети
	auth_profile string		Имя ссылки на профиль авторизации
	backend string		Имя ссылки на бэкенд
	be_path string		Путь бэкенда
	comment string		Строка комментария
	denied_networks list		Список имен запрещенных сетей
	hot_standby boolean		Использовать горячее резервирование
	name string		Имя объекта
	path string		Имя пути
	status boolean		Активен ли объект
	stickysession_id string		Идентификатор stickysession
	stickysession_status boolean		Использовать stickysession или нет
	websocket_passthrough boolean		Использовать проброс веб-сокетов или нет

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Johannes Brunswicker (@MatrixCrawler)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/utm_proxy_location_module.html