niilo/clamav-rest repository overview

Project is maintained on Github https://github.com/niilo/clamav-rest⁠

Travis CI build will build new release on weekly basis. Virus definitions will be updated on every docker build.

This is two in one docker image so it runs open source virus scanner ClamAV (https://www.clamav.net/⁠), automatic virus definition updates as background process and REST api interface to interact with ClamAV process.

Usage :

Run container

$ docker run -p 9000:9000 --rm -it niilo/clamav-rest

Test that service detects common test virus signature (https://raw.githubusercontent.com/niilo/clamav-rest/master/eicar.com.txt⁠):

$ curl -i -F "[email protected]" http://localhost:9000/scan
HTTP/1.1 100 Continue
HTTP/1.1 406 Not Acceptable
Content-Type: application/json; charset=utf-8
Date: Mon, 28 Aug 2017 20:22:34 GMT
Content-Length: 56
{ Status: "FOUND", Description: "Eicar-Test-Signature" }

RESPONSE CODES:

• 200 - clean file = no KNOWN infections
• 406 - INFECTED
• 400 - ClamAV returned general error for file
• 412 - unable to parse file
• 501 - unknown request