مولّد UUID v2

ما هو UUID v2؟

UUID v2 هو إصدار UUID DCE Security، موحَّد كجزء من مواصفة بيئة الحوسبة الموزّعة (DCE) ومُشار إليه في RFC 4122. يوسّع UUID v1 بتضمين معرّف مستخدم أو مجموعة POSIX (UID/GID) في حقل الطابع الزمني.

البنية مماثلة لـ UUID v1، لكن حقل time_low البالغ 32 بت يُستبدَل بـ معرّف محلي 32 بت (مثلاً POSIX UID) وحقل local_domain بحجم بايت واحد يحدّد نوع المعرّف المحلي. يُبتَر الطابع الزمني نتيجةً لذلك، مما يقلّل دقّته وضمانات تفرّده.

UUID v2 نادر للغاية في البرمجيات الحديثة. معظم المطوّرين لن يحتاجوا أبداً لتوليد واحد. توثّق هذه الصفحة التنسيق للاكتمال ولمساعدة في فكّ ترميز قيم UUID v2 المصادَفة في الأنظمة القديمة.

بنية UUID v2

UUID v2 لديه صيغة 128 بت بواصلات ذاتها كسائر إصدارات UUID. تختلف الحقول عن UUID v1 كما يلي:

مثال: 000003e8-92e0-21ef-8000-325096b39f47 — local_id 0x000003e8 = UID 1000، local_domain 0x00 = مستخدم POSIX

قيم النطاق المحلي

بايت local_domain يحدّد نوع المعرّف المحلي المضمَّن في UUID:

قيم النطاق معرَّفة بمواصفة DCE. القيم من 3 إلى 255 محجوزة. عملياً، يُصادَف النطاق 0 (Person/UID) فقط في قيم UUID v2 الواقعية.

لماذا UUID v2 نادر الاستخدام

ثلاث خصائص تجعل UUID v2 غير عملي لمعظم التطبيقات الحديثة:

دقة طابع زمني خشنة

يُبتَر الطابع الزمني إلى 28 بتاً (تقريباً دقة 7.2 دقائق). داخل تلك النافذة، UUID المولَّدة بنفس local_id والنطاق على المضيف ذاته ليست فريدة — تعتمد المواصفة على حقل clock_seq للتمييز بينها، مما يحدّ التفرّد بـ 64 قيمة لكل نافذة 7 دقائق.

لا دعم لمكتبات قياسية

خلافاً لـ UUID v1 وv4، لا تدعم معظم مكتبات UUID توليد UUID v2. حزمة uuid npm وحدة Python's uuid وJava's java.util.UUID تحذف جميعها v2. يتطلب الأمر تطبيقاً مخصَّصاً.

دلالات خاصة بـ POSIX

مفهوم النطاق المحلي (UID/GID) هو بطبيعته خاص بـ POSIX ولا ينتقل بمعنى مفيد إلى Windows أو الأنظمة المضمَّنة أو بيئات السحابة حيث غياب مفهوم معرّف مستخدم POSIX.

السياق التاريخي

عُرِّف UUID v2 كجزء من بيئة الحوسبة الموزّعة لمؤسسة Open Software Foundation (DCE/RPC) في أوائل التسعينيات. كان الهدف إنشاء UUID تستطيع حمل سياق التفويض — تحديداً لتمكين خادم RPC من تحديد المستخدم المتصل دون خطوة مصادقة منفصلة.

افترض نموذج أمان DCE بيئة POSIX متجانسة حيث تشارك كل عقدة في فضاء أسماء UID/GID مشترك. UID المضمَّن سيتيح للخادم فحص قوائم التحكم بالوصول بسرعة دون رحلة ذهاباً وإياباً إلى خدمة الدليل.

• تحرّك الإنترنت بعيداً عن بيئات POSIX المتجانسة نحو بنى سحابية متغايرة
• تستخدم المصادقة الحديثة الرموز (JWT وOAuth) بدلاً من UIDs المضمَّنة في المعرّفات
• UUID v4 (عشوائي كلياً) وUUID v7 (مرتّب زمنياً) يغطّيان حالات الاستخدام العملية للمعرّفات الفريدة
• DCE/RPC نفسه انحدر استخدامه الواسع

أدرج RFC 4122 (2005) UUID v2 بالإحالة إلى مواصفة DCE، لكنه حذف عمداً خوارزمية التوليد التفصيلية — مشيراً إلى أنها معرَّفة بواسطة DCE لا IETF.

RFC 9562 (2024)، الذي حدَّث معيار UUID، أبقى UUID v2 للاكتمال التاريخي لكنه استمرّ في الإشارة إلى طبيعته الخاصة بـ POSIX وغياب خوارزمية توليد كاملة في المعيار IETF.

UUID v2 مقابل UUID v1

UUID v2 مشتق من UUID v1. إليك مقارنتهما:

لا يوفّر UUID v2 شيئاً على UUID v1 للاستخدام العام، بل هو أسوأ بشكل صارم في معظم الجوانب. لا سبب لاختيار UUID v2 للتطوير الجديد.

أمثلة الكود

UUID v2 ليس لديه دعم أصيلي في المكتبات القياسية. تُظهر الأمثلة التالية كيفية التعامل مع قيم UUID v2:

Python — تطبيق يدوي

import uuid, struct, time

def uuid_v2(local_id: int, local_domain: int = 0) -> str:
    """
    Generate a DCE Security UUID (v2).
    local_domain: 0 = POSIX UID, 1 = POSIX GID, 2 = Org
    local_id: 32-bit unsigned integer (e.g. os.getuid())
    """
    # Get a v1 UUID for the time and node fields
    v1 = uuid.uuid1()
    fields = list(v1.fields)  # [time_low, time_mid, time_hi_version, clock_seq_hi_variant, clock_seq_low, node]

    # Replace time_low with local_id
    fields[0] = local_id & 0xFFFFFFFF

    # Replace version nibble: clear lower 12 bits of time_hi, set version 2
    fields[2] = (fields[2] & 0x0FFF) | 0x2000

    # Replace clock_seq_low with local_domain
    fields[4] = local_domain & 0xFF

    return str(uuid.UUID(fields=tuple(fields)))


import os
print(uuid_v2(os.getuid(), local_domain=0))   # POSIX UID
print(uuid_v2(os.getgid(), local_domain=1))   # POSIX GID

Go — ملاحظة

// The standard "github.com/google/uuid" package does NOT support v2.
// You would need to implement it manually, similar to the Python example above.
// Most Go developers use v4 or v7 for new projects.
import "github.com/google/uuid"

v4 := uuid.New()          // v4 — recommended for most use cases
v7, _ := uuid.NewV7()     // v7 — time-ordered, ideal for database primary keys

JavaScript — استخراج الحقول

لاستخراج local_id والنطاق من سلسلة UUID v2 قائمة:

// Extracting fields from a UUID v2 string
const uuidStr = '000003e8-1234-2abc-8200-a1b2c3d4e5f6'
//               ^^^^^^^^ ^^^^ ^    ^^
//               local_id      ver  variant+clockSeqHi
//                                  ^^ = local_domain (00 = POSIX UID)

const parts = uuidStr.split('-')

const localId     = parseInt(parts[0], 16)       // → 1000 (0x3e8)
const version     = parseInt(parts[2][0], 16)    // → 2
const localDomain = parseInt(parts[3].slice(2), 16) // low byte of octet pair

const DOMAIN_NAMES = ['POSIX UID', 'POSIX GID', 'Org']
console.log(`Local ID: ${localId}`)                       // Local ID: 1000
console.log(`Version:  ${version}`)                       // Version:  2
console.log(`Domain:   ${DOMAIN_NAMES[localDomain]}`)     // Domain:   POSIX UID

الأسئلة الشائعة