ASN.1- / DER-Strukturen lesen
Zuletzt aktualisiert:
ASN.1- / DER-Strukturen zu lesen heißt, die Binärsprache zu lesen, in der jedes Zertifikat, jeder private Schlüssel, jede CSR und jede Sperrliste auf Ihren Systemen geschrieben ist. ASN.1 ist die Notation — die Grammatik zur Beschreibung von Daten — und DER, die Distinguished Encoding Rules, ist die eine kanonische Art, jeden Wert in Bytes zu verwandeln. Wenn diese Bytes für Sie wie Rauschen aussehen, sind Sie nicht allein: Die meisten Admins lernen ASN.1 durch eine Fehlermeldung kennen, lange nachdem das Zertifikat, das sie beschreibt, schon etwas kaputt gemacht hat. Sie können jeden DER- oder PEM-Blob in den ASN.1- / DER-Explorer einfügen und erhalten den vollständig annotierten Baum in Ihrem Browser — nichts wird hochgeladen — aber dieser Artikel lehrt Sie, die Bytes selbst zu lesen, damit der Baum nie eine Blackbox ist.
Eine Sprache unter jedem Zertifikat, Schlüssel und CSR — und warum man immer wieder darüber stolpert
ASN.1, Abstract Syntax Notation One, ist die Notation; die X.680-Reihe definiert die Grammatik und X.690 die Kodierungsregeln, darunter DER. Jedes X.509-Zertifikat, jeder private PKCS#8-Schlüssel, jede CSR, jede CRL, jedes PKCS#7-Paket und jede OCSP-Antwort ist ein Wert in dieser einen Sprache. Admins stolpern immer wieder darüber, aus einem einfachen Grund: Dieselben Bytes tragen drei Kostüme. Eine .pem-Datei öffnet sich als lesbarer Text, eine .der-Datei druckt sich als Müll, eine .cer-Datei kann beides sein — und die Werkzeuge, die die Struktur zeigen, tun das nur auf Nachfrage, sodass die meisten Menschen erst dann in ein Zertifikat schauen, wenn schon etwas schiefgegangen ist.
Die zweite Stolperfalle: ASN.1 beschreibt die Form, nicht die Bedeutung. Zwei Dateien können beide perfekt gültiges DER sein und völlig verschiedene Dinge bedeuten; die Bedeutung kommt aus dem Schema — RFC 5280 für Zertifikate — und aus den OIDs darin. DER zu lesen sind also zwei Fähigkeiten zugleich: das Tag-Length-Value-Gerüst zu parsen und zu wissen, welches Schema die oberste Ebene zu sein behauptet. Dieser Artikel behandelt beides, und der Explorer automatisiert das erste und kennzeichnet das zweite als Best-Effort-Vermutung, niemals als Urteil — denn ein Parser kann sagen, was eine Struktur aussagt, aber nur das Schema sagt, was sie bedeutet.
TLV: Tag, Länge, Wert — die ganze Grammatik in drei Bytes
Jeder ASN.1-Wert besteht aus drei Teilen: einem Tag, der sagt, was er ist, einer Länge, die sagt, wie viele Bytes folgen, und dem Wert selbst. Das Tag-Byte packt drei Fakten in acht Bits: Die obersten zwei Bits sind die Klasse — 00 universell, 01 Anwendung, 10 kontextspezifisch (die [0] und [3], die man überall in Zertifikaten sieht), 11 privat — Bit 6 sagt konstruiert (ein Container, der andere Werte hält) oder primitiv (ein Blatt), und die unteren fünf Bits sind die Tagnummer, wobei 31 heißt: „lies weiter, die Nummer geht weiter". Die Länge ist eine Kurzform, ein Byte, für alles unter 128 Bytes, oder eine Langform: ein erstes Byte 0x80 plus eine Zählung n, dann n Bytes mit der Länge in Big-Endian. DER verbietet die unbestimmte Form, ein Längenbyte 0x80 — eine Datei, die sie benutzt, ist BER, nicht DER, und ein strenger DER-Parser muss sie ablehnen.
Hier ist die ganze Grammatik in einem durchgearbeiteten Beispiel — einem minimalen handgebauten Beispiel in derselben Form wie das Demo des Explorers. 30 0C 02 01 05 06 02 2A 03 0C 03 66 6F 6F liest sich so: 30, ein konstruiertes SEQUENCE (universeller Tag 16); 0C, zwölf Inhaltsbytes folgen; dann 02 01 05, ein INTEGER, ein Byte lang, mit dem Wert 5; 06 02 2A 03, ein OBJECT IDENTIFIER, zwei Bytes lang, wobei 0x2A 42 ist und 42 gleich 1 × 40 + 2, also sind die ersten beiden Bögen 1.2, und dann ergibt 03 die 1.2.3; und 0C 03 66 6F 6F, ein UTF8String, drei Bytes lang, der „foo" buchstabiert. Dieselben vierzehn Bytes, mit openssl asn1parse zurückgelesen, stehen im Codeblock unten — führen Sie ihn selbst aus und gleichen Sie jede Zeile mit den Bytes ab. Wer dieses Beispiel durchgehen kann, kann jede Struktur durchgehen: Es ist derselbe Drei-Byte-Rhythmus, so tief verschachtelt, wie das Schema es verlangt.
Ein Zertifikat von Hand lesen: tbsCertificate, der Reihe nach
Ein Zertifikat ist ein SEQUENCE aus drei Dingen: tbsCertificate, dem Teil, der signiert wird; signatureAlgorithm; und signatureValue, ein BIT STRING. Innerhalb von tbsCertificate kommen die Felder immer in derselben Reihenfolge — version [0], bei jedem modernen Zertifikat v3; serialNumber, ein INTEGER; signature, die Algorithmuskennung, die mit der äußeren übereinstimmen muss; issuer, ein Name; validity, ein SEQUENCE aus notBefore und notAfter; subject, ein Name; subjectPublicKeyInfo; und dann die optionalen eindeutigen Kennungen und extensions [3]. Wer das zweite SEQUENCE innerhalb des ersten findet, schaut bereits auf das tbsCertificate, und alles danach sind nur Felder in fester Reihenfolge.
Der Teil, nach dem die Leute wirklich suchen — die Domainnamen — ist überhaupt kein Feld der obersten Ebene. SANs stecken in extensions [3], unter der OID 2.5.29.17 (subjectAltName), als SEQUENCE von GeneralNames mit [2] für DNS-Namen, [7] für IP-Adressen, [1] für E-Mail und [6] für URIs. Der commonName, OID 2.5.4.3, im Subject ist die alte Stelle, an der Browser früher nachgesehen haben; moderne Browser ignorieren ihn und lesen stattdessen die SAN-Erweiterung — weshalb ein Zertifikat mit perfektem CN und ohne SAN in jedem Browser scheitert. Wer die Felder eines Zertifikats in einfacher Sprache sehen will, nimmt den SSL-Zertifikats-Parser; der Explorer zeigt, wo jedes Feld im Baum sitzt.
OIDs sind das Adressbuch: was 2.5.4.3 und 1.2.840.113549.1.1.11 bedeuten
Eine OID, ein Objektidentifikator, ist ein gepunkteter Pfad durch einen globalen Registrierungsbaum, und so sagt eine Datei ohne Worte, was ein Feld bedeutet. Die ersten beiden Bögen werden in ein einziges Byte gepackt — Bogen eins mal vierzig plus Bogen zwei, also wird 1.2 zu 0x2A, 42 — und spätere Bögen werden base-128 kodiert. Lesen Sie 2.5.4.3 als X.500-Attributtypen (2.5.4) und dann commonName (3): das Namensfeld im Subject jedes Zertifikats. Lesen Sie 1.2.840.113549.1.1.11 als ISO-Member-Body (1.2.840), dann RSA (113549), dann pkcs-1 (1), dann sha256WithRSAEncryption (11) — der Signaturalgorithmus der meisten Zertifikate in freier Wildbahn.
Warum Zahlen statt Namen? Weil ein Name über Sprachen und Anbieter hinweg mehrdeutig ist und eine Zahl nicht: Eine OID lässt zwei Implementierungen, die sich nie begegnet sind, darin übereinstimmen, dass ein Feld dasselbe bedeutet. Der Explorer löst die Bögen auf, denen man am häufigsten begegnet — X.500-Attribute, RSA und PKCS, elliptische Kurven, X.509-Erweiterungen, PKCS#7, OCSP — und druckt für alles, was er nicht erkennt, die gepunktete Form, sodass eine unbekannte OID weiterhin eine Adresse bleibt, die man nachschlagen kann, statt einer nackten Zahl. Eine nackte Zahl ohne gepunktete Form ist ein Parser, der aufgibt; die gepunktete Form ist das Minimum an Ehrlichkeit.
DER vs. BER vs. PEM: Was haben Sie wirklich in der Hand?
DER ist die kanonische Teilmenge von BER. BER, die Basic Encoding Rules, lässt Wahlmöglichkeiten: eine Länge in Kurz- oder Langform, eine unbestimmte Länge, die mit zwei Nullbytes endet, ein primitiver Typ, der als konstruiert kodiert ist. DER nagelt jede Wahl fest, sodass es genau eine korrekte Kodierung jedes Werts gibt — und das ist der ganze Punkt, denn die Signatur eines Zertifikats deckt die exakten tbsCertificate-Bytes ab, und gäbe es zwei Kodierungen desselben Werts, ließe sich die Signatur nicht prüfen. PEM ist überhaupt keine Kodierung: Es ist Base64 der DER-Bytes mit einer -----BEGIN CERTIFICATE------Rüstung darum, umgebrochen bei 64 Zeichen pro Zeile.
Wie man erkennt, was man hat: Öffnen Sie die Datei. Beginnt sie mit -----BEGIN, ist es PEM — Rüstung entfernen, den Rest Base64-dekodieren, und man hat DER. Beginnt sie mit dem Byte 0x30, einem SEQUENCE-Tag, ist es DER oder BER; ein strenger Parser zeigt es, und ein Längenbyte 0x80 bedeutet BER. Wenn ein Werkzeug „kann nicht geladen werden" sagt, heißt das meist, dass man ihm PEM gab, als es DER wollte, oder umgekehrt; OpenSSL konvertiert in beide Richtungen (openssl x509 -outform DER oder -inform DER), und der Explorer akzeptiert PEM, Base64, Hex oder rohes DER und sagt, was er erkannt hat. Eine Endung .cer oder .crt sagt gar nichts — beide Kodierungen können dahinterstecken.
Dieselbe Sprache, andere Dokumente: CSR, CRL, PKCS#7, OCSP
Sobald der TLV-Rhythmus sitzt, ist der Rest Vokabular. Eine CSR ist ein SEQUENCE aus certificationRequestInfo, signatureAlgorithm und signatureValue — dieselbe dreiteilige Form wie ein Zertifikat, wobei die Antragsinformationen dort sitzen, wo tbsCertificate sitzt. Eine CRL ist ein SEQUENCE aus tbsCertList, signatureAlgorithm und signatureValue, mit den gesperrten Zertifikaten darin aufgelistet. Ein PKCS#7- / CMS-SignedData-Paket packt seinen Inhalt unter die OID 1.2.840.113549.1.7.2, und eine OCSP-Antwort ist eine BasicOCSPResponse mit einem Status pro Zertifikat. Dieselben Bytes, dieselben Verschachtelungsregeln — nur das Schema der obersten Ebene ändert sich.
Darum deckt auch ein einziger Parser sie alle ab: Der Explorer parst jeden DER-Blob in denselben Baum und fragt dann, wie die oberste Ebene aussieht, und kennzeichnet seine Erkennung als Best-Effort. Kann er die oberste Ebene nicht erkennen, zeigt er trotzdem den ganzen Baum und sagt das auch — der Baum ist so oder so die Antwort. Und die Grenzen sollte man klar benennen, denn Parsen ist nicht Verifizieren. Der Explorer prüft keine Signaturen, validiert keine Kette gegen einen Trust-Store und öffnet keine verschlüsselten PKCS#12-Container. Er sagt, was eine Struktur aussagt, nicht ob man ihr vertrauen soll. Um ein Zertifikat mit seinem privaten Schlüssel zusammenzuführen, nehmen Sie den Zertifikats- und Schlüssel-Abgleicher.
Selbst ausprobieren: 14 Bytes DER, mit OpenSSL zurückgelesen
# 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