Skip to content

CiscoSecurity/fp-05-microsoft-sentinel-connector

Repository files navigation

Gitter chat

Update - EOL Effective 6/6/2023

Hello, this code base has moved to https://github.com/CiscoSecurity/fp-05-firepower-cli, you will need to configure the connector to use proper ports for the Microsoft Agent which is detailed in the Microsoft documentation here Sentinel Data Connectors

The main delta between the projects is the following in the estreamer.conf

        {
            "adapter": "cef",
            "enabled": true,
            "name": "CEFSentinel",
            "stream": {
                "uri": "tcp://127.0.0.1:25226"
            }
        }

License

Copyright (c) 2017 by Cisco Systems, Inc.

Cisco EULA

ALL RIGHTS RESERVED. THESE SOURCE FILES ARE THE SOLE PROPERTY
OF CISCO SYSTEMS, Inc. AND CONTAIN CONFIDENTIAL  AND PROPRIETARY
INFORMATION.  REPRODUCTION OR DUPLICATION BY ANY MEANS OF ANY
PORTION OF THIS SOFTWARE WITHOUT PRIOR WRITTEN CONSENT OF
CISCO SYSTEMS, Inc. IS STRICTLY PROHIBITED.

eStreamer eNcore

The Cisco eStreamer client.

The Cisco Event Streamer (also known as eStreamer) allows you to stream System intrusion, discovery, and connection data from Firepower Management Center or managed device (also referred to as the eStreamer server) to external client applications.

eStreamer responds to client requests with terse, compact, binary encoded messages – this keeps it fast.

eNcore is a new all-purpose client which requests all possible events from eStreamer, parses the binary content and outputs events in various formats to support other SIEMs.

Support

This is a beta version of eNcore. Before the General Availability release this will be updated with details of paying for and receiving support.

Quick install

  • Navigate to the directory you want to contain eStreamer eNcore
  • Run eNcore: ./encore.sh
  • Run a connectivity test: ./encore.sh test (and enter the pkcs12 password)
  • View the log output tail -f estreamer.log
  • ./encore.sh foreground - run in the foreground
  • ./encore.sh start - starts a background task
  • ./encore.sh stop - this will stop the background task
  • ./encore.sh restart - this will restart the background task
  • ./encore.sh clean - this will remove all data files within a 12 hour window