ansible / ansible.builtin / v2.9.27 / module / utm_proxy_exception Create, update or destroy reverse_proxy exception entry in Sophos UTM | "added in version" 2.8 of ansible.builtin" Authors: Sebastian Schenzel (@RickS-C137) preview | supported by communityansible.builtin.utm_proxy_exception (v2.9.27) — module
pip
Install with pip install ansible==2.9.27
Create, update or destroy a reverse_proxy exception entry in SOPHOS UTM.
This module needs to have the REST Ability of the UTM to be activated.
- name: Create UTM proxy_exception utm_proxy_exception: utm_host: sophos.host.name utm_token: abcdefghijklmno1234 name: TestExceptionEntry backend: REF_OBJECT_STRING state: present
- name: Remove UTM proxy_exception utm_proxy_exception: utm_host: sophos.host.name utm_token: abcdefghijklmno1234 name: TestExceptionEntry state: absent
op: choices: - AND - OR default: AND description: - The operand to be used with the entries of the path parameter required: false type: str name: description: - The name of the object. Will be used to identify the entry required: true type: str path: default: [] description: - The paths the exception in the reverse proxy is defined for required: false type: list state: choices: - absent - present default: present description: - The desired state of the object. - C(present) will create or update an object - C(absent) will delete an object if it was present type: str skipav: default: false description: - Skip the Antivirus Scanning required: false type: bool source: default: [] description: - Define which categories of threats are skipped required: false type: list status: default: true description: - Status of the exception rule set required: false type: bool headers: description: - A dictionary of additional headers to be sent to POST and PUT requests. - Is needed for some modules required: false type: dict skiptft: default: false description: - Enable true file type control required: false type: bool skipurl: default: false description: - Enable static URL hardening required: false type: bool skipform: default: false description: - Enable form hardening required: false type: bool utm_host: description: - The REST Endpoint of the Sophos UTM. required: true type: str utm_port: default: 4444 description: - The port of the REST interface. type: int utm_token: description: - The token used to identify at the REST-API. See U(https://www.sophos.com/en-us/medialibrary/PDFs/documentation/UTMonAWS/Sophos-UTM-RESTful-API.pdf?la=en), Chapter 2.4.2. required: true type: str skipcookie: default: false description: - Skip the Cookie Signing check required: false type: bool utm_protocol: choices: - http - https default: https description: - The protocol of the REST Endpoint. type: str skipbadclients: default: false description: - Block clients with bad reputation required: false type: bool validate_certs: default: true description: - Whether the REST interface's ssl certificate should be verified or not. type: bool skiphtmlrewrite: default: false description: - Protection against SQL required: false type: bool skipform_missingtoken: default: false description: - Enable form hardening with missing tokens required: false type: bool skip_custom_threats_filters: default: [] description: - A list of threats to be skipped required: false type: list skip_threats_filter_categories: default: [] description: - Define which categories of threats are skipped required: false type: list
result: contains: _locked: description: Whether or not the object is currently locked type: bool _ref: description: The reference name of the object type: str _type: description: The type of the object type: str comment: description: The optional comment string name: description: The name of the object type: str op: description: The operand to be used with the entries of the path parameter type: str path: description: The paths the exception in the reverse proxy is defined for type: list skip_custom_threats_filters: description: A list of threats to be skipped type: list skip_threats_filter_categories: description: Define which categories of threats are skipped type: list skipav: description: Skip the Antivirus Scanning type: bool skipbadclients: description: Block clients with bad reputation type: bool skipcookie: description: Skip the Cookie Signing check type: bool skipform: description: Enable form hardening type: bool skipform_missingtoken: description: Enable form hardening with missing tokens type: bool skiphtmlrewrite: description: Protection against SQL type: bool skiptft: description: Enable true file type control type: bool skipurl: description: Enable static URL hardening type: bool source: description: Define which categories of threats are skipped type: list description: The utm object that was created returned: success type: complex