Comment lire les structures ASN.1 / DER

Savoir lire une structure ASN.1 / DER, c'est savoir lire le langage binaire dans lequel sont écrits tous les certificats, clés privées, CSR et listes de révocation de vos systèmes. ASN.1 est la notation — la grammaire pour décrire les données — et DER, les règles d'encodage distingué, est la seule façon canonique de transformer chaque valeur en octets. Si ces octets vous semblent du bruit, vous n'êtes pas seul : la plupart des administrateurs découvrent ASN.1 par un message d'erreur, longtemps après que le certificat qu'il décrit a déjà cassé quelque chose. Vous pouvez coller n'importe quel blob DER ou PEM dans l'explorateur ASN.1 / DER et obtenir l'arbre complet annoté dans votre navigateur — rien n'est téléversé — mais cet article vous apprend à lire les octets vous-même, pour que l'arbre ne soit jamais une boîte noire.

Un seul langage sous chaque certificat, clé et CSR — et pourquoi il nous fait toujours trébucher

ASN.1, Abstract Syntax Notation One, est la notation ; la série X.680 définit la grammaire et X.690 définit les règles d'encodage, dont DER. Chaque certificat X.509, chaque clé privée PKCS#8, chaque CSR, chaque CRL, chaque paquet PKCS#7 et chaque réponse OCSP est une valeur écrite dans ce langage unique. Les administrateurs trébuchent dessus pour une raison simple : les mêmes octets portent trois déguisements. Un fichier .pem s'ouvre comme du texte lisible, un fichier .der s'imprime comme des déchets, un fichier .cer peut être l'un ou l'autre — et les outils qui montrent la structure ne le font que si on le leur demande, si bien que la plupart des gens regardent dans un certificat pour la première fois après que quelque chose a déjà échoué.

Le deuxième piège, c'est qu'ASN.1 décrit la forme, pas le sens. Deux fichiers peuvent être du DER parfaitement valide et signifier des choses complètement différentes ; le sens vient du schéma — la RFC 5280 pour les certificats — et des OID qu'il contient. Lire DER, c'est donc deux compétences à la fois : analyser le squelette étiquette-longueur-valeur, et savoir quel schéma le niveau supérieur prétend être. Cet article couvre les deux, et l'explorateur automatise la première et étiquette la seconde comme une supposition au mieux, jamais comme un verdict — car un analyseur peut dire ce qu'une structure dit, mais seul le schéma dit ce qu'elle signifie.

TLV : étiquette, longueur, valeur — toute la grammaire en trois octets

Chaque valeur ASN.1 comporte trois parties : une étiquette qui dit ce qu'elle est, une longueur qui dit combien d'octets suivent, et la valeur elle-même. L'octet d'étiquette range trois informations en huit bits : les deux bits supérieurs sont la classe — 00 universelle, 01 application, 10 propre au contexte (les [0] et [3] que l'on voit partout dans les certificats), 11 privée — le bit 6 dit construit (un conteneur qui contient d'autres valeurs) ou primitif (une feuille), et les cinq bits inférieurs sont le numéro d'étiquette, 31 signifiant « continuez à lire, le numéro continue ». La longueur est une forme courte, un octet, pour tout ce qui fait moins de 128 octets, ou une forme longue : un premier octet 0x80 plus un compteur n, puis n octets contenant la longueur en big-endian. DER interdit la forme indéfinie, un octet de longueur 0x80 : un fichier qui l'utilise est du BER, pas du DER, et un analyseur DER strict doit le rejeter.

Voici toute la grammaire dans un exemple détaillé — un exemple minimal construit à la main, de la même forme que la démonstration de l'explorateur. 30 0C 02 01 05 06 02 2A 03 0C 03 66 6F 6F se lit ainsi : 30, un SEQUENCE construit (étiquette universelle 16) ; 0C, douze octets de contenu suivent ; puis 02 01 05, un INTEGER d'un octet valant 5 ; 06 02 2A 03, un OBJECT IDENTIFIER de deux octets, où 0x2A vaut 42, et 42 vaut 1 × 40 + 2, donc les deux premiers arcs sont 1.2, puis 03 donne 1.2.3 ; et 0C 03 66 6F 6F, un UTF8String de trois octets qui épelle « foo ». Les mêmes quatorze octets, relus avec openssl asn1parse, sont imprimés dans le bloc de code ci-dessous — exécutez-le vous-même et faites correspondre chaque ligne avec les octets. Une fois que vous savez parcourir cet exemple, vous savez parcourir n'importe quelle structure : c'est le même rythme de trois octets, imbriqué aussi profondément que le schéma l'exige.

Lire un certificat à la main : tbsCertificate, dans l'ordre

Un certificat est un SEQUENCE de trois choses : tbsCertificate, la partie qui est signée ; signatureAlgorithm ; et signatureValue, un BIT STRING. Dans tbsCertificate, les champs arrivent toujours dans le même ordre — version [0], qui est v3 pour tout certificat moderne ; serialNumber, un INTEGER ; signature, l'identifiant de l'algorithme, qui doit correspondre à celui de l'extérieur ; issuer, un Name ; validity, un SEQUENCE de notBefore et notAfter ; subject, un Name ; subjectPublicKeyInfo ; puis les identifiants uniques facultatifs et les extensions [3]. Si vous arrivez à trouver le deuxième SEQUENCE à l'intérieur du premier, vous regardez déjà le tbsCertificate, et tout ce qui suit n'est que des champs dans un ordre fixe.

La partie que les gens cherchent vraiment — les noms de domaine — n'est pas du tout un champ de niveau supérieur. Les SAN vivent dans extensions [3], sous l'OID 2.5.29.17 (subjectAltName), sous la forme d'un SEQUENCE de GeneralNames étiquetés [2] pour les noms DNS, [7] pour les adresses IP, [1] pour les e-mails et [6] pour les URI. Le commonName, OID 2.5.4.3, du subject est l'endroit hérité où les navigateurs regardaient autrefois ; les navigateurs modernes l'ignorent et lisent l'extension SAN à la place, ce qui explique pourquoi un certificat avec un CN parfait et sans SAN échoue dans tous les navigateurs. Si vous voulez les champs d'un certificat en langage clair, l'analyseur de certificats SSL les extrait ; l'explorateur vous montre où chacun se trouve dans l'arbre.

Les OID sont l'annuaire : ce que signifient 2.5.4.3 et 1.2.840.113549.1.1.11

Un OID, un identifiant d'objet, est un chemin en pointillés à travers un arbre d'enregistrement mondial, et c'est ainsi qu'un fichier dit ce qu'un champ signifie sans utiliser de mots. Les deux premiers arcs sont regroupés dans un seul octet — le premier arc fois quarante plus le deuxième, donc 1.2 devient 0x2A, soit 42 — et les arcs suivants sont encodés en base 128. Lisez 2.5.4.3 comme types d'attributs X.500 (2.5.4) puis commonName (3) : le champ de nom du subject de chaque certificat. Lisez 1.2.840.113549.1.1.11 comme organisme membre ISO (1.2.840), puis RSA (113549), puis pkcs-1 (1), puis sha256WithRSAEncryption (11) — l'algorithme de signature de la plupart des certificats en circulation.

Pourquoi des chiffres plutôt que des noms ? Parce qu'un nom est ambigu d'une langue et d'un fournisseur à l'autre, et qu'un chiffre ne l'est pas : un OID permet à deux implémentations qui ne se sont jamais rencontrées de s'accorder sur le fait qu'un champ signifie la même chose. L'explorateur résout les arcs que l'on rencontre le plus souvent — attributs X.500, RSA et PKCS, courbes elliptiques, extensions X.509, PKCS#7, OCSP — et imprime la forme pointillée de tout ce qu'il ne reconnaît pas, de sorte qu'un OID inconnu reste une adresse que l'on peut chercher plutôt qu'un nombre nu. Un nombre nu sans forme pointillée, c'est un analyseur qui abandonne ; la forme pointillée est le minimum honnête.

DER, BER et PEM : lequel avez-vous vraiment entre les mains ?

DER est le sous-ensemble canonique de BER. BER, les règles d'encodage de base, autorise des choix : une longueur en forme courte ou longue, une longueur indéfinie terminée par deux octets zéro, un type primitif encodé comme construit. DER fige chaque choix, si bien qu'il n'existe qu'une seule codification correcte de chaque valeur — et c'est tout l'enjeu, car la signature d'un certificat couvre les octets exacts de tbsCertificate, et s'il existait deux codifications de la même valeur, la signature ne pourrait pas être vérifiée. PEM n'est pas du tout un encodage : c'est le base64 des octets DER entouré d'une armure -----BEGIN CERTIFICATE-----, avec un retour à la ligne tous les 64 caractères.

Comment savoir ce que vous avez : ouvrez le fichier. S'il commence par -----BEGIN, c'est du PEM — retirez l'armure, décodez en base64 ce qui reste, et vous avez du DER. S'il commence par l'octet 0x30, une étiquette SEQUENCE, c'est du DER ou du BER ; passez-le dans un analyseur strict, et un octet de longueur 0x80 signifie BER. Si un outil dit « impossible à charger », c'est généralement que vous lui avez donné du PEM alors qu'il voulait du DER, ou l'inverse ; OpenSSL convertit dans les deux sens (openssl x509 -outform DER, ou -inform DER), et l'explorateur accepte PEM, base64, hexadécimal ou DER brut et vous dit lequel il a détecté. Une extension .cer ou .crt ne dit rien : l'une ou l'autre des codifications peut se cacher derrière.

Le même langage, des documents différents : CSR, CRL, PKCS#7, OCSP

Une fois le rythme TLV assimilé, le reste n'est que du vocabulaire. Une CSR est un SEQUENCE de certificationRequestInfo, signatureAlgorithm et signatureValue — la même forme en trois parties qu'un certificat, avec les informations de la demande là où se trouve tbsCertificate. Une CRL est un SEQUENCE de tbsCertList, signatureAlgorithm et signatureValue, avec les certificats révoqués listés à l'intérieur. Un paquet PKCS#7 / CMS SignedData enveloppe son contenu sous l'OID 1.2.840.113549.1.7.2, et une réponse OCSP est un BasicOCSPResponse qui porte un statut par certificat. Les mêmes octets, les mêmes règles d'imbrication — seul le schéma de niveau supérieur change.

C'est aussi pour cela qu'un seul analyseur les couvre tous : l'explorateur analyse n'importe quel blob DER dans le même arbre, puis regarde à quoi ressemble le niveau supérieur, et étiquette sa reconnaissance comme une tentative au mieux. S'il ne peut pas reconnaître le niveau supérieur, il montre quand même tout l'arbre et le dit — l'arbre est la réponse dans tous les cas. Et il vaut la peine d'énoncer clairement les limites, car analyser n'est pas vérifier. L'explorateur ne vérifie pas les signatures, ne valide pas une chaîne par rapport à un magasin de confiance et n'ouvre pas les conteneurs PKCS#12 chiffrés. Il dit ce qu'une structure dit, pas si vous devez lui faire confiance. Pour associer un certificat à sa clé privée, utilisez le comparateur de certificats et de clés.

Essayez vous-même : 14 octets de DER, relus avec 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

Sources

Questions fréquentes

J'ai un fichier .pem — c'est du DER ou autre chose ?

C'est du DER déguisé en texte. PEM, c'est du DER encodé en base64 entouré d'une armure -----BEGIN …----- et -----END …-----. Retirez l'armure, décodez en base64 ce qui reste, et vous avez les octets DER bruts. Vous pouvez convertir avec OpenSSL — openssl x509 -in cert.pem -outform DER -out cert.der — ou coller le PEM directement dans l'explorateur ASN.1 / DER, qui détecte l'armure, enregistre l'étiquette (CERTIFICATE, PRIVATE KEY, etc.) et le décode pour vous.

Peut-on modifier un certificat en changeant ses octets ?

On peut changer les octets, mais le résultat ne se vérifiera pas. La signature couvre les octets exacts de tbsCertificate, et DER est canonique — il n'existe qu'une seule codification correcte de chaque valeur. Changez un seul octet du subject ou des dates de validité et la signature ne correspond plus ; ré-encoder la structure doit aussi reproduire les octets d'origine exactement, sinon la vérification échoue. S'il vous faut d'autres informations, émettez un nouveau certificat ; il n'y a pas de modification sur place pour des données signées.

Pourquoi un analyseur strict rejette-t-il un fichier qu'OpenSSL accepte ?

Généralement parce que le fichier est du BER, pas du DER. BER autorise l'encodage à longueur indéfinie — un octet de longueur 0x80, terminé par 00 00 — et d'autres choix que DER interdit ; l'analyseur d'OpenSSL est tolérant et lit le BER sans problème, tandis qu'un analyseur DER strict doit le rejeter. C'est la règle, pas un bug. Autres causes fréquentes : un conteneur PKCS#12 chiffré (.p12 / .pfx), qu'aucun analyseur DER ne peut ouvrir sans le mot de passe, et des octets excédentaires après la valeur de niveau supérieur. L'explorateur nomme la cause au lieu d'échouer en silence.