opensense-docs/source/manual/how-tos/proxyicapantivirusinternal.rst

==================================================
Setup Anti Virus Protection using OPNsense Plugins
==================================================
OPNsense can offer HTTP and HTTPS protection by utilizing its highly flexible
proxy and the industry standard ICAP. An external engine from one of the known
vendors is used to offer maximum protection against malware, such as ransomware,
trojans and viruses. This protection can be further enhanced by the built-in Intrusion
Prevention System and Category Based Web filtering.

This How To will use the Plugins C-ICAP and ClamAV.

.. Note::
    The Anti Virus Engine can protect you against malicious websites and infected
    file downloads, it does not protect the local clients. Therefore it is always
    a good idea to install a client based solution as well to protect against other
    forms of infection such as through emails or usb stick if they are not analyzed
    as well.

.. Note::
    Note that there is still another attack vector called social engineering.
    Most attacks would fail without the help of an internal human whose trust
    is exploited. An active scanner is only a part of the security concept.

Step 1 - Setup the Proxy
------------------------
Start with setting up the proxy with its basic configuration, see :doc:`cachingproxy`.

Step 2 - Setup Transparent Mode
-------------------------------
To setup the transparent mode, see: :doc:`proxytransparent`.

Step 3 - Install and Configure the ClamAV and the C-ICAP plugins
----------------------------------------------------------------

.. Note::
    The defaults from c-icap and ClamAV (vendor defaults) are used.
    Please keep in mind that changing may affect security or performance.
    If you don't know how a setting is affecting your network,
    you should keep it at the default.

- :doc:`clamav`
- :doc:`c-icap`


Step 4 - Configure ICAP
-----------------------
To configure ICAP go to :menuselection:`Services --> Proxy --> Administration` and select **ICAP Settings**
for the **Forward Proxy** tab.

Select enable ICAP and filling the Request and Response URLs.
For the C-ICAP plugin, the default URLs will be:

======================== =========================
 **Request Modify URL**   icap://[::1]:1344/avscan
 **Response Modify URL**  icap://[::1]:1344/avscan
======================== =========================

Now click on **Apply**

Step 5 - Test using EICAR
-------------------------
To test if the engine is operational and functional go to http://www.eicar.org/85-0-Download.html
on this page you will find several files you can test.

First test the HTTP protocol version. If that works, test the HTTPS version if you
have also configured the transparent SSL proxy mode.

.. Warning::
    **IMPORTANT NOTE** :
    YOU DOWNLOAD THESE FILES AT YOUR OWN RISK!


**DONE**