Blackbox Protobuf

Blackbox Protobuf dispose désormais d'un paquet officiel sur PyPi sous le nom bbpb. Le paquet blackboxprotobuf est un ancien fork

Description

Blackbox Protobuf est un ensemble d'outils permettant de travailler avec des Protocol Buffers (protobuf) encodés, sans la définition protobuf correspondante.

Protobuf est un format de sérialisation binaire de Google qui peut être utilisé comme alternative plus efficace à des formats comme JSON ou XML. Les développeurs peuvent définir le format du message dans un fichier .proto et utiliser le compilateur protobuf pour générer des gestionnaires de messages dans le langage de leur choix. L'encodage protobuf est binaire et, contrairement à json/xml, n'est ni lisible par un humain ni facile à modifier à la main. Le format tire également parti du fait que les deux côtés disposent de la définition du message et omet une grande partie des informations de type. C'est efficace, mais cela augmente la difficulté d'analyse ou de modification du trafic réseau.

Blackbox Protobuf est conçu pour permettre de travailler avec des protocol buffers sans la définition du message. Il a été initialement implémenté comme une extension Burp pour décoder et modifier les messages lors de tests d'intrusion mobiles, mais a également été utilisé pour des outils de rétro-ingénierie et de forensique.

Outils

Ce dépôt contient plusieurs interfaces pour travailler avec des protocol buffers :

• Une extension Burp en jython dans burp/
• Une bibliothèque python utilisable dans d'autres applications dans lib/
• Une CLI basée sur python intégrée dans la bibliothèque
• Un addon mitmproxy dans mitmproxy

Documentation

En plus du README.md de chaque outil, la documentation suivante est disponible :

• Guide de définition de types - guide pour modifier les typedefs afin de corriger les types et améliorer la lisibilité

Outils futurs

Certains outils qui pourraient être construits sur blackboxprotobuf à l'avenir :

• outil de découverte de types protobuf