ПунктЗначение
ИмяSHA1-DIGEST (BIND в документе спецификации SHA1-DIGEST)
TAG ID0x07DL
Codec ID0x000007D0
Документ спецификации0x00000000/codecs/0x000007D0/ (цель DECLARE 07D0)
Раздел3 0011 (Value), смещение C внутри раздела = 29
KindValue · семейство: BINARY
TAG WORD0000 0111 1101 LLLL (000K KKKC CCCC LLLL)
Описание в индексеРезультат SHA-1, фиксированный Payload 10 WORD. Только для идентификации, например ID объектов git
Сторона Hugovalue/binary/sha1-digest.md

Поля (документ спецификации)

Порядок FIELD в документе — это порядок полей Payload (документ спецификации Codec).

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1digest#2простое значение, 10 WORD

SHA1-DIGEST — Value фиксированной ширины, хранящий результат SHA-1 целиком. Прямой код Value 0x07DL, семейство BINARY. Payload — ровно 10 WORD (160 бит), усечение (truncation) не допускается.

Используется только для идентификации. Устойчивость SHA-1 к коллизиям нарушена (SHAttered, 2017). В качестве основания целостности и подписи используется SHA-256-DIGEST. Этот формат введён, чтобы хранить как есть идентификаторы, уже определённые через SHA-1, прежде всего ID объектов (ID коммитов) репозиториев git на SHA-1. Например, Version (ID коммита) в TRANSFORMED-BY хранится в 11 WORD вместо hex-текста (22 WORD).

Раскладка

TAG WORD          0x07DA (0000 0111 1101 1010)  LLLL=1010
Payload           10 WORD  SHA-1 Digest

Интерпретация и действительность

  • 20 octet Payload читаются в том порядке, в каком их выдаёт SHA-1. В каждом WORD первым идёт старший octet (то же обрамление, что у SHA-256-DIGEST).
  • Если Payload не равен 10 WORD или результат произвольно усечён (сокращённый ID git и т. п.), значение отвергается. Descriptor и padding нет.
  • ID объекта git — это значение в точности так, как его вычислил git. SHA-1 в git — вариант с обнаружением коллизий (SHA-1DC), но на входах, не являющихся коллизионной атакой, результат совпадает с SHA-1.

Основание в стандартах

  • Алгоритм SHA-1 и 160-битный результат соответствуют NIST FIPS 180-4, Secure Hash Standard (SHS).
  • GEUL TAG и обрамление 16-битными WORD — правила, которые добавляет этот формат.

Длина

  • Всего — ровно 11 WORD: TAG 1 WORD и Payload 10 WORD; используется LLLL=1010. Расширения Length нет.

Пример

Коммит git ddc0719974a32aaa7b422ee84221a9721085ce4c:

07DA DDC0 7199 74A3 2AAA 7B42 2EE8 4221 A972 1085 CE4C

Связанные страницы

Исходный текст документа спецификации

Так выглядит документ спецификации 0x00000000/codecs/0x000007D0/latest.geul, прочитанный командой geul show (шестнадцатеричные цифры заглавные).

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000007D000000000
BODY
#1 DECLARE 0x07D0
#2 FIELD #1 0x000A
#3 BIND #1 "SHA1-DIGEST"
#4 BIND #2 "digest"