Skip to content
New

DeepSeek V4.1 Flash free for 7 days: 10M tokens a day after a top-up of $10 or more. Until Nov 30.

How it works
meltedinhex/reverse-engineering-custom-c2-protocolsReverse engineering and fuzzing

reverse-engineering-custom-c2-protocols

⁨Reverses proprietary command-and-control protocols: locating send/recv routines,⁩

v1.0.03 installs+3 in 7 days24 StarsApache-2.0synced 10 hours ago

Install

No NotHoly CLI yet? Install it first.

$ curl -fsSL https://notholy.com/install.sh | sh
$ notholy skills install meltedinhex/reverse-engineering-custom-c2-protocols

Writes to ⁦~/.notholy/skills⁩ after checking the signature and the SHA-256.

SignatureSigned, ed25519
69KiTq8UMC…erjx9TDg==The CLI checks the SHA-256 and the signature before it writes a file.
Package4c8f5b9e…ff36300e
4c8f5b9e949c…c705ff36300e4 files · ⁦3.1 KB⁩
ScanMedium2 findings
  • Executable script shipped with the skillscripts/analyst.py
  • Links to outside domains
See the full scan
Sourcegithub.com/meltedinhex/analyst-ai-pack/tree/main/skills/reverse-engineering-custom-c2-protocols@da7600a

When to Use

  • A sample uses a non-standard protocol (or a custom layer over HTTP/TCP) and you must decode its traffic.
  • You need to recover message framing, the encryption/encoding scheme, and the command set.
  • You want to build a standalone decoder or emulator to parse captured beacon traffic.

Do not use this for documented protocols handled by existing dissectors — use the protocol analyzer directly instead of reversing from scratch.

Prerequisites

  • A disassembler/debugger and a network capture (PCAP) of the sample's traffic where possible.
  • The crypto/obfuscation skills for recovering keys and encodings.

Workflow

Step 1: Locate the network routines

Find send/recv/WSASend/WinHTTP calls (or the framework wrappers) and the buffers they operate on. These bracket the serialization and crypto.

Step 2: Recover framing

Trace how outbound buffers are built: magic bytes, length prefixes, sequence/ID fields, and type/opcode fields. Document the header layout.

text
[ magic(4) ][ len(4 LE) ][ opcode(1) ][ flags(1) ][ payload(len) ]

Step 3: Recover crypto/encoding

Identify the transform applied before send / after recv (XOR with embedded key, RC4, AES, base64). Recover keys from the binary or from the key-setup routine.

Step 4: Reconstruct the command set

Map opcodes to handlers (shell, download, upload, sleep/jitter, exit) by following the dispatch switch. Build a table of command → behavior.

Step 5: Build a decoder and validate

Implement a parser/decryptor and run it against captured traffic; confirm it yields coherent commands and recovers the beacon's config.

bash
python scripts/analyst.py decode capture.bin --key 0x5a --magic 4d5a4331

Validation

  • The decoder parses every message in a real capture without desync.
  • Decrypted payloads are coherent (printable commands / structured config).
  • The opcode table matches the dispatch logic observed in the binary.

Pitfalls

  • Assuming fixed keys when the protocol negotiates a session key in the first exchange.
  • Missing a length/sequence field and desynchronizing after the first message.
  • Confusing transport (TLS) with the inner custom layer; decode the inner layer.

References

  • See references/api-reference.md for the framing decoder.
  • MITRE ATT&CK T1071 and T1573 (linked in frontmatter).

Files in this version

Permissions

PermissionDeclaredFound by the scan
Reads filesNoNo
Writes filesNoNo
Runs shell commandsYesYes
Uses the networkYesYes
Uses connectorsNoNo
Drives a browserNoNo

Scan findings

Reviewed on Nov 13, 2026

  1. MediumFile · Executable script shipped with the skillscripts/analyst.py
  2. InfoLink · Links to outside domains

A clean scan lowers the risk but does not prove a package is safe. Read what you install.

VersionPublishedCommitSHA-256SignaturePermission change
v1.0.0Nov 13, 2026da7600a4c8f5b9eSigned–

Ask anything your scope allows.

Create an account, add credits and ask the first question in the chat or the terminal.

  1. 1/3

    Create the account

    Individual or company. You can switch to a company later without losing balance or keys.

    IndividualCompany
  2. 2/3

    Add credits

    By card. Pay per token, no subscription.

    $5.00minimum deposit
  3. 3/3

    Ask

    In the chat, or install the CLI and run notholy login in your terminal.

    $ notholy login