gpgpdump - OpenPGP packet visualizer

no extension

余暇でちまちま作っていたが，とりあえず使えるようになったので。

OpenPGP パケットの内容を視覚化する gpgpdump の 0.1.0 をリリースした。 名前でピンとくる人もいるだろうが，山本和彦さんの pgpdump の翻案である。 特徴は以下のとおり。

たとえば

$ cat sig -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iF4EARMIAAYFAlTDCN8ACgkQMfv9qV+7+hg2HwEA6h2iFFuCBv3VrsSf2BREQaT1 T1ZprZqwRPOjiLJg9AwA/ArTwCPz7c2vmxlv7sRlRLUI6CdsOqhuO1KfYXrq7idI =ZOTN -----END PGP SIGNATURE-----

という OpenPGP 署名データがあるとする。 これを pgpdump で表示すると

$ pgpdump sig Old: Signature Packet(tag 2)(94 bytes) Ver 4 - new Sig type - Signature of a canonical text document(0x01). Pub alg - Reserved for ECDSA(pub 19) Hash alg - SHA256(hash 8) Hashed Sub: signature creation time(sub 2)(4 bytes) Time - Sat Jan 24 11:52:15 東京 (標準時) 2015 Sub: issuer key ID(sub 16)(8 bytes) Key ID - 0x31FBFDA95FBBFA18 Hash left 2 bytes - 36 1f Unknown signature(pub 19)

となる。 一方， gpgpdump の場合は

$ gpgpdump sig [[Packet]] name = "Packet" value = "Signature Packet (tag 2)" note = "94 bytes" [[Packet.Item]] name = "Version" value = "4" dump = "04" note = "new" [[Packet.Item]] name = "Signiture Type" value = "Signature of a canonical text document (0x01)" [[Packet.Item]] name = "Public-key Algorithm" value = "ECDSA public key algorithm (pub 19)" [[Packet.Item]] name = "Hash Algorithm" value = "SHA256 (hash 8)" [[Packet.Item]] name = "Hashed Subpacket" [[Packet.Item.Item]] name = "Signature Creation Time (sub 2)" value = "2015-01-24T11:52:15+09:00" dump = "54 c3 08 df" [[Packet.Item]] name = "Unhashed Subpacket" [[Packet.Item.Item]] name = "Issuer (sub 16)" value = "0x31FBFDA95FBBFA18" [[Packet.Item]] name = "Hash left 2 bytes" dump = "36 1f" [[Packet.Item]] name = "Multi-precision integer" dump = "..." note = "ECDSA r (256 bits)" [[Packet.Item]] name = "Multi-precision integer" dump = "..." note = "ECDSA s (252 bits)"

という感じで同等の内容を TOML フォーマットで出力する。 また -j オプションを付けると

$ gpgpdump -j sig { "Packet": [ { "name": "Packet", "value": "Signature Packet (tag 2)", "note": "94 bytes", "Item": [ { "name": "Version", "value": "4", "dump": "04", "note": "new" }, { "name": "Signiture Type", "value": "Signature of a canonical text document (0x01)" }, { "name": "Public-key Algorithm", "value": "ECDSA public key algorithm (pub 19)" }, { "name": "Hash Algorithm", "value": "SHA256 (hash 8)" }, { "name": "Hashed Subpacket", "Item": [ { "name": "Signature Creation Time (sub 2)", "value": "2015-01-24T11:52:15+09:00", "dump": "54 c3 08 df" } ] }, { "name": "Unhashed Subpacket", "Item": [ { "name": "Issuer (sub 16)", "value": "0x31FBFDA95FBBFA18" } ] }, { "name": "Hash left 2 bytes", "dump": "36 1f" }, { "name": "Multi-precision integer", "dump": "...", "note": "ECDSA r (256 bits)" }, { "name": "Multi-precision integer", "dump": "...", "note": "ECDSA s (252 bits)" } ] } ] }

という感じに JSON 形式で出力する。 だいぶ冗長な表現で申し訳ないが，解析結果を以下の struct で正規化している。

//Packets - OpenPGP packets
type Packets struct {
    Packet []*Item
}

//Item - item in Packets
type Item struct {
    Name  string  `toml:"name" json:"name"`
    Value string  `toml:"value,omitempty" json:"value,omitempty"`
    Dump  string  `toml:"dump,omitempty" json:"dump,omitempty"`
    Note  string  `toml:"note,omitempty" json:"note,omitempty"`
    Item  []*Item `toml:"Item,omitempty" json:"Item,omitempty"`
}

gpgpdump は Go 言語の勉強用に作成した。

golang.org/x/crypto/openpgp/packet というパッケージがあって，これを使えば簡単にできるだろうと思ったのが大間違いで，結局このパッケージで使えたのは OpaquePacket や OpaqueSubpacket くらい。 実際のパケットの解析はゴリゴリとコードを書くはめになった。 いや，これだけでもだいぶ助かったけど。

とはいえ，まだまだ課題はあって

  • パケット解析部分のテストが未実装。つか，古いフォーマットのパケットのテストどうしよう
  • そもそもパケット解析部分は作りが悪くて，不正なパケットを食わせると簡単に panic が起きてしまうので全面的に書きなおす予定
  • Compressed Data Packet (Tag 8) が未実装。どうやって実現しようか悩み中
  • 実は ECC (RFC 6637) がよく分かってない。もしかしたら解釈を間違えているかもしれない
  • 最終的には pgpdump と同等な出力を目指す

といったあたりを，これからゆっくり手を入れていこうと考えている。

ブックマーク