ÉlémentValeur
NomSIGNATURE (BIND SIGNATURE du document de spécification)
TAG ID0x1E6L
Codec ID0x00001E60
Document de spécification0x00000000/codecs/0x00001E60/ (cible du DECLARE 1E60)
Section15 1111 (Meta), décalage C dans la section = 6
KindMeta · classe : vérification
TAG WORD0001 1110 0110 LLLL (000K KKKC CCCC LLLL)
Description d’indexSignature d’un objet. La signature d’un document porte sur son hachage du contenu (commit ou tag signé de git)
Côté Hugometa/verification/signature.md

Champs (document de spécification)

L’ordre des FIELD dans le document est l’ordre des champs du Payload (document de spécification de Codec).

OrdreChamp (BIND)FIELDLargeurFormat reçu (CODEC)ENUM
1algorithm#2valeur brute 1 WORD0x0001 ed25519
2signer#3enregistrement0400 ISSUER-POINTER
3signature#4valeur brute du reste (0xFFFF)

Signature portant sur le hachage du contenu du document (commit ou tag signé de git).

Disposition

TAG WORD          0001 1110 0110 LLLL      Codec 0x1E6L
[TAG d'extension Length]
ID d'algorithme   1 WORD (0x0001 = Ed25519)
Signataire        Enregistrement Reference ISSUER-POINTER (Issuer)
Signature         Tout le reste. La largeur est fixée par l'algorithme (Ed25519 32 WORD)
  • Codec : Meta 0x1E6L, classe vérification
  • Payload : ID d’algorithme (valeur brute 1 WORD) + signataire (Reference intégrée) + signature (valeur brute, le reste)
  • Nombre : plusieurs possibles

Interprétation et validité

  • L’objet signé est le hachage du contenu. On ne signe pas le BODY seul (signature).
  • Étant de la classe vérification, elle est exclue du hachage du contenu. Ajouter une signature ne change pas le hachage.
  • On vérifie non pas « s’il y a une signature, on contrôle » mais « il doit y avoir la signature d’une clé déterminée ».
  • Le document de liste des versions est signé par l’instance de publication.
  • Le signataire est un ISSUER-POINTER (Issuer) qui désigne l’Issuer lui-même. Comme c’est un enregistrement Reference qui se termine par sa propre Length, la disposition reste unique même si la largeur de la signature varie selon l’algorithme (champ du reste de DECLARE).
  • Si le nombre de WORD de la signature diffère de la largeur fixée par l’algorithme, c’est invalid.

Problèmes ouverts

  • Faut-il signer aussi l’instant de la signature ?

Texte du document de spécification

Voici le document de spécification 0x00000000/codecs/0x00001E60/latest.geul tel que lu par geul show (hexadécimal en majuscules).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001E6000000000
BODY
#1 DECLARE 0x1E60
#2 FIELD #1 0x0001
#3 FIELD #1 record
#11 CODEC #3 0x0400
#4 FIELD #1 rest
#5 ENUM #2 0x0001
#6 BIND #1 "SIGNATURE"
#7 BIND #2 "algorithm"
#8 BIND #3 "signer"
#9 BIND #4 "signature"
#10 BIND #5 "ed25519"