วิธีจำกัดตัวเลือกการส่งออกไฟล์ใน Collabora Online (โค้ด)

เพื่อจำกัดการส่งออกไฟล์ใน Collabora Online CODE ให้โฮสต์ WOPI ส่งข้อมูลกลับมาDisableExport: trueในCheckFileInfoคำตอบสำหรับไฟล์และผู้ใช้ที่เกี่ยวข้องHideExportOption: trueนอกจากนี้ ให้ลบคำสั่ง “ดาวน์โหลดเป็น” ออกจากเมนูตัวแก้ไขด้วย คุณสมบัติแรกจะปิดใช้งานฟังก์ชันการส่งออกของ Collabora ในส่วนแบ็กเอนด์ ส่วนคุณสมบัติที่สองจะควบคุมการมองเห็น การตั้งค่าเฉพาะแฟล็กการมองเห็นอย่างเดียวไม่ถือเป็นมาตรการควบคุมการเข้าถึง

CODE คือโปรแกรมแก้ไขเอกสาร ในการผสานรวมแบบมาตรฐาน โฮสต์ WOPI แยกต่างหาก เช่น Nextcloud, ownCloud หรือแอปพลิเคชันที่กำหนดเอง จะจัดเก็บไฟล์ต้นฉบับและส่งข้อมูลเมตาและสิทธิ์การเข้าถึงไฟล์ให้กับ Collabora นี่คือเหตุผลที่โดยปกติแล้วสิทธิ์การส่งออกจะถูกกำหนดค่าในการผสานรวมโฮสต์ ไม่ใช่เป็นสวิตช์สากลในคอนเทนเนอร์ของcoolwsd.xmlCollabora

เลือกปุ่มควบคุมที่ตรงกับการกระทำ

ใช้ช่องสองช่องแรกสำหรับงานเฉพาะเจาะจง คือการบล็อกคุณสมบัติ "ดาวน์โหลดเป็น/ส่งออก" ของ Collabora เพิ่มตัวควบคุมอื่นๆ เฉพาะในกรณีที่นโยบายของคุณครอบคลุมการกระทำเหล่านั้นด้วย การที่ไม่มีรายการเมนูเพียงอย่างเดียวไม่ได้พิสูจน์ว่าการดาวน์โหลดถูกบล็อก

ตัดสินใจว่าจะใช้ข้อจำกัดนั้นที่ใด

ขั้นแรก ให้ระบุแอปพลิเคชันที่จัดเก็บไฟล์และเปิดไฟล์นั้นใน Collabora ในศัพท์เฉพาะของ WOPI แอปพลิเคชันนั้นเรียกว่าโฮสต์ Collabora จะเรียกใช้CheckFileInfoเอนด์พอยต์ของโฮสต์เพื่อรับข้อมูลไฟล์และสิทธิ์การใช้งาน โฮสต์รู้ว่าใครเปิดเอกสารและนโยบายการแชร์ บัญชี หรือไฟล์อนุญาตให้ดาวน์โหลดหรือไม่

• Nextcloud หรือแพลตฟอร์มไฟล์ที่ผสานรวมอื่นๆ:ให้ใช้การตั้งค่าการแชร์หรือการดูที่ปลอดภัยที่แพลตฟอร์มนั้นๆ รองรับ หากเวอร์ชันที่คุณติดตั้งมีนโยบาย "ซ่อนการดาวน์โหลด" หรือนโยบายที่เทียบเท่า การผสานรวมสามารถแปลงนโยบายนั้นเป็นสิทธิ์ WOPI ได้ ตรวจสอบการตอบสนองของโฮสต์จริงหรือเอกสารปัจจุบันของแพลตฟอร์มก่อนที่จะสรุปว่าเส้นทางการส่งออก การพิมพ์ การคัดลอก หรือการดาวน์โหลดโดยตรงใดที่ถูกบล็อก
• โฮสต์ WOPI ของคุณเอง:อัปเดตโค้ดที่สร้างCheckFileInfoการตอบสนอง JSON คำนวณข้อจำกัดจากสิทธิ์ของผู้ใช้ที่เข้าสู่ระบบและนโยบายการแชร์ไฟล์
• ผู้ดูแลระบบคอนเทนเนอร์ CODE ที่ไม่มีการควบคุมโฮสต์:โปรดขอให้ผู้ดูแลระบบโฮสต์หรือนักพัฒนาการผสานรวมบังคับใช้ การแก้ไขเฉพาะคอนเทนเนอร์ CODE อาจซ่อนรูปแบบเสริมบางอย่างจากอินเทอร์เฟซ แต่ไม่ได้ให้สิทธิ์การใช้งาน WOPI ต่อไฟล์

การกำหนดค่าซอร์สโค้ดปัจจุบันของ Collabora อธิบายextra_export_formatsตัวเลือกเหล่านี้ว่าเป็นตัวเลือกในระดับอินเทอร์เฟซ: การปิดใช้งานรูปแบบเสริมเหล่านั้นในส่วนนั้นจะซ่อนตัวเลือกเหล่านั้นไว้เฉพาะในเชิงภาพเท่านั้น อย่าใช้การตั้งค่านี้เป็นการบังคับใช้การส่งออกฝั่งเซิร์ฟเวอร์ การตั้งค่านี้มีไว้สำหรับการแสดงผลในเมนูรูปแบบ ไม่ใช่เพื่อใช้แทนสิทธิ์การเข้าถึงของโฮสต์

ตั้งค่าสิทธิ์การส่งออกในโฮสต์ WOPI แบบกำหนดเอง

1. ค้นหาตัวจัดการการตอบสนอง CheckFileInfo

ค้นหาเส้นทางที่ตอบสนองต่อGET /wopi/files/{id}คำขอ WOPI ของ Collabora ยืนยันวิธีการตรวจสอบสิทธิ์โทเค็นการเข้าถึงและแมปโทเค็นนั้นกับผู้ใช้และไฟล์ปัจจุบัน อย่าเชื่อถือแฟล็กที่เบราว์เซอร์ให้มา?disableExport=trueเว้นแต่โฮสต์จะตรวจสอบความถูกต้องกับกฎการอนุญาตของตนเองแล้ว

2. พิจารณาตัดสินใจจากนโยบายของเจ้าภาพ

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

3. ส่งคืนฟิลด์ WOPI แบบบูลีน

เพิ่มฟิลด์ Boolean สองฟิลด์ลงในคำตอบ JSON นี่เป็นเพียงส่วนหนึ่งที่จะนำไปผสานรวมกับCheckFileInfoคำตอบที่สมบูรณ์ที่มีอยู่แล้วของคุณ ไม่ใช่ส่วนที่จะใช้แทนไฟล์และคุณสมบัติผู้ใช้ที่จำเป็น:

{
  "BaseFileName": "budget.xlsx",
  "Size": 48123,
  "UserId": "viewer-42",
  "OwnerId": "team-7",
  "UserCanWrite": false,
  "HideExportOption": true,
  "DisableExport": true
}

คงไว้ซึ่งฟิลด์ที่จำเป็นและแฟล็กความสามารถตามปกติที่การผสานรวมของคุณมีอยู่แล้ว ใช้ค่าบูลีน JSON trueและfalseไม่ใช่สตริง เช่น"true"หรือ"1"เมื่ออนุญาตให้ส่งออก ให้ส่งคืนค่า false หรือละเว้นคุณสมบัติเสริมตามพฤติกรรมที่รองรับโดยการผสานรวมและเวอร์ชัน Collabora ของคุณ

4. บล็อกฟังก์ชัน "บันทึกเป็น" แยกต่างหาก หากนโยบายกำหนดไว้

การส่งออกไปยังรูปแบบไฟล์ในเครื่องและการบันทึกสำเนากลับไปยังโฮสต์ WOPI เป็นการดำเนินการที่แตกต่างกัน หากผู้ใช้ไม่ควรสร้างสำเนา "บันทึกเป็น" ผ่านทางตัวแก้ไข ให้กลับไปUserCanNotWriteRelative: trueและทำให้โฮสต์ปฏิเสธคำขอเขียนแบบสัมพัทธ์ที่เกี่ยวข้อง อย่าคิดว่าDisableExportการบล็อกทุกสำเนาหรือเส้นทางการบันทึกจะมีผลเสมอไป ในทำนองเดียวกัน ให้รวมDisablePrint: trueเฉพาะกรณีที่การพิมพ์อยู่ภายใต้นโยบายเท่านั้น

ใช้การตั้งค่าที่เทียบเท่ากันในแพลตฟอร์มแบบบูรณาการ

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

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

ตรวจสอบว่าข้อจำกัดนั้นใช้งานได้จริง

1. เปิดเอกสารทดสอบโดยใช้บัญชีที่ควรถูกจำกัดการเข้าถึง
2. ตรวจสอบการตอบสนอง CheckFileInfo ของโฮสต์ WOPI ในบันทึกแอปพลิเคชันหรือการติดตามการพัฒนาที่ปลอดภัย ยืนยันว่าทั้งสองฟิลด์เป็นค่าบูลีน JSON ที่ตั้งค่าเป็น true สำหรับเซสชันนี้
3. ใน Collabora ให้ตรวจสอบว่าไม่มีตัวเลือก “ดาวน์โหลดเป็น” และทดสอบการส่งออกที่เกี่ยวข้อง อย่าใช้ไฟล์ลับจริงในระหว่างการตรวจสอบเบื้องต้น
4. หากต้องการบล็อกฟังก์ชัน "บันทึกเป็น" ด้วย ให้ทดสอบว่าคำขอเขียนแบบสัมพัทธ์ฝั่งโฮสต์ถูกปฏิเสธหรือไม่ รายการเมนูอาจยังคงปรากฏให้เห็นแม้ว่าโฮสต์จะปฏิเสธการดำเนินการก็ตาม
5. เปิดเอกสารใหม่โดยกำหนดสิทธิ์การส่งออก ตรวจสอบให้แน่ใจว่าการเปลี่ยนแปลงไม่ได้ปิดใช้งานการส่งออกสำหรับผู้ใช้หรือไฟล์ทั้งหมดโดยไม่ได้ตั้งใจ
6. ทดสอบการดาวน์โหลดโดยตรงจากแพลตฟอร์มจัดเก็บข้อมูลแยกต่างหาก ฟังก์ชันการส่งออกของ Collabora ไม่ได้เพิกถอนสิทธิ์ของผู้ใช้ในการดาวน์โหลดไฟล์ต้นฉบับจาก Nextcloud, ownCloud, WebDAV หรือปลายทางโฮสต์อื่นโดยอัตโนมัติ

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

ข้อจำกัดด้านความปลอดภัยและคำแนะนำเชิงปฏิบัติ

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

สำหรับการติดตั้ง CODE ส่วนใหญ่ ให้ใช้DisableExportและHideExportOptionในการตอบสนอง WOPI CheckFileInfo ที่สร้างโดยโฮสต์ โดยกำหนดขอบเขตให้เฉพาะผู้ใช้และเอกสารที่เกี่ยวข้อง บังคับใช้การดาวน์โหลดโดยตรงและการบันทึกเป็นไฟล์ใหม่ (Save As) ที่โฮสต์ และตรวจสอบทั้งเซสชันที่ถูกจำกัดและที่ได้รับอนุญาตหลังจากปรับใช้แล้ว

เอกสารอ้างอิง

• คู่มือการใช้งาน Collabora Online SDK: WOPI CheckFileInfo และ DisableExport
• การกำหนดค่าแหล่งข้อมูล Collabora Online: extra_export_formats
• เอกสารประกอบการใช้งาน Microsoft WOPI: CheckFileInfo
• ตัวควบคุม WOPI ของเอกสาร Rich Documents ของ Nextcloud