Come limitare le opzioni di esportazione dei file in Collabora Online CODE

Per limitare l'esportazione di file in Collabora Online CODE, fai in modo che l'host WOPI restituisca un valore DisableExport: truenella sua CheckFileInforisposta per il file e l'utente interessati. Aggiungi HideExportOption: truein modo che anche il comando "Scarica come" venga rimosso dal menu dell'editor. La prima proprietà disabilita la funzione di esportazione di Collabora nel backend; la seconda controlla la visibilità. Impostare solo il flag di visibilità non è una misura di controllo degli accessi.

CODE è l'editor di documenti. In un'integrazione standard, un host WOPI separato, come Nextcloud, ownCloud o un'applicazione personalizzata, memorizza il file originale e fornisce a Collabora i metadati e le autorizzazioni del file. Per questo motivo, le autorizzazioni di esportazione vengono solitamente configurate nell'integrazione host, non come un'opzione universale nel container di Collabora coolwsd.xml.

Scegli il comando corrispondente all'azione

Utilizzate i primi due campi specificamente per bloccare la funzione "Scarica come/Esporta" di Collabora. Aggiungete gli altri controlli solo se la vostra policy prevede anche il blocco di queste singole azioni. La semplice assenza di una voce di menu non è sufficiente a dimostrare che i download siano bloccati.

Decidere dove applicare la restrizione

Innanzitutto, identifica l'applicazione che memorizza il file e lo apre in Collabora. Nella terminologia WOPI, tale applicazione è chiamata host. Collabora chiama l'endpoint dell'host CheckFileInfoper ottenere informazioni e funzionalità relative al file. L'host sa chi ha aperto il documento e se una condivisione, un account o una policy sui file consentono il download.

• Nextcloud o un'altra piattaforma di file integrata: utilizza l'impostazione di condivisione o visualizzazione sicura supportata se la versione installata offre una policy "Nascondi download" o equivalente. L'integrazione può tradurre tale policy in autorizzazioni WOPI. Verifica la risposta effettiva dell'host o la documentazione aggiornata della piattaforma prima di presumere quali percorsi di esportazione, stampa, copia o download diretto vengano bloccati.
• Il tuo host WOPI: aggiorna il codice che genera la CheckFileInforisposta JSON. Calcola la restrizione in base alle autorizzazioni dell'utente autenticato e alla politica di condivisione del file.
• Amministratore del contenitore CODE senza controllo dell'host: chiedere all'amministratore dell'host o allo sviluppatore dell'integrazione di imporre questa impostazione. La modifica del solo contenitore CODE potrebbe nascondere alcuni formati opzionali dall'interfaccia, ma non fornisce una policy di autorizzazioni WOPI per singolo file.

La configurazione sorgente attuale di Collabora descrive extra_export_formatsqueste opzioni a livello di interfaccia: disabilitando i formati opzionali, questi vengono solo nascosti visivamente. Non considerare questa impostazione come un'imposizione di esportazione lato server. È pensata per la visualizzazione nel menu dei formati, non come un sostituto delle autorizzazioni dell'host.

Impostare le autorizzazioni di esportazione in un host WOPI personalizzato

1. Individua il gestore della risposta CheckFileInfo

Individua il percorso che risponde alla GET /wopi/files/{id}richiesta WOPI di Collabora. Verifica come autentica il token di accesso e come lo associa all'utente e al file correnti. Non fidarti di un flag fornito dal browser, a meno ?disableExport=trueche l'host non lo convalidi in base alle proprie regole di autorizzazione.

2. Derivare la decisione dalla politica dell'host

Utilizza i dati di controllo degli accessi lato server per decidere se questa persona può esportare il file. Il proprietario del file, un editor interno e un visualizzatore di link pubblici possono avere diritti diversi. Se la restrizione riguarda una singola condivisione, determinala in base ai criteri di quella condivisione, non in base a una variabile d'ambiente globale che potrebbe accidentalmente influenzare tutti gli utenti.

3. Restituisci i campi booleani WOPI

Aggiungi i due campi booleani alla risposta JSON. Questo è un frammento da integrare nella CheckFileInforisposta completa esistente, non un sostituto delle proprietà obbligatorie relative a file e utente:

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

Mantieni i campi obbligatori e i flag di funzionalità già forniti dalla tua integrazione. Utilizza valori booleani JSON truee false, non stringhe come "true"o "1". Quando l'esportazione è consentita, restituisci false o ometti le proprietà opzionali in base al comportamento supportato dalla tua integrazione e dalla versione di Collabora.

4. Bloccare "Salva con nome" separatamente, se richiesto dai criteri.

L'esportazione in un formato locale e il salvataggio di una copia sull'host WOPI sono operazioni diverse. Se gli utenti non devono creare una copia "Salva con nome" tramite l'editor, tornare indietro UserCanNotWriteRelative: truee fare in modo che l'host rifiuti la corrispondente richiesta di scrittura relativa. Non presumere che DisableExportblocchi ogni copia o percorso di salvataggio. Allo stesso modo, includere DisablePrint: truesolo quando la stampa è coperta dalla policy.

Applicare l'impostazione equivalente in una piattaforma integrata

Quando Nextcloud gestisce i file e le condivisioni, la soluzione meno invasiva è quella di implementare le autorizzazioni di nascondi-scaricamento o visualizzazione sicura supportate dal sistema, se disponibili per quel tipo di condivisione e quella versione. L'attuale codice sorgente di Nextcloud Richdocuments mappa una policy di nascondi-scaricamento lato host ai DisableExportcampi di Collabora HideExportOption, insieme alle restrizioni di stampa e copia. I controlli esatti a disposizione di un amministratore possono variare a seconda della versione, dell'edizione e del tipo di condivisione di Nextcloud, pertanto è consigliabile verificare il comportamento nel prodotto installato anziché copiare una patch WOPI personalizzata nei file dell'applicazione.

Se gestisci un host WOPI diverso, implementa i campi nella sua risposta CheckFileInfo. Evita di modificare la configurazione del contenitore generata da Collabora per aggiungere chiavi non documentate: la risposta WOPI è il punto in cui vengono comunicate le autorizzazioni per singolo file. Dopo una modifica al codice host, distribuiscila utilizzando il normale processo di rilascio dell'applicazione. In genere, il riavvio di Collabora non è il passaggio che modifica una decisione di autorizzazione generata dall'host; chiudi e riapri il documento per ottenere una nuova risposta CheckFileInfo.

Verifica che la restrizione funzioni

1. Aprire un documento di prova utilizzando un account che dovrebbe essere soggetto a restrizioni.
2. Esamina la risposta CheckFileInfo dell'host WOPI nei log dell'applicazione o in una traccia di sviluppo sicura. Verifica che entrambi i campi siano valori booleani JSON impostati su true per questa sessione.
3. In Collabora, verifica che l'opzione "Scarica come" non sia presente e testa la relativa azione di esportazione. Non utilizzare un file riservato reale durante la verifica iniziale.
4. Se si desidera bloccare anche il salvataggio con nome, verificare che la richiesta di scrittura relativa lato host venga rifiutata. La voce di menu potrebbe rimanere visibile anche se l'host rifiuta l'operazione.
5. Apri un documento separato con i permessi di esportazione. Verifica che la modifica non abbia disabilitato inavvertitamente l'esportazione per tutti gli utenti o i file.
6. Esegui separatamente un test di download diretto dalla piattaforma di archiviazione. Il flag di esportazione di Collabora non revoca automaticamente l'autorizzazione dell'utente a scaricare il file originale da Nextcloud, ownCloud, WebDAV o da un altro endpoint host.

Se il comando rimane visibile, conferma che la risposta sia per il file e l'utente che hai testato, riapri il documento per creare una nuova sessione e verifica che l'host invii effettivamente HideExportOption. Se il pulsante scompare ma l'esportazione funziona ancora tramite un altro percorso, verifica che DisableExportsia vero e che l'azione sia effettivamente un'esportazione di Collabora e non un download offerto dall'host di archiviazione o da un gestore postMessage specifico dell'integrazione.

Limiti di sicurezza e raccomandazioni pratiche

Queste impostazioni controllano le operazioni di esportazione e salvataggio supportate da Collabora; non possono impedire a un utente che può visualizzare il documento di acquisire schermate, fotografare lo schermo o copiare manualmente le informazioni che l'applicazione gli consente di visualizzare. Collabora deve inoltre ricevere il contenuto del documento per poterlo visualizzare. Per un controllo dei dati più rigoroso, combina le restrizioni dell'editor con l'autorizzazione al download dell'host di file, l'ambito del token di accesso, i criteri di condivisione, la registrazione degli eventi e qualsiasi filigrana o controllo di prevenzione della perdita di dati approvato dall'organizzazione. Descrivi il risultato come una limitazione dei percorsi di esportazione supportati, non come l'impossibilità di copiare il contenuto visibile.

Per la maggior parte delle installazioni CODE, utilizzare DisableExporte HideExportOptionnella risposta WOPI CheckFileInfo generata dall'host, con ambito all'utente e al documento applicabili. Imporre download diretti e Salva con nome sull'host e verificare sia le sessioni con restrizioni che quelle consentite dopo la distribuzione.

Riferimenti

• Manuale dell'SDK di Collabora Online: WOPI CheckFileInfo e DisableExport
• Configurazione della sorgente Collabora Online: formati di esportazione aggiuntivi
• Documentazione Microsoft WOPI: CheckFileInfo
• Controller WOPI per documenti avanzati di Nextcloud