Exporturi de fișiere bloc în CODE Collabora prin WOPI

Pentru a împiedica utilizatorii să exporte un document deschis în CODE Collabora Online, configurați gazda WOPI să returneze o valoare în răspunsul "DisableExport": truedocumentului respectiv . Documentația de integrare Collabora descrie acest lucru ca dezactivarea funcționalității de export; atunci când este setată, opțiunea de meniu Descărcare ca este, de asemenea, ascunsă. [Download as] modifică doar interfața, deci nu este controlul potrivit atunci când scopul este de a interzice exportul. Consultați proprietățile de răspuns CheckFileInfo extinse ale Collabora .CheckFileInfoHideExportOption

Folosește permisiunea WOPI, nu o setare doar din meniu

CODE este componenta de editare dintr-o integrare WOPI. Serviciul de stocare sau de aplicație acționează ca gazdă WOPI și furnizează informații pentru fiecare fișier atunci când Collabora deschide un document. Acest lucru face ca gazda să fie locul potrivit pentru a decide dacă un anumit utilizator poate exporta un anumit fișier.

În obiectul JSON returnat de endpoint-ul gazdei CheckFileInfo, includeți proprietatea booleană:

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

Acesta este un fragment ilustrativ, nu un răspuns CheckFileInfo complet. Păstrați celelalte câmpuri obligatorii și orice proprietăți de integrare existente pe care gazda le returnează deja. Valoarea cheii trebuie să fie o valoare booleană JSON, nu șirul de text "true". Setați-o folosind aceeași decizie de autorizare pe care o folosește aplicația dvs. pentru fișier și utilizatorul curent.

De exemplu, o organizație ar putea permite personalului să editeze un registru de lucru confidențial pentru buget, împiedicându-i în același timp să utilizeze funcțiile de export ale Collabora. Când gazda WOPI deschide registrul de lucru respectiv pentru un membru al personalului, aceasta returnează DisableExport: true. Pentru un șablon public sau un document obișnuit, gazda poate returna o valoare falseconform politicii sale. O valoare statică aplicată fiecărui document este potrivită numai dacă fiecare utilizator și document ar trebui să primească aceeași restricție.

Actualizați gazda WOPI care deservește fișierul

1. Identificați punctul final de integrare. Găsiți ruta gazdă care răspunde CheckFileInfosolicitării WOPI a Collabora pentru fișier. În Nextcloud, ownCloud sau alt produs de stocare, aceasta înseamnă în mod normal modificarea stratului de integrare sau de politică care generează răspunsul; editarea configurației globale a containerului Collabora nu înlocuiește permisiunea per fișier a gazdei.
2. Aplicați regula la domeniul de aplicare corect. Derivați valoarea din utilizatorul autentificat, clasificarea fișierelor, permisiunile de partajare sau o altă regulă din aplicația dvs. Pentru o politică simplă pentru toți utilizatorii, returnați true pentru fiecare document relevant. Evitați să vă bazați pe o preferință de meniu din browser sau pe o valoare furnizată de client.
3. Returnează valoarea booleană în CheckFileInfo. Asigură-te că răspunsul este un JSON valid și include proprietatea în răspunsul primit de Collabora. O modificare a politicii la nivel de cod poate necesita implementarea sau repornirea aplicației gazdă WOPI, în funcție de framework-ul său; CODE-ul în sine poate să nu necesite o modificare de configurație atunci când gazda furnizează dinamic câmpul.
4. Redeschideți documentul. Închideți sesiunea curentă de editare și deschideți din nou fișierul sub contul afectat. CheckFileInfo este consultat ca parte a fluxului de deschidere a documentului, așadar o sesiune deja deschisă poate să nu reflecte o permisiune modificată.

Fișierul, clasa, setarea sau interfața administrativă exactă variază în funcție de gazda WOPI și de versiunea produsului. Documentația Collabora definește câmpul, dar nu prescrie o setare universală pentru Nextcloud sau pentru aplicații terțe. Dacă gazda dvs. nu expune o restricție de descărcare, verificați documentația de administrare curentă a produsului respectiv sau implementați politica în calea de răspuns WOPI acceptată.

Când ar trebui să setați și HideExportOption?

Setați HideExportOptionla truemomentul în care doriți ca controlul „Descărcare ca” să fie ascuns fără a impune interdicția de export. Pentru o restricție reală, preferați DisableExport: true; Ghidul de integrare Collabora spune că acest lucru implică și comportamentul de ascundere a meniului. Returnarea ambelor câmpuri ca fiind adevărate poate face intenția explicită într-o integrare, dar nu ar trebui să fie necesară pentru comportamentul documentat.

Nu confundați acest lucru cu extra_export_formatsintrările din coolwsd.xml. Șablonul de configurare actual al Collabora spune explicit că dezactivarea acelor formate opționale le ascunde doar vizual și nu dezactivează exportul pe server. Aceste opțiuni controlează ce formate suplimentare sunt oferite, nu dacă un utilizator este autorizat să exporte un document. Consultați șablonul de configurare actual al Collabora Online înainte de a modifica setările globale.

Ce protejează – și ce nu – această restricție

DisableExportse aplică funcționalității de export a aplicației Collabora pentru sesiune. Este utilă atunci când utilizatorii ar trebui să editeze un fișier în browser, dar nu ar trebui să utilizeze funcțiile de export sau Descărcare ale editorului. Nu elimină în sine accesul utilizatorului la fișierul original din serviciul de stocare. Dacă gazda permite în continuare utilizatorului respectiv să descarce fișierul sursă în altă parte, setarea Collabora nu închide calea respectivă.

În mod similar, un utilizator care poate vizualiza conținut poate copia informații manual, poate face capturi de ecran sau poate utiliza alte funcții ale aplicației permise de politica dvs. Nu descrieți această setare ca împiedicând exfiltrarea completă a datelor sau garantând că nu se poate copia conținutul. Pentru a limita accesul la original, impuneți reguli de descărcare și partajare și în gazda WOPI și în aplicația de stocare. Dacă cerința dvs. este ca un utilizator să nu vadă deloc conținutul, refuzați accesul la documente în loc să vă bazați pe un semnalizator de export.

Există, de asemenea, o distincție între ascunderea unui element de interfață și dezactivarea unei operațiuni. Șablonul de configurare Collabora face această distincție pentru setările opționale de format de export, în timp ce câmpul de răspuns WOPI este restricția la nivel de integrare. Prima acțiune este utilă pentru simplificarea meniurilor; a doua este setarea menită să blocheze exporturile prin Collabora. Dacă o integrare existentă se comportă diferit, verificați versiunea sa Collabora și inspectați răspunsul CheckFileInfo real, în loc să presupuneți că un anumit produs gazdă își mapează propria casetă de selectare „dezactivare descărcare” la ambele câmpuri.

Verificați restricția cu un cont de testare

1. Folosește un cont non-administrator care corespunde politicii de restricționare și deschide un document de test într-o sesiune nouă.
2. Confirmați că opțiunea „Descărcare ca” a editorului nu mai este disponibilă. Dacă apare în continuare, verificați răspunsul CheckFileInfo produs pentru acest utilizator și fișier; confirmați că câmpul este boolean trueși că noul răspuns este servit.
3. Testați acțiunea de exportare prin interfața normală Collabora. Politica gazdei ar trebui să se reflecte în comportamentul editorului. Nu trageți concluzia că controlul este aplicat doar pentru că elementul de meniu este ascuns.
4. Verificați separat aplicația de stocare: încercați propria rută de descărcare numai dacă planul de testare permite acest lucru. O descărcare reușită acolo înseamnă că politica de acces la fișierul sursă o permite în continuare, chiar dacă Collabora blochează exporturile.
5. Deschideți un document pentru un utilizator care are permisiunea de a exporta și confirmați că gazda dvs. returnează permisiunea dorită pentru cazul respectiv. Această acțiune detectează regulile care au fost aplicate global din greșeală.

Pentru detalii despre implementare, utilizați referința de integrare WOPI de la Collabora și șablonul de configurare a proiectului . Comportamentul acceptat de CODE poate varia în funcție de versiuni și integrări gazdă, așadar validați răspunsul și rezultatul pentru versiunea pe care o implementați. Nu se pretinde aici că a fost testată o anumită versiune gazdă sau o implementare eșantion.