Skip to content

Commit

Permalink
Long overdue update to the overview.
Browse files Browse the repository at this point in the history
  • Loading branch information
jeffbryner committed Jun 7, 2018
1 parent 5f83f13 commit fff4695
Showing 1 changed file with 22 additions and 17 deletions.
39 changes: 22 additions & 17 deletions docs/source/overview.rst
Original file line number Diff line number Diff line change
@@ -1,12 +1,16 @@
Overview
========
What?
----
Easiest to describe The Mozilla Defense Platform (MozDef) as a set of micro-services you can use as an open source Security Informaition and Event Management (SIEM) overlay on top of Elasticsearch.

Why?
----

The inspiration for MozDef comes from the large arsenal of tools available to attackers.
Suites like metasploit, armitage, lair, dradis and others are readily available to help attackers coordinate, share intelligence and finely tune their attacks in real time.
Defenders are usually limited to wikis, ticketing systems and manual tracking databases attached to the end of a Security Information Event Management (SIEM) system.
Open source suites like metasploit, armitage, lair, dradis and others are readily available to help attackers coordinate, share intelligence and finely tune their attacks in real time.

Open source options for defenders are usually limited to wikis, ticketing systems and manual tracking databases attached to the end of a commercial SIEM.

The Mozilla Defense Platform (MozDef) seeks to automate the security incident handling process and facilitate the real-time activities of incident handlers.

Expand All @@ -17,7 +21,7 @@ High level
**********

* Provide a platform for use by defenders to rapidly discover and respond to security incidents.
* Automate interfaces to other systems like MIG, flowspec, load balancers, etc
* Automate interfaces to other systems like firewalls, cloud protections and anything that has an API
* Provide metrics for security events and incidents
* Facilitate real-time collaboration amongst incident handlers
* Facilitate repeatable, predictable processes for incident handling
Expand All @@ -26,7 +30,7 @@ High level
Technical
*********

* Replace a Security Information and Event Management (SIEM)
* Offer micro services that make up an Open Source Security Information and Event Management (SIEM)
* Scalable, should be able to handle thousands of events per second, provide fast searching, alerting, correlation and handle interactions between teams of incident handlers.

MozDef aims to provide traditional SIEM functionality including:
Expand All @@ -41,8 +45,10 @@ It is non-traditional in that it:

* Accepts only JSON input
* Provides you open access to your data
* Integrates with a variety of log shippers including heka, logstash, beaver, nxlog and any shipper that can send JSON to either rabbit-mq or an HTTP endpoint.
* Integrates with a variety of log shippers including logstash, beaver, nxlog, syslog-ng and any shipper that can send JSON to either rabbit-mq or an HTTP(s) endpoint.
* Provides easy integration to Cloud-based data sources such as cloudtrail or guard duty
* Provides easy python plugins to manipulate your data in transit
* Provides extensive plug-in opportunities to customize your event enrichment stream, your alert workflow, etc
* Provides realtime access to teams of incident responders to allow each other to see their work simultaneously


Expand All @@ -66,7 +72,7 @@ MozDef is based on open source technologies including:
Frontend processing
*******************

Frontend processing for MozDef consists of receiving an event/log (in json) over HTTP(S) or AMQP(S),
Frontend processing for MozDef consists of receiving an event/log (in json) over HTTP(S), AMQP(S), or SQS
doing data transformation including normalization, adding metadata, etc. and pushing
the data to elasticsearch.

Expand All @@ -79,7 +85,7 @@ the RabbitMQ exchanges and elasticsearch indices.
Status
------

MozDef is in production at Mozilla where we are using it to process over 300 million events per day.
MozDef has been in production at Mozilla since 2014 where we are using it to process over 300 million events per day.

Roadmap
-------
Expand All @@ -90,21 +96,20 @@ Initial Release:
* Enhance the incident workflow UI to enable realtime collaboration
* Enable basic plug-ins to the event input stream for meta data, additional parsing, categorization and basic machine learning
* Support as many common event/log shippers as possible with repeatable recipies
* Base integration into Mozilla's defense mechanisms for automation
* 3D visualizations of threat actors
* Fine tuning of interactions between meteor, mongo, dc.js

Mid term:
Recently implemented:

* Repeatable installation guides
* Ready-made AMIs/downloadable ISOs
* Correlation through machine learning, AI
* Base integration into Mozilla's defense mechanisms for automation
* Fine tuning of interactions between meteor, mongo, dc.js
* Support a variety of authentication/authorization schemes/technologies
* Plain text version of attackers
* Enhanced search for alerts, events, attackers within the MozDef UI
* Support for OIDC authentication/authorization
* Docker containers for each service
* Updates to support recent (breaking) versions of Elasticsearch

Long term:
Future (join us!):

* Correlation through machine learning, AI
* Enhanced search for alerts, events, attackers within the MozDef UI
* Integration into common defense mechanisms used outside Mozilla


0 comments on commit fff4695

Please sign in to comment.