דילוג לתוכן
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
noorqureshi/reverse-eng-protocolהנדסה לאחור ו-fuzzing

reverse-eng-protocol

⁨Reverse a custom network protocol from captured traffic or the client binary: recover the frame layout, message-type dictionary, field meanings, and state machine. Load for custom TCP/UDP binary protocols, Protobuf/gRPC without reflection, FlatBuffers/MessagePack, WebSocket/MQTT/private RPC framing,⁩

v2026.10.14-ee0e0c53 התקנות⁦+3⁩ ב-7 ימים27 כוכביםMITסונכרן לפני 22 שעות

התקנה

עדיין אין לכם את ה-CLI של NotHoly? התקינו אותו קודם.

$ curl -fsSL https://notholy.com/install.sh | sh
$ notholy skills install noorqureshi/reverse-eng-protocol

נכתב אל ⁦~/.notholy/skills⁩ אחרי בדיקת החתימה וה-SHA-256.

חתימהחתום, ed25519
V96KiMEHxl…8+DHsnBg==ה-CLI בודק את ה-SHA-256 ואת החתימה לפני שהוא כותב קובץ כלשהו.
חבילהf9184d23…b2fbbc93
f9184d23c5cf…3ef2b2fbbc93שני קבצים · ⁦3.6 KB⁩
סריקהנמוךממצא אחד
  • קישורים לדומיינים חיצוניים
לסריקה המלאה
מקורgithub.com/NoorQureshi/security-skills/tree/main/skills/reverse-engineering/reverse-eng-protocol@ee0e0c5

הפריט הזה עדיין לא נכתב בעברית, ולכן הוא מוצג בשפה אחרת: English.

When it applies

The target speaks something that isn't plain HTTP/JSON: a custom binary TCP/UDP protocol, Protobuf/gRPC with no reflection, FlatBuffers/MessagePack, WebSocket or MQTT frames, or a private RPC format — and you have a PCAP, a proxy export, client logs, or the client binary. (For pure HTTP parameter signing in JS, use reverse-eng-js; for gRPC's HTTP/2 attack surface itself, api-grpc.) Target and any replay testing must be in scope.txt (tradecraft-scope-roe) — replay only against systems you're authorized to touch.

Why it works

Protocols are machines, and machines are regular: fixed headers, magic bytes, length fields, monotonic sequence numbers, and repeated type-length-value structures. Align many samples of the same message type and the invariant bytes identify themselves; the variable ones are your fields. Serialization formats like Protobuf are self-describing enough to decode blind — field numbers and wire types survive even without the .proto.

Method

  1. Capture and triage. Pull raw payloads and label each sample by direction (C→S / S→C); note handshake, heartbeat, and reconnect patterns:
    bash
    tshark -r cap.pcap -Y "tcp.port==4433" -T fields -e frame.number -e ip.src -e tcp.payload | head
    First questions: fixed header? magic bytes? a length field? TLV or fixed-size records? Any compression (zlib/gzip/lz4) or per-frame encryption (AES/ChaCha)?
  2. Recover the frame layout. Align several messages of the same kind and diff the bytes: invariant regions = header/constants; counters = sequence numbers; a field whose value matches the remaining byte count = length (check endianness, and whether it includes the header). Locate integrity fields last — CRC16/32, checksums, HMAC slots. Sketch the state machine (Connect → Auth → Ready → Request/Response → Close). Encode the layout as a Wireshark Lua dissector, an ImHex/010 Editor template, or a Kaitai Struct .ksy.
  3. Tackle serialization and crypto. Protobuf: protoc --decode_raw < msg.bin for a quick read, blackboxprotobuf or pbtk to rebuild a usable .proto. gRPC is HTTP/2 headers plus a protobuf body. Encrypted frames: the key derivation lives in the client — pull it with reverse-eng-binary-triage (native), reverse-eng-js (web), or mobile tooling; look for the nonce/IV adjacent to the ciphertext.
  4. Produce the artifacts. A message-type table (name / opcode / fields), at least one reproducible decode command or script, and evidence excerpts (raw hex + decoded result, redacted of secrets and third-party data).

See cheatsheet.md for the layout-pattern table, parser skeleton, and tshark one-liners.

Gotchas

  • Length-field ambiguity — big- vs little-endian, and header-inclusive vs body-only, are the two classic off-by-entire-parse errors; validate against a known sample's byte count.
  • A crash on replay is not proof of a bug — it may be a checksum/sequence check rejecting you; fix your framing first, then judge the response.
  • Compressed-before-encrypted vs encrypted-before-compressed — high entropy over the whole body means encryption; compression headers (\x78\x9c, \x1f\x8b) mean you can decompress directly.
  • Don't fuzz blind against the live service — replay a captured, harmless message first; mutate one field at a time, and only within scope.

Verify success

Your dissector or script decodes a fresh capture into the correct fields with no manual fix-ups, and you can state the message-type dictionary and state machine. Bonus proof: a replayed (in-scope) message with one mutated field is accepted by the server — the layout is right, and the protocol is now fuzzable.

References

Wireshark/tshark docs; Kaitai Struct gallery; blackboxprotobuf; api-grpc, web-websocket, reverse-eng-binary-triage in this library.


Portions adapted from reverse-skill by zhaoxuya520, MIT License.

הקבצים בגרסה הזו

הרשאות

הרשאההוצהרנמצא בסריקה
קורא קבציםכןכן
כותב קבציםלאלא
מריץ פקודות shellכןכן
משתמש ברשתכןכן
משתמש במחבריםלאלא
שולט בדפדפןלאלא

ממצאי הסריקה

נבדק ב-13 בנוב׳ 2026

  1. מידעקישור · קישורים לדומיינים חיצוניים

סריקה נקייה מורידה את הסיכון, אבל לא מוכיחה שהחבילה בטוחה. כדאי לקרוא מה מתקינים.

גרסהפורסמהCommitSHA-256חתימהשינוי בהרשאות
v2026.10.14-ee0e0c513 בנוב׳ 2026ee0e0c5f9184d23חתומה–

שאלו כל מה שהסקופ מאפשר.

יוצרים חשבון, מוסיפים קרדיטים ושואלים את השאלה הראשונה בצ׳אט או בטרמינל.

  1. 1/3

    יצירת חשבון

    פרטי או חברה. אפשר לעבור לחשבון חברה אחר כך בלי לאבד יתרה או מפתחות.

    פרטיחברה
  2. 2/3

    הוספת קרדיטים

    בכרטיס אשראי. תשלום לפי טוקן, בלי מנוי.

    $5.00טעינה מינימלית
  3. 3/3

    שאלה ראשונה

    בצ׳אט, או להתקין את ה-CLI ולהריץ notholy login בטרמינל.

    $ notholy login