المصادقة

ينطبق على:

DuoKey Cockpitالرموز الحاملة (Bearer tokens)MFA · SSO

الرموز الحاملة (Bearer tokens)

يجب أن يتضمن كل طلب إلى واجهة الإدارة (/api/…) رمزاً حاملاً:

ملاحظة

Authorization: Bearer <access-token>

يحدد الرمز هوية المستخدم، والمستأجر الذي يعمل ضمنه، والأذونات التي يحملها. تتلقى الطلبات التي لا تحمل رمزاً صالحاً استجابة 401 Unauthorized؛ ويتلقى الرمز الصالح الذي يفتقر إلى الإذن المطلوب استجابة 403 Forbidden.

الحصول على رمز

صادِق باستخدام بيانات اعتماد المستخدم (وعامل ثانٍ إذا كان مفعّلاً) عبر نقطة نهاية تسجيل الدخول في Cockpit. عند النجاح، تحصل على رمز وصول (access token) ورمز تحديث (refresh token).

استدعاء API

أرسِل رمز الوصول في ترويسة Authorization مع كل طلب.

التحديث

عندما يقترب رمز الوصول من الانتهاء، استخدم رمز التحديث للحصول على رمز جديد دون إعادة إدخال بيانات الاعتماد. تُهيَّأ مدد صلاحية الرموز في إعدادات المضيف.

نصيحة

للوصول بين الآلات (machine-to-machine)، استخدم هوية خدمة (service identity) يهيّئها مسؤول النظام بدلاً من بيانات اعتماد مستخدم بشري.

الجلسات والإبطال

تُربط الرموز بجلسة. يتوقف قبول الرمز عندما تُبطَل الجلسة، أو تتغيّر كلمة مرور المستخدم، أو يسجّل المستخدم الخروج — بحيث يمكن قطع أي رمز مسرَّب مركزياً. رموز الوصول قصيرة العمر؛ أما رموز التحديث فهي أطول عمراً وقابلة للإبطال أيضاً.