Skip to main content
docs/images/diffy_small.png Travis CI Codecov https://img.shields.io/gitter/room/nwjs/nw.js.svg?style=flat-square PyPi version Supported Python versions License Status RTD

Diffy is a digital forensics and incident response (DFIR) tool developed by Netflix’s Security Intelligence and Response Team (SIRT).

Diffy allows a forensic investigator to quickly scope a compromise across cloud instances during an incident, and triage those instances for followup actions. Diffy is currently focused on Linux instances running within Amazon Web Services (AWS), but owing to our plugin structure, could support multiple platforms and cloud providers.

It’s called “Diffy” because it helps a human investigator to identify the differences between instances, and because Alex pointed out that “The Difforensicator” was unnecessarily tricky.

See Releases for recent changes. See our Read the Docs site for well-formatted documentation.

Supported Technologies

  • AWS (AWS Systems Manager / SSM)

  • Local

  • osquery

Each technology has its own plugins for targeting, collection and persistence.

Features

  • Efficiently highlights outliers in security-relevant instance behavior. For example, you can use Diffy to tell you which of your instances are listening on an unexpected port, are running an unusual process, include a strange crontab entry, or have inserted a surprising kernel module.

  • Uses one, or both, of two methods to highlight differences:

    • Collection of a “functional” baseline from a “clean” running instance, against which your instance group is compared, and

    • Collection of a “clustered” baseline, in which all instances are surveyed, and outliers are made obvious.

  • Uses a modular plugin-based architecture. We currently include plugins for collection using osquery via AWS Systems Manager (formerly known as Simple Systems Manager or SSM).

Installation

Via pip:

pip install diffy

Roadmap

We are actively adding more plugins & tests, and improving the documentation.

Why python 3 only?

Please see Guido’s guidance regarding the Python 2.7 end of life date.

Release files for diffy 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for diffy 0.1.0
File Size Uploaded
diffy-0.1.0.tar.gz 31.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for diffy 0.1.0
File Interpreter ABI Platform
diffy-0.1.0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 78.3 kB

Release files / diffy-0.1.0.tar.gz

Download URL diffy-0.1.0.tar.gz
Size 31.1 kB
Tags Source
SHA-256 checksum
How to use checksums
88ff943f81f437de9ee7a0e05314caa236715aea37989fd7be00c988b456dd0f
BLAKE2b-256 checksum
How to use checksums
eeec89b75acfcc8ca8bb6a5451998f276f38dff07885be85f8e9d0c9ce06a413
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / diffy-0.1.0-py2.py3-none-any.whl

Download URL diffy-0.1.0-py2.py3-none-any.whl
Size 47.3 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
237c7fac29b43336060765fc8dcd5b02b4714a116b7daa9865960a462daf6b46
BLAKE2b-256 checksum
How to use checksums
54600d9af719e0f19d1da6b4a6d15ff630894d7db71523e95f76164947b3fc4c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page