ASN.1 / DER 構造の読み方
最終更新:
ASN.1 / DER 構造を読むとは、システム上のあらゆる証明書、秘密鍵、CSR、失効リストが書かれているバイナリ言語を読むことです。ASN.1は記法——データを記述するための文法——であり、DER(識別符号化規則)は各値をバイトに変換する唯一の標準的な方法です。これらのバイトがノイズに見えるなら、あなただけではありません。ほとんどの管理者は、ASN.1をエラーメッセージとして知ります。それも、その証明書がすでに何かを壊してからずっと後のことです。DERやPEMのデータをASN.1 / DER エクスプローラーに貼り付ければ、注釈付きの完全なツリーがブラウザーで得られます——何もアップロードされません——。ただしこの記事ではバイトを自分で読む方法を教えます。ツリーがブラックボックスになることはもうありません。
あらゆる証明書、鍵、CSRの下にある一つの言語——なぜいつもつまずくのか
ASN.1(抽象構文記法1)は記法です。X.680シリーズが文法を定め、X.690がDERを含む符号化規則を定めています。X.509証明書、PKCS#8秘密鍵、CSR、CRL、PKCS#7バンドル、OCSP応答はすべて、この一つの言語で書かれた値です。管理者がいつもつまずく理由は単純です。同じバイトが3つの衣装を着ているからです。.pemファイルは読めるテキストとして開き、.derファイルはゴミとして表示され、.cerファイルはどちらか分からない——そして構造を表示するツールは、尋ねたときにしか表示しないため、ほとんどの人が証明書の中を初めて見るのは、何かがすでに壊れてからです。
2つ目の落とし穴は、ASN.1が形を記述するものであって、意味を記述するものではないことです。2つのファイルがどちらも完全に正しいDERでありながら、まったく違う意味を持つことがあります。意味はスキーマ——証明書の場合はRFC 5280——と、その中のOIDから来ます。DERを読むとは、つまり2つのスキルを同時に使うことです。タグ・長さ・値の骨格を解析することと、トップレベルがどのスキーマだと主張しているかを知ることです。この記事では両方を扱い、エクスプローラーは前者を自動化し、後者を「ベストエフォートの推測」として表示し、断定はしません。パーサーは構造が何を言っているかを教えられますが、それが何を意味するかはスキーマだけが教えられるからです。
TLV:タグ、長さ、値——文法のすべては3バイト
ASN.1の値はすべて3つの部分からなります。何であるかを示すタグ、後に続くバイト数を示す長さ、そして値そのものです。タグバイトは8ビットに3つの情報を詰め込みます。上位2ビットはクラス——00は汎用、01はアプリケーション、10はコンテキスト固有(証明書のあちこちに見られる[0]や[3])、11はプライベート——、第6ビットは構成型(他の値を入れるコンテナ)か基本型(葉)かを示し、下位5ビットはタグ番号で、31は「続きを読んでください、番号はまだ続いています」という意味です。長さは128バイト未満なら短形式で1バイト、長形式は最初のバイトが0x80にカウントnを加えたもので、その後にnバイトで長さをビッグエンディアンで格納します。DERは不定長形式(長さバイト0x80)を禁止しています。それを使ったファイルはBERでありDERではありません。厳格なDERパーサーは拒否しなければなりません。
ここに、実際に解いた例で文法のすべてを示します。エクスプローラーの手作りデモと同じ形の、最小の例です。30 0C 02 01 05 06 02 2A 03 0C 03 66 6F 6Fはこう読みます。30は構成型SEQUENCE(汎用タグ16)、0Cは内容が12バイト続くこと、次に02 01 05は長さ1バイト、値5のINTEGER、06 02 2A 03は長さ2バイトのOBJECT IDENTIFIERで、0x2Aは42、42は1×40+2なので最初の2つのアークは1.2、続く03で1.2.3になります。そして0C 03 66 6F 6Fは長さ3バイトのUTF8Stringで「foo」と綴ります。同じ14バイトをopenssl asn1parseで読み返した結果は下のコードブロックにあります。自分で実行し、各行をバイトと照らし合わせてください。この例をたどることができれば、どんな構造でもたどれます。スキーマが求める深さまでネストする、同じ3バイトのリズムです。
証明書を手で読む:tbsCertificateを順番に
証明書は3つのものからなるSEQUENCEです。署名される部分であるtbsCertificate、signatureAlgorithm、そしてBIT STRINGであるsignatureValueです。tbsCertificateの中では、フィールドは常に同じ順序で現れます。version [0](現代の証明書はv3)、serialNumber(INTEGER)、signature(アルゴリズム識別子。外側のものと一致しなければなりません)、issuer(Name)、validity(notBeforeとnotAfterからなるSEQUENCE)、subject(Name)、subjectPublicKeyInfo、そして任意の固有識別子とextensions [3]です。最初のSEQUENCEの中に2つ目のSEQUENCEを見つけられれば、すでにtbsCertificateを見ています。その後は固定順序のフィールドが並ぶだけです。
人々が実際に探すもの——ドメイン名——は、トップレベルのフィールドではまったくありません。SANはextensions [3]の中にあり、OIDは2.5.29.17(subjectAltName)で、GeneralNameのSEQUENCEとして、[2]がDNS名、[7]がIPアドレス、[1]がメール、[6]がURIです。subject内のcommonName(OID 2.5.4.3)は、ブラウザがかつて見ていたレガシーな場所です。現代のブラウザはこれを無視し、代わりにSAN拡張を読みます。そのため、CNが完璧でもSANのない証明書は、すべてのブラウザで失敗します。1枚の証明書のフィールドを平易な言葉で見たい場合はSSL証明書パーサーが抽出します。エクスプローラーは、それぞれがツリーのどこにあるかを示します。
OIDはアドレス帳:2.5.4.3と1.2.840.113549.1.1.11の意味
OID(オブジェクト識別子)は、グローバルな登録ツリーを通るドット区切りのパスであり、ファイルが言葉を使わずにフィールドの意味を示す方法です。最初の2つのアークは1バイトに詰め込まれます。最初のアーク×40+2番目のアークなので、1.2は0x2A、つまり42になり、それ以降のアークはbase-128でエンコードされます。2.5.4.3は、X.500属性タイプ(2.5.4)からcommonName(3)と読みます。あらゆる証明書のsubjectにある名前フィールドです。1.2.840.113549.1.1.11は、ISOメンバー団体(1.2.840)、RSA(113549)、pkcs-1(1)、sha256WithRSAEncryption(11)と読みます。世に出回っているほとんどの証明書の署名アルゴリズムです。
なぜ名前ではなく数字なのか。名前は言語やベンダーによって曖昧ですが、数字は曖昧ではないからです。OIDがあれば、一度も会ったことのない2つの実装でも、あるフィールドが同じ意味だと合意できます。エクスプローラーは、最もよく出会うアーク——X.500属性、RSAとPKCS、楕円曲線、X.509拡張、PKCS#7、OCSP——を解決し、認識できないものにはドット形式を印字します。未知のOIDも、むき出しの数字ではなく、調べられるアドレスのまま残ります。ドット形式のないむき出しの数字は、パーサーが諦めた証拠です。ドット形式は最低限の誠実な出力です。
DER、BER、PEM——手元にあるのは実際どれ?
DERはBERの標準的なサブセットです。BER(基本符号化規則)は選択を許します。長さを短形式か長形式か、不定長を2つのゼロバイトで終えること、基本型を構成型としてエンコードすること。DERはあらゆる選択を固定するため、各値の正しいエンコードは1つだけになります。これこそが要点です。証明書の署名は正確なtbsCertificateバイトを対象としており、同じ値に2つのエンコードが存在すれば、署名は検証できません。PEMはそもそも符号化ではありません。DERバイトのbase64で、周囲に-----BEGIN CERTIFICATE-----のアーマーが付いており、1行64文字で折り返されています。
手元にあるものを見分ける方法は、ファイルを開くことです。-----BEGINで始まればPEMです。アーマーを外し、残りをbase64デコードすればDERが得られます。0x30というバイト(SEQUENCEタグ)で始まればDERかBERです。厳格なパーサーにかけ、長さバイトが0x80ならBERです。ツールが「読み込めません」と言う場合、通常はDERが欲しいツールにPEMを渡したか、その逆です。OpenSSLは両方向に変換できます(openssl x509 -outform DER、または-inform DER)。エクスプローラーはPEM、base64、16進数、生のDERを受け付け、どれを検出したかも教えてくれます。.cerや.crtという拡張子は何も語りません。どちらの符号化もその背後に隠れ得ます。
同じ言語、違う文書:CSR、CRL、PKCS#7、OCSP
TLVのリズムが分かれば、残りは語彙です。CSRはcertificationRequestInfo、signatureAlgorithm、signatureValueからなるSEQUENCEで、証明書と同じ3部構成で、tbsCertificateの位置に要求情報が入ります。CRLはtbsCertList、signatureAlgorithm、signatureValueからなるSEQUENCEで、失効した証明書が中に列挙されます。PKCS#7 / CMS SignedDataバンドルは、OID 1.2.840.113549.1.7.2の下に内容を包み、OCSP応答はBasicOCSPResponseで、証明書ごとに1つのステータスを持ちます。同じバイト、同じネスト規則——変わるのはトップレベルのスキーマだけです。
だからこそ、1つのパーサーがそれらすべてをカバーできます。エクスプローラーはあらゆるDERデータを同じツリーに解析し、トップレベルがどのように見えるかを尋ね、その認識をベストエフォートとして表示します。トップレベルを認識できなくても、ツリー全体を表示し、その旨を伝えます。いずれにせよツリー自体が答えです。そして、解析は検証ではないため、制限をはっきり述べておく価値があります。エクスプローラーは署名を検証せず、信頼ストアに対してチェーンを検証せず、暗号化されたPKCS#12コンテナも開きません。構造が何を言っているかを教えるのであって、それを信頼すべきかどうかを教えるのではありません。証明書と秘密鍵を照合するには証明書と鍵の照合ツールを使ってください。
自分で試してみる:14バイトのDERをOpenSSLで読み返す
# A hand-built ASN.1 value: SEQUENCE { INTEGER 5, OID 1.2.3, UTF8String "foo" }
# 14 bytes of DER:
30 0C 02 01 05 06 02 2A 03 0C 03 66 6F 6F
# Read it back with OpenSSL:
$ printf '\x30\x0c\x02\x01\x05\x06\x02\x2a\x03\x0c\x03\x66\x6f\x6f' > sample.der
$ openssl asn1parse -inform DER -in sample.der
0:d=0 hl=2 l= 12 cons: SEQUENCE
2:d=1 hl=2 l= 1 prim: INTEGER :05
5:d=1 hl=2 l= 2 prim: OBJECT :1.2.3
9:d=1 hl=2 l= 3 prim: UTF8STRING :foo