modulexcite / fibratus Goto Github PK

Fibratus

A modern tool for the Windows kernel exploration and observability
Get Started »

Docs   •   Filaments   •   Download   •   Discussions

What is Fibratus?

Fibratus is a tool for exploration and tracing of the Windows kernel. It lets you trap system-wide events such as process life-cycle, file system I/O, registry modifications or network requests among many other observability signals. In a nutshell, Fibratus allows for gaining deep operational visibility into the Windows kernel but also processes running on top of it.

Events can be shipped to a wide array of output sinks or dumped to capture files for local inspection and forensics analysis. The powerful filtering engine permits drilling into the event flux entrails.

You can use filaments to extend Fibratus with your own arsenal of tools and so leverage the power of the Python ecosystem

Quick start

• Observe Microsoft Outlook attachments creating on the file system

fibratus run file.operation = 'create' and file.name icontains '\\Content.Outlook\\'

• Hunt remote thread creations

fibratus run kevt.name = 'CreateThread' and kevt.pid != thread.pid

• Record network interactions to the capture file

fibratus capture kevt.category = 'net' -o conns.kcap

• Replay events from the capture

fibratus replay net.dport in (443, 80) -k conns.kcap

• Run the filament for watching file system changes

fibratus run -f watch_files

Features

• ⚡ blazing fast
• 📡 collects a wide spectrum of kernel events - from process to network observability signals
• 🔍 super powerful filtering engine
• 🐍 running Python scriptlets on top of kernel event flow
• 💽 capturing event flux to kcap files and replaying anywhere
• 🚀 transporting events to Elasticsearch, RabbitMQ or console sinks
• ✂️ transforming kernel events
• 🎯 scanning malicious processes and files with Yara
• 📁 PE (Portable Executable) introspection

Documentation

Setup

• Installation
• Building from source
• Running as standalone binary
• Running as Windows Service
• CLI
• Configuration

Events

• Anatomy of an event
• Process
• Thread
• Image
• File
• Registry
• Network
• Handle

Filters

• Needle in the haystack
• Prefiltering
• Filtering
• Operators
• Functions
• Paths
• Fields
• Rules

Captures

• Immortalizing the event flux
• Capturing
• Replaying

Filaments

• Python meets kernel events
• Executing
• Internals
• Writing filaments

Outputs

• Transporting kernel events
• Console
• Null
• RabbitMQ
• Elasticsearch

Transformers

• Parsing, enriching, transforming
• Remove
• Rename
• Replace
• Tags
• Trim

Alerts

• Watchdogging kernel events
• Mail
• Slack
• Filament alerting

PE (Portable Executable)

• Portable Executable introspection
• Sections
• Symbols
• Resources

YARA

• Pattern matching swiss knife
• Scanning processes
• Alerts

Troubleshooting

• Logs
• Stats
• Profiling

Developed with ❤️ by Nedim Šabić Šabić

Logo designed with ❤️ by Karina Slizova