github.com/WhiteBeamSec/WhiteBeam @v0.2.6

Transparent endpoint security

Features

• Block and detect advanced attacks
• Modern audited cryptography: RustCrypto for hashing and encryption
• Highly compatible: Development focused on all platforms (incl. legacy) and architectures
• Source available: Audits welcome
• Reviewed by security researchers with combined 100+ years of experience

In Action

• Video demonstration of detection and prevention capabilities
• Testing WhiteBeam against zeroday exploits
• Recorded attacks against the WhiteBeam honeypot

Installation

From Packages (Linux)

Distro-specific packages have not been released yet for WhiteBeam, check again soon!

From Releases (Linux)

1. Download the latest release
2. Ensure the release file hash matches the official hashes (How-to)
3. Install:
   • ./whitebeam-installer install

From Source (Linux)

1. Run tests (Optional):
   • cargo run test
2. Compile:
   • cargo run build
3. Install WhiteBeam:
   • cargo run install

Quick start

1. Become root (sudo -s/su root)
2. Set a recovery secret. You'll be able to use this with whitebeam --auth to make changes to the system: whitebeam --setting RecoverySecret mask

How to Detect Attacks with WhiteBeam

Multiple guides are provided depending on your preference. Contact us so we can help you integrate WhiteBeam with your environment. 1. Serverless guide, for passive review 2. osquery Fleet setup guide, for passive review 3. WhiteBeam Server setup guide, for active response

How to Prevent Attacks with WhiteBeam

:information_source: WhiteBeam is experimental software. Contact us for assistance safely implementing it.

1. Become root (sudo -s/su root)
2. Download default whitelists for your platform:
   • whitebeam --load Base
3. Review the baseline after a minimum of 24 hours:
   • whitebeam --baseline
4. Add trusted behavior to the whitelist, following the whitelisting guide
5. Enable WhiteBeam prevention:
   • whitebeam --setting Prevention true