Metadata-Version: 1.1
Name: PeekabooAV
Version: 1.7
Summary: Peekaboo Extended Email Attachment Behavior Observation Owl
Home-page: https://github.com/scVENUS/PeekabooAV.git
Author: Felix Bauer
Author-email: felix.bauer@atos.net
License: GPLv3
Download-URL: https://github.com/scVENUS/PeekabooAV/archive/master.zip
Description: # PeekabooAV #
        
        **Peekaboo Extended Email Attachment Behavior Observation Owl**
        
        * PeekabooAV is an Anti Virus software
        * It gets email attachments from AMaViSd, checks them, uses Cuckoo for behavioral checks, and evaluates and rates fully automatic
        * PeekabooAV is written in Python, multi-threaded, scalable, has a very powerful ruleset, and is easy to extend and personalize
        * It is able to detect: malware by its behavior, exploitation of zero days, and targeted attacks
        
        * We develop and work in Germany
        * PeekabooAV is entirely open source
        * can run 100% local and does not require any external service
        * any file with any application can be scanned
        
        If you run mail on-site, distrust security vendors and need a high level of security and secrecy
        PeekabooAV is for you.
        
        For news and announcements follow us on twitter [@peekabooAV](https://twitter.com/peekabooav).
        
        
        
        ## Getting Started ##
        
        ### Prerequisites ####
        
        * [Python 2.7](https://www.python.org/downloads/)
        * [Cuckoo 2.0](https://github.com/cuckoosandbox/cuckoo)
        * [AMaViSd 2.11.0](https://www.ijs.si/software/amavisd/)
        * Installer is available: [PeekabooAV-Installer](https://github.com/scVENUS/PeekabooAV-Installer)
        
        
        ### Installation ###
        
        Clone the repository
        ```shell
        git clone https://github.com/scVENUS/PeekabooAV.git
        ```
        
        Start a new virtualenv
        ```shell
        virtualenv --python2 /path/to/venv
        ```
        
        Install PeekabooAV
        ```shell
        /path/to/venv/bin/pip install .
        ```
        
        This will pull in all required packages and install them into the virtualenv.
        
        ### Configuration ###
        Take a look at ``peekaboo.conf.sample`` and ``ruleset.conf.sample``.
        
        
        ## Running the tests ##
        
        Runs the unit tests
        ```shell
        /path/to/venv/bin/python test.py
        ```
        
        
        ## Usage ##
        
        Now, you can run PeekabooAV with
        ```shell
        /path/to/venv/bin/peekaboo -c /path/to/your/peekaboo.conf
        ```
        
        **Note:** If you put your PeekabooAV configuration file at
        ``/opt/peekaboo/etc/peekaboo.conf`` you can omit the ``-c`` option.
        Also, for detailed command line options run
        ```shell
        peekaboo --help
        ```
        
        ### Usage without Installation ###
        
        You can also run PeekabooAV without installing it using the ``peekaboo_debug.py`` script.
        ```shell
        python peekaboo_debug.py -c /path/to/your/peekaboo.conf
        ```
        
        **Note:** ``peekaboo_debug.py`` provides the same command line options like ``peekaboo``.
        They can be displayed by running
        
        ```shell
        python peekaboo_debug.py --help
        ```
        
        
        ## Contributing ##
        Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
        
        
        ## Versioning ##
        
        We use [SemVer](http://semver.org/) for versioning. For the versions available,
        see the [tags on this repository](https://github.com/scVENUS/PeekabooAV/releases).
        
        ## Past and present Developers and Contributors ##
        
        * **Felix Bauer** - *Security Analyst and Project Leader* - [@Jack28](https://github.com/Jack28)
        * **Michael Weiser** - *Developer* - [@michaelweiser](https://github.com/michaelweiser)
        * **Sebastian Deiss** - *Former Technical Lead* - [@SebastianDeiss](https://github.com/SebastianDeiss)
        
        ## License ##
        
        This project is licensed under the GPL 3 license - see the [LICENSE.txt](LICENSE.txt) file for details.
        
Keywords: Cuckoo,Amavis
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Natural Language :: German
Classifier: Topic :: Communications :: Email :: Filters
