การส่งออกไฟล์บล็อกใน 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. ใช้กฎในขอบเขตที่เหมาะสมกำหนดค่าจากผู้ใช้ที่เข้าสู่ระบบ การจัดประเภทไฟล์ สิทธิ์การแชร์ หรือกฎอื่นๆ ในแอปพลิเคชันของคุณ สำหรับนโยบายแบบง่ายๆ สำหรับผู้ใช้ทั้งหมด ให้ส่งค่า true กลับมาสำหรับเอกสารที่เกี่ยวข้องทุกฉบับ หลีกเลี่ยงการพึ่งพาการตั้งค่าในเมนูฝั่งเบราว์เซอร์หรือค่าที่ลูกค้าป้อน
3. ส่งคืนค่าบูลีนใน CheckFileInfo ตรวจสอบให้แน่ใจว่าการตอบกลับเป็น JSON ที่ถูกต้องและมีคุณสมบัติดังกล่าวในการตอบกลับที่ Collabora ได้รับ การเปลี่ยนแปลงนโยบายระดับโค้ดอาจต้องมีการปรับใช้หรือรีสตาร์ทแอปพลิเคชันโฮสต์ WOPI ขึ้นอยู่กับเฟรมเวิร์กของแอปพลิเคชันนั้น ตัวโค้ดเองอาจไม่จำเป็นต้องเปลี่ยนแปลงการกำหนดค่าเมื่อโฮสต์จัดหาฟิลด์นั้นแบบไดนามิก
4. เปิดเอกสารอีกครั้งปิดเซสชันแก้ไขปัจจุบัน แล้วเปิดไฟล์อีกครั้งโดยใช้บัญชีที่ได้รับผลกระทบ ระบบจะเรียกใช้ CheckFileInfo ในขั้นตอนการเปิดเอกสาร ดังนั้นเซสชันที่เปิดอยู่แล้วอาจไม่แสดงสิทธิ์ที่เปลี่ยนแปลงไป

ไฟล์ คลาส การตั้งค่า หรืออินเทอร์เฟซการดูแลระบบที่แน่นอนจะแตกต่างกันไปตามโฮสต์ WOPI และเวอร์ชันของผลิตภัณฑ์ เอกสารของ Collabora ได้กำหนดฟิลด์นี้ไว้ แต่ไม่ได้กำหนดการตั้งค่าทั่วไปสำหรับ Nextcloud หรือแอปพลิเคชันของบุคคลที่สาม หากโฮสต์ของคุณไม่ได้แสดงข้อจำกัดในการดาวน์โหลด โปรดตรวจสอบเอกสารการดูแลระบบปัจจุบันของผลิตภัณฑ์นั้น หรือนำนโยบายไปใช้ในเส้นทางการตอบสนอง WOPI ที่รองรับ

คุณควรตั้งค่า HideExportOption เมื่อใด?

ตั้งค่า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 ที่สร้างขึ้นสำหรับผู้ใช้และไฟล์นี้โดยเฉพาะ ตรวจสอบให้แน่ใจว่าฟิลด์เป็นค่าบูลีนtrueและมีการส่งการตอบสนองใหม่แล้ว
3. ทดสอบการส่งออกผ่านอินเทอร์เฟซ Collabora ปกติ นโยบายของโฮสต์ควรสะท้อนให้เห็นในพฤติกรรมของตัวแก้ไข อย่าสรุปว่าการควบคุมนั้นถูกบังคับใช้เพียงเพราะรายการเมนูถูกซ่อนอยู่
4. ตรวจสอบแอปพลิเคชันจัดเก็บข้อมูลแยกต่างหาก: ลองใช้เส้นทางการดาวน์โหลดของแอปพลิเคชันนั้นโดยเฉพาะ หากแผนการทดสอบของคุณอนุญาต การดาวน์โหลดสำเร็จในแอปพลิเคชันนั้นหมายความว่านโยบายการเข้าถึงไฟล์ต้นฉบับยังคงอนุญาตอยู่ แม้ว่า Collabora จะบล็อกการส่งออกก็ตาม
5. เปิดเอกสารสำหรับผู้ใช้ที่ได้รับอนุญาตให้ส่งออก และตรวจสอบว่าโฮสต์ของคุณส่งคืนสิทธิ์ที่ต้องการสำหรับกรณีนั้นหรือไม่ วิธีนี้จะช่วยตรวจจับกฎที่ถูกนำไปใช้ทั่วโลกโดยไม่ได้ตั้งใจ

สำหรับรายละเอียดการใช้งาน โปรดใช้เอกสารอ้างอิงการผสานรวม WOPI ของ Collabora และเทมเพลตการกำหนดค่าโครงการพฤติกรรมที่รองรับของ CODE อาจแตกต่างกันไปในแต่ละเวอร์ชันและการผสานรวมโฮสต์ ดังนั้นโปรดตรวจสอบการตอบสนองและผลลัพธ์ในเวอร์ชันที่คุณใช้งาน ไม่มีการอ้างว่าได้ทดสอบกับเวอร์ชันโฮสต์หรือการปรับใช้ตัวอย่างใดโดยเฉพาะ