Blockdatei-Exporte in Collabora CODE über WOPI

Um zu verhindern, dass Benutzer ein geöffnetes Dokument in Collabora Online CODE exportieren, lassen Sie Ihren WOPI-Host "DisableExport": truedie entsprechende Antwort für dieses Dokument zurückgeben CheckFileInfo. Die Integrationsdokumentation von Collabora beschreibt dies als Deaktivierung der Exportfunktion; in diesem Fall wird auch die Menüoption „Herunterladen als“ ausgeblendet. Diese Einstellung allein ändert lediglich die Benutzeroberfläche und ist daher nicht die richtige Methode, um den Export zu verhindern. Weitere Informationen finden Sie in den erweiterten AntworteigenschaftenHideExportOption von Collabora .

Verwenden Sie die WOPI-Berechtigung, nicht eine reine Menüeinstellung.

CODE ist die Bearbeitungskomponente in einer WOPI-Integration. Ihr Speicher- oder Anwendungsdienst fungiert als WOPI-Host und stellt dateispezifische Informationen bereit, sobald Collabora ein Dokument öffnet. Daher ist der Host der geeignete Ort, um zu entscheiden, ob ein bestimmter Benutzer eine bestimmte Datei exportieren darf.

CheckFileInfoFügen Sie die boolesche Eigenschaft in das vom Host-Endpunkt zurückgegebene JSON-Objekt ein:

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

Dies ist ein beispielhafter Ausschnitt, keine vollständige Antwort von CheckFileInfo. Behalten Sie die anderen erforderlichen Felder und alle vorhandenen Integrationseigenschaften bei, die Ihr Host bereits zurückgibt. Der Schlüsselwert muss ein boolescher JSON-Wert sein, keine Textzeichenfolge "true". Verwenden Sie für die Festlegung dieselbe Autorisierungsentscheidung, die Ihre Anwendung für die Datei und den aktuellen Benutzer verwendet.

Eine Organisation könnte beispielsweise Mitarbeitern die Bearbeitung einer vertraulichen Budgetmappe erlauben, ihnen aber gleichzeitig die Exportfunktionen von Collabora untersagen. Wenn der WOPI-Host diese Mappe für einen Mitarbeiter öffnet, gibt er einen bestimmten Wert zurück DisableExport: true. Bei einer öffentlichen Vorlage oder einem normalen Dokument kann der Host falsegemäß seiner Richtlinie einen bestimmten Wert zurückgeben. Ein statischer Wert, der für jedes Dokument gilt, ist nur dann sinnvoll, wenn für jeden Benutzer und jedes Dokument dieselbe Einschränkung gelten soll.

Aktualisieren Sie den WOPI-Host, der die Datei bereitstellt.

1. Identifizieren Sie den Integrationsendpunkt. Ermitteln Sie die Hostroute, die Collaboras WOPI- CheckFileInfoAnfrage für die Datei beantwortet. In Nextcloud, ownCloud oder einem anderen Speicherprodukt bedeutet dies normalerweise, die Integrations- oder Richtlinienebene zu ändern, die die Antwort generiert. Die Bearbeitung der globalen Konfiguration des Collabora-Containers ersetzt nicht die dateispezifischen Berechtigungen des Hosts.
2. Wenden Sie die Regel im richtigen Bereich an. Leiten Sie den Wert vom authentifizierten Benutzer, der Dateiklassifizierung, den Freigabeberechtigungen oder einer anderen Regel Ihrer Anwendung ab. Bei einer einfachen Richtlinie für alle Benutzer geben Sie für jedes relevante Dokument „true“ zurück. Vermeiden Sie es, sich auf eine Browsermenüeinstellung oder einen vom Client bereitgestellten Wert zu verlassen.
3. Geben Sie den booleschen Wert in CheckFileInfo zurück. Stellen Sie sicher, dass die Antwort gültiges JSON ist und die Eigenschaft enthält, die Collabora empfängt. Eine Änderung der Richtlinien auf Codeebene kann je nach Framework die Bereitstellung oder den Neustart der WOPI-Hostanwendung erfordern; der Code selbst benötigt möglicherweise keine Konfigurationsänderung, wenn der Host das Feld dynamisch bereitstellt.
4. Öffnen Sie das Dokument erneut. Schließen Sie die aktuelle Editor-Sitzung und öffnen Sie die Datei erneut unter dem betroffenen Benutzerkonto. Da CheckFileInfo im Rahmen des Dokumentöffnungsprozesses konsultiert wird, spiegelt eine bereits geöffnete Sitzung möglicherweise keine geänderten Berechtigungen wider.

Die genaue Datei, Klasse, Einstellung oder Verwaltungsschnittstelle variiert je nach WOPI-Host und Produktversion. Die Dokumentation von Collabora definiert das Feld, schreibt aber keine universelle Einstellung für Nextcloud oder Drittanbieteranwendungen vor. Falls Ihr Host keine Downloadbeschränkung bereitstellt, prüfen Sie die aktuelle Verwaltungsdokumentation des Produkts oder implementieren Sie die Richtlinie im unterstützten WOPI-Antwortpfad.

Wann sollte man auch HideExportOption aktivieren?

Setzen Sie HideExportOptiondiese Option, truewenn Sie das Steuerelement „Download als“ ausblenden möchten, ohne das Exportverbot zu erzwingen. Für eine tatsächliche Einschränkung DisableExport: trueverwenden Sie die Option `--export ...

Verwechseln Sie dies nicht mit den extra_export_formatsEinträgen in der coolwsd.xmlKonfigurationsvorlage von Collabora. Die aktuelle Konfigurationsvorlage von Collabora gibt ausdrücklich an, dass das Deaktivieren dieser optionalen Formate diese lediglich optisch ausblendet und den serverseitigen Export nicht deaktiviert. Diese Optionen steuern, welche zusätzlichen Formate angeboten werden, nicht aber, ob ein Benutzer zum Exportieren eines Dokuments berechtigt ist. Überprüfen Sie die aktuelle Konfigurationsvorlage von Collabora Online, bevor Sie globale Einstellungen ändern.

Was diese Einschränkung schützt – und was nicht.

DisableExportDiese Einstellung betrifft die Exportfunktion von Collabora für die aktuelle Sitzung. Sie ist hilfreich, wenn Benutzer eine Datei im Browser bearbeiten, aber die Export- oder Download-Funktion des Editors nicht nutzen möchten. Der Zugriff des Benutzers auf die Originaldatei im Speicherdienst wird dadurch nicht automatisch unterbunden. Wenn der Host dem Benutzer weiterhin erlaubt, die Quelldatei an anderer Stelle herunterzuladen, wird dieser Zugriff durch die Collabora-Einstellung nicht blockiert.

Ebenso kann ein Benutzer, der Inhalte ansehen kann, Informationen möglicherweise manuell kopieren, Screenshots erstellen oder andere Anwendungsfunktionen nutzen, die Ihre Richtlinie zulässt. Beschreiben Sie diese Einstellung nicht als Verhinderung jeglicher Datenexfiltration oder als Garantie dafür, dass Inhalte nicht kopiert werden können. Um den Zugriff auf das Original einzuschränken, setzen Sie Download- und Freigaberegeln auch in der WOPI-Host- und Speicheranwendung durch. Wenn Sie sicherstellen möchten, dass ein Benutzer die Inhalte überhaupt nicht sehen darf, verweigern Sie den Dokumentenzugriff, anstatt sich auf ein Exportflag zu verlassen.

Es besteht ein Unterschied zwischen dem Ausblenden eines Interface-Elements und dem Deaktivieren einer Operation. Die Konfigurationsvorlage von Collabora berücksichtigt dies bei den optionalen Exportformat-Einstellungen, während das WOPI-Antwortfeld die Einschränkung auf Integrationsebene darstellt. Die erste Aktion dient der Vereinfachung von Menüs; die zweite Einstellung blockiert Exporte über Collabora. Falls sich eine bestehende Integration anders verhält, überprüfen Sie die Collabora-Version und die tatsächliche CheckFileInfo-Antwort, anstatt anzunehmen, dass ein bestimmtes Host-Produkt seine eigene Checkbox „Download deaktivieren“ beiden Feldern zuordnet.

Überprüfen Sie die Einschränkung mit einem Testkonto.

1. Verwenden Sie ein Nicht-Administrator-Konto, das der Einschränkungsrichtlinie entspricht, und öffnen Sie ein Testdokument in einer neuen Sitzung.
2. Prüfen Sie, ob die Option „Herunterladen als“ des Editors nicht mehr verfügbar ist. Falls sie weiterhin angezeigt wird, überprüfen Sie die für diesen Benutzer und diese Datei generierte CheckFileInfo-Antwort. Stellen Sie sicher, truedass das Feld vom Typ „Boolean“ ist und die neue Antwort übermittelt wird.
3. Testen Sie die Exportfunktion über die normale Collabora-Oberfläche. Die Richtlinien des Hosts sollten sich im Verhalten des Editors widerspiegeln. Schließen Sie nicht allein daraus, dass die Steuerung durchgesetzt wird, nur weil der Menüpunkt ausgeblendet ist.
4. Prüfen Sie die Speicheranwendung separat: Versuchen Sie deren Downloadpfad nur dann, wenn Ihr Testplan dies zulässt. Ein erfolgreicher Download bedeutet, dass die Zugriffsrichtlinie für die Quelldatei dies weiterhin erlaubt, selbst wenn Collabora Exporte blockiert.
5. Öffnen Sie ein Dokument für einen Benutzer mit Exportberechtigung und prüfen Sie, ob Ihr Host die gewünschte Berechtigung für diesen Fall zurückgibt. Dadurch werden Regeln erkannt, die irrtümlich global angewendet wurden.

Für Details zur Implementierung nutzen Sie bitte die WOPI-Integrationsreferenz von Collabora und die Projektkonfigurationsvorlage . Das von CODE unterstützte Verhalten kann je nach Version und Hostintegration variieren. Überprüfen Sie daher die Antwort und das Ergebnis in der von Ihnen eingesetzten Version. Es wird hier nicht garantiert, dass eine bestimmte Hostversion oder eine bestimmte Beispielbereitstellung getestet wurde.