Cum să restricționezi opțiunile de exportare a fișierelor în Collabora Online CODE

Pentru a restricționa exportul de fișiere în CODE Collabora Online, faceți ca gazda WOPI să returneze DisableExport: trueîn CheckFileInforăspunsul său pentru fișierul și utilizatorul afectat. Adăugați HideExportOption: trueastfel încât comanda „Descărcare ca” să fie eliminată și din meniul editorului. Prima proprietate dezactivează funcția de export a Collabora în backend; a doua controlează vizibilitatea. Setarea doar a semnalizatorului de vizibilitate nu este o măsură de control al accesului.

CODE este editorul de documente. Într-o integrare standard, o gazdă WOPI separată, cum ar fi Nextcloud, ownCloud sau o aplicație personalizată, stochează fișierul original și furnizează Collabora metadate și permisiuni ale fișierului. Acesta este motivul pentru care permisiunile de export sunt de obicei configurate în integrarea gazdei, nu ca un comutator universal în fișierul . al containerului Collabora coolwsd.xml.

Alegeți controlul care corespunde acțiunii

Folosește primele două câmpuri pentru sarcina restrânsă de blocare a funcției Descărcare ca/exportare din Collabora. Adaugă celelalte controale numai dacă politica ta acoperă și acele acțiuni separate. Lipsa unui element de meniu nu dovedește în sine că descărcările sunt blocate.

Decideți unde să aplicați restricția

Mai întâi identificați aplicația care stochează fișierul și îl deschide în Collabora. În terminologia WOPI, acea aplicație este gazda. Collabora apelează CheckFileInfoendpoint-ul gazdei pentru a obține informații și capacități despre fișier. Gazda știe cine a deschis documentul și dacă o partajare, un cont sau o politică de fișiere permite descărcări.

• Nextcloud sau o altă platformă integrată de fișiere: utilizați setarea de partajare sau vizualizare securizată acceptată dacă versiunea instalată oferă o politică „Ascundere descărcare” sau echivalentă. Integrarea poate traduce această politică în permisiuni WOPI. Verificați răspunsul gazdei sau documentația actuală a platformei înainte de a presupune ce căi de export, imprimare, copiere sau descărcare directă blochează.
• Propria gazdă WOPI: actualizați codul care construiește CheckFileInforăspunsul JSON. Calculați restricția din permisiunile utilizatorului autentificat și politica de partajare a fișierului.
• Administrator container CODE fără controlul gazdei: solicitați administratorului gazdei sau dezvoltatorului integrării să impună această politică. Editarea doar a containerului CODE poate ascunde anumite formate opționale din interfață, dar nu oferă o politică de permisiuni WOPI per fișier.

Configurația sursă actuală a programului Collabora descrie extra_export_formatsopțiunile la nivel de interfață: dezactivarea acelor formate opționale le ascunde doar vizual. Nu tratați această setare ca o impunere a exportului pe server. Este destinată prezentării meniului de formatare, nu ca un substitut pentru permisiunile gazdei.

Setați permisiunile de export într-o gazdă WOPI personalizată

1. Găsiți rutiera de răspuns CheckFileInfo

Localizați ruta care răspunde la GET /wopi/files/{id}solicitarea WOPI a Collabora. Confirmați modul în care autentifică token-ul de acces și îl mapează la utilizatorul și fișierul curent. Nu aveți încredere într-un semnalizator furnizat de browser, de exemplu, ?disableExport=truedecât dacă gazda îl validează în funcție de propriile reguli de autorizare.

2. Deduceți decizia din politica gazdei

Folosește datele de control al accesului de pe server pentru a decide dacă această persoană poate exporta acest fișier. Un proprietar de fișier, un editor intern și un vizualizator de linkuri publice pot avea drepturi diferite. Dacă restricția este pentru o singură partajare, determin-o din politica partajării respective, nu dintr-o variabilă de mediu globală care afectează accidental fiecare utilizator.

3. Returnează câmpurile WOPI booleene

Adăugați cele două câmpuri booleene la răspunsul JSON. Acesta este un fragment care va fi îmbinat în CheckFileInforăspunsul complet existent, nu un înlocuitor pentru fișierul și proprietățile utilizator necesare:

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

Păstrați câmpurile obligatorii obișnuite și indicatoarele de capabilitate pe care integrarea dvs. le furnizează deja. Folosiți valori booleene JSON trueși false, nu șiruri de caractere precum "true"sau "1". Când exportul este permis, returnați false sau omiteți proprietățile opționale în funcție de comportamentul acceptat de integrarea dvs. și de versiunea Collabora.

4. Blocați Salvare ca separat dacă politica o impune

Exportul într-un format local și salvarea unei copii înapoi pe gazda WOPI sunt operațiuni diferite. Dacă utilizatorii nu trebuie să creeze o copie „Salvare ca” prin intermediul editorului, returnați comanda UserCanNotWriteRelative: trueși faceți ca gazda să respingă solicitarea de scriere relativă corespunzătoare. Nu presupuneți că acest lucru DisableExportblochează fiecare copie sau cale de salvare. De asemenea, includeți comanda DisablePrint: truedoar atunci când imprimarea este acoperită de politică.

Aplicați setarea echivalentă într-o platformă integrată

Când Nextcloud gestionează fișierul și partajarea, cea mai puțin invazivă rută este propria permisiune de descărcare ascunsă sau vizualizare securizată, dacă este disponibilă pentru tipul și versiunea de partajare respectivă. Sursa Richdocuments Nextcloud curentă mapează o politică de descărcare ascunsă pe partea gazdă la fișierele DisableExportși HideExportOptioncâmpurile Collabora, împreună cu restricțiile de imprimare și copiere. Controalele exacte expuse unui administrator pot varia în funcție de versiunea, ediția și tipul de partajare Nextcloud, așadar confirmați comportamentul în produsul instalat, în loc să copiați un patch WOPI personalizat în fișierele aplicației sale.

Dacă mențineți o altă gazdă WOPI, implementați câmpurile în răspunsul său CheckFileInfo. Evitați modificarea configurației containerului generat de Collabora pentru a adăuga chei nedocumentate: răspunsul WOPI este locul unde se comunică permisiunile per fișier. După o modificare a codului gazdă, implementați-l utilizând procesul normal de lansare al aplicației respective. O repornire a Collabora nu este, în general, pasul care modifică o decizie de permisiune generată de gazdă; închideți și redeschideți documentul pentru a obține un răspuns CheckFileInfo nou.

Verificați dacă restricția funcționează

1. Deschideți un document de test utilizând un cont care ar trebui restricționat.
2. Verificați răspunsul CheckFileInfo al gazdei WOPI în jurnalele aplicației sau într-o urmărire de dezvoltare sigură. Confirmați că ambele câmpuri sunt booleene JSON setate la adevărat pentru această sesiune.
3. În Collabora, verificați dacă opțiunea „Descărcați ca” nu este selectată și testați acțiunea de export relevantă. Nu utilizați un fișier confidențial real în timpul verificării inițiale.
4. Dacă ar trebui să fie blocată și opțiunea „Salvare ca”, verificați dacă solicitarea de scriere relativă de pe partea gazdei este respinsă. Elementul de meniu poate rămâne vizibil chiar dacă gazda refuză operațiunea.
5. Deschideți un document separat cu permisiune de export. Confirmați că modificarea nu a dezactivat în mod neintenționat exportul pentru toți utilizatorii sau fișierele.
6. Testați descărcarea directă de pe platforma de stocare separat. Indicatorul de export al Collabora nu revocă automat permisiunea utilizatorului de a descărca fișierul original din Nextcloud, ownCloud, WebDAV sau alt endpoint gazdă.

Dacă comanda rămâne vizibilă, confirmați că răspunsul este pentru fișierul și utilizatorul testat, redeschideți documentul pentru a crea o sesiune nouă și verificați dacă gazda trimite într-adevăr HideExportOption. Dacă butonul dispare, dar exportul funcționează în continuare printr-o altă rută, verificați dacă DisableExporteste adevărat și dacă acțiunea este într-adevăr un export Collabora, mai degrabă decât o descărcare oferită de gazda de stocare sau de un handler postMessage specific integrării.

Limite de securitate și recomandări practice

Aceste setări controlează operațiunile de export și salvare acceptate de Collabora; acestea nu pot împiedica un utilizator care poate vizualiza documentul să facă capturi de ecran, să fotografieze ecranul sau să copieze manual informațiile pe care aplicația îi permite să le vadă. De asemenea, Collabora trebuie să primească conținutul documentului pentru a-l reda. Pentru controale mai puternice asupra datelor, combinați restricțiile editorului cu autorizația de descărcare a gazdei fișierului, domeniul de aplicare al token-ului de acces, politica de partajare, înregistrarea în jurnal de audit și orice controale aprobate de organizație pentru filigran sau prevenirea pierderii de date. Descrieți rezultatul ca restricționând căile de export acceptate, nu ca făcând conținutul vizibil imposibil de copiat.

Pentru majoritatea instalărilor CODE, utilizați DisableExportși HideExportOptionîn răspunsul WOPI CheckFileInfo generat de gazdă, în domeniul de aplicare al utilizatorului și documentului aplicabil. Impuneți descărcări directe și Salvare ca la gazdă și verificați atât sesiunile restricționate, cât și pe cele permise după implementare.

Referințe

• Manualul SDK-ului Collabora Online: WOPI CheckFileInfo și DisableExport
• Configurarea sursei Collabora Online: extra_export_formats
• Documentația Microsoft WOPI: CheckFileInfo
• Controler WOPI Nextcloud Richdocuments