Skip to content

إدارة الرموز

الرموز هي بيانات اعتماد المصادقة التي يستخدمها عملاء CLI للاتصال بالخادم. كل رمز مرتبط بمستخدم واختيارياً بجهاز.

أوامر CLI

bash
# إنشاء رمز للمستخدم ذي المعرف 1
unns token gen 1

# إنشاء مع اسم الجهاز
unns token gen 1 macbook-pro

# سرد جميع الرموز
unns token list

# سرد رموز مستخدم محدد
unns token list 1

# إلغاء رمز
unns token revoke 3

خصائص الرمز

الحقلالوصف
hashتجزئة SHA-256 (مخزنة، لا يتم تخزين النص العادي أبداً)
user_idالمستخدم المالك
device_nameمعرّف الجهاز (اختياري)
enabledنشط أو ملغى
created_atتاريخ الإنشاء
last_usedآخر مصادقة ناجحة

كيف تعمل الرموز

  1. ينشئ المدير رمزاً ← يُعرض الرمز الخام مرة واحدة
  2. يُعطى الرمز للمستخدم
  3. يشغّل المستخدم unne setup ويدخل الرمز
  4. يرسل CLI الرمز أثناء المصافحة
  5. يقوم الخادم بتجزئته والبحث عن التجزئة في قاعدة البيانات
  6. يرث الرمز جميع حدود المستخدم الأصل

الرمز = الجهاز

عندما يتم تعيين max_devices على مستخدم، يُحسب كل رمز كجهاز واحد. إذا كان لدى مستخدم max_devices=2، يمكنه الحصول على رمزين نشطين كحد أقصى يتصلان في نفس الوقت.

الأمان

  • يتم تخزين الرموز كتجزئات SHA-256 فقط
  • يُعرض الرمز الخام مرة واحدة عند الإنشاء ولا يتم تخزينه أبداً
  • إلغاء الرمز يفصل العميل فوراً
  • يمكن إدارة الرموز عبر CLI أو لوحة الإدارة

Released under the MIT License.