community.general.utm_proxy_location_info – создание, обновление или удаление записи расположения обратного прокси-сервера в Sophos UTM
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general
Чтобы использовать его в книге задач, укажите: community.general.utm_proxy_location_info
Обзор
- Создайте, обновите или удалите запись расположения обратного прокси-сервера в Sophos UTM.
- Данному модулю требуется активировать возможность REST-API UTM.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| headers словарь | Словарь дополнительных заголовков, которые будут отправлены в запросах POST и PUT. Необходим для некоторых модулей | |
| name строка / обязательно | Имя объекта. Будет использовано для идентификации записи | |
| state строка |
| Желаемое состояние объекта. present создаст или обновит объектabsent удалит объект, если он был присутствующим |
| 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: Remove UTM proxy_location
community.general.utm_proxy_location_info:
utm_host: sophos.host.name
utm_token: abcdefghijklmno1234
name: TestLocationEntry
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращённое | Описание | |
|---|---|---|---|
| result сложный | успех | Объект UTM, который был создан | |
| _locked булево | успех | Заблокирован ли объект в настоящее время | |
| _ref строка | успех | Идентификатор объекта | |
| _type строка | успех | Тип объекта | |
| access_control строка | успех | Использовать состояние контроля доступа | |
| allowed_networks список / элементы=строка | успех | Список разрешённых сетей | |
| auth_profile строка | успех | Имя профиля аутентификации | |
| backend строка | успех | Имя бэкенда | |
| be_path строка | успех | Путь бэкенда | |
| comment строка | успех | Строка комментария | |
| denied_networks список / элементы=строка | успех | Список запрещённых сетей | |
| hot_standby булево | успех | Использовать горячую резервную копию | |
| name строка | успех | Имя объекта | |
| path строка | успех | Имя пути | |
| status булево | успех | Активен ли объект | |
| stickysession_id строка | успех | Идентификатор stickysession | |
| stickysession_status булево | успех | Использовать stickysession | |
| websocket_passthrough булево | успех | Использовать проброс websocket | |
Авторы
- 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.10/collections/community/general/utm_proxy_location_info_module.html