ProtobufDecoder

ProtoBufdecoder

Esta aplicación ayuda a analizar las cargas útiles de Buffers de protocolos de Google donde no tiene un archivo .proto correspondiente.

Escenarios en los que es posible que desee usar esto es inspeccionar el resultado de la serialización o cuando necesita interoperar con un sistema que habla ProtoBuf pero que no proporciona un archivo .proto . Se puede usar para la ingeniería inversa, pero tenga en cuenta que esto puede no ser legal en su jurisdicción.

ProtoBufDecoder leerá y decodificará los datos binarios que captura de un depurador o una herramienta como Wireshark y analiza las etiquetas de los datos. Luego puede analizar la carga útil para ver qué etiquetas están presentes, cuáles son sus tipos (número, cadenas, etc.) y si hay mensajes incrustados.

Se puede encontrar un CangeLog aquí

Características

• Lista de campos en la carga útil capturada y muestre información sobre:
  • Índice de etiquetas
  • Tipo de cable
  • Contenido (bytes crudos, valores)
• Muestre la ubicación y el tamaño de una etiqueta específica en la carga útil binaria (seleccione una etiqueta en la vista de árbol y resalta los bytes)
• Genere una especificación de ProtoBuf de la carga útil decodificada (trabajo en progreso)
• Guardar la especificación de protoBuf generada en un archivo .proto
• Copiar el valor de una etiqueta como una matriz de byte C#

Uso

Descargue el último instalador de la página de lanzamientos.

Cuando se inicia la aplicación, abra un archivo que contiene una carga útil de ProtoBuf, ya sea a través del archivo -> Abrir o usar el acceso directo del teclado Ctrl + O.

Tenga en cuenta que en este momento el ProtoBufDecoder solo admite el archivo A que contiene solo un solo mensaje de ProtoBuf. Si el archivo contiene un prefijo de longitud, se despojará automáticamente (desde la versión 0.4.0).

Para los guerreros del teclado: las teclas de atajo están disponibles en toda la aplicación y se insinúan en los elementos del menú.

Integrarse con otras herramientas

ProtoBufDecoder admite abrir un archivo directamente pasando en un argumento de línea de comando:

C:usersjohndoe > ProtobufDecoder.Application.Wpf.exe < path to binary >

Esto iniciará ProtoBufDecoder e inmediatamente abrirá el archivo especificado. Si el archivo no existe o no se puede abrir, el error se mostrará en la barra de estado.

Edificio

Actualmente no hay una versión empaquetada de la aplicación, lo que significa que deberá compilar la aplicación usted mismo.

1. Clon este repositorio
2. cd en el directorio clonado
3. cd src/ProtobufDecoder.Application.Wpf
4. dotnet run -c Release

Eso restaurará los paquetes necesarios, construirá la aplicación y la iniciará.

Para facilitar la ejecución de la aplicación después del paso 3, ejecute:

4. dotnet publish -c Release
5. Haga doble clic en el ejecutable ProtobufDecoder.Application.Wpf.exe en la carpeta src/ProtobufDecoder.Application.Wpf/bin/Release/net5.0-windows/publish

Puede crear un acceso directo a ese ejecutable en el menú Inicio o donde desee.

Hacer

• Valores de etiqueta delimitados de longitud de decodificación que podrían ser cadenas, valores repetidos empaquetados o mensajes incrustados
• Generar el archivo .proto a partir de la carga útil decodificada
  • Etiquetas individuales
  • Etiquetas opcionales vs requeridas
  • Mensajes anidados (trabajo en progreso)
  • Tipo de etiqueta de longitud delimitada Sugerencia (¿es una cadena o un mensaje?) (Trabajar en progreso)
  • Etiquetas de valor repetidas
• Aplicación de paquete para descargar
• Configurar la versión de lanzamiento para las etiquetas Git
• Cargue un archivo .proto y aplíquelo a la carga útil decodificada (para verificar el archivo .proto y la coincidencia de carga útil)
• Grupos decodificadores

Licencia

Ver licencia.

Expresiones de gratitud

Esta aplicación usa:

• Topas/ VarintbitConverter/ para VarInt Decoding desde las cargas útiles de ProtoBuf. (Ver VarIntValue)
• WPF: HexEditor para mostrar la carga útil y la etiqueta resaltando la etiqueta
• Trucos de detección de cuerdas de Mildsunrise/ProtoBuf-Inspector