So schränken Sie die Dateiexportoptionen in Collabora Online ein (Code)

Um den Dateiexport in Collabora Online CODE einzuschränken, muss der WOPI-Host DisableExport: truein seiner CheckFileInfoAntwort für die betroffene Datei und den betroffenen Benutzer eine entsprechende Meldung zurückgeben. Zusätzlich HideExportOption: truemuss der Befehl „Herunterladen als“ aus dem Editormenü entfernt werden. Die erste Eigenschaft deaktiviert die Exportfunktion von Collabora im Backend; die zweite steuert die Sichtbarkeit. Das Setzen des Sichtbarkeitsflags allein stellt keine Zugriffskontrolle dar.

CODE ist der Dokumenteneditor. Bei einer Standardintegration speichert ein separater WOPI-Host wie Nextcloud, ownCloud oder eine benutzerdefinierte Anwendung die Originaldatei und stellt Collabora die Metadaten und Berechtigungen der Datei bereit. Daher werden Exportberechtigungen üblicherweise in der Hostintegration konfiguriert und nicht als universeller Schalter im Collabora-Container coolwsd.xml.

Wählen Sie das Steuerelement aus, das der Aktion entspricht.

Verwenden Sie die ersten beiden Felder ausschließlich zum Blockieren der Collabora-Funktion „Herunterladen als/Exportieren“. Fügen Sie die weiteren Steuerelemente nur dann hinzu, wenn Ihre Richtlinie auch diese separaten Aktionen abdeckt. Ein fehlender Menüpunkt allein beweist nicht, dass Downloads blockiert sind.

Entscheiden Sie, wo die Beschränkung angewendet werden soll.

Zuerst muss die Anwendung identifiziert werden, die die Datei speichert und in Collabora öffnet. In der WOPI-Terminologie wird diese Anwendung als Host bezeichnet. Collabora ruft den CheckFileInfoEndpunkt des Hosts auf, um Dateiinformationen und -berechtigungen abzurufen. Der Host weiß, wer das Dokument geöffnet hat und ob eine Freigabe, ein Konto oder eine Dateirichtlinie Downloads zulässt.

• Nextcloud oder eine andere integrierte Dateiplattform: Nutzen Sie die unterstützten Freigabe- oder Sicherheitsansichtseinstellungen, falls Ihre installierte Version eine Option zum Ausblenden von Downloads oder eine vergleichbare Richtlinie bietet. Die Integration kann diese Richtlinie in WOPI-Berechtigungen übersetzen. Prüfen Sie die tatsächliche Antwort des Hosts oder die aktuelle Dokumentation der Plattform, bevor Sie annehmen, welche Export-, Druck-, Kopier- oder Direkt-Download-Pfade blockiert werden.
• Ihr eigener WOPI-Host: Aktualisieren Sie den Code, der die CheckFileInfoJSON-Antwort erstellt. Berechnen Sie die Einschränkung anhand der Berechtigungen des authentifizierten Benutzers und der Freigaberichtlinie der Datei.
• Der CODE-Container-Administrator hat keine Kontrolle über den Host: Bitten Sie den Host-Administrator oder Integrationsentwickler, dies durchzusetzen. Die Bearbeitung des CODE-Containers allein kann bestimmte optionale Formate in der Benutzeroberfläche ausblenden, bietet aber keine dateispezifische WOPI-Berechtigungsrichtlinie.

Die aktuelle Quellcode-Konfiguration von Collabora beschreibt extra_export_formatsOptionen auf Benutzeroberfläche: Das Deaktivieren dieser optionalen Formate blendet sie lediglich optisch aus. Diese Einstellung ist nicht als serverseitige Exportkontrolle zu verstehen. Sie dient der Darstellung im Formatmenü und ersetzt nicht die Host-Berechtigungen.

Exportberechtigungen in einem benutzerdefinierten WOPI-Host festlegen

1. Ermitteln Sie den Antworthandler für CheckFileInfo.

Ermitteln Sie die Route, die auf die WOPI- GET /wopi/files/{id}Anfrage von Collabora antwortet. Prüfen Sie, wie das Zugriffstoken authentifiziert und dem aktuellen Benutzer und der Datei zugeordnet wird. Vertrauen Sie keinem vom Browser bereitgestellten Flag, es sei denn, ?disableExport=trueder Host validiert es anhand seiner eigenen Autorisierungsregeln.

2. Die Entscheidung aus der Richtlinie des Gastgebers ableiten.

Verwenden Sie serverseitige Zugriffskontrolldaten, um zu entscheiden, ob diese Person die Datei exportieren darf. Dateibesitzer, interne Bearbeiter und Betrachter eines öffentlichen Links können unterschiedliche Rechte haben. Wenn die Einschränkung für eine einzelne Freigabe gilt, ermitteln Sie sie anhand der Richtlinie dieser Freigabe und nicht anhand einer globalen Umgebungsvariablen, die versehentlich alle Benutzer betrifft.

3. Rückgabe von booleschen WOPI-Feldern

Fügen Sie die beiden booleschen Felder zur JSON-Antwort hinzu. Dies ist ein Fragment, das Sie in Ihre bestehende, vollständige CheckFileInfoAntwort einfügen können, und kein Ersatz für die erforderlichen Datei- und Benutzereigenschaften:

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

Behalten Sie die üblichen Pflichtfelder und Funktionsflags bei, die Ihre Integration bereits bereitstellt. Verwenden Sie JSON-Boolesche Werte true, falsenicht Zeichenketten wie „“ "true"oder „“ "1". Wenn der Export zulässig ist, geben Sie „false“ zurück oder lassen Sie optionale Eigenschaften entsprechend dem von Ihrer Integration und Ihrer Collabora-Version unterstützten Verhalten weg.

4. Blockieren Sie „Speichern unter“ separat, falls die Richtlinie dies erfordert.

Das Exportieren in ein lokales Format und das Speichern einer Kopie auf dem WOPI-Host sind unterschiedliche Vorgänge. Wenn Benutzer keine Kopie über den Editor erstellen dürfen, veranlassen Sie UserCanNotWriteRelative: trueden Host, die entsprechende relative Schreibanforderung abzulehnen. Gehen Sie nicht davon aus, dass dadurch DisableExportjeder Kopier- oder Speicherpfad blockiert wird. Fügen Sie diese Option DisablePrint: truenur dann hinzu, wenn das Drucken von der Richtlinie abgedeckt ist.

Wenden Sie die entsprechende Einstellung in einer integrierten Plattform an.

Wenn Nextcloud die Datei und Freigabe verwaltet, ist die schonendste Methode die Verwendung der eigenen, unterstützten Berechtigungen zum Ausblenden von Downloads oder zum sicheren Anzeigen, sofern diese für den jeweiligen Freigabetyp und die Version verfügbar sind. Der aktuelle Quellcode von Nextcloud RichDocuments ordnet eine hostseitige Richtlinie zum Ausblenden von Downloads DisableExportden HideExportOptionentsprechenden Feldern von Collabora zu, zusammen mit Einschränkungen für Drucken und Kopieren. Die genauen Steuerelemente, die einem Administrator zur Verfügung stehen, können je nach Nextcloud-Version, Edition und Freigabetyp variieren. Prüfen Sie daher das Verhalten im installierten Produkt, anstatt einen benutzerdefinierten WOPI-Patch in die Anwendungsdateien zu kopieren.

Wenn Sie einen anderen WOPI-Host verwenden, implementieren Sie die Felder in dessen CheckFileInfo-Antwort. Vermeiden Sie Änderungen an der von Collabora generierten Containerkonfiguration, um undokumentierte Schlüssel hinzuzufügen: Die Berechtigungen pro Datei werden in der WOPI-Antwort übermittelt. Nach einer Codeänderung am Host stellen Sie die Anwendung gemäß dem normalen Release-Prozess bereit. Ein Neustart von Collabora ändert in der Regel keine vom Host generierten Berechtigungen; schließen Sie das Dokument und öffnen Sie es erneut, um eine aktuelle CheckFileInfo-Antwort zu erhalten.

Überprüfen Sie, ob die Einschränkung funktioniert.

1. Öffnen Sie ein Testdokument mit einem Konto, das eingeschränkt sein sollte.
2. Überprüfen Sie die CheckFileInfo-Antwort des WOPI-Hosts in den Anwendungsprotokollen oder einem sicheren Entwicklungsprotokoll. Stellen Sie sicher, dass beide Felder JSON-Boolesche Werte sind, die für diese Sitzung auf „true“ gesetzt sind.
3. Prüfen Sie in Collabora, ob die Option „Herunterladen als“ fehlt, und testen Sie die entsprechende Exportfunktion. Verwenden Sie für die erste Überprüfung keine echte, vertrauliche Datei.
4. Sollte auch „Speichern unter“ blockiert werden, prüfen Sie, ob relative Schreibvorgänge auf Hostseite abgelehnt werden. Der Menüpunkt kann weiterhin sichtbar bleiben, obwohl der Host den Vorgang verweigert.
5. Öffnen Sie ein separates Dokument mit Exportberechtigung. Prüfen Sie, ob die Änderung den Export für alle Benutzer oder Dateien unbeabsichtigt deaktiviert hat.
6. Testen Sie den direkten Download von der Speicherplattform separat. Die Exportfunktion von Collabora widerruft nicht automatisch die Berechtigung des Benutzers zum Herunterladen der Originaldatei von Nextcloud, ownCloud, WebDAV oder einem anderen Host-Endpunkt.

Wenn der Befehl weiterhin sichtbar ist, überprüfen Sie, ob die Antwort für die getestete Datei und den getesteten Benutzer gilt. Öffnen Sie das Dokument erneut, um eine neue Sitzung zu erstellen, und vergewissern Sie sich, dass der Host tatsächlich sendet HideExportOption. Falls die Schaltfläche verschwindet, der Export aber über einen anderen Weg weiterhin funktioniert, prüfen Sie, ob dies DisableExportzutrifft und ob es sich tatsächlich um einen Collabora-Export und nicht um einen Download des Speicheranbieters oder eines integrationsspezifischen PostMessage-Handlers handelt.

Sicherheitsgrenzen und praktische Empfehlungen

Diese Einstellungen steuern die von Collabora unterstützten Export- und Speichervorgänge. Sie können jedoch nicht verhindern, dass ein Benutzer, der das Dokument anzeigen kann, Screenshots erstellt, den Bildschirm fotografiert oder Informationen, die die Anwendung ihm anzeigt, manuell kopiert. Collabora benötigt außerdem den Dokumentinhalt, um ihn darzustellen. Für eine stärkere Datenkontrolle kombinieren Sie die Einschränkungen des Editors mit der Download-Autorisierung des Dateihosts, dem Zugriffstoken-Bereich, der Freigaberichtlinie, der Protokollierung und allen von Ihrer Organisation genehmigten Wasserzeichen oder Maßnahmen zur Verhinderung von Datenverlust. Beschreiben Sie das Ergebnis als Einschränkung der unterstützten Exportpfade und nicht als Verhinderung des Kopierens sichtbarer Inhalte.

Bei den meisten CODE-Installationen verwenden Sie DisableExportdie HideExportOptionvom Host generierte WOPI-CheckFileInfo-Antwort, beschränkt auf den jeweiligen Benutzer und das entsprechende Dokument. Erzwingen Sie direkte Downloads und das Speichern unter auf dem Host und überprüfen Sie nach der Bereitstellung sowohl eingeschränkte als auch zulässige Sitzungen.

Referenzen

• Collabora Online SDK-Handbuch: WOPI CheckFileInfo und DisableExport
• Collabora Online-Quellkonfiguration: extra_export_formats
• Microsoft WOPI-Dokumentation: CheckFileInfo
• Nextcloud RichDocuments WOPI-Controller