Esportazione di file a blocchi in Collabora CODE tramite WOPI

Per impedire agli utenti di esportare un documento aperto in Collabora Online CODE, è necessario che l'host WOPI restituisca un valore specifico "DisableExport": truenella risposta del documento CheckFileInfo. La documentazione di integrazione di Collabora descrive questa operazione come la disabilitazione della funzionalità di esportazione; quando è impostata, anche l'opzione di menu "Scarica come" viene nascosta. Questa impostazione HideExportOptionda sola modifica solo l'interfaccia, quindi non è il controllo appropriato quando l'obiettivo è impedire l'esportazione. Consultare le proprietà di risposta estese di CheckFileInfo di Collabora .

Utilizzare l'autorizzazione WOPI, non un'impostazione presente solo nel menu.

CODE è il componente di modifica in un'integrazione WOPI. Il servizio di archiviazione o applicativo funge da host WOPI e fornisce informazioni per ogni file quando Collabora apre un documento. Questo rende l'host il luogo appropriato per decidere se un determinato utente può esportare un file specifico.

Nell'oggetto JSON restituito dall'endpoint dell'host CheckFileInfo, includere la proprietà booleana:

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

Questo è un frammento illustrativo, non una risposta completa di CheckFileInfo. Mantieni gli altri campi obbligatori e le eventuali proprietà di integrazione già restituite dal tuo host. Il valore della chiave deve essere un booleano JSON, non una stringa di testo "true". Impostalo utilizzando la stessa decisione di autorizzazione che la tua applicazione utilizza per il file e l'utente corrente.

Ad esempio, un'organizzazione potrebbe consentire al personale di modificare una cartella di lavoro di bilancio riservata, impedendogli al contempo di utilizzare le funzioni di esportazione di Collabora. Quando l'host WOPI apre tale cartella di lavoro per un membro del personale, restituisce un valore statico DisableExport: true. Per un modello pubblico o un documento ordinario, l'host può restituire falseun valore statico in base alle proprie policy. Un valore statico applicato a ogni documento è appropriato solo se ogni utente e documento deve ricevere la stessa restrizione.

Aggiorna l'host WOPI che fornisce il file

1. Identifica l'endpoint di integrazione. Trova il percorso host che risponde alla richiesta WOPI di Collabora CheckFileInfoper il file. In Nextcloud, ownCloud o un altro prodotto di storage, questo di solito significa modificare il livello di integrazione o di policy che genera la risposta; la modifica della configurazione globale del container di Collabora non sostituisce l'autorizzazione per file dell'host.
2. Applica la regola all'ambito corretto. Ricava il valore dall'utente autenticato, dalla classificazione dei file, dalle autorizzazioni di condivisione o da un'altra regola della tua applicazione. Per una semplice policy per tutti gli utenti, restituisci "true" per ogni documento pertinente. Evita di affidarti a una preferenza del menu del browser o a un valore fornito dal client.
3. Restituisci il valore booleano in CheckFileInfo. Assicurati che la risposta sia un JSON valido e includa la proprietà nella risposta ricevuta da Collabora. Una modifica alla policy a livello di codice potrebbe richiedere la distribuzione o il riavvio dell'applicazione host WOPI, a seconda del framework; il CODE stesso potrebbe non richiedere una modifica alla configurazione quando l'host fornisce il campo dinamicamente.
4. Riapri il documento. Chiudi la sessione corrente dell'editor e riapri il file con l'account interessato. CheckFileInfo viene consultato durante il processo di apertura del documento, pertanto una sessione già aperta potrebbe non riflettere le modifiche alle autorizzazioni.

Il file, la classe, l'impostazione o l'interfaccia amministrativa esatta variano a seconda dell'host WOPI e della versione del prodotto. La documentazione di Collabora definisce il campo, ma non prescrive un'impostazione universale per Nextcloud o per applicazioni di terze parti. Se il tuo host non prevede restrizioni di download, consulta la documentazione di amministrazione del prodotto o implementa la policy nel percorso di risposta WOPI supportato.

Quando è opportuno impostare anche HideExportOption?

Imposta HideExportOptionsu true truequando desideri che il controllo "Scarica come" sia nascosto senza imporre il divieto di esportazione. Per una restrizione effettiva, preferisci DisableExport: true; la guida all'integrazione di Collabora afferma che ciò implica anche il comportamento di occultamento del menu. Restituire entrambi i campi come true può rendere esplicita l'intenzione in un'integrazione, ma non dovrebbe essere necessario per il comportamento documentato.

Non confondere questo con le extra_export_formatsvoci in coolwsd.xml. Il modello di configurazione corrente di Collabora afferma esplicitamente che la disabilitazione di questi formati opzionali li nasconde solo visivamente e non disabilita l'esportazione lato server. Queste opzioni controllano quali formati aggiuntivi vengono offerti, non se un utente è autorizzato a esportare un documento. Consultare il modello di configurazione corrente di Collabora Online prima di modificare le impostazioni globali.

Ciò che questa restrizione protegge e non protegge

DisableExportSi applica alla funzionalità di esportazione di Collabora per la sessione. È utile quando gli utenti devono modificare un file nel browser ma non devono utilizzare le funzioni di esportazione o download dell'editor. Di per sé, non impedisce all'utente di accedere al file originale nel servizio di archiviazione. Se il server consente ancora all'utente di scaricare il file sorgente altrove, l'impostazione di Collabora non blocca tale accesso.

Allo stesso modo, un utente che può visualizzare il contenuto potrebbe essere in grado di copiare manualmente le informazioni, acquisire schermate o utilizzare altre funzionalità dell'applicazione consentite dalla policy. Non descrivere questa impostazione come un modo per impedire completamente l'esfiltrazione dei dati o per garantire che il contenuto non possa essere copiato. Per limitare l'accesso all'originale, applica le regole di download e condivisione anche nell'host WOPI e nell'applicazione di archiviazione. Se il requisito è che un utente non debba visualizzare affatto il contenuto, nega l'accesso al documento anziché affidarti a un flag di esportazione.

Esiste anche una distinzione tra nascondere un elemento dell'interfaccia e disabilitare un'operazione. Il modello di configurazione di Collabora fa questa distinzione per le sue impostazioni opzionali del formato di esportazione, mentre il campo di risposta WOPI rappresenta la restrizione a livello di integrazione. La prima azione è utile per semplificare i menu; la seconda è l'impostazione destinata a bloccare le esportazioni tramite Collabora. Se un'integrazione esistente si comporta diversamente, verifica la sua versione di Collabora e ispeziona la risposta CheckFileInfo effettiva anziché presumere che un particolare prodotto host mappi la propria casella di controllo "disabilita download" a entrambi i campi.

Verifica la restrizione con un account di prova.

1. Utilizza un account non amministratore che corrisponda ai criteri di restrizione e apri un documento di prova in una nuova sessione.
2. Verifica che l'opzione "Scarica come" dell'editor non sia più disponibile. Se appare ancora, esamina la risposta CheckFileInfo generata per questo specifico utente e file; verifica che il campo sia booleano truee che la nuova risposta venga fornita.
3. Verifica l'azione di esportazione tramite la normale interfaccia di Collabora. Le policy del sistema host dovrebbero riflettersi nel comportamento dell'editor. Non concludere che il controllo venga applicato solo perché la voce di menu è nascosta.
4. Verifica separatamente l'applicazione di archiviazione: prova a scaricare il file tramite il suo percorso dedicato solo se il tuo piano di test lo consente. Un download riuscito significa che la policy di accesso al file sorgente lo permette ancora, anche se Collabora blocca le esportazioni.
5. Apri un documento per un utente autorizzato all'esportazione e verifica che il tuo host restituisca l'autorizzazione prevista per quel caso. In questo modo puoi individuare le regole applicate a livello globale per errore.

Per i dettagli di implementazione, consultare la documentazione di riferimento sull'integrazione WOPI di Collabora e il modello di configurazione del progetto . Il comportamento supportato da CODE può variare a seconda delle versioni e delle integrazioni con l'host, pertanto è necessario verificare la risposta e il risultato sulla versione distribuita. Non si garantisce in questa sede che una particolare versione dell'host o un'implementazione di esempio siano state testate.