Skip to content
Web-based sensor management suite
Go JavaScript HTML CSS Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
agent implemented websocket for realtime updates Aug 5, 2019
cmd implemented websocket for realtime updates Aug 5, 2019
config implemented websocket for realtime updates Aug 5, 2019
html Correct TLS detection for websocket connection Aug 8, 2019
json implemented websocket for realtime updates Aug 5, 2019
model implemented websocket for realtime updates Aug 5, 2019
module implemented websocket for realtime updates Aug 5, 2019
packet implemented websocket for realtime updates Aug 5, 2019
server Escape the @ modifier in the GJSON path. This was necessary since an … Aug 8, 2019
web implemented websocket for realtime updates Aug 5, 2019
COPYING Create COPYING May 2, 2019
Dockerfile Improved build and docker image; Clarified UI with respect to incompl… Jun 25, 2019
LICENSE Added dynamic API URL detection, Adjusted external URLs to point to g… Jun 11, 2019 support self-signed certs on the master Jun 18, 2019
sensoroni.json Improved build and docker image; Clarified UI with respect to incompl… Jun 25, 2019


Sensoroni is a software system for monitoring and interrogating remote servers or devices.

This system is comprised of a server and one or more agents. An agent runs on a remote server or device and performs jobs that have been queued on the server. The server provides a user interface for administrators to perform various tasks, such as:

  • monitor all sensors
  • add new jobs
  • view the job queue
  • inspect job details


Sensoroni is is distributed under the terms of version 2 of the GNU General Public License (GPL).

Only version 2 of the GNU GPL license applies to Sensoroni. No other GNU GPL version applies.

See LICENSE for more information.


Sensor Status List Sensor list

Job Status List Job list

Job Details and Results Job Details and Results


Sensoroni, at its core, is a job queueing and dispatch system. It is targetted specifically towards the computer security industry, primarily due to the job's focus on network concepts. For example, when creating a job, the source address and port, destination address and port, and beginning and ending time range can be specified. But additional, untyped job parameters can also be specified, which allows a job to target systems outside of the security realm.

Each job must be assigned to a sensor. Sensors are responsible for periodically checking into the server to let the server know that the sensor is still up, and to check for new jobs that it must process. Upon completion of a job, the sensor will update the server with the job results.

Job results are provided in any form, and are encapsulated within a byte stream. The job results typically represent a packet structure, in PCAP form.


In order to allow Sensoroni to support the variety of job types that are expected to be used, specific functionality of certain job types are isolated to optional modules. However, some module types are mandatory. For example, all servers and agents must provide an auth module, while the server must also provide a datastore module. This doesn't mean a specific module must be enabled, but rather that a module that implements a particular interface must be enabled. This provides runtime flexibility in how each Sensoroni deployment performs.

Sensoroni's configuration file controls whether additional modules should be enabled. Modules can provide custom, or specific integration with other systems. Both the server and the agent have their own lists of available modules.

Below are the current modules:

filedatastore (server)

Implements the Datastore module by using the local file system for persisting information about pending and completed jobs.

statickeyauth (server and agent)

Implements the Auth module by specifying a shared key that both the agents and the server will utilize, as well as an optional CIDR block that, if specified, allows the server to bypass the key verification if the request originates from a network in the CIDR block.

securityonion (server)

A custom module that integrates Sensoroni with Security Onion. This module provides a new endpoint, /securityonion/joblookup?esid=xyz&redirectUrl=/, where xyz is the Elasticsearch document ID containing the desired packet source, target, and date ranges to retrieve. The redirectUrl parameter is available to accomodate reverse proxy configurations.

stenoquery (agent)

Integrates with Google Stenographer for retrieving PCAP files from remote sensors.

Reverse Proxy

Since Sensoroni does not provide a user management system it is recommended that all deployments place the server behind a reverse proxy, such as NGINX, where the users have already been authenticated via an alternate authorization system.


A single compiled Sensoroni binary can be configured to run either as a server, an agent, or as both (for development and test purposes.) See the example configuration file below for an example configuration of the dual agent and server configuration, and with an additional SecurityOnion module.

Sample sensoroni.json file:

  "logLevel": "debug",
  "logFilename": "sensoroni.log",
  "server": {
    "bindAddress": "",
    "maxPacketCount": 5000,
    "htmlDir": "html",
    "modules": {
      "filedatastore": {
        "jobDir": "jobs"
      "securityonion": {
        "elasticsearchHost": "",
        "elasticsearchUsername": "",
        "elasticsearchPassword": "",
        "elasticsearchVerifyCert": false
      "statickeyauth": {
        "anonymousCidr": "",
        "apiKey": "123abc"
  "agent": {
    "pollIntervalMs": 10000,
    "serverUrl": "",
    "modules": {
      "statickeyauth": {
        "apiKey": "123abc"
      "stenoquery": {
        "pcapInputPath": "/nsm/pcap",
        "pcapOutputPath": "/nsm/pcapoutput"

In a real deployment, the server block and agent block would not coexist in the same configuration file.

The agent can be configured to use a proxy by ensuring the HTTP_PROXY environment variable is provided. Ex:

export HTTP_PROXY="http://proxyIp:proxyPort"
You can’t perform that action at this time.