انتقل إلى المحتوى
توثيق مؤرشف. اختر إصدار تثبيتك.

المصادقة

الوصول المجهول، Basic Auth، الجلسات المشفرة و HTTPS.

المصادقة المدعومة

يدعم الوصول المجهول و htpasswd Basic Auth الأصلي. لا يدعم خدمات Bearer الخارجية أو OIDC. إدارة المستخدمين غير متاحة في هذا الإصدار.

جانب التسجيل Basic Auth

قم بإنشاء ملف htpasswd باستخدام كلمة مرور bcrypt. يستخدم المثال التالي حاوية Apache رسمية مؤقتة؛ استبدل بيانات اعتماد المثال وقم بحماية الملف الناتج:

mkdir -p auth
docker run --rm --entrypoint htpasswd httpd:2   -Bbn your-user choose-a-strong-password > auth/htpasswd

مثال على إعدادات Distribution:

auth:
  htpasswd:
    realm: Registry
    path: /auth/htpasswd

قم بتحميل الملف الذي تم إنشاؤه في حاوية التسجيل على /auth/htpasswd. تكوين التسجيل منفصل عن تكوين Crateview. استخدم HTTPS للوصول عن بعد؛ Basic Auth هو تشفير وليس تشفير نقل. تجنب ترك كلمات مرور حقيقية في سجل الصدفة المشترك أو الأمثلة العامة.

جلسات واجهة المستخدم

يقوم خادم Nitro بالتحقق من صحة بيانات الاعتماد مقابل السجل. يقوم بتخزينها في ملف تعريف ارتباط مشفر HttpOnly SameSite=Strict. لا يتلقى متصفح JavaScript وlocalStorage بيانات الاعتماد. تنتهي الجلسات بعد ثماني ساعات.

قم بتعيين سر جلسة إنتاج عشوائية:

openssl rand -base64 32

استخدم القيمة التي تم إنشاؤها كـ NUXT_SESSION_PASSWORD، مع 32 حرفًا على الأقل. يجب أن يستخدم كل مثيل للواجهة الأمامية خلف موازن التحميل نفس القيمة. بدون التكوين، يقوم Crateview بإنشاء سر العملية المحلية، وبالتالي فإن إعادة التشغيل تؤدي إلى إبطال الجلسات الحالية.

HTTPS وتسجيل الخروج

يستخدم ملف تعريف ارتباط الجلسة Secure عندما يكون بروتوكول الطلب العام هو HTTPS. قم بتكوين بروتوكول إعادة توجيه الوكيل العكسي بشكل صحيح. يؤدي تسجيل الخروج إلى مسح جلسة واجهة المستخدم؛ ولا يحذف أو يعدل مستخدمي التسجيل.

يقوم Docker وعملاء CLI الآخرين بالمصادقة مباشرة من خلال وكيل /v2/** باستخدام بيانات اعتماد التسجيل العادية الخاصة بهم. لا يؤدي تسجيل الدخول إلى واجهة مستخدم الويب إلى تسجيل دخول Docker CLI تلقائيًا.