avg

malice-avg

Malice AVG AntiVirus

This repository contains a Dockerfile of avg.

Dependencies

• debian:jessie (125 MB)

Installation

1. Install Docker.
2. Download trusted build from public DockerHub: docker pull malice/avg

Usage

docker run --rm malice/avg EICAR

Or link your own malware folder:

$ docker run --rm -v /path/to/malware:/malware:ro malice/avg FILE

Usage: avg [OPTIONS] COMMAND [arg...]

Malice AVG AntiVirus Plugin

Version: v0.1.0, BuildTime: 20180903

Author:
  blacktop - <https://github.com/blacktop>

Options:
  --verbose, -V          verbose output
  --elasticsearch value  elasticsearch url for Malice to store results [$MALICE_ELASTICSEARCH_URL]
  --table, -t            output as Markdown table
  --callback, -c         POST results back to Malice webhook [$MALICE_ENDPOINT]
  --proxy, -x            proxy settings for Malice webhook endpoint [$MALICE_PROXY]
  --timeout value        malice plugin timeout (in seconds) (default: 120) [$MALICE_TIMEOUT]
  --help, -h             show help
  --version, -v          print the version

Commands:
  update  Update virus definitions
  web     Create a AVG scan web service
  help    Shows a list of commands or help for one command

Run 'avg COMMAND --help' for more information on a command.

Sample Output

JSON

{
  "avg": {
    "infected": true,
    "result": "Virus identified EICAR_Test",
    "engine": "13.0.3114",
    "database": "4477/13807",
    "updated": "20170121"
  }
}

Markdown

AVG

Documentation

• To write results to ElasticSearch
• To create a AVG scan micro-service
• To post results to a webhook
• To update the AV definitions

Issues

Find a bug? Want more features? Find something missing in the documentation? Let me know! Please don't hesitate to file an issue.

TODO

• add configurable re-try count (cuz this AV is weak sauce YO!)

CHANGELOG

See CHANGELOG.md

Contributing

See all contributors on GitHub.

Please update the CHANGELOG.md and submit a Pull Request on GitHub.

License

MIT Copyright (c) 2016 blacktop