مصادقة HTTP Basic لواجهة الويب

عندما يُعيَّن webServerHost إلى أي شيء غير الحلقة المحلية (مثلًا 0.0.0.0)، تصبح واجهة الويب قابلة للوصول لأي شخص على الشبكة. لإبقاء ذكرياتك بعيدة عن الشبكة المحلية، احمِ خادم الويب بمصادقة HTTP Basic عبر نفس ملف الإعداد المستخدم لكل شيء آخر:

{
  "webServerHost": "0.0.0.0", // optional: reach the UI from the LAN
  "webServerAuthPassword": "pick-a-strong-one",
  "webServerAuthUsername": "admin", // optional, defaults to the current OS user
}

الحقل	الافتراضي	التأثير
webServerAuthPassword	(فارغ)	عند التعيين، يطلب الخادم بيانات اعتماد HTTP Basic Auth على كل طلب. اتركه فارغًا للإبقاء على السلوك المفتوح افتراضيًا.
webServerAuthUsername	مستخدم نظام التشغيل ($USER)	اسم المستخدم المطلوب لتحدي Basic Auth.

يقبل webServerAuthPassword نفس صيغ الأسرار التي يقبلها memoryApiKey:

• سلسلة حرفية (بسيطة، مناسبة للأجهزة الشخصية)،
• env://SOME_ENV_VAR لسحب القيمة من البيئة عند البدء،
• file:///path/to/secret لقراءتها من ملف (chmod 600 موصى به — سيحذّر المكون الإضافي إذا كان الملف قابلًا للقراءة للجميع).

سيظهر المتصفح حوار Basic Auth الأصلي ويتذكر بيانات الاعتماد للجلسة الحالية؛ إغلاق جميع نوافذ المتصفح يتجاهلها، لذا يتطلب إعادة فتح المتصفح تسجيل الدخول مجددًا. تُقارن بيانات الاعتماد بفحص بزمن ثابت، وتحمل استجابة 401 غير المصادق عليها Cache-Control: no-store حتى لا تعيد أي ذاكرة تخزين وسيطة تشغيلها. يُرخَّى CORS أيضًا بمجرد تفعيل المصادقة، حتى تتمكن أدوات أخرى على نفس الشبكة المحلية من التحدث إلى API بعد المصادقة.