GEUL не собирает систему идентификации в одном месте. Каждый Issuer определяет объекты и форматы, а другие документы берут опубликованные определения. Определения либо держат конфиденциальными, либо публикуют на geul.org (CC0), либо публикуют частным образом (по лицензии, которую задаёт Issuer). Каким определениям доверять, решает пользователь.

Адрес публикации, указание формата, список Issuer, список версий и уровни доверия определяет страница Адрес публикации и список версий.

Что определяет Issuer

ОбъектСпособ
Объекты (сущности, понятия, термины)Объявляются как LOCAL в собственном документе
Формат ReferenceОпределяется 2-WORD номером Codec под кодом Issuer
Формат ValueОпределяется 2-WORD номером Codec под кодом Issuer
Формат EdgeОпределяется 2-WORD номером Codec под кодом Issuer
  • Определения форматов Reference, Value и Edge тоже публикуются как документы.

Принципы

  • Объект, определённый Issuer, — это LOCAL документа, опубликованного этим Issuer. Другие документы цитируют его напрямую указывающим объявлением (EXTERNAL-ISSUER-*) либо импортируют через IMPORT-DOC и указывают через EXTERNAL-POINTER-*. Смысл записи REFERENCE-ISSUER определяет документ Codec, выпущенный Issuer.
  • Для объекта, на который нужно указывать вне документа, выдаётся LOCAL опубликованного документа. У этого документа должен быть DOC-ID.

Классы Issuer

ШиринаДиапазон значенийВыдача
2 WORD0x00000000~0xFFFFFFFFРегистрация на geul.org. Требуется подтверждение владения доменом. Номера, назначенные geul.org организациям-разработчикам стандартов и крупным учреждениям, тоже имеют эту ширину (Таблица назначения 2 WORD)
4 WORD2^32~2^64−1Регистрация на geul.org. Подтверждения владения нет
16 WORD2^64 и вышеСамовыдача. Вычисляется из открытого ключа
  • ID Issuer — целое число. Одинаковое значение означает одного и того же Issuer. Ширина не входит в идентификатор.
  • Длинная запись короткого ID Issuer с ведущими нулями — тот же Issuer (2 → 4, 2 → 16, 4 → 16 WORD). 0x00000001 и 0x0000000000000001 — один Issuer. Поэтому 4-WORD Issuer со значением 0x00000000XXXXXXXX и 16-WORD Issuer, у которого старшие 12 WORD равны 0, не назначаются.
  • Каноническая форма — самая короткая ширина. В записи пишется самая короткая ширина, в которую значение помещается, а запись с более широкой шириной отвергается. Поэтому назначение каждой ширины начинается со значения после конца диапазона ширины ниже. Самая короткая ширина — 2 WORD. В адресе публикации пишется число цифр, соответствующее ширине выдачи (2 WORD — 8 цифр, 4 WORD — 16 цифр, 16 WORD — 64 цифры), в шестнадцатеричных заглавных (адрес, записанный строчными, приводится к заглавным при поиске), а при чтении расширенная запись принимается как тот же Issuer (Адрес публикации и список версий).

Таблица назначения 2 WORD

geul.org назначает номера 2-WORD Issuer организациям-разработчикам стандартов и крупным учреждениям по порядку с начала. Де-факто стандарты и форматы по соглашению, у которых нет организации-разработчика, помещаются под ADHOC (adhoc.geul.org). Собственные форматы, разработанные GEUL, — прямые коды. Issuer организаций-разработчиков стандартов — Issuer поддоменов geul.org. Имя поддомена — имя организации строчными (<имя организации>.geul.org, например iso.geul.org, iec.geul.org). Домены приведены в таблице ниже.

IssuerИмяДоменОрганизацияТипичные форматы
0x00000000GEULgeul.orggeul.orgДокументы спецификации прямых кодов (кодекбук)
0x00000001wikidata.geul.orgwikidata.geul.orggeul.orgДокументы элементов и свойств Викиданных
0x00000002ADHOCadhoc.geul.orggeul.orgФорматы по соглашению без организации-разработчика. BFLOAT16, BLAKE3, комплексные числа, дроби, интервалы, кватернионы, векторы и тензоры
0x00000003ISOiso.geul.orgInternational Organization for StandardizationISO 8601, ISO 4217 (валюты), ISO 3166 (страны)
0x00000004IECiec.geul.orgInternational Electrotechnical CommissionIEC 80000 (обозначения единиц)
0x00000005ISO-IEC-JTC1iso-iec-jtc1.geul.orgISO/IEC Joint Technical Committee 1Стандарты ISO/IEC по информационным технологиям
0x00000006ITU-Titu-t.geul.orgITU Telecommunication Standardization SectorX.509, X.690 (кодирование ASN.1)
0x00000007IETFietf.geul.orgInternet Engineering Task ForceURI (RFC 3986), UUID (RFC 9562), CRC32C, IPv4 и IPv6
0x00000008IANAiana.geul.orgInternet Assigned Numbers AuthorityМедиатипы, реестр языковых подтегов
0x00000009W3Cw3c.geul.orgWorld Wide Web ConsortiumТипы данных XML Schema, RDF
0x0000000AWHATWGwhatwg.geul.orgWeb Hypertext Application Technology Working GroupURL, HTML
0x0000000BUNICODEunicode.geul.orgUnicode ConsortiumКодировки символов, нормализация, CLDR
0x0000000CECMAecma.geul.orgEcma InternationalJSON (ECMA-404)
0x0000000DIEEEieee.geul.orgInstitute of Electrical and Electronics EngineersIEEE 754 с плавающей запятой и decimal, MAC-адрес (802)
0x0000000EKHRONOSkhronos.geul.orgKhronos GroupФорматы пикселей (RGBA8·BGRA8 UNORM), glTF
0x0000000FOGCogc.geul.orgOpen Geospatial ConsortiumКоординаты, ограничивающие рамки, семейство GeoJSON
0x00000010ONNXonnx.geul.orgONNX (LF AI & Data Foundation)FP8 E4M3FN·E4M3FNUZ·E5M2·E5M2FNUZ
0x00000011OCPocp.geul.orgOpen Compute ProjectФорматы Microscaling (E8M0, FP4 E2M1)
0x00000012OASISoasis.geul.orgOASIS OpenСтандарты документов и безопасности
0x00000013BIPMbipm.geul.orgBureau International des Poids et MesuresЕдиницы СИ, TAI
0x00000014IERSiers.geul.orgInternational Earth Rotation and Reference Systems ServiceВисокосная секунда, UTC−TAI
0x00000015NISTnist.geul.orgNational Institute of Standards and TechnologySHA-2 (FIPS 180-4), SHA-3 (FIPS 202)
0x00000016GPSgps.geul.orgПравительственные операторы GPSВремя GPS
0x00000017KATSkats.geul.orgКорейское агентство по технологиям и стандартам (국가기술표준원)Стандарты KS
  • Расширяющие форматы помещаются под Issuer организации, установившей формат. Номера Codec под Issuer определяет каждый Issuer.
  • Номера Codec определяет Issuer. GEUL их смысл не задаёт. Номера Codec не пересекаются внутри Issuer независимо от Kind (Адрес публикации и список версий).
  • Если организация-разработчик стандарта не ведёт номера Codec GEUL сама, geul.org регистрирует стандарты этой организации номерами вместо неё. Номер записывается вместе с идентификатором документа стандарта.
  • Новая организация-разработчик стандарта получает следующий свободный номер.
  • Домен может измениться. Привязка Issuer к домену может измениться позже. ID Issuer не меняется. Когда организация начнёт вести его сама, он заменяется официальным доменом этой организации.
  • Поддомены geul.org — не официальные издатели. Поддомен geul.org с именем организации-разработчика стандартов не является официальным издателем этой организации. Например, iso.geul.org — не официальный издатель ISO.

16-WORD Issuer

Issuer ID = SHA-256("GEUL-ISSUER-v1" ‖ ID алгоритма подписи (2 байта) ‖ открытый ключ)
  • 32 байта результата записываются в 16 WORD, начиная со старшего байта.
  • Любой может создать его без регистрации. Владение доказывается подписью закрытым ключом.
  • Открытый ключ и алгоритм объявляются через ISSUER-KEY в HEAD документа. Алгоритм подписи 0x0001 — Ed25519, остальные значения — Reserved.
  • Префикс GEUL-ISSUER-v1 не допускает получения одинакового ID при использовании одного ключа для разных целей (разделение назначений).
  • Даже если алгоритм подписи изменится (например, Ed25519 → ML-DSA), ширина ID остаётся прежней — 16 WORD.
  • Если результат меньше 2^64 (вероятность практически нулевая), Issuer по этому ключу не создаётся, потому что это пересекается с правилом самой короткой ширины.

Подтверждение домена

  • Подтверждение владения доменом 2-WORD Issuer проверяется только в момент регистрации. Дальнейшее управление доменом — ответственность Issuer.
  • Один домен соответствует только одному Issuer. У одного Issuer может быть несколько доменов. Соответствие записывается через BIND в списке Issuer issuers/ (Адрес публикации и список версий).
  • Даже если срок домена истёк или он перешёл другому владельцу, соответствие остаётся за Issuer, первым подтвердившим его. Новый владелец не может использовать этот домен как имя Issuer.
  • Доменное имя служит для ввода и отображения в интерпретаторе и CLI. Это не URL-адрес публикации (Адрес публикации и список версий). Внутри документов GEUL записывается только ID Issuer.

Документы определения терминов

  • Термины, определённые Issuer (инструменты, программы, роли, понятия внутри организации), заводятся одним документом на один термин. Термин — это LOCAL этого документа, имя связывается через BIND, а указываемый внешний объект (URI и т. п.) — через REFERENCE-NODE.
  • Другие документы указывают на термин через EXTERNAL-ISSUER-* (Issuer, ID документа, LOCAL ID). Одно и то же определение в каждом документе не повторяется. Пример: инструмент в TRANSFORMED-BY.
  • Диапазон ID документов для документов определения терминов задаёт Issuer. geul.org (0x00000000) использует 0x0001xxxx xxxxxxxx.
  • Каждый Issuer резервирует ID документа 0x0000000000000000 и 0xFFFFFFFFFFFFFFFF. Сейчас они применяются двумя способами ниже.
  • ID документа 0x0000000000000000 — место индексного документа определений терминов этого Issuer: <Issuer>/docs/0x0000000000000000/. Это место, где перечисляются документы определения терминов.
  • ID документа 0xFFFFFFFFFFFFFFFF используется для списка Issuer issuers/ у Issuer geul.org (0x00000000). Другие Issuer этот ID не используют. Этот ID ни у какого Issuer не отдаётся по адресу <Issuer>/docs/<ID документа>/ (404) (Адрес публикации и список версий).
  • Индексный документ рекомендуется всем Issuer. Он не обязателен.
  • Порядок указания внешнего объекта: (1) подходящий Reference Codec, если есть (WIKIDATA-QID и др.), (2) GEUL-документ, определяющий этот объект, если есть (DOC-POINTER, EXTERNAL-ISSUER), (3) иначе объект определяется как LOCAL в собственном документе определения терминов и указывается.

Способы раскрытия документов

СпособДля когоЛицензияУправление версиямиСохранность
КонфиденциальноЛюбой IssuerВнутри IssuerIssuerЗависит от Issuer
Публикация на geul.org2-WORD IssuerCC0geul.orggeul.org сохраняет
Частная публикацияЛюбой IssuerЗадаёт IssuerIssuerЗависит от Issuer

Публикация на geul.org

  • 2-WORD Issuer может зарегистрировать документ на geul.org и опубликовать его. Зарегистрированный документ — CC0. Зарегистрированное публикуется сразу, а проблемы решаются постфактум.
  • Публиковать можно определения понятий и Codec. Reference, указывающие на физических лиц, на geul.org публиковать нельзя. Они делаются конфиденциальными или публикуются частным образом.
    • Исключение: указывать на физическое лицо через WIKIDATA-QID разрешено.
  • Зарегистрированная версия не изменяется и не удаляется, и документ остаётся, даже если Issuer исчез (сохранение прежнего закона). Исключения — удаление по закону и удаление по должностному решению (TOMBSTONE).
  • Issuer может только пометить определение рекомендацией об отказе от использования (deprecated). Определение с такой рекомендацией продолжает интерпретироваться.
  • Новая версия того же документа может вводить, изменять и удалять определения (Документ). Удалённые ID сущностей и номера Codec для других объектов повторно не используются. Wire-макет номера Codec не пересматривается.

Частная публикация

  • Issuer, желающий опубликовать документ под лицензией, отличной от CC0, обслуживает документы в частной сети (на собственном домене и т. п.). Лицензия объявляется через LICENSE в HEAD документа.
  • Частная публикация использует те же пути, что и geul.org (Адрес публикации и список версий).
  • Управление версиями, доступность, поддержание домена и условия лицензии определяет Issuer. geul.org не участвует в частной публикации и не гарантирует её.

Конфиденциально

  • Конфиденциальные документы не публикуются. На них ставится контроль доступа, и они помечаются через ACCESS.
  • Если документ, использующий конфиденциальные определения, отправить вовне, принимающая сторона не сможет интерпретировать эти Reference, Value и Edge и пропустит их. Определения, которыми обмениваются с внешним миром, публикуются.

Выбор пользователя

  • Пользователь выбирает документы для использования, исходя из объявленной лицензии и вероятности существования Issuer в будущем.
  • Определения со слишком ограничительной лицензией или от Issuer с ненадёжным существованием использоваться не будут.
  • Для ссылок, которые должны сохраняться долго, используются документы, опубликованные на geul.org.

Подпись

  • Подпись обязательна для опубликованного документа. Она ставится в HEAD как SIGNATURE. Документ без подписи тоже является допустимым документом GEUL, а конфиденциальные и внутренние документы по возможности тоже подписываются.
  • Подписывается хеш содержимого документа (Документ). Подписывается не только BODY.
    • В HEAD есть правила интерпретации. Если изменить цель IMPORT-DOC, тот же BODY будет указывать на другую цель.
    • Если не подписывать LICENSE и PARENT, лицензию и историю можно подделать.
  • В один документ можно поставить несколько подписей. Все они подписывают один и тот же хеш содержимого, поэтому добавление подписи хеш содержимого не меняет.
  • Проверка ключа подписи:
    • 2- и 4-WORD Issuer: ключ, зарегистрированный на geul.org (публикация ключей проверки ниже).
    • 16-WORD Issuer: ISSUER-KEY того же документа. Issuer ID, вычисленный из этого открытого ключа, должен совпадать с подписавшим.
  • Читающая сторона при отсутствии подписи снижает доверие, а если подпись есть, но проверка не прошла, это свидетельство подделки или выдачи себя за другого, и доверие снижается ещё сильнее.
  • Подпись документа ставит Issuer этого документа, а подпись списка версий — публикующая сторона, назначившая ID версии (Адрес публикации и список версий).

Публикация ключей проверки

  • geul.org публикует ключи проверки подписи зарегистрированных Issuer (2- и 4-WORD).
  • Список ключей выпускается как опубликованный документ GEUL Issuer (0x00000000). Он CC0 и подписан geul.org.
    • Элементы: Issuer, ID алгоритма подписи, открытый ключ, момент начала действия, момент отзыва и причина.
  • Отозванные ключи тоже не стираются. Прошлые подписи проверяются ключом, действовавшим в момент подписания.
  • Смена ключа регистрируется подписанием нового ключа старым. Проверяющая сторона может подтвердить непрерывность ключа, не доверяя geul.org.
  • История смены ключей ведётся в журнале, допускающем только добавление (как Certificate Transparency, Go sumdb). Правка истории становится заметной.
  • Если ключ потерян и подписать старым ключом нельзя, geul.org заново подтверждает личность и регистрирует новый ключ. 2-WORD Issuer заново проходит подтверждение владения доменом. В этом случае необходимо доверять geul.org, причина записывается в журнал.
  • 16-WORD Issuer этого не касается. Issuer ID вычисляется из открытого ключа, поэтому проверка выполняется только по ISSUER-KEY внутри документа.

Импорт

IMPORT импортирует только документы.

IMPORT-DOC                      DOC-POINTER (Issuer + ID документа + ID версии) + IMPORT ID
                                для документа Codec — CODEC-POINTER (Issuer + Codec ID + ID версии) + IMPORT ID
EXTERNAL-POINTER-1/2/4WORD      IMPORT ID + LOCAL ID
EXTERNAL-ISSUER-2/4/16WORD      Issuer + ID документа + LOCAL ID (без IMPORT)
ISSUER-POINTER                  Issuer (сам Issuer)
DOC-POINTER                     Issuer + ID документа + ID версии (2 WORD, 0 — последняя)
CODEC-POINTER                   Issuer + Codec ID + ID версии (2 WORD, 0 — последняя)
  • На Issuer любой ширины и его документ можно указать указывающим объявлением без IMPORT. Сам Issuer — ISSUER-POINTER, сам документ — DOC-POINTER, LOCAL документа — EXTERNAL-ISSUER-*. Указывающее объявление следует последней версии, а чтобы зафиксировать версию, используются IMPORT-DOC (ID версии) и EXTERNAL-POINTER-*.
  • Reference в теле, указывающие на объект внешнего документа, используют не полный путь (Issuer + документ + ID объекта), а только IMPORT ID + ID объекта. REFERENCE-ISSUER записывает Issuer и номер Codec.
  • Ширина IMPORT ID определяется в IMPORT-DOC длиной, а в EXTERNAL-POINTER-* — Codec (IMPORT-DOC).
  • Импорт без ID версии следует последней версии. Если ID версии указан, фиксируется эта версия. Опубликованный документ указывает ID версии.

Лицензия

  • Документы, опубликованные на geul.org, и документы GEUL Issuer (0x00000000) — CC0.
  • Лицензию частно опубликованных документов задаёт Issuer. GEUL её не навязывает.
  • Лицензия форматов Issuer. Только прямые коды и публикации, предоставляемые geul.org, — CC0. Лицензию форматов Issuer задаёт этот Issuer.
  • Указание Issuer. GEUL основывает Resolve на указании Issuer. В документах, использующих Codec другого Issuer, этот Issuer указан всегда.
  • Основные продукты GEUL не копируют содержимое документов Issuer, не распространяемых под CC0.

Открытые проблемы

  • Способ подтверждения владения доменом (DNS TXT _geul.<домен>, HTTP .well-known) и вопрос, привязывать ли к значению подтверждения отпечаток ключа подписи.
  • Противодействие захвату домена при восстановлении утерянного ключа. Если регистрировать новый ключ только по повторному подтверждению домена, захватчик может забрать Issuer. Рассматриваются проверка регистрационного контакта, отсрочка с возможностью возражения по старому ключу и применение результата доменного спора.
  • Формат записей индексного документа определений терминов (ID документа 0) (Edge, перечисляющий документы определения терминов).
  • Значение алгоритма подписи по умолчанию (рекомендуется Ed25519).