Come disabilitare la telemetria e le connessioni esterne in Collabora CODE

In breve: Collabora Online Development Edition (CODE) non offre un'opzione generale per disattivare la telemetria che gli amministratori devono disabilitare per le analisi di routine. Collabora afferma che la versione self-hosted di Online non richiede callback di telemetria o analisi. Le attività in uscita che vale la pena controllare sono separate: controlli periodici degli aggiornamenti, integrazioni opzionali, endpoint di monitoraggio e funzionalità dei documenti che recuperano dati remoti. Disabilitate le funzionalità opzionali che non utilizzate, quindi applicate una lista di traffico in uscita consentita mantenendo la connessione WOPI al vostro server di archiviazione.

Questo vale per CODE self-hosted, come ad esempio un'istanza integrata con Nextcloud o ownCloud. Il blocco completo del traffico in uscita può interrompere il caricamento e il salvataggio dei documenti, poiché CODE deve raggiungere il suo host WOPI. I nomi delle configurazioni riportati di seguito sono stati verificati rispetto al modello upstream di Collabora il 6 ottobre 2026; il packaging e le impostazioni predefinite possono variare a seconda della versione.

Cosa si intende per telemetria o connessione esterna?

La telemetria in genere si riferisce ai dati di utilizzo del prodotto o ai dati diagnostici inviati a un fornitore. Collabora afferma che il suo prodotto online self-hosted non richiede telemetria, callback di analisi o connettività a servizi esterni. Il coolwsd.xmlmodello upstream non mostra un raccoglitore di telemetria globale o un interruttore "telefonata a casa".

Viene visualizzato un controllo periodico della versione: fetch_update_checkl'impostazione predefinita è ogni 10 ore. Impostalo su 0per disattivare tale controllo. allow_update_popupControlla se le notifiche di aggiornamento vengono visualizzate nell'editor; impostandolo su falsenasconde la notifica, ma non sostituisce la disabilitazione del controllo stesso. Se la tua versione supporta entrambe le opzioni, impostale entrambe.

Altre connessioni sono basate su funzionalità specifiche. Possono includere un monitor esterno configurato, servizi di controllo ortografico o grammaticale remoti, la traduzione DeepL, provider di intelligenza artificiale, configurazione remota dei font e dati esterni richiesti da un documento. Il modello di riferimento indica che le API remote di LanguageTool o Duden sono disabilitate per impostazione predefinita; anche DeepL è disabilitato per impostazione predefinita. Utilizzare le impostazioni fornite con la propria versione di CODE quando si esaminano le opzioni di intelligenza artificiale o di integrazione.

Fase 1: Individuare le destinazioni essenziali e quelle facoltative

Prima di modificare la rete, mappa il funzionamento della modifica. Ad esempio, supponiamo che Nextcloud si trovi all'indirizzo cloud.example.come CODE all'indirizzo office.example.com. Il browser carica l'editor da CODE, mentre il server CODE comunica con Nextcloud tramite WOPI per recuperare e salvare il documento. Mantieni il percorso da server a server, lo schema e la porta utilizzati dalla tua installazione e qualsiasi servizio DNS o proxy richiesto dalla tua implementazione.

Successivamente, inventaria i servizi opzionali nella tua configurazione effettiva. Cerca <monitors>gli indirizzi di monitoraggio configurati esplicitamente. Verifica il controllo ortografico remoto, DeepL, l'IA, la configurazione remota dei font e gli URL di configurazione remota. Rimuovi gli endpoint personalizzati che non fanno parte di un flusso di lavoro approvato. Se necessario, documenta il nome host e lo scopo prima di creare la corrispondente eccezione di rete.

Esamina anche lok_allow. Controlla quali host i documenti modificati possono utilizzare come fonti di dati esterne, inclusi gli URL utilizzati per la grafica inserita o le funzioni dei fogli di calcolo come WEBSERVICE(). Non è un firewall universale. La configurazione a monte nota che gli host WOPI e POST consentiti possono essere trattati anche come fonti di dati consentite, quindi mantieni questa policy distinta dai controlli in uscita dalla rete.

Passaggio 2: Disabilitare i controlli periodici degli aggiornamenti

Per il contenitore Collabora CODE, imposta le opzioni tramite la relativa extra_paramsvariabile d'ambiente. Uniscile al valore esistente; mantieni le impostazioni correnti di terminazione TLS, reverse proxy o host da cui dipende la tua installazione. Blocca un tag immagine CODE approvato per il tuo ambiente anziché affidarti a un latesttag dinamico.

services:
  collabora:
    image: collabora/code:<approved-tag>
    environment:
      extra_params: >-
        --o:fetch_update_check=0
        --o:allow_update_popup=false

Questo è un frammento di Docker Compose a scopo illustrativo, non un'implementazione completa. Mantieni le restrizioni di dominio, le credenziali di amministratore, le impostazioni TLS e la configurazione del proxy esistenti. In Kubernetes, il chart Helm upstream espone collabora.extra_paramse supporta coolwsd.xmlcontenuti personalizzati; utilizza il file dei valori e le istruzioni per la versione del chart che hai installato.

Se gestisci direttamente il file XML, inserisci i valori all'interno del suo <config>elemento main:

<fetch_update_check>0</fetch_update_check>
<allow_update_popup>false</allow_update_popup>

Non affidarti a una modifica manuale all'interno di un container in esecuzione, a meno che il file non sia persistente. Un riavvio, un aggiornamento dell'immagine o un'implementazione dell'orchestrazione potrebbero sostituirlo. Modifica la sorgente di configurazione persistente di Compose, Helm o montata e ricrea o implementa CODE seguendo la tua normale procedura.

Passaggio 3: Disattiva le integrazioni non utilizzate e limita il recupero dei documenti

Lascia <monitors>vuoto questo campo se non utilizzi un servizio di monitoraggio esterno. Il file upstream contiene un monitor di esempio commentato; una voce commentata è un esempio, non una connessione attiva. Rimuovi le voci di monitoraggio attive aggiunte localmente se non sono più necessarie.

Mantieni disabilitate le funzionalità di controllo ortografico e grammaticale remoto, DeepL e i provider di intelligenza artificiale, a meno che gli utenti non ne abbiano bisogno. Il controllo linguistico remoto può inviare il testo selezionato del documento al servizio configurato, quindi la sua attivazione ha conseguenze sia a livello di connettività che di gestione dei dati. Se è necessaria un'integrazione, consenti solo il suo endpoint approvato attraverso la policy di uscita.

Per i contenuti remoti richiesti dai documenti, rimuovere gli host pubblici <lok_allow>e mantenere solo le destinazioni necessarie agli utenti. Non rimuovere il percorso WOPI per ottenere questo risultato. WOPI è la connessione di archiviazione necessaria per la normale modifica. Si noti inoltre che le voci di rete privata troppo ampie possono consentire il recupero di documenti da un numero di host interni superiore a quello previsto; restringerle laddove la configurazione di rete e la versione di CODE lo consentano.

Passaggio 4: applicare le regole in uscita al di fuori del CODICE

Le impostazioni dell'applicazione disabilitano determinati comportamenti; non garantiscono che il sistema operativo o il processo non possano aprire altre connessioni. Per una protezione più efficace, applica regole in uscita al firewall dell'host, alla rete del container, alla NetworkPolicy di Kubernetes o a un firewall esterno. Utilizza il blocco predefinito per CODE, quindi consenti solo la destinazione WOPI e le dipendenze esplicitamente approvate. Consenti il ​​DNS tramite il servizio di rete utilizzato dalla tua piattaforma.

Nell'esempio precedente, a CODE potrebbe essere consentito di raggiungere cloud.example.comlo schema e la porta configurati per WOPI, mentre le destinazioni pubbliche non correlate potrebbero essere bloccate. Evitate di affidarvi a un indirizzo IP fisso quando l'host di storage si trova dietro un bilanciatore di carico o ha indirizzi variabili. Un gruppo di destinazione gestito o un proxy di uscita controllato sono più facili da gestire. Assicuratevi che qualsiasi proxy sia configurato in modo coerente per il container.

Mantenere separati i percorsi in entrata e in uscita. Il browser deve essere in grado di raggiungere l'endpoint CODE pubblicato e il server di archiviazione potrebbe dover raggiungere CODE per la scoperta o le sessioni dei documenti. Una policy in uscita che consente a CODE di chiamare WOPI non stabilisce tali percorsi in entrata. Allo stesso modo, la modifica lok_allownon disabilita ogni tipo di connessione in uscita.

Passaggio 5: riavviare e verificare i criteri

Riavvia o distribuisci CODE in modo che venga caricata la configurazione effettiva. Controlla i log di avvio per i valori di configurazione caricati e gli avvisi relativi alle impostazioni ignorate. Quindi apri un documento di prova modificabile tramite la normale integrazione con lo storage, apporta una modifica, salvalo, chiudilo e riaprilo. Il documento dovrebbe conservare la modifica.

• Durante l'avvio e la modifica, esamina i log del firewall, del proxy o delle policy di rete. Il traffico WOPI previsto dovrebbe essere consentito.
• Verifica che le destinazioni esterne che intendevi bloccare siano effettivamente negate. Un semplice log di attività non è sufficiente a dimostrare che ogni possibile percorso sia bloccato.
• Trascorso il precedente intervallo di verifica degli aggiornamenti, controlla se il contenitore CODE ha tentato una ricerca di aggiornamenti. Conferma che la finestra di dialogo di aggiornamento non sia presente, qualora fosse stata disabilitata.
• Verifica tutte le funzionalità necessarie agli utenti, inclusi font remoti, traduzione, ausili linguistici, collegamenti a documenti e formule che recuperano dati esterni. Ripristina solo la destinazione specifica approvata richiesta dalla funzionalità.

Se i documenti non si aprono o non si salvano, verificare innanzitutto il DNS e il percorso WOPI da server a server. Se il problema riguarda solo un'immagine esterna o una formula di un foglio di calcolo, esaminare lok_allowseparatamente le impostazioni del firewall. Il blocco di una fonte di dati pubblica, pur mantenendo il funzionamento di WOPI, è il risultato previsto; il blocco dei salvataggi indica che la policy di uscita è troppo permissiva.

Cosa può e non può garantire la disattivazione di queste connessioni

Disattivando il controllo degli aggiornamenti e le integrazioni non utilizzate si riduce l'attività in uscita prevista da CODE. Una policy di rete di tipo "nega per impostazione predefinita" definisce il limite di applicazione. Nessuna delle due gestisce separatamente il traffico proveniente dall'host, dal runtime del container, dalla piattaforma di orchestrazione, dal proxy inverso o dall'agente di monitoraggio. Se il requisito riguarda l'intero server, è necessario controllare anche tali componenti.

Le impostazioni predefinite di configurazione possono cambiare tra una versione e l'altra e le integrazioni possono aggiungere impostazioni. Confronta il modello fornito con l'immagine bloccata con il modello upstream corrente prima del rilascio e testalo nell'ambiente di staging. I riferimenti principali sono il modello di configurazione coolwsd.xml upstream di Collabora , i valori ufficiali del grafico Helm e la sua dichiarazione sulle implementazioni self-hosted e sui servizi esterni .