whatisgithub

What is brickstorm-scanner?

mandiant/brickstorm-scanner — explained in plain English

Analysis updated 2026-08-08 · repo last pushed 2025-11-14

88ShellAudience · ops devopsComplexity · 1/5QuietSetup · easy

In one sentence

A simple shell script that scans Linux and BSD systems for the BRICKSTORM backdoor malware by checking files for specific signatures, designed for appliances that can't run heavier security tools.

Mindmap

mindmap
  root((repo))
    What it does
      Scans for BRICKSTORM malware
      Checks ELF executables
      Three-step signature matching
    Tech stack
      Shell script
      Standard Linux utilities
      No extra dependencies
    Use cases
      Check compromised appliances
      Scan directories recursively
      Quick triage investigation
    Audience
      IT admins
      Security analysts
      Appliance maintainers
    Limitations
      Only detects known variant
      No process or log checks
      Not a full security audit

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Scan a Linux or BSD appliance for the BRICKSTORM backdoor malware after a suspected compromise.

USE CASE 2

Recursively check all executable files in a directory for known BRICKSTORM signatures.

USE CASE 3

Triage VMware or Ivanti appliances quickly when heavier forensic tools cannot be installed.

What is it built with?

ShellBashLinux utilities

How does it compare?

mandiant/brickstorm-scannerarnabbagxd/brand-building-skillsbryanyzhu/agentic-ai-system-course
Stars889085
LanguageShellShellShell
Last pushed2025-11-14
MaintenanceQuiet
Setup difficultyeasyeasyeasy
Complexity1/51/52/5
Audienceops devopspm foundergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Just download and run the shell script on any Linux or BSD system, no dependencies or installation required.

No license information is provided in the repository.

So what is it?

The brickstorm-scanner is a security tool from Mandiant that helps you check whether a Linux or BSD system has been infected with a specific backdoor malware called BRICKSTORM. It is meant for situations where you suspect a system may have been compromised and need a quick way to look for signs of this particular threat, especially on appliances or devices that do not have specialized security software installed. At a high level, the scanner is a shell script that examines files on your system and flags any that look like they match a known malware signature. For a file to be flagged, it has to pass three checks: it must be a valid Linux executable (an ELF binary), it must contain a specific set of text strings associated with the malware, and it must contain a particular 25-byte pattern found through a hex dump. Only if all three conditions are met will the tool report a match. You can run it against individual files or point it at an entire directory to scan everything underneath recursively. The people who would use this are IT administrators, security analysts, or anyone responsible for maintaining Linux-based appliances from vendors like VMware or Ivanti. If you have read about the BRICKSTORM espionage campaign and want to check whether your devices are affected, this tool gives you a practical way to do that without needing to install heavier forensic tools. If it finds a match, Mandiant recommends doing a deeper forensic investigation and offers to help directly. What is notable about the project is that it is deliberately built as a simple bash script rather than a more sophisticated tool. This is a deliberate tradeoff: many appliances have minimal software installed and cannot run standard security tools like YARA, so the scanner relies only on utilities that are already present on virtually every Linux system. The project is also upfront about its limitations. It will not catch every variant of the malware, it does not check for other signs of compromise like suspicious processes or logs, and a clean scan does not guarantee the system is safe. It is a focused starting point, not a complete security audit.

Copy-paste prompts

Prompt 1
Write a bash script that checks if a file is a valid ELF binary, then searches it for specific text strings and a hex pattern, reporting a match only if all three checks pass.
Prompt 2
Help me run the brickstorm-scanner from Mandiant against my Linux appliance, I need to scan the entire /usr/bin directory recursively for BRICKSTORM malware.
Prompt 3
Create a checklist for what to do after the brickstorm-scanner finds a match on one of my Ivanti appliances, including next forensic steps and who to contact at Mandiant.
Prompt 4
Adapt the brickstorm-scanner approach to scan for a different malware by replacing the text strings and hex pattern, show me which parts of the script to modify.

Frequently asked questions

What is brickstorm-scanner?

A simple shell script that scans Linux and BSD systems for the BRICKSTORM backdoor malware by checking files for specific signatures, designed for appliances that can't run heavier security tools.

What language is brickstorm-scanner written in?

Mainly Shell. The stack also includes Shell, Bash, Linux utilities.

Is brickstorm-scanner actively maintained?

Quiet — no commits in 6-12 months (last push 2025-11-14).

What license does brickstorm-scanner use?

No license information is provided in the repository.

How hard is brickstorm-scanner to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is brickstorm-scanner for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.