Python library using the MISP Rest API
Go to file
Raphaël Vinot 8809ccde7e
Merge pull request #143 from 3c7/feature/send_attributes
Adding multiple named attributes (without proposal) require a single POST request now
2017-11-22 16:17:04 +01:00
docs chg: Change version number to master in the doc 2017-11-22 10:30:06 +01:00
examples chg: Add a generic MISP object generator 2017-11-15 17:37:17 +01:00
pymisp Adding multiple named attributes require a single POST request now 2017-11-22 14:57:11 +01:00
tests Fix test suite 2017-10-25 11:17:25 -04:00
.gitchangelog.rc Fix: Changelog config + update 2017-10-04 10:25:10 +02:00
.gitignore new: Added ability to add attachments to events 2017-01-13 13:15:53 +00:00
.gitmodules Initial commit supporting MISP Objects 2017-07-21 20:34:56 +02:00
.travis.yml fix: Update dependencies for VT generator. 2017-10-25 15:00:00 -04:00
CHANGELOG.txt chg: Bump CHANGELOG 2017-11-09 13:47:17 -08:00
LICENSE add license 2014-12-09 14:54:45 +01:00
MANIFEST.in fix: properly bundle object templates 2017-10-24 09:07:33 -04:00
README.md - Remove CIRCL reference from README.md 2017-11-19 10:02:03 +01:00
setup.cfg Fix PyPi package. 2015-08-05 17:48:15 +02:00
setup.py fix: Update dependencies for VT generator. 2017-10-25 15:00:00 -04: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 latest version from repo

git clone https://github.com/MISP/PyMISP.git && cd PyMISP
pip3 install -I .

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

Debugging

You have two options there:

  1. Pass debug=True to PyMISP and it will enable logging.DEBUG to stderr on the whole module

  2. Use the python logging module directly:


import logging
logger = logging.getLogger('pymisp')

# Configure it as you whish, for example, enable DEBUG mode:
logger.setLevel(logging.DEBUG)

Or if you want to write the debug output to a file instead of stderr:

import pymisp
import logging

logger = logging.getLogger('pymisp')
logging.basicConfig(level=logging.DEBUG, filename="debug.log", filemode='w', format=pymisp.FORMAT)

Documentation

PyMISP API documentation is available.

Documentation can be generated with epydoc:

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

Everything is a Mutable Mapping

... or at least everything that can be imported/exported from/to a json blob

AbstractMISP is the master class, and inherit collections.MutableMapping which means the class can be represented as a python dictionary.

The abstraction assumes every property that should not be seen in the dictionary is prepended with a _, or its name is added to the private list __not_jsonable (accessible through update_not_jsonable and set_not_jsonable.

This master class has helpers that will make it easy to load, and export, to, and from, a json string.

MISPEvent, MISPAttribute, MISPObjectReference, MISPObjectAttribute, and MISPObject are subclasses of AbstractMISP, which mean that they can be handled as python dictionaries.

MISP Objects

Creating a new MISP object generator should be done using a pre-defined template and inherit AbstractMISPObjectGenerator.

Your new MISPObject generator need to generate attributes, and add them as class properties using add_attribute.

When the object is sent to MISP, all the class properties will be exported to the JSON export.