الجلسات والأمان
جلسات المستندات والتحكم في الوصول
يحدد رمز Doconut مستندًا مفتوحًا. إذا تم خدمة أي طلب يحمل هذا الرمز، فإن من يحصل عليه يمكنه قراءة كل صفحة. تشرح هذه الصفحة ما تحتويه جلسة المستند، ومدة بقاءها، وكيف يقرر DocImage.axd من يمكنه رؤية صفحاته — على خادم واحد وفي مزرعة ويب.
ما تحتويه جلسة المستند
كل OpenDocumentAsync ناجح ينشئ جلسة واحدة، تُحفظ في الذاكرة:
- عارض الصيغة المحملة — نسخة المحرك التي تحتفظ بالمستند المُحلل،
- حالة كل صفحة — الدوران، الانعكاسات، وبيانات التعليقات التي يضيفها المستخدم في الواجهة،
- فهرس البحث الاختياري، يُبنى عند أول بحث (أو يُحمَّل من ملف
.srhمُسبق الإنشاء)، - علامة المائية للجلسة من
DocOptions.Watermark.
مدة الحياة
تنتهي الجلسات بعد نافذة متحركة: DocOptions.TimeOut دقيقة (الافتراضي 60)، تُعاد ضبطها بكل طلب يقدم الرمز. عندما تنتهي الجلسة — بسبب الانتهاء أو بسبب CloseDocument(token) — يتم تحرير محرك المستند وتحرير الذاكرة فورًا.
// جلسة قصيرة الأمد لمعاينة لمرة واحدة
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });طلب يحمل رمزًا منتهي الصلاحية يحصل على صورة خطأ تُظهر Document session not found. Please re-open document.. يجب على الصفحة فتح المستند مرة أخرى للحصول على رمز جديد. على خادم واحد، يؤدي إعادة تدوير مجموعة التطبيقات إلى إنهاء كل الجلسات أيضًا.
تُقدم الصفحات فقط للجلسة التي فتحتها
مع UnsafeMode = false — الافتراضي — يمنح فتح المستند الوصول إلى جلسة ASP.NET للطلب الذي فتحه، عبر كتابة إدخال secure-{token} في تلك الجلسة. يتطلب DocImage.axd حالة الجلسة نفسها، ويقدم الصفحة فقط عندما تحمل الجلسة الطالبة ذلك الإدخال. أي متصفح آخر يقدم نفس الرمز يحصل على صورة خطأ تُظهر You Are Not Authorized To View This Page.
Doconut.DoconutHost.Initialize(options =>
{
// false (الافتراضي): DocImage.axd يقدم صفحة فقط إلى جلسة ASP.NET التي فتحتها
// المستند. المعالج يطلب حالة الجلسة بنفسه؛ هو فقط يحتاج إلى أن الموقع لا
// إيقاف حالة الجلسة في Web.config.
options.UnsafeMode = false;
});ثلاث نتائج عملية:
- نقطة النهاية المفتوحة تحتاج حالة جلسة. متحكمات MVC وصفحات Web Forms تمتلكها افتراضيًا. لا يمتلك
IHttpHandlerمخصص ذلك إلا إذا نفّذSystem.Web.SessionState.IRequiresSessionState. الفتح الذي يعمل بدون جلسة لا يملك ما يمنحه، لذا يعرض العارض الرسالة "أنت غير مخول لعرض هذه الصفحة." في كل صفحة. - يجب أن تظل حالة الجلسة مفعلة. يؤدي
<sessionState mode="Off" />فيWeb.configإلى تعطيل كل من الإذن والفحص، وتُرفض كل صفحة. - يجب على المتصفح إرسال ملف تعريف الارتباط الخاص بالجلسة. طلبات الواجهة هي من نفس الأصل، لذا تحمل
ASP.NET_SessionIdتلقائيًا. يُرفض عميل لا يملك ملف تعريف الارتباط — سكريبت، اتصال خادم إلى خادم، إعداد عابر للأصل يزيل ملفات الارتباط —. هذه هي الميزة التي تعمل.
UnsafeMode = true يوقف الفحص: أي طلب يحمل الرمز يُخدم. إنه مفتاح عالمي واحد لكل مستند، دون إمكانية تجاوز لكل مستند. اتركه false.
إلغاء الترخيص
CloseDocument(token) يفعل أكثر من تحرير الذاكرة: يزيل إدخال secure-{token} من جلسة الطلب الحالي ويلغي الرمز، بحيث يُرفض الرمز المغلق فورًا.
مزرعات الويب: تذاكر موقعة
في مزرعة، قد يصل الطلب التالي إلى خادم لم يرَ المستند أبدًا، في عملية عامل مختلفة، مع جلسة ASP.NET الخاصة به. لا يمكن أن يتبع الإذن الجلسة. يستبدل الوضع الموزع ذلك بـ تذكرة موقعة مرتبطة بالمتصفح: كل عقدة تشارك مخزنًا واحدًا لجلسات المستند ومفتاح توقيع واحد، ويتقبل DocImage.axd طلبًا عندما تكون تذكرته صالحة لذلك الرمز، لذلك المتصفح، وعند تسجيل دخول المستخدم — لذلك المستخدم.
الإعداد، متماثل على كل عقدة:
// Global.asax.cs - Application_Start
// سر المزرعة: على الأقل 32 بايت، نفسه على كل عقدة، محفوظ خارج التحكم بالمصدر.
byte[] farmKey = Convert.FromBase64String(Environment.GetEnvironmentVariable("DOCONUT_FARM_KEY"));
Doconut.DoconutHost.Initialize(
options => options.UnsafeMode = false, // فحص التذكرة يعمل فقط عندما يكون هذا false
services => services.AddDoconutDistributed(d =>
{
d.Store = CloudLocation.FileShare;
d.FileShareRootPath = @"\\fileserver\doconut-shared"; // مجلد يمكن لكل عقدة الوصول إليه
d.SigningKey = farmKey; // على الأقل 32 بايت، SAME على كل عقدة
}));ثم تقوم نقطة النهاية المفتوحة بربط التذكرة بالمتصفح قبل الفتح، وتعيد التذكرة مع الرمز:
- ضبط
DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions)— يصدر ملف تعريف الارتباطdoconut-clientالمرتبط بالتذكرة — وDocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current)؛ - بعد
OpenDocumentAsync، أعدviewer.AccessTokenجنبًا إلى جنب مع الرمز؛ - في الصفحة، مرّر كليهما إلى الواجهة:
objViewer.View(token, access).
الانتقال من علم مزرعة الويب الكلاسيكي (IsWebfarm مع ExportToPng)؟ يوضح الترحيل التغيير خطوة بخطوة.
احتفظ بمفتاح التوقيع خارج التحكم في المصدر: فهو يوقع التذاكر ويشفّر المستندات في المخزن المشترك. العقدة التي لديها مفتاح مختلف ترفض كل تذكرة أصدرها الآخرون.
اختبر مزرعة باستخدام متصفح حقيقي، أو سكريبت يحتفظ بملفات الارتباط. العميل الذي لا يملك ملف تعريف الارتباط doconut-client لا يحصل على رد بـ 401: يتلقى صورة الخطأ "غير مخول" بالحالة 200، بحجم حوالي 2 كيلوبايت، بينما تكون الصفحة الحقيقية بحجم عشرات إلى مئات الكيلوبايت.
قائمة التحقق للإنتاج
- احتفظ بـ
UnsafeMode = false(الافتراضي). - افتح المستندات من طلبات تمتلك حالة جلسة، ولا تُطفئ حالة الجلسة أبدًا.
- تأكد من وصول ملف تعريف الارتباط الخاص بالجلسة إلى
DocImage.axd(نفس الأصل، HTTPS، سياسةSameSiteالتي تسمح بذلك). - في المزرعة، استخدم الوضع الموزع بمفتاح توقيع واحد مشترك بين جميع العقد.
- استدعِ
CloseDocumentعندما يغادر المستخدم المستند — سيفيد ذلك الذاكرة والأمان. - لا تُسجِّل أو تشارك الرموز أبدًا؛ اعتبرها بيانات اعتماد قصيرة الأجل.
هل كانت هذه الصفحة مفيدة؟