https://github.com/ink-splatters/blackboxprotobuf-orig
Blackbox protobuf is a Burp Suite extension for decoding and modifying arbitrary protobuf messages without the protobuf type definition. Fork of original https://github.com/nccgroup/blackboxprotobuf
https://github.com/ink-splatters/blackboxprotobuf-orig
Last synced: 3 months ago
JSON representation
Blackbox protobuf is a Burp Suite extension for decoding and modifying arbitrary protobuf messages without the protobuf type definition. Fork of original https://github.com/nccgroup/blackboxprotobuf
- Host: GitHub
- URL: https://github.com/ink-splatters/blackboxprotobuf-orig
- Owner: ink-splatters
- License: mit
- Created: 2022-12-27T20:42:04.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2022-12-27T21:24:35.000Z (over 2 years ago)
- Last Synced: 2025-01-14T05:31:29.697Z (5 months ago)
- Language: Python
- Size: 414 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Blackbox Protobuf
## Description
Blackbox Protobuf is a set of tools for working with encoded Protocol Buffers
(protobuf) without the matching protobuf definition.
Protobuf is a binary serialization format from Google which can be used as a
more efficient alternative to formats like JSON or XML. Developers can define
the message format in a `.proto` file and use the protobuf compiler to
geneerate message handlers in their language of choice. The protobuf encoding
is binary, and unlike json/xml not human readable or easy to modify by hand.
The format also takes advantage of both sides having the message definition and
strips out much of the type information. This is good for efficiency, but
increases the difficulty analyizing or modifying the network traffic.
Blackbox protobuf is designed to allow working with protocol buffers without
the message definition. It was originally implemented as a Burp extension for
decoding and modifying messages during mobile pentests, but has also been used
for reverse engineering and forensics tooling.
## Tools
This repository contains two applications for working with protocol buffers:
- A jython burp extension in [burp/](https://github.com/nccgroup/blackboxprotobuf/tree/master/burp)
- A python library that can be used in other appliations in [lib/](https://github.com/nccgroup/blackboxprotobuf/tree/master/lib)
## Future Tools
Some tooling that may be built on top of blackboxprotobuf in the future:
- mitmproxy addon
- command line interface
- protobuf type discovery tool