Python library using the MISP Rest API
Go to file
Raphaël Vinot 8dd0914a73 Allow to pass a MISPEvent to add_event and update_event 2017-03-15 14:10:51 +01:00
docs Fix documentation generation 2016-11-15 11:03:51 +01:00
examples Example using the search() function 2017-03-09 15:57:15 -05:00
pymisp Allow to pass a MISPEvent to add_event and update_event 2017-03-15 14:10:51 +01:00
tests Add an attributes to an event without sending the full existing event 2017-03-15 11:33:24 +01:00
.gitignore new: Added ability to add attachments to events 2017-01-13 13:15:53 +00:00
.travis.yml Run on more python versions 2017-01-24 09:50:34 +01:00
LICENSE
MANIFEST.in
README.md Install PyMISP with python3 by default. 2017-02-27 11:43:46 +01:00
setup.cfg
setup.py Fix package installation 2016-11-04 14:32:29 +01:00

README.md

README

Documentation Status Build Status Coverage Status

PyMISP - Python Library to access MISP

PyMISP is a Python library to access MISP platforms via their REST API.

PyMISP allows you to fetch events, add or update events/attributes, add or update samples or search for attributes.

Requirements

Install from pip

pip3 install pymisp

Install the lastest version from repo

git clone https://github.com/CIRCL/PyMISP.git && cd PyMISP
python3 setup.py install

Samples and how to use PyMISP

Various examples and samples scripts are in the examples/ directory.

In the examples directory, you will need to change the keys.py.sample to enter your MISP url and API key.

cd examples
cp keys.py.sample keys.py
vim keys.py

The API key of MISP is available in the Automation section of the MISP web interface.

To test if your URL and API keys are correct, you can test with examples/last.py to fetch the last 10 events published.

cd examples
python3 last.py -l 10

Documentation

PyMISP API documentation is available.

Documentation can be generated with epydoc:

epydoc --url https://github.com/CIRCL/PyMISP --graph all --name PyMISP --pdf pymisp -o doc