utm_proxy_frontend_info – создание, обновление или удаление записи обратного прокси-фронта в Sophos UTM
Новая версия с 2.8.
Описание
- Создание, обновление или удаление записи обратного прокси-фронта в 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/ru-ru/medialibrary/PDFs/documentation/UTMonAWS/Sophos-UTM-RESTful-API.pdf?la=en, Глава 2.4.2. | |
| validate_certs булево |
| Требуется ли проверка сертификата ssl REST интерфейса. |
Примеры
- name: Get utm proxy_frontend
utm_proxy_frontend_info:
utm_host: sophos.host.name
utm_token: abcdefghijklmno1234
name: TestBackendEntry
host: REF_OBJECT_STRING
Возвращаемые значения
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| result сложный | success | Созданный объект utm | |
| _locked булево | Заблокирован ли объект в данный момент | ||
| _ref строка | Имя ссылки объекта | ||
| _type строка | Тип объекта | ||
| add_content_type_header булево | Добавлять ли заголовок типа содержимого | ||
| address строка | Имя ссылки адреса | ||
| allowed_networks список | Список ссылок на сети, связанных с объектом | ||
| certificate строка | Имя ссылки сертификата (ca/host_key_cert) | ||
| comment строка | Строка комментария | ||
| disable_compression булево | Состояние поддержки сжатия | ||
| domain список | Список хост-имен | ||
| exceptions список | Список связанных исключений прокси | ||
| htmlrewrite булево | Состояние переписывания html | ||
| htmlrewrite_cookies булево | Установка куки html rewrite | ||
| implicitredirect булево | Использование неявного перенаправления | ||
| lbmethod строка | Метод балансировки нагрузки | ||
| locations список | Списки ссылок на reverse_proxy/locations, связанные с объектом | ||
| name строка | Имя объекта | ||
| port целое число | Порт подключения фронта | ||
| preservehost булево | Сохранение заголовка хоста | ||
| profile строка | Связанный reverse_proxy/profile | ||
| status булево | Активен ли объект фронта | ||
| type строка | Тип соединения | ||
| xheaders булево | Состояние xheaders | ||
Статус
- Гарантируется обратная совместимость этого модуля. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.8/modules/utm_proxy_frontend_info_module.html