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 WORD | 0x00000000~0xFFFFFFFF | Регистрация на geul.org. Требуется подтверждение владения доменом. Номера, назначенные geul.org организациям-разработчикам стандартов и крупным учреждениям, тоже имеют эту ширину (Таблица назначения 2 WORD) |
| 4 WORD | 2^32~2^64−1 | Регистрация на geul.org. Подтверждения владения нет |
| 16 WORD | 2^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 | Имя | Домен | Организация | Типичные форматы |
|---|---|---|---|---|
0x00000000 | GEUL | geul.org | geul.org | Документы спецификации прямых кодов (кодекбук) |
0x00000001 | wikidata.geul.org | wikidata.geul.org | geul.org | Документы элементов и свойств Викиданных |
0x00000002 | ADHOC | adhoc.geul.org | geul.org | Форматы по соглашению без организации-разработчика. BFLOAT16, BLAKE3, комплексные числа, дроби, интервалы, кватернионы, векторы и тензоры |
0x00000003 | ISO | iso.geul.org | International Organization for Standardization | ISO 8601, ISO 4217 (валюты), ISO 3166 (страны) |
0x00000004 | IEC | iec.geul.org | International Electrotechnical Commission | IEC 80000 (обозначения единиц) |
0x00000005 | ISO-IEC-JTC1 | iso-iec-jtc1.geul.org | ISO/IEC Joint Technical Committee 1 | Стандарты ISO/IEC по информационным технологиям |
0x00000006 | ITU-T | itu-t.geul.org | ITU Telecommunication Standardization Sector | X.509, X.690 (кодирование ASN.1) |
0x00000007 | IETF | ietf.geul.org | Internet Engineering Task Force | URI (RFC 3986), UUID (RFC 9562), CRC32C, IPv4 и IPv6 |
0x00000008 | IANA | iana.geul.org | Internet Assigned Numbers Authority | Медиатипы, реестр языковых подтегов |
0x00000009 | W3C | w3c.geul.org | World Wide Web Consortium | Типы данных XML Schema, RDF |
0x0000000A | WHATWG | whatwg.geul.org | Web Hypertext Application Technology Working Group | URL, HTML |
0x0000000B | UNICODE | unicode.geul.org | Unicode Consortium | Кодировки символов, нормализация, CLDR |
0x0000000C | ECMA | ecma.geul.org | Ecma International | JSON (ECMA-404) |
0x0000000D | IEEE | ieee.geul.org | Institute of Electrical and Electronics Engineers | IEEE 754 с плавающей запятой и decimal, MAC-адрес (802) |
0x0000000E | KHRONOS | khronos.geul.org | Khronos Group | Форматы пикселей (RGBA8·BGRA8 UNORM), glTF |
0x0000000F | OGC | ogc.geul.org | Open Geospatial Consortium | Координаты, ограничивающие рамки, семейство GeoJSON |
0x00000010 | ONNX | onnx.geul.org | ONNX (LF AI & Data Foundation) | FP8 E4M3FN·E4M3FNUZ·E5M2·E5M2FNUZ |
0x00000011 | OCP | ocp.geul.org | Open Compute Project | Форматы Microscaling (E8M0, FP4 E2M1) |
0x00000012 | OASIS | oasis.geul.org | OASIS Open | Стандарты документов и безопасности |
0x00000013 | BIPM | bipm.geul.org | Bureau International des Poids et Mesures | Единицы СИ, TAI |
0x00000014 | IERS | iers.geul.org | International Earth Rotation and Reference Systems Service | Високосная секунда, UTC−TAI |
0x00000015 | NIST | nist.geul.org | National Institute of Standards and Technology | SHA-2 (FIPS 180-4), SHA-3 (FIPS 202) |
0x00000016 | GPS | gps.geul.org | Правительственные операторы GPS | Время GPS |
0x00000017 | KATS | kats.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используется для списка Issuerissuers/у 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 | Внутри Issuer | Issuer | Зависит от Issuer |
| Публикация на geul.org | 2-WORD Issuer | CC0 | geul.org | geul.org сохраняет |
| Частная публикация | Любой Issuer | Задаёт Issuer | Issuer | Зависит от 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, лицензию и историю можно подделать.
- В HEAD есть правила интерпретации. Если изменить цель
- В один документ можно поставить несколько подписей. Все они подписывают один и тот же хеш содержимого, поэтому добавление подписи хеш содержимого не меняет.
- Проверка ключа подписи:
- 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).