sophos.sophos_firewall.sfos_malware_protection module – Manage Malware Protection (Configure > System services > Malware protection)

Note

This module is part of the sophos.sophos_firewall collection (version 2.0.1).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install sophos.sophos_firewall. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: sophos.sophos_firewall.sfos_malware_protection.

New in sophos.sophos_firewall 1.0.0

Synopsis

  • Manage Malware Protection (Configure > System services > Malware protection) on Sophos Firewall

Requirements

The below requirements are needed on the host that executes this module.

  • sophosfirewall-python

  • Beginning in version 2.0.0, this module requires use of an httpapi connection plugin. See the HTTPAPI example for details.

Parameters

Parameter

Comments

antivirus_engine

string

Set the primary Antivirus engine

Choices:

  • "Sophos"

  • "Avira"

state

string / required

Use query to retrieve or updated to modify

Choices:

  • "updated"

  • "query"

Examples

- name: Update malware protection settings
  sophos.sophos_firewall.sfos_malware_protection:
    antivirus_engine: Sophos
    state: updated

- name: Query malware protection settings
  sophos.sophos_firewall.sfos_malware_protection:
    state: query

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

api_response

dictionary

Serialized object containing the API response.

Returned: always

Authors

  • Matt Mullen (@mamullen13316)