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.
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 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 Setup Caching Proxy.
Step 3 - Install and Configure the ClamAV and the C-ICAP plugins¶
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.
Step 4 - Configure ICAP¶
To configure ICAP go toand 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
Response Modify URL
Now click on Apply
Step 5 - Test using EICAR¶
To test if the engine is operational and functional go to http://pkg.opnsense.org/test/eicar.com.txt on this page you will find a file with the eiacar test string.
First test the HTTP protocol version. If that works, test the HTTPS version if you have also configured the transparent SSL proxy mode.
IMPORTANT NOTE : YOU DOWNLOAD THESE FILES AT YOUR OWN RISK!