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

出典

よくある質問

.pemファイルを持っています——DERですか、それとも別のものですか?

テキストの衣装を着たDERです。PEMはbase64エンコードされたDERで、周囲に-----BEGIN …-----と-----END …-----のアーマーがあります。アーマーを外し、残りをbase64デコードすれば、生のDERバイトが得られます。OpenSSLで変換できます——openssl x509 -in cert.pem -outform DER -out cert.der——。あるいはPEMをそのままASN.1 / DER エクスプローラーに貼り付けてください。アーマーを検出し、ラベル(CERTIFICATE、PRIVATE KEYなど)を記録して、デコードしてくれます。

バイトを変更して証明書を編集できますか?

バイトを変更することはできますが、結果は検証されません。署名は正確なtbsCertificateバイトを対象としており、DERは標準的です。各値の正しいエンコードは1つだけです。subjectや有効期限の1バイトでも変更すれば、署名は一致しなくなります。構造を再エンコードする場合も、元のバイトを正確に再現しなければならず、そうでなければ検証は失敗します。異なる情報が必要なら、新しい証明書を発行してください。署名済みデータをその場で編集する方法はありません。

OpenSSLが受け入れるファイルを、厳格なパーサーが拒否するのはなぜですか?

通常、そのファイルがDERではなくBERだからです。BERは不定長エンコーディング——長さバイト0x80で、00 00で終わるもの——や、DERが禁止する他の選択を許します。OpenSSLのパーサーは寛容で、BERを問題なく読みますが、厳格なDERパーサーは拒否しなければなりません。これは規則であり、バグではありません。その他の一般的な原因としては、暗号化されたPKCS#12(.p12 / .pfx)コンテナ(パスワードなしではどのDERパーサーも開けません)や、トップレベルの値の後に残っている余分なバイトがあります。エクスプローラーは、黙って失敗するのではなく原因を名指しします。