ProtobufDecoder

ProtobufDecoder

Este aplicativo ajuda a analisar as cargas úteis do Google Protocol, onde você não possui um arquivo .proto correspondente.

Cenários em que você pode usar isso é inspecionar o resultado da serialização ou quando você precisa interoperar com um sistema falando protobuf, mas que não fornece um arquivo .proto . Pode ser usado para engenharia reversa, mas lembre -se de que isso pode não ser legal em sua jurisdição.

O ProtobufDecoder lerá e decodificará dados binários que você captura de um depurador ou de uma ferramenta como o Wireshark e analisa as tags dos dados. Você pode analisar a carga útil para ver quais tags estão presentes, quais são seus tipos (número, strings etc.) e se houver mensagens incorporadas.

Um changelog pode ser encontrado aqui

Características

• Listar campos na carga útil capturada e exibir informações sobre:
  • Índice de tags
  • Tipo de fio
  • Conteúdo (bytes crus, valores)
• Exiba a localização e o tamanho de uma tag específica na carga útil binária (selecione uma tag na visualização da árvore e destaca os bytes)
• Gere uma especificação Protobuf a partir da carga útil decodificada (trabalho em andamento)
• Salve a especificação Protobuf gerada em um arquivo .proto
• Copie o valor de uma tag como uma matriz de byte C#

Uso

Faça o download do instalador mais recente da página de lançamentos.

Quando o aplicativo iniciar, abra um arquivo que contém uma carga útil do Protobuf via arquivo -> Abra ou usando o atalho do teclado Ctrl + O.

Observe que, neste momento, o ProtobufDecoder suporta apenas o arquivo A que contém apenas uma única mensagem RAW Protobuf. Se o arquivo contiver um prefixo de comprimento, ele será retirado automaticamente (desde a versão 0.4.0).

Para os guerreiros do teclado: as teclas de atalho estão disponíveis em todo o aplicativo e são sugeridas nos itens do menu.

Integração com outras ferramentas

O ProtobufDecoder suporta a abertura de um arquivo diretamente, passando em um argumento da linha de comando:

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

Isso iniciará o ProtobUfDecoder e abrirá imediatamente o arquivo especificado. Se o arquivo não existir ou não puder ser aberto, o erro será exibido na barra de status.

Prédio

Atualmente, não há uma versão embalada do aplicativo, o que significa que você precisará compilar você mesmo.

1. Clone este repositório
2. cd no diretório clonado
3. cd src/ProtobufDecoder.Application.Wpf
4. dotnet run -c Release

Isso restaurará os pacotes necessários, criará o aplicativo e iniciará.

Para facilitar a execução do aplicativo após a Etapa 3:

4. dotnet publish -c Release
5. Clique duas vezes no ProtobufDecoder.Application.Wpf.exe no src/ProtobufDecoder.Application.Wpf/bin/Release/net5.0-windows/publish pasta

Você pode criar um atalho para esse executável no menu Iniciar ou onde quiser.

Pendência

• Decodes valores de tags delimitados por comprimento que podem ser strings, valores repetidos compactados ou mensagens incorporadas
• Gerar o arquivo .proto a partir da carga útil decodificada
  • Tags únicas
  • Tags opcionais vs necessárias
  • Mensagens aninhadas (trabalho em andamento)
  • Tipo de tag delimitado por comprimento Dimtring (é uma string ou uma mensagem?) (Trabalho em andamento)
  • Tags de valor repetidas
• Aplicativo de pacote para download
• Configure a versão de lançamento para tags git
• Carregue um arquivo .proto e aplique -o à carga útil decodificada (para verificar o arquivo .proto e a correspondência de carga útil)
• Grupos de decodificação

Licença

Consulte a licença.

Agradecimentos

Este aplicativo usa:

• TOPAS/ VARINTBITCONVERTER/ PARA VARINT Decodificação a partir das cargas PROTOBUF. (Veja VarIntValue)
• WPF: Hexeditor para exibir a carga útil bruta e o destaque da tag
• Truques de detecção de cordas de Mildsunrise/Protobuf-Inspetor