Introduction¶
About¶
IntelMQ is a solution for IT security teams (CERTs & CSIRTs, SOCs abuse departments, etc.) for collecting and processing security feeds (such as log files) using a message queuing protocol. It’s a community driven initiative called IHAP (Incident Handling Automation Project) which was conceptually designed by European CERTs/CSIRTs during several InfoSec events. Its main goal is to give to incident responders an easy way to collect & process threat intelligence thus improving the incident handling processes of CERTs.
Incident Handling Automation Project
URL: <http://www.enisa.europa.eu/activities/cert/support/incident-handling-automation>
Mailing-list: <ihap@lists.trusted-introducer.org>
Several pieces of software are evolved around IntelMQ. For an overview, look at the IntelMQ Universe.
IntelMQ can be used for - automated incident handling - situational awareness - automated notifications - as data collector for other tools - etc.
IntelMQ’s design was influenced by AbuseHelper however it was re-written from scratch and aims at:
Reducing the complexity of system administration
Reducing the complexity of writing new bots for new data feeds
Reducing the probability of events lost in all process with persistence functionality (even system crash)
Use and improve the existing Data Harmonization Ontology
Use JSON format for all messages
Provide easy way to store data into Log Collectors like ElasticSearch, Splunk, databases (such as PostgreSQL)
Provide easy way to create your own black-lists
Provide easy communication with other systems via HTTP RESTful API
It follows the following basic meta-guidelines:
Don’t break simplicity - KISS
Keep it open source - forever
Strive for perfection while keeping a deadline
Reduce complexity/avoid feature bloat
Embrace unit testing
Code readability: test with inexperienced programmers
Communicate clearly
Usage¶
Various approaches of installing intelmq are described in Installation.
The Configuration and Management gives an overview how a intelmq installation is set up and how to configure and maintain the setup. There is also a list of available Data Feeds as well as a detailed description of the different Bots inventory intelmq brings with it.
If you know additional feeds and how to parse them, please contribute your code or your configuration (by issues or the mailing lists).
If you need help, read here about your options: Getting support.
IntelMQ Manager¶
Check out this graphical tool to easily manage an IntelMQ system.
Contribute¶
Subscribe to the IntelMQ Developers Mailinglist
Via GitHub issues
Via Pull requests (please have a look at the Developers Guide first)