mirror of https://github.com/MISP/PyMISP
62 lines
1.7 KiB
Markdown
62 lines
1.7 KiB
Markdown
README
|
|
======
|
|
|
|
[](http://pymisp.readthedocs.io/en/master/?badge=master)
|
|
[](https://travis-ci.org/MISP/PyMISP)
|
|
[](https://coveralls.io/github/MISP/PyMISP?branch=master)
|
|
|
|
# PyMISP - Python Library to access MISP
|
|
|
|
PyMISP is a Python library to access [MISP](https://github.com/MISP/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
|
|
|
|
* [requests](http://docs.python-requests.org)
|
|
|
|
## Install from pip
|
|
|
|
```
|
|
pip3 install pymisp
|
|
```
|
|
|
|
## Install the latest 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/](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](https://media.readthedocs.org/pdf/pymisp/master/pymisp.pdf).
|
|
|
|
Documentation can be generated with epydoc:
|
|
|
|
```
|
|
epydoc --url https://github.com/CIRCL/PyMISP --graph all --name PyMISP --pdf pymisp -o doc
|
|
```
|