{ "info": { "author": "Felix Bauer", "author_email": "felix.bauer@atos.net", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Natural Language :: English", "Natural Language :: German", "Operating System :: POSIX", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3", "Topic :: Communications :: Email :: Filters" ], "description": "# PeekabooAV #\n\n**Peekaboo Extended Email Attachment Behavior Observation Owl**\n\n* PeekabooAV is an Anti Virus software\n* It gets email attachments from AMaViSd, checks them, uses Cuckoo for behavioral checks, and evaluates and rates fully automatic\n* PeekabooAV is written in Python, multi-threaded, scalable, has a very powerful ruleset, and is easy to extend and personalize\n* It is able to detect: malware by its behavior, exploitation of zero days, and targeted attacks\n\n* We develop and work in Germany\n* PeekabooAV is entirely open source\n* can run 100% local and does not require any external service\n* any file with any application can be scanned\n\nIf you run mail on-site, distrust security vendors and need a high level of security and secrecy\nPeekabooAV is for you.\n\nFor news and announcements follow us on twitter [@peekabooAV](https://twitter.com/peekabooav).\n\n\n\n## Getting Started ##\n\n### Prerequisites ####\n\n* [Python 2.7](https://www.python.org/downloads/)\n* [Cuckoo 2.0](https://github.com/cuckoosandbox/cuckoo)\n* [AMaViSd 2.11.0](https://www.ijs.si/software/amavisd/)\n* Installer is available: [PeekabooAV-Installer](https://github.com/scVENUS/PeekabooAV-Installer)\n\n\n### Installation ###\n\nClone the repository\n```shell\ngit clone https://github.com/scVENUS/PeekabooAV.git\n```\n\nStart a new virtualenv\n```shell\nvirtualenv --python2 /path/to/venv\n```\n\nInstall PeekabooAV\n```shell\n/path/to/venv/bin/pip install .\n```\n\nThis will pull in all required packages and install them into the virtualenv.\n\n### Configuration ###\nTake a look at ``peekaboo.conf.sample`` and ``ruleset.conf.sample``.\n\n\n## Running the tests ##\n\nRuns the unit tests\n```shell\n/path/to/venv/bin/python test.py\n```\n\n\n## Usage ##\n\nNow, you can run PeekabooAV with\n```shell\n/path/to/venv/bin/peekaboo -c /path/to/your/peekaboo.conf\n```\n\n**Note:** If you put your PeekabooAV configuration file at\n``/opt/peekaboo/etc/peekaboo.conf`` you can omit the ``-c`` option.\nAlso, for detailed command line options run\n```shell\npeekaboo --help\n```\n\n### Usage without Installation ###\n\nYou can also run PeekabooAV without installing it using the ``peekaboo_debug.py`` script.\n```shell\npython peekaboo_debug.py -c /path/to/your/peekaboo.conf\n```\n\n**Note:** ``peekaboo_debug.py`` provides the same command line options like ``peekaboo``.\nThey can be displayed by running\n\n```shell\npython peekaboo_debug.py --help\n```\n\n\n## Contributing ##\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.\n\n\n## Versioning ##\n\nWe use [SemVer](http://semver.org/) for versioning. For the versions available,\nsee the [tags on this repository](https://github.com/scVENUS/PeekabooAV/releases).\n\n## Past and present Developers and Contributors ##\n\n* **Felix Bauer** - *Security Analyst and Project Leader* - [@Jack28](https://github.com/Jack28)\n* **Michael Weiser** - *Developer* - [@michaelweiser](https://github.com/michaelweiser)\n* **Sebastian Deiss** - *Former Technical Lead* - [@SebastianDeiss](https://github.com/SebastianDeiss)\n\n## License ##\n\nThis project is licensed under the GPL 3 license - see the [LICENSE.txt](LICENSE.txt) file for details.", "description_content_type": "", "docs_url": null, "download_url": "https://github.com/scVENUS/PeekabooAV/archive/master.zip", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/scVENUS/PeekabooAV.git", "keywords": "Cuckoo,Amavis", "license": "GPLv3", "maintainer": "", "maintainer_email": "", "name": "PeekabooAV", "package_url": "https://pypi.org/project/PeekabooAV/", "platform": "", "project_url": "https://pypi.org/project/PeekabooAV/", "project_urls": { "Download": "https://github.com/scVENUS/PeekabooAV/archive/master.zip", "Homepage": "https://github.com/scVENUS/PeekabooAV.git" }, "release_url": "https://pypi.org/project/PeekabooAV/1.7/", "requires_dist": null, "requires_python": "", "summary": "Peekaboo Extended Email Attachment Behavior Observation Owl", "version": "1.7" }, "last_serial": 5180696, "releases": { "1.5": [ { "comment_text": "", "digests": { "md5": "f2b05da7a494225f3042c0151c764912", "sha256": "532f8de6b612493dcda6b4b945e241949130e4f0925b508dba9137d4b1cb07f6" }, "downloads": -1, "filename": "PeekabooAV-1.5.linux-x86_64.tar.gz", "has_sig": false, "md5_digest": "f2b05da7a494225f3042c0151c764912", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 58067, "upload_time": "2018-01-17T07:25:17", "url": "https://files.pythonhosted.org/packages/f6/b6/514d7cfd702af13b997f095ae44520c57ecedde834e6c8460ef74767ad52/PeekabooAV-1.5.linux-x86_64.tar.gz" } ], "1.5.1": [ { "comment_text": "", "digests": { "md5": "4d5afa534b4e9ad46cb934b9c5b32cf1", "sha256": "9356dbed12e45bc0b6a7af968cb021c6b03f27f2e0542261819beaee490c27f1" }, "downloads": -1, "filename": "PeekabooAV-1.5.1.tar.gz", "has_sig": false, "md5_digest": "4d5afa534b4e9ad46cb934b9c5b32cf1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 43766, "upload_time": "2018-01-17T09:32:52", "url": "https://files.pythonhosted.org/packages/10/b2/e4888c981e431260d96186e433493b789e75af8b79dbcb29b15cac564834/PeekabooAV-1.5.1.tar.gz" } ], "1.6": [ { "comment_text": "", "digests": { "md5": "c1e3ed744cdd5d8c00e4841cdbca33e6", "sha256": "de4d5fd04839fe52cf1d41f5a4067ddc811360583befa027c69988274d18e34c" }, "downloads": -1, "filename": "PeekabooAV-1.6.linux-x86_64.tar.gz", "has_sig": false, "md5_digest": "c1e3ed744cdd5d8c00e4841cdbca33e6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 57928, "upload_time": "2018-06-04T06:47:39", "url": "https://files.pythonhosted.org/packages/e7/cd/5e988bd72bf8e080dfd52d69cbf0ee89b6047b69320afa3158861b17354e/PeekabooAV-1.6.linux-x86_64.tar.gz" } ], "1.6.1": [ { "comment_text": "", "digests": { "md5": "ba2bd1113c1ec6860c66940a9d8fe2e2", "sha256": "1c2e91cf25e31e0a59331c46ff1982c90d506f17fb6cdb630d7ab61e478a584d" }, "downloads": -1, "filename": "PeekabooAV-1.6.1.tar.gz", "has_sig": false, "md5_digest": "ba2bd1113c1ec6860c66940a9d8fe2e2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 42139, "upload_time": "2018-06-19T11:41:50", "url": "https://files.pythonhosted.org/packages/31/1b/b7cc9afd87f16434c0415e985cd0a4fac87329cc2e6cb47f00f91174273a/PeekabooAV-1.6.1.tar.gz" } ], "1.6.2": [ { "comment_text": "", "digests": { "md5": "123589def06deb8482a1d605c8d64a69", "sha256": "f878551669ceea936e1ba081dcc76c0690b7e0886c3c2249091de3c8d0df0539" }, "downloads": -1, "filename": "PeekabooAV-1.6.2.tar.gz", "has_sig": false, "md5_digest": "123589def06deb8482a1d605c8d64a69", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 43559, "upload_time": "2018-11-30T12:19:01", "url": "https://files.pythonhosted.org/packages/3f/87/c32171fb4e08bb54f5f0b440d3e3e251122b93d4c40a75fa77f128e8007f/PeekabooAV-1.6.2.tar.gz" } ], "1.7": [ { "comment_text": "", "digests": { "md5": "ea0bdcf28bca4938eedff37ea82f3439", "sha256": "cd1238d44314068cd678f4cfbedb97d892570478f8a1eca5eb01346dbcb276d9" }, "downloads": -1, "filename": "PeekabooAV-1.7.tar.gz", "has_sig": false, "md5_digest": "ea0bdcf28bca4938eedff37ea82f3439", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 58333, "upload_time": "2019-04-24T07:16:16", "url": "https://files.pythonhosted.org/packages/77/c9/9635b76dca9cbaa1db34a6baee6a43ef781b8acb432f26ee769fe9c2e28f/PeekabooAV-1.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "ea0bdcf28bca4938eedff37ea82f3439", "sha256": "cd1238d44314068cd678f4cfbedb97d892570478f8a1eca5eb01346dbcb276d9" }, "downloads": -1, "filename": "PeekabooAV-1.7.tar.gz", "has_sig": false, "md5_digest": "ea0bdcf28bca4938eedff37ea82f3439", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 58333, "upload_time": "2019-04-24T07:16:16", "url": "https://files.pythonhosted.org/packages/77/c9/9635b76dca9cbaa1db34a6baee6a43ef781b8acb432f26ee769fe9c2e28f/PeekabooAV-1.7.tar.gz" } ] }