GEUL אינה מרכזת את מערכת הזיהוי במקום אחד. כל Issuer מגדיר פריטים ופורמטים, ומסמכים אחרים לוקחים את ההגדרות שפורסמו וכך משתמשים בהן. את ההגדרות אפשר לשמור חסויות, או לפרסם ב-geul.org (CC0) או בפרסום פרטי (ברישיון שה-Issuer קובע). באילו הגדרות לסמוך ולהשתמש מחליט המשתמש.

כתובות פרסום, ציון פורמט, רשימת Issuer, רשימת גרסאות ושכבות אמון נקבעים ב-כתובות פרסום ורשימת גרסאות.

מה ש-Issuer מגדיר

יעדשיטה
פריט (ישות, מושג, מונח)מצהירים עליו כ-LOCAL של המסמך שלו
פורמט Referenceמוגדר במספר Codec של 2 WORD תחת קוד ה-Issuer
פורמט Valueמוגדר במספר Codec של 2 WORD תחת קוד ה-Issuer
פורמט Edgeמוגדר במספר Codec של 2 WORD תחת קוד ה-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 ומעלההנפקה עצמית. מחושב ממפתח ציבורי
  • Issuer ID הוא ערך שלם. ערך זהה פירושו אותו Issuer. הרוחב אינו חלק מהמזהה.
  • ייצוג ארוך של Issuer ID קצר עם אפסים מובילים הוא אותו Issuer (2 ← 4, 2 ← 16, 4 ← 16 WORD). 0x00000001 ו-0x0000000000000001 הם אותו Issuer. לכן לא מקצים כ-Issuer של 4 WORD את 0x00000000XXXXXXXX, וכ-Issuer של 16 WORD לא מקצים ערך ש-12 ה-WORD העליונים בו אפס.
  • הצורה הקנונית היא הרוחב הקצר ביותר. ברשומה כותבים ברוחב הקצר ביותר שהערך נכנס בו, וייצוג ברוחב רחב יותר נדחה. לכן הקצאה בכל רוחב מתחילה מהערך שאחרי סוף הטווח של הרוחב שמתחתיו. 2 WORD הוא הרוחב הקצר ביותר. בכתובת פרסום כותבים במספר הספרות של רוחב ההנפקה (8 ספרות ל-2 WORD, 16 ל-4 WORD, 64 ל-16 WORD) ובאותיות hex גדולות (גם כתובת שנכתבה באותיות קטנות מומרת לגדולות לפני החיפוש), ובקריאה מקבלים גם ייצוג מורחב כאותו Issuer (כתובות פרסום ורשימת גרסאות).

טבלת הקצאות 2 WORD

geul.org מקצה מספרי Issuer של 2 WORD לגופי תקינה ולמוסדות מרכזיים לפי הסדר מההתחלה. פורמטים שהם תקן דה פקטו או מקובלים ואין להם גוף תקינה ממוקמים תחת ADHOC (adhoc.geul.org). פורמט ייחודי ש-GEUL תכננה הוא קוד ישיר. ה-Issuer של גוף תקינה הוא Issuer של תת-דומיין של geul.org. שם תת-הדומיין הוא שם המוסד באותיות קטנות (<שם המוסד>.geul.org, למשל iso.geul.org, iec.geul.org). הדומיין נרשם בטבלה שלהלן.

Issuerשםדומייןגוףפורמטים מייצגים
0x00000000GEULgeul.orggeul.orgמסמכי מפרט של קוד ישיר (codebook)
0x00000001wikidata.geul.orgwikidata.geul.orggeul.orgמסמכי פריטים ומאפיינים של Wikidata
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יחידות SI, 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 לדומיין עשוי להשתנות בהמשך. Issuer ID אינו משתנה. כשהמוסד מתחיל לנהל זאת בעצמו, מחליפים לדומיין הרשמי של המוסד.
  • תת-דומיין של geul.org אינו גוף פרסום רשמי. תת-דומיין של geul.org הנושא שם גוף תקינה אינו גוף הפרסום הרשמי של אותו גוף. לדוגמה, iso.geul.org אינו גוף הפרסום הרשמי של ISO.

Issuer של 16 WORD

Issuer ID = SHA-256("GEUL-ISSUER-v1" ‖ מזהה אלגוריתם חתימה (2 בייט) ‖ מפתח ציבורי)
  • 32 הבייטים של התוצאה נכתבים ל-16 WORD מהבייט העליון.
  • כל אחד יכול ליצור אותו ללא רישום. הבעלות מוכחת בחתימת המפתח הפרטי.
  • המפתח הציבורי והאלגוריתם מוצהרים ב-ISSUER-KEY ב-HEAD של המסמך. אלגוריתם חתימה 0x0001 הוא Ed25519, וערכים אחרים הם Reserved.
  • התחילית GEUL-ISSUER-v1 מבטיחה שלא ייווצר אותו ID כשמשתמשים באותו מפתח לשימוש אחר (הפרדת שימושים).
  • גם כשאלגוריתם החתימה משתנה (למשל Ed25519 ← ML-DSA) רוחב ה-ID נשאר 16 WORD.
  • אם התוצאה קטנה מ-2^64 (ההסתברות כמעט אפס), לא יוצרים Issuer מהמפתח הזה. הסיבה היא שהוא מתנגש בכלל הרוחב הקצר ביותר.

הוכחת דומיין

  • הוכחת הבעלות על דומיין של Issuer ב-2 WORD נבדקת רק בעת הרישום. לאחר מכן ניהול הדומיין הוא באחריות ה-Issuer.
  • דומיין אחד מתאים ל-Issuer אחד בלבד. ל-Issuer אחד יכולים להיות כמה דומיינים. ההתאמה נרשמת ב-BIND ברשימת ה-Issuer issuers/ (כתובות פרסום ורשימת גרסאות).
  • גם אם הדומיין פג או עובר לאחר, ההתאמה נשארת עם ה-Issuer שהוכיח אותו ראשון. הבעלים החדש אינו יכול להשתמש בדומיין כשם Issuer.
  • שם הדומיין נועד לקלט ולתצוגה במפרש וב-CLI. הוא אינו כתובת URL של פרסום (כתובות פרסום ורשימת גרסאות). במסמך GEUL כותבים רק את Issuer ID.

מסמך הגדרת מונח

  • מונח ש-Issuer הגדיר (כלי, תוכנה, תפקיד, מושג בתוך ארגון) מוצב במסמך אחד לכל מונח. המונח הוא LOCAL של המסמך, שמו מקושר ב-BIND, ופריט חיצוני שהוא מצביע עליו (URI וכדומה) מחובר ב-REFERENCE-NODE.
  • מסמכים אחרים מצביעים על המונח באמצעות EXTERNAL-ISSUER-* (Issuer, מזהה מסמך, LOCAL ID). אין לחזור על אותה הגדרה בכל מסמך. דוגמה: הכלי ב-TRANSFORMED-BY.
  • טווח מזהי המסמך של מסמכי הגדרת מונחים נקבע בידי ה-Issuer. geul.org (0x00000000) משתמש ב-0x0001xxxx xxxxxxxx.
  • כל Issuer שומר את מזהי המסמך 0x0000000000000000 ו-0xFFFFFFFFFFFFFFFF. השימוש כיום הוא שני אלה.
  • מזהה מסמך 0x0000000000000000 הוא מקום מסמך אינדקס הגדרות המונחים של אותו Issuer: <Issuer>/docs/0x0000000000000000/. זהו המקום שמונה את מסמכי הגדרת המונחים.
  • מזהה מסמך 0xFFFFFFFFFFFFFFFF משמש ברשימת ה-Issuer issuers/ של ה-Issuer geul.org (0x00000000). Issuer אחר אינו משתמש במזהה זה. את המזהה הזה לא מקבלים בכתובת <Issuer>/docs/<מזהה מסמך>/ באף Issuer (404) (כתובות פרסום ורשימת גרסאות).
  • מסמך אינדקס מומלץ לכל Issuer. אינו חובה.
  • סדר ההצבעה על פריט חיצוני: (1) אם יש Reference Codec מתאים, משתמשים בו (WIKIDATA-QID וכדומה), (2) אם יש מסמך GEUL שהגדיר את הפריט, משתמשים בו (DOC-POINTER·EXTERNAL-ISSUER), (3) אם אין, מגדירים אותו כ-LOCAL במסמך הגדרת המונחים של עצמך ומצביעים עליו.

אופן חשיפת מסמכים

אופןיעדרישיוןניהול גרסאותקיום
חסויכל Issuerפנימי ל-IssuerIssuerתלוי ב-Issuer
פרסום ב-geul.orgIssuer של 2 WORDCC0geul.orggeul.org משמר
פרסום פרטיכל Issuerה-Issuer קובעIssuerתלוי ב-Issuer

פרסום ב-geul.org

  • Issuer של 2 WORD יכול לרשום מסמכים ב-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 תקף, וגם מסמכים חסויים ופנימיים חותמים אם אפשר.
  • מה שנחתם הוא hash התוכן של המסמך (מסמך). לא חותמים על ה-BODY בלבד.
    • ב-HEAD יש כללי פירוש. אם משנים את היעד של IMPORT-DOC, אותו BODY מצביע על יעד אחר.
    • אם LICENSE ו-PARENT אינם נחתמים, אפשר לזייף את הרישיון וההיסטוריה.
  • אפשר להציב כמה חתימות במסמך אחד. כולן חותמות על אותו hash תוכן, ולכן הוספת חתימה אינה משנה את hash התוכן.
  • אימות מפתח החתימה:
    • Issuer של 2·4 WORD: המפתח שנרשם ב-geul.org (פרסום מפתחות האימות להלן).
    • Issuer של 16 WORD: ה-ISSUER-KEY באותו מסמך. ה-Issuer ID שמחושב מהמפתח הציבורי חייב להיות זהה לחותם.
  • הצד הקורא מוריד את רמת האמינות אם אין חתימה, ומורידה עוד יותר אם יש חתימה ואימותה נכשל, כי זו ראיה לזיוף או התחזות.
  • חתימת מסמך נעשית בידי ה-Issuer של המסמך, וחתימת רשימת גרסאות נעשית בידי גוף הפרסום שהקצה את מזהי הגרסה (כתובות פרסום ורשימת גרסאות).

פרסום מפתחות אימות

  • geul.org מפרסמת את מפתחות אימות החתימה של Issuer רשומים (2·4 WORD).
  • רשימת המפתחות יוצאת כמסמך מפורסם של ה-Issuer GEUL (0x00000000). היא CC0 ו-geul.org חותמת עליה.
    • פריטים: Issuer, מזהה אלגוריתם חתימה, מפתח ציבורי, זמן תחילת תוקף, זמן ביטול וסיבה.
  • גם מפתח שבוטל אינו נמחק. חתימה מהעבר מאומתת במפתח שהיה תקף בזמן החתימה.
  • החלפת מפתח נעשית בחתימת המפתח החדש במפתח הישן ורישומו. הצד המאמת יכול לבדוק את רציפות המפתחות גם בלי לסמוך על geul.org.
  • רישום שינויי המפתחות נשמר ביומן שאפשר רק להוסיף לו (Certificate Transparency, באותו אופן כמו Go sumdb). שינוי ההיסטוריה ייחשף.
  • אם איבדו את המפתח ואי אפשר לחתום במפתח הישן, geul.org מאמתת את הזהות מחדש ורושמת מפתח חדש. Issuer של 2 WORD עובר שוב הוכחת בעלות על דומיין. במקרה זה חייבים לסמוך על geul.org, והסיבה נרשמת ביומן.
  • אינו חל על Issuer של 16 WORD. מכיוון שה-Issuer ID מחושב מהמפתח הציבורי, מאמתים רק באמצעות ISSUER-KEY שבתוך המסמך.

ייבוא

IMPORT מייבא מסמכים בלבד.

IMPORT-DOC                      DOC-POINTER(Issuer + מזהה מסמך + מזהה גרסה) + IMPORT ID
                                מסמך Codec: CODEC-POINTER(Issuer + Codec ID + מזהה גרסה) + IMPORT ID
EXTERNAL-POINTER-1/2/4WORD      IMPORT ID + LOCAL ID
EXTERNAL-ISSUER-2/4/16WORD      Issuer + מזהה מסמך + LOCAL ID (ללא IMPORT)
ISSUER-POINTER                  Issuer (ה-Issuer עצמו)
DOC-POINTER                     Issuer + מזהה מסמך + מזהה גרסה (2 WORD, 0 = האחרונה)
CODEC-POINTER                   Issuer + Codec ID + מזהה גרסה (2 WORD, 0 = האחרונה)
  • אפשר להצביע על Issuer בכל רוחב ועל מסמכיו בהצהרה מצביעה ללא IMPORT. ה-Issuer עצמו הוא ISSUER-POINTER, המסמך עצמו הוא DOC-POINTER, וה-LOCAL של המסמך הוא EXTERNAL-ISSUER-*. הצהרה מצביעה עוקבת אחר הגרסה האחרונה, ולנעילת גרסה משתמשים ב-IMPORT-DOC (מזהה גרסה) וב-EXTERNAL-POINTER-*.
  • Reference בגוף המסמך המצביע על פריט במסמך חיצוני משתמש רק ב-IMPORT ID + ID של הפריט, במקום בנתיב המלא (Issuer + מסמך + ID של הפריט). REFERENCE-ISSUER רושם Issuer ומספר Codec.
  • רוחב ה-IMPORT ID נקבע ב-IMPORT-DOC לפי האורך וב-EXTERNAL-POINTER-* לפי ה-Codec (IMPORT-DOC).
  • ייבוא בלי מזהה גרסה עוקב אחר הגרסה האחרונה. כשכותבים מזהה גרסה, הייבוא ננעל לגרסה זו. מסמך מפורסם כותב מזהה גרסה.

רישיון

  • מסמכים שפורסמו ב-geul.org ומסמכי ה-Issuer GEUL (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. בוחנים אימות איש קשר רשום, תקופת המתנה והתנגדות של המפתח הישן, ויישום תוצאת סכסוך הדומיין.
  • פורמט הרשומות של מסמך אינדקס הגדרות המונחים (מזהה מסמך 0) (Edge שמונה את מסמכי הגדרת המונחים).
  • ברירת המחדל של אלגוריתם החתימה (מומלץ Ed25519).