EintragWert
NameSIGNATURE (Spezifikationsdokument BIND SIGNATURE)
TAG ID0x1E6L
Codec ID0x00001E60
Spezifikationsdokument0x00000000/codecs/0x00001E60/ (DECLARE-Ziel 1E60)
Abschnitt15 1111 (Meta), Offset im Abschnitt C = 6
KindMeta · Klasse: Verifikation
TAG WORD0001 1110 0110 LLLL (000K KKKC CCCC LLLL)
Beschreibung im IndexSignatur über ein Objekt. Die Signatur über ein Dokument signiert den Inhaltshash (git signierte Commits und Tags)
Hugo-Seitemeta/verification/signature.md

Felder (Spezifikationsdokument)

Die Reihenfolge der FIELD im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).

ReihenfolgeFeld (BIND)FIELDBreiteAkzeptiertes Format (CODEC)ENUM
1algorithm#2Rohwert 1 WORD0x0001 ed25519
2signer#3Record0400 ISSUER-POINTER
3signature#4Rest-Rohwert (0xFFFF)

Eine Signatur über den Inhaltshash des Dokuments (git signierte Commits und Tags).

Layout

TAG WORD          0001 1110 0110 LLLL      Codec 0x1E6L
[Length-Erweiterungs-TAG]
Algorithmus-ID    1 WORD (0x0001 = Ed25519)
Unterzeichner     ISSUER-POINTER-(Issuer-)Reference-Record
Signatur          der gesamte Rest. Die Breite bestimmt der Algorithmus (Ed25519 32 WORD)
  • Codec: Meta 0x1E6L, Verifikationsklasse
  • Payload: Algorithmus-ID (Rohwert 1 WORD) + Unterzeichner (eingebettete Reference) + Signatur (Rohwert, Rest)
  • Anzahl: mehrere möglich

Interpretation und Gültigkeit

  • Signiert wird der Inhaltshash. Nicht nur der BODY wird signiert (Signatur).
  • Als Verifikationsklasse fällt es aus dem Inhaltshash heraus. Auch wenn man Signaturen hinzufügt, bleibt der Hash gleich.
  • Geprüft wird nicht „wenn eine Signatur da ist, wird sie kontrolliert“, sondern „es muss eine Signatur des festgelegten Schlüssels vorhanden sein“.
  • Das Versionslisten-Dokument signiert die veröffentlichende Stelle.
  • Der Unterzeichner ist ein ISSUER-POINTER (Issuer), der auf den Issuer selbst verweist. Da es ein Reference-Record ist, der mit seiner eigenen Length endet, steht das Layout auch dann fest, wenn die Signaturbreite je Algorithmus verschieden ist (DECLARE Rest-Feld).
  • Weicht die WORD-Zahl der Signatur von der vom Algorithmus bestimmten Breite ab, ist es invalid.

Offene Probleme

  • Ob der Zeitpunkt der Signatur mitsigniert wird.

Wortlaut des Spezifikationsdokuments

So sieht das Spezifikationsdokument 0x00000000/codecs/0x00001E60/latest.geul aus, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).

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"