Blokbestanden exporteren in Collabora CODE via WOPI

Om te voorkomen dat gebruikers een geopend document in Collabora Online CODE exporteren, moet uw WOPI-host "DisableExport": truein het antwoord van dat document een waarde retourneren CheckFileInfo. De integratiedocumentatie van Collabora beschrijft dit als het uitschakelen van de exportfunctionaliteit; wanneer dit is ingesteld, wordt de menuoptie 'Downloaden als' ook verborgen. Deze instelling wijzigt alleen de interface, dus is het niet de juiste controle wanneer het doel is om exporteren te verbieden. Zie de uitgebreide CheckFileInfo-antwoordeigenschappenHideExportOption van Collabora .

Gebruik de WOPI-machtiging, niet een instelling die alleen in het menu beschikbaar is.

CODE is de bewerkingscomponent in een WOPI-integratie. Uw opslag- of applicatieservice fungeert als WOPI-host en levert informatie per bestand wanneer Collabora een document opent. Daardoor is de host de aangewezen plek om te bepalen of een bepaalde gebruiker een bepaald bestand mag exporteren.

Voeg in het JSON-object dat door het CheckFileInfoeindpunt van de host wordt geretourneerd de volgende booleaanse eigenschap toe:

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

Dit is een illustratief fragment, geen volledig CheckFileInfo-antwoord. Behoud de andere verplichte velden en eventuele bestaande integratie-eigenschappen die uw host al retourneert. De sleutelwaarde moet een JSON-boolean zijn, geen tekststring "true". Stel deze in met dezelfde autorisatiebeslissing die uw applicatie gebruikt voor het bestand en de huidige gebruiker.

Een organisatie kan bijvoorbeeld medewerkers toestaan ​​een vertrouwelijk budgetwerkblad te bewerken, maar hen tegelijkertijd de exportfuncties van Collabora ontzeggen. Wanneer de WOPI-host dat werkblad voor een medewerker opent, retourneert deze DisableExport: true. Voor een openbaar sjabloon of een gewoon document kan de host een andere waarde retourneren, falseafhankelijk van het beleid. Een statische waarde die op elk document van toepassing is, is alleen geschikt als elke gebruiker en elk document dezelfde beperking moet krijgen.

Werk de WOPI-host bij die het bestand levert.

1. Identificeer het integratie-eindpunt. Zoek de hostroute die het WOPI- CheckFileInfoverzoek van Collabora voor het bestand beantwoordt. In Nextcloud, ownCloud of een ander opslagproduct betekent dit normaal gesproken dat de integratie- of beleidslaag die het antwoord genereert, moet worden gewijzigd; het bewerken van de globale configuratie van de Collabora-container is geen vervanging voor de per-bestandsmachtiging van de host.
2. Pas de regel toe binnen het juiste bereik. Leid de waarde af van de geauthenticeerde gebruiker, bestandsclassificatie, deelrechten of een andere regel in uw applicatie. Voor een eenvoudig beleid dat voor alle gebruikers geldt, retourneer 'true' voor elk relevant document. Vermijd het gebruik van een voorkeursinstelling in het browsermenu of een door de client aangeleverde waarde.
3. Retourneer de boolean in CheckFileInfo. Zorg ervoor dat het antwoord geldige JSON is en de eigenschap bevat in het antwoord dat Collabora ontvangt. Een beleidswijziging op codeniveau kan, afhankelijk van het framework, het implementeren of herstarten van de WOPI-hostapplicatie vereisen; CODE zelf hoeft mogelijk niet geconfigureerd te worden wanneer de host het veld dynamisch aanlevert.
4. Heropen het document. Sluit de huidige editorsessie en open het bestand opnieuw met het betreffende account. CheckFileInfo wordt geraadpleegd als onderdeel van het proces voor het openen van een document, dus een reeds geopende sessie kan een gewijzigde machtiging mogelijk niet weergeven.

Het exacte bestand, de klasse, de instelling of de beheerdersinterface verschilt per WOPI-host en productversie. De documentatie van Collabora definieert het veld, maar schrijft geen universele Nextcloud- of applicatie-instelling van derden voor. Als uw host geen downloadbeperking biedt, raadpleeg dan de actuele beheerdersdocumentatie van dat product of implementeer het beleid in het ondersteunde WOPI-antwoordpad.

Wanneer moet je HideExportOption ook instellen?

Stel HideExportOptiondit in op true truewanneer u de knop 'Downloaden als' wilt verbergen zonder het exportverbod af te dwingen. Voor een daadwerkelijke beperking kunt u het beste DisableExport: true; gebruiken. De integratiehandleiding van Collabora geeft aan dat dit ook het gedrag impliceert waarbij het menu wordt verborgen. Door beide velden op true in te stellen, kunt u de intentie expliciet maken in een integratie, maar dit zou niet nodig moeten zijn voor het gedocumenteerde gedrag.

Verwar dit niet met de extra_export_formatsvermeldingen in coolwsd.xml. De huidige configuratiesjabloon van Collabora geeft expliciet aan dat het uitschakelen van deze optionele formaten ze alleen visueel verbergt en het exporteren aan de serverzijde niet uitschakelt. Deze opties bepalen welke extra formaten worden aangeboden, niet of een gebruiker gemachtigd is om een ​​document te exporteren. Raadpleeg de huidige configuratiesjabloon van Collabora Online voordat u algemene instellingen wijzigt.

Wat deze beperking wel en niet beschermt

DisableExportDeze instelling is van toepassing op de exportfunctionaliteit van Collabora voor de sessie. Het is handig wanneer gebruikers een bestand in de browser moeten bewerken, maar de export- of downloadfunctie van de editor niet mogen gebruiken. De instelling verwijdert op zichzelf niet de toegang van de gebruiker tot het originele bestand in de opslagservice. Als de host de gebruiker nog steeds toestaat het bronbestand elders te downloaden, sluit de Collabora-instelling dat pad niet af.

Een gebruiker die de inhoud kan bekijken, kan mogelijk ook handmatig informatie kopiëren, schermafbeeldingen maken of andere applicatiefuncties gebruiken die uw beleid toestaat. Beschrijf deze instelling niet als het voorkomen van alle datalekken of als een garantie dat inhoud niet kan worden gekopieerd. Om de toegang tot het origineel te beperken, moet u ook download- en deelregels afdwingen in de WOPI-host en de opslagapplicatie. Als uw vereiste is dat een gebruiker de inhoud helemaal niet mag zien, moet u de toegang tot het document weigeren in plaats van te vertrouwen op een exportvlag.

Er is ook een onderscheid tussen het verbergen van een interface-item en het uitschakelen van een bewerking. De configuratiesjabloon van Collabora maakt dit onderscheid voor de optionele instellingen voor het exportformaat, terwijl het WOPI-antwoordveld de beperking op integratieniveau aangeeft. De eerste actie is handig om menu's te vereenvoudigen; de tweede is de instelling die bedoeld is om exporteren via Collabora te blokkeren. Als een bestaande integratie zich anders gedraagt, controleer dan de Collabora-release en inspecteer het daadwerkelijke CheckFileInfo-antwoord in plaats van aan te nemen dat een specifiek hostproduct zijn eigen selectievakje "downloaden uitschakelen" aan beide velden koppelt.

Controleer de beperking met een testaccount.

1. Gebruik een niet-beheerdersaccount dat voldoet aan het beperkingsbeleid en open een testdocument in een nieuwe sessie.
2. Controleer of de optie 'Downloaden als' van de editor niet langer beschikbaar is. Als deze nog steeds verschijnt, inspecteer dan het CheckFileInfo-antwoord dat voor deze specifieke gebruiker en dit bestand is gegenereerd; controleer of het veld een boolean-waarde heeft trueen of het nieuwe antwoord wordt weergegeven.
3. Test de exportfunctie via de normale Collabora-interface. Het beleid van de host moet worden weerspiegeld in het gedrag van de editor. Ga er niet van uit dat de controle wordt afgedwongen enkel omdat het menu-item verborgen is.
4. Test de opslagtoepassing afzonderlijk: probeer de downloadroute alleen als uw testplan dit toestaat. Een succesvolle download betekent dat het toegangsbeleid voor het bronbestand dit nog steeds toestaat, zelfs als Collabora exporten blokkeert.
5. Open een document voor een gebruiker die mag exporteren en controleer of uw host de juiste machtiging voor dat geval retourneert. Dit voorkomt dat regels per ongeluk globaal zijn toegepast.

Raadpleeg voor implementatiedetails de WOPI-integratiereferentie van Collabora en de projectconfiguratiesjabloon . Het ondersteunde gedrag van CODE kan variëren tussen releases en hostintegraties, dus controleer de respons en het resultaat op de versie die u implementeert. Er wordt hier niet beweerd dat een specifieke hostversie of voorbeeldimplementatie is getest.