تصدير ملفات الكتل في Collabora CODE من خلال WOPI

لمنع المستخدمين من تصدير مستند مفتوح في Collabora Online CODE، اجعل مضيف WOPI يُعيد قيمةً "DisableExport": trueفي استجابة ذلك المستند CheckFileInfo. تُشير وثائق تكامل Collabora إلى أن هذا يُعطّل وظيفة التصدير؛ وعند تفعيله، يُخفى خيار "تنزيل باسم" من القائمة أيضًا. HideExportOptionيُغيّر هذا وحده واجهة المستخدم فقط، لذا فهو ليس الخيار الأمثل لمنع التصدير. راجع خصائص استجابة CheckFileInfo المُوسّعة في Collabora .

استخدم إذن WOPI، وليس إعدادًا موجودًا في القائمة فقط.

يُعدّ CODE عنصر التحرير في تكامل WOPI. تعمل خدمة التخزين أو التطبيق الخاصة بك كمضيف WOPI، وتُقدّم معلومات لكل ملف عند فتح Collabora لمستند. وهذا يجعل المضيف المكان المناسب لتحديد ما إذا كان بإمكان مستخدم معين تصدير ملف معين.

في كائن JSON الذي يتم إرجاعه بواسطة نقطة نهاية المضيف CheckFileInfo، قم بتضمين الخاصية المنطقية:

{
  "BaseFileName": "quarterly-plan.docx",
  "Size": 24576,
  "UserCanWrite": true,
  "DisableExport": true
}

هذا جزء توضيحي، وليس استجابة كاملة من CheckFileInfo. احتفظ بالحقول المطلوبة الأخرى وأي خصائص تكامل موجودة يُرجعها مضيفك بالفعل. يجب أن تكون قيمة المفتاح قيمة منطقية JSON، وليست سلسلة نصية "true". عيّنها باستخدام نفس قرار التفويض الذي يستخدمه تطبيقك للملف والمستخدم الحالي.

على سبيل المثال، قد تسمح مؤسسة لموظفيها بتعديل مصنف ميزانية سري مع منعهم من استخدام وظائف التصدير في Collabora. عندما يفتح مضيف WOPI هذا المصنف لأحد الموظفين، فإنه يُرجع قيمة DisableExport: true. بالنسبة للقوالب العامة أو المستندات العادية، يمكن للمضيف إرجاع قيمة falseوفقًا لسياسته. لا يُناسب تطبيق قيمة ثابتة على جميع المستندات إلا إذا كان ينبغي أن يخضع كل مستخدم ومستند لنفس القيود.

قم بتحديث مضيف WOPI الذي يقدم الملف

1. حدد نقطة نهاية التكامل. ابحث عن مسار المضيف الذي يستجيب CheckFileInfoلطلب WOPI الخاص بـ Collabora للملف. في Nextcloud أو ownCloud أو أي منتج تخزين آخر، يعني هذا عادةً تغيير طبقة التكامل أو السياسة التي تُنشئ الاستجابة؛ ولا يُعد تعديل التكوين العام لحاوية Collabora بديلاً عن أذونات كل ملف على حدة على المضيف.
2. طبّق القاعدة في النطاق الصحيح. استمد القيمة من المستخدم المُصادق عليه، أو تصنيف الملف، أو أذونات المشاركة، أو قاعدة أخرى في تطبيقك. لسياسة بسيطة تشمل جميع المستخدمين، أرجع القيمة "صحيح" لكل مستند ذي صلة. تجنّب الاعتماد على تفضيلات قائمة المتصفح أو قيمة مُقدّمة من العميل.
3. أعد القيمة المنطقية في دالة CheckFileInfo. تأكد من أن الاستجابة بتنسيق JSON صحيح وتتضمن الخاصية المطلوبة في الاستجابة التي يتلقاها Collabora. قد يتطلب تغيير السياسة على مستوى الكود إعادة نشر أو إعادة تشغيل تطبيق WOPI المضيف، وذلك بحسب إطاره البرمجي؛ وقد لا يحتاج الكود نفسه إلى تغيير في الإعدادات عندما يُزوّد ​​المضيف الحقل ديناميكيًا.
4. أعد فتح المستند. أغلق جلسة التحرير الحالية، ثم افتح الملف مرة أخرى باستخدام الحساب المتأثر. يتم الرجوع إلى CheckFileInfo كجزء من عملية فتح المستند، لذا قد لا تعكس الجلسة المفتوحة بالفعل أي تغيير في الأذونات.

يختلف الملف أو الفئة أو الإعداد أو واجهة الإدارة باختلاف مُضيف WOPI وإصدار المنتج. تُعرّف وثائق Collabora هذا الحقل، لكنها لا تُحدد إعدادًا عامًا لتطبيقات Nextcloud أو تطبيقات الطرف الثالث. إذا لم يُفعّل مُضيفك قيود التنزيل، فراجع وثائق إدارة المنتج الحالية أو طبّق السياسة في مسار استجابة WOPI المدعوم.

متى يجب عليك أيضاً ضبط خيار إخفاء التصدير؟

اضبط HideExportOptionهذا الخيار trueعندما تريد إخفاء عنصر تحكم "التنزيل كـ" دون فرض حظر التصدير. لفرض حظر فعلي، يُفضّل استخدام الخيار DisableExport: true; يشير دليل تكامل Collabora إلى أن هذا يعني ضمنيًا سلوك إخفاء القائمة. يمكن أن يؤدي إرجاع كلا الحقلين بقيمة "صحيح" إلى توضيح الغرض من التكامل، ولكن لا ينبغي أن يكون ذلك ضروريًا للسلوك الموثق.

لا تخلط بين هذا وبين extra_export_formatsالإعدادات الموجودة في [المكان المذكور coolwsd.xml]. ينص نموذج التكوين الحالي لـ Collabora صراحةً على أن تعطيل هذه التنسيقات الاختيارية يُخفيها ظاهريًا فقط ولا يُعطّل التصدير من جانب الخادم. تتحكم هذه الخيارات في التنسيقات الإضافية المُتاحة، وليس في صلاحية المستخدم لتصدير المستند. راجع نموذج التكوين الحالي لـ Collabora Online قبل تغيير الإعدادات العامة.

ما يحميه هذا القيد وما لا يحميه

DisableExportينطبق هذا على وظيفة التصدير في Collabora للجلسة. وهو مفيد عندما يرغب المستخدمون في تعديل ملف في المتصفح دون استخدام ميزتي التصدير أو التنزيل كملف في المحرر. ولا يؤدي هذا الإعداد تلقائيًا إلى إزالة وصول المستخدم إلى الملف الأصلي في خدمة التخزين. فإذا كان المضيف لا يزال يسمح للمستخدم بتنزيل الملف المصدر من مكان آخر، فإن إعداد Collabora لا يغلق هذا المسار.

وبالمثل، قد يتمكن المستخدم الذي يستطيع عرض المحتوى من نسخ المعلومات يدويًا، أو التقاط لقطات شاشة، أو استخدام ميزات أخرى للتطبيق تسمح بها سياستك. لا تصف هذا الإعداد بأنه يمنع تسريب البيانات تمامًا أو يضمن عدم إمكانية نسخ المحتوى. لتقييد الوصول إلى الملف الأصلي، طبّق قواعد التنزيل والمشاركة في تطبيق استضافة وتخزين WOPI أيضًا. إذا كان شرطك هو منع المستخدم من رؤية المحتوى نهائيًا، فامنع الوصول إلى المستند بدلًا من الاعتماد على علامة التصدير.

يوجد فرق بين إخفاء عنصر واجهة المستخدم وتعطيل عملية ما. يوضح قالب تكوين Collabora هذا الفرق في إعدادات تنسيق التصدير الاختيارية، بينما يمثل حقل استجابة WOPI قيدًا على مستوى التكامل. يُفيد الإجراء الأول في تبسيط القوائم، بينما يُستخدم الإعداد الثاني لمنع التصدير عبر Collabora. إذا كان التكامل الحالي يتصرف بشكل مختلف، فتحقق من إصدار Collabora الخاص به وافحص استجابة CheckFileInfo الفعلية، بدلًا من افتراض أن منتجًا مضيفًا معينًا يربط خانة اختيار "تعطيل التنزيل" الخاصة به بكلا الحقلين.

تحقق من القيد باستخدام حساب تجريبي

1. استخدم حسابًا غير حساب المسؤول يتوافق مع سياسة التقييد وافتح مستند اختبار في جلسة جديدة.
2. تأكد من أن خيار "التنزيل باسم" الخاص بالمحرر لم يعد متاحًا. إذا كان لا يزال يظهر، فافحص استجابة CheckFileInfo المُنتجة لهذا المستخدم والملف تحديدًا؛ وتأكد من أن الحقل منطقي (boolean) trueوأن الاستجابة الجديدة تُعرض.
3. اختبر عملية التصدير عبر واجهة Collabora المعتادة. يجب أن تنعكس سياسة المضيف في سلوك المحرر. لا تستنتج أن التحكم مُفعّل لمجرد أن عنصر القائمة مخفي.
4. تحقق من تطبيق التخزين بشكل منفصل: جرّب مسار التنزيل الخاص به فقط إذا سمحت خطة الاختبار بذلك. يعني نجاح التنزيل هناك أن سياسة الوصول إلى ملف المصدر لا تزال تسمح به، حتى لو حظرت Collabora عمليات التصدير.
5. افتح مستندًا لمستخدم لديه صلاحية التصدير، وتأكد من أن مضيفك يُعيد الصلاحية المطلوبة في هذه الحالة. هذا الإجراء يكشف القواعد التي طُبقت بشكل عام عن طريق الخطأ.

للحصول على تفاصيل التنفيذ، استخدم مرجع تكامل WOPI الخاص بـ Collabora وقالب تكوين المشروع . قد يختلف السلوك المدعوم لـ CODE باختلاف الإصدارات وعمليات التكامل مع المضيف، لذا تحقق من الاستجابة والنتيجة على الإصدار الذي تقوم بنشره. لا ندعي هنا أنه تم اختبار إصدار مضيف معين أو نموذج نشر محدد.