misp-book/README.md

---
description: Introduction to MISP - Open Source Threat Intelligence Sharing Platform
---

# Introduction

[![Build Status](https://travis-ci.org/MISP/misp-book.svg?branch=master)](https://travis-ci.org/MISP/misp-book)

![MISP logo](https://raw.githubusercontent.com/MISP/MISP/2.4/INSTALL/logos/misp-logo.png)

User guide for MISP - The Open Source Threat Intelligence Sharing Platform. This user guide is intended for ICT professionals such as security analysts, security incident handlers, or malware reverse engineers who share threat intelligence using MISP or integrate MISP into other security monitoring tools. The user guide includes day-to-day usage of the MISP's graphical user interface along with its automated interfaces \(API\), in order to integrate MISP within a security environment and operate one or more MISP instances.

## Acknowledgement

The MISP user guide is a collaborative effort between all the contributors to [MISP](https://www.github.com/MISP) including:

* Belgian Ministry of Defence \(CERT\)
* [CIRCL Computer Incident Response Center Luxembourg](https://www.circl.lu/)
* Iklody IT Solutions
* [NATO NCIRC](http://www.ncirc.nato.int/)
* Cthulhu Solutions
* [CERT-EU](https://cert.europa.eu)

and many other contributors especially the ones during the [MISP hackathons](https://github.com/MISP/MISP/wiki/Hackathon "MISP Hackathon Wiki").

## Contributing

We welcome contributions to the MISP book. If you want to contribute, see our [contributing guide](/CONTRIBUTING.md) 

<div class="pagebreak"></div>

## Format

MISP book is available in [HTML](https://www.circl.lu/doc/misp/), [PDF](https://www.circl.lu/doc/misp/book.pdf), [ePub](https://www.circl.lu/doc/misp/book.epub) and [Kindle mobi format](https://www.circl.lu/doc/misp/book.mobi).

## License

The MISP user guide is dual-licensed under [GNU Affero General Public License version 3](http://www.gnu.org/licenses/agpl-3.0.html) and [CC-BY-SA 4.0 international](https://creativecommons.org/licenses/by-sa/4.0/).

* Copyright \(C\) 2012 Christophe Vandeplas
* Copyright \(C\) 2012 Belgian Defence
* Copyright \(C\) 2012 NATO / NCIRC
* Copyright \(C\) 2013-2021 Andras Iklody
* Copyright \(C\) 2015-2021 Alexandre Dulaunoy
* Copyright \(C\) 2014-2021 CIRCL - Computer Incident Response Center Luxembourg
* Copyright \(C\) 2018 Camille Schneider
* Copyright \(C\) 2018-2021 Steve Clement
Updates README.md Auto commit by GitBook Editor 2018-02-20 17:08:43 +01:00			`---`
chg: [readme] MISP is a threat intelligence sharing platform 2021-02-21 09:27:50 +01:00			`description: Introduction to MISP - Open Source Threat Intelligence Sharing Platform`
Updates README.md Auto commit by GitBook Editor 2018-02-20 17:08:43 +01:00			`---`

Initial version of misp-book (using gitbook) 2015-10-06 09:49:55 +02:00			`# Introduction`

Update readme 2016-04-11 16:21:03 +02:00			`[![Build Status](https://travis-ci.org/MISP/misp-book.svg?branch=master)](https://travis-ci.org/MISP/misp-book)`

Fix url to MISP logo 2016-04-11 18:30:05 +02:00			`![MISP logo](https://raw.githubusercontent.com/MISP/MISP/2.4/INSTALL/logos/misp-logo.png)`
MISP Logo added 2015-12-03 17:51:45 +01:00
chg: [readme] MISP is a threat intelligence sharing platform 2021-02-21 09:27:50 +01:00			User guide for MISP - The Open Source Threat Intelligence Sharing Platform. This user guide is intended for ICT professionals such as security analysts, security incident handlers, or malware reverse engineers who share threat intelligence using MISP or integrate MISP into other security monitoring tools. The user guide includes day-to-day usage of the MISP's graphical user interface along with its automated interfaces \(API\), in order to integrate MISP within a security environment and operate one or more MISP instances.
Introduction updated 2015-10-06 13:41:15 +02:00
			`## Acknowledgement`

			`The MISP user guide is a collaborative effort between all the contributors to [MISP](https://www.github.com/MISP) including:`

Updates README.md Auto commit by GitBook Editor 2018-02-20 17:08:43 +01:00			`* Belgian Ministry of Defence \(CERT\)`
			`* [CIRCL Computer Incident Response Center Luxembourg](https://www.circl.lu/)`
			`* Iklody IT Solutions`
			`* [NATO NCIRC](http://www.ncirc.nato.int/)`
			`* Cthulhu Solutions`
			`* [CERT-EU](https://cert.europa.eu)`
Introduction updated 2015-10-06 13:41:15 +02:00
Updates README.md Auto commit by GitBook Editor 2018-02-20 17:14:06 +01:00			`and many other contributors especially the ones during the [MISP hackathons](https://github.com/MISP/MISP/wiki/Hackathon "MISP Hackathon Wiki").`
README updated 2017-02-04 20:41:40 +01:00
How to contribute added 2016-05-19 14:46:40 +02:00			`## Contributing`

chg: [doc] Add link to contributing.md, update... copyright year 2021-04-12 09:31:03 +02:00			`We welcome contributions to the MISP book. If you want to contribute, see our [contributing guide](/CONTRIBUTING.md)`
How to contribute added 2016-05-19 14:46:40 +02:00
- Added possibility to make page-breaks, this greatly enhances readability and structure of a book… - Added custom css place holder for HTML output too. - Added 2 page breaks: quickstart - Create Event & Intro - License 2018-05-10 05:15:28 +02:00			`<div class="pagebreak"></div>`

chg: [main] references to all format added 2018-12-14 09:34:17 +01:00			`## Format`

			`MISP book is available in [HTML](https://www.circl.lu/doc/misp/), [PDF](https://www.circl.lu/doc/misp/book.pdf), [ePub](https://www.circl.lu/doc/misp/book.epub) and [Kindle mobi format](https://www.circl.lu/doc/misp/book.mobi).`

Dual-licensing added - CC-BY-SA and Affero GPL 2015-11-03 11:08:38 +01:00			`## License`

Added a CC-BY-SA 4.0 int link - Fix #1 2015-11-03 17:26:49 +01:00			`The MISP user guide is dual-licensed under [GNU Affero General Public License version 3](http://www.gnu.org/licenses/agpl-3.0.html) and [CC-BY-SA 4.0 international](https://creativecommons.org/licenses/by-sa/4.0/).`
Dual-licensing added - CC-BY-SA and Affero GPL 2015-11-03 11:08:38 +01:00
Updates README.md Auto commit by GitBook Editor 2018-02-20 17:08:43 +01:00			`* Copyright \(C\) 2012 Christophe Vandeplas`
			`* Copyright \(C\) 2012 Belgian Defence`
			`* Copyright \(C\) 2012 NATO / NCIRC`
chg: [doc] Add link to contributing.md, update... copyright year 2021-04-12 09:31:03 +02:00			`* Copyright \(C\) 2013-2021 Andras Iklody`
			`* Copyright \(C\) 2015-2021 Alexandre Dulaunoy`
			`* Copyright \(C\) 2014-2021 CIRCL - Computer Incident Response Center Luxembourg`
fix: Copyright(s) updated + title 2018-04-08 16:19:52 +02:00			`* Copyright \(C\) 2018 Camille Schneider`
chg: [doc] Add link to contributing.md, update... copyright year 2021-04-12 09:31:03 +02:00			`* Copyright \(C\) 2018-2021 Steve Clement`
Dual-licensing added - CC-BY-SA and Affero GPL 2015-11-03 11:08:38 +01:00