Модуль community.general.utm_proxy_frontend — создание, обновление или удаление записи интерфейсной части 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_frontend.
Краткое описание
- Создаёт, обновляет или удаляет запись интерфейсной части reverse_proxy в Sophos UTM.
- Для работы этого модуля необходимо активировать REST-возможность UTM.
Параметры
Параметр | Комментарии |
|---|---|
add_content_type_header boolean | Добавлять ли заголовок Content-Type. Варианты:
|
address string | Справочное имя объекта network/interface_address. По умолчанию: |
allowed_networks list / elements=string | Список справочных имён разрешённых сетей. По умолчанию: |
certificate string | Справочное имя объекта ca/host_key_cert. По умолчанию: |
comment string | Необязательный комментарий, добавляемый к объекту. По умолчанию: |
disable_compression boolean | Включать ли сжатие. Варианты:
|
domain list / elements=string | Список доменных имён для объекта интерфейсной части. |
exceptions list / elements=string | Список справочных имён исключений (reverse_proxy/exception). По умолчанию: |
headers dictionary | Словарь дополнительных заголовков, передаваемых в запросах POST и PUT. Необходим для некоторых модулей. По умолчанию: |
htmlrewrite boolean | Включать ли переписывание HTML. Варианты:
|
htmlrewrite_cookies boolean | Включать ли переписывание cookie в HTML. Варианты:
|
implicitredirect boolean | Включать ли неявную переадресацию. Варианты:
|
lbmethod string | Метод балансировщика нагрузки. Варианты:
|
locations list / elements=string | Список справочных имён расположений (reverse_proxy/location). По умолчанию: |
name string / обязательный | Имя объекта, идентифицирующее запись. |
port integer | HTTP-порт интерфейсной части. По умолчанию: |
preservehost boolean | Сохранять ли заголовок Host. Варианты:
|
profile string | Справочная строка объекта reverse_proxy/profile. По умолчанию: |
state string | Требуемое состояние объекта.
Варианты:
|
status boolean | Активировать ли запись интерфейсной части. Варианты:
|
type string | Используемый протокол. Варианты:
|
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-интерфейса. Варианты:
|
xheaders boolean | Передавать ли заголовок Host. Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: нет | Можно выполнять в режиме |
diff_mode | Поддержка: нет | В режиме diff возвращает сведения об изменениях (или о возможных изменениях в |
Примеры
- name: Create utm proxy_frontend
community.general.utm_proxy_frontend:
utm_host: sophos.host.name
utm_token: abcdefghijklmno1234
name: TestFrontendEntry
host: REF_OBJECT_STRING
state: present
- name: Remove utm proxy_frontend
community.general.utm_proxy_frontend:
utm_host: sophos.host.name
utm_token: abcdefghijklmno1234
name: TestFrontendEntry
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
result complex | Созданный объект utm. Возвращается: при успехе |
|
_locked boolean |
Заблокирован ли объект в данный момент. Возвращается: при успехе |
|
_ref string |
Имя ссылки на объект. Возвращается: при успехе |
|
_type string |
Тип объекта. Возвращается: при успехе |
|
add_content_type_header boolean |
Добавлять ли заголовок Content-Type. Возвращается: при успехе |
|
address string |
Имя ссылки на адрес. Возвращается: при успехе |
|
allowed_networks list / elements=string |
Список имен ссылок на связанные сети. Возвращается: при успехе |
|
certificate string |
Имя ссылки на сертификат (ca/host_key_cert). Возвращается: при успехе |
|
comment string |
Текст комментария. Возвращается: при успехе |
|
disable_compression boolean |
Состояние поддержки сжатия. Возвращается: при успехе |
|
domain list / elements=string |
Список имен хостов. Возвращается: при успехе |
|
exceptions list / elements=string |
Список связанных исключений прокси-сервера. Возвращается: при успехе |
|
htmlrewrite boolean |
Состояние перезаписи HTML. Возвращается: при успехе |
|
htmlrewrite_cookies boolean |
Установлена ли cookie для перезаписи HTML. Возвращается: при успехе |
|
implicitredirect boolean |
Использовать ли неявное перенаправление. Возвращается: при успехе |
|
lbmethod string |
Метод балансировки нагрузки, который следует использовать. Возвращается: при успехе |
|
locations list / elements=string |
Имена ссылок на связанные с объектом reverse_proxy/locations. Возвращается: при успехе |
|
name string |
Имя объекта. Возвращается: при успехе |
|
port integer |
Порт подключения внешнего интерфейса. Возвращается: при успехе |
|
preservehost boolean |
Сохранять заголовок Host. Возвращается: при успехе |
|
profile string |
Связанный reverse_proxy/profile. Возвращается: при успехе |
|
status boolean |
Активен ли объект внешнего интерфейса. Возвращается: при успехе |
|
type string |
Тип подключения. Возвращается: при успехе |
|
xheaders boolean |
Состояние xheaders. Возвращается: при успехе |
Ссылки на коллекцию
© 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_frontend_module.html