Skip to main content

IntelMQ is a solution for IT security teams for collecting and processing security feeds using a message queuing protocol.

Project description

IntelMQ

Build Status codecov.io

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.

Several pieces of software are evolved around IntelMQ. For an overview, look at the Ecosystem document.

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 unexperienced programmers

  • Communicate clearly

Table of Contents

  1. How to Install

  2. Developers Guide

  3. User Guide

  4. IntelMQ Manager

  5. Incident Handling Automation Project

  6. Data Harmonization

  7. How to Participate

  8. Licence

  9. Funded by

How to Install

See INSTALL.

Developers Guide

See Developers Guide.

User Guide

See User Guide. Which Feeds are supported? Have a look at the Feeds documentation and the Bots documentation. If you know additional feeds and how to parse them, please contribute your code or your configuration (by issues or the mailing lists).

For support questions please use the intelmq-users mailing list: https://lists.cert.at/cgi-bin/mailman/listinfo/intelmq-users

IntelMQ Manager

Check out this graphical tool and easily manage an IntelMQ system.

Incident Handling Automation Project

Data Harmonization

IntelMQ use the Data Harmonization. Please read this document for more details.

How to participate

  • Subscribe to the Intelmq-dev Mailing list: https://lists.cert.at/cgi-bin/mailman/listinfo/intelmq-dev (for developers)

  • Watch out for our regular developers conf call

  • IRC: server: irc.freenode.net, channel: #intelmq

  • Via github issues

  • Via Pull requests (please do read help.github.com first)

Licence

This software is licensed under GNU Affero General Public License version 3

Funded by

This project was partially funded by the CEF framework

Co-financed by the Connecting Europe Facility of the European Union

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

intelmq-2.1.0.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

intelmq-2.1.0-py2.py3-none-any.whl (1.0 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file intelmq-2.1.0.tar.gz.

File metadata

  • Download URL: intelmq-2.1.0.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.20.1 setuptools/40.5.0 requests-toolbelt/0.8.0 tqdm/4.31.1 CPython/3.6.5

File hashes

Hashes for intelmq-2.1.0.tar.gz
Algorithm Hash digest
SHA256 412e49c5021d1fbc9fb8bf9cf32ce3629b1e49b2873f7fe8957a90178a5aec36
MD5 0470075326403693c35b7bc57d45512a
BLAKE2b-256 95b9fe95924c4eee2d1c5306863c6c2414ba0afcc40f1591da6fa52797b5f06d

See more details on using hashes here.

File details

Details for the file intelmq-2.1.0-py2.py3-none-any.whl.

File metadata

  • Download URL: intelmq-2.1.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 1.0 MB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.20.1 setuptools/40.5.0 requests-toolbelt/0.8.0 tqdm/4.31.1 CPython/3.6.5

File hashes

Hashes for intelmq-2.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b3949e78ea31f0f0808b2c5ca2feb285dae642664b1bbcb56e2651958ae0b308
MD5 00c17368c0ce10e8ed03a3a202b5787d
BLAKE2b-256 75bbfa739b809f5e2c05391c383d3e0a0d705fc4bd7573214b4d9bc7cfdc87a9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page