Connetti Collabora Online a ownCloud Infinite Scale

Utilizza il servizio Collaboration di ownCloud Infinite Scale come ponte WOPI tra l'interfaccia web e Collabora Online. Per una nuova installazione, la soluzione più sicura è ocis_fulll'esempio Docker Compose modulare ufficiale di ownCloud, che include Infinite Scale, Collaboration, Collabora e Traefik. Imposta gli URL pubblici di Infinite Scale, Collabora e WOPI, utilizza certificati TLS validi e mantieni coerenti tutte le credenziali di accesso. Non configurare Infinite Scale come se fosse il classico ownCloud Server.

Questa distinzione è confermata dalla documentazione attuale di ownCloud: Infinite Scale integra le suite per ufficio tramite WOPI e il suo servizio di collaborazione. Tale servizio sostituisce il vecchio cs3org/wopiserver esterno nelle versioni più recenti, pertanto gli amministratori che aggiornano un'implementazione precedente devono seguire le istruzioni di migrazione specifiche per la versione installata.

1. Verificare la versione e i prerequisiti di rete

Prima di installare qualsiasi cosa, verificate la versione esatta di Infinite Scale. La documentazione attuale di ownCloud elenca il servizio Collaboration nella documentazione di sviluppo 9.0 e afferma che deve essere avviato separatamente quando Infinite Scale viene eseguito in modalità supervisionata. L'esempio full-stack di ownCloud avverte inoltre che la configurazione dipende dalle versioni che includono il servizio Collaboration e non funziona con le versioni di produzione 5.x. Utilizzate la documentazione e i file Compose corrispondenti alla versione installata; non copiate un esempio rolling release in un sistema di produzione precedente senza averne verificato la compatibilità.

Per una distribuzione pubblica, pianifica nomi host separati come cloud.example.com, office.example.com, e wopi.example.com. Il browser deve poter raggiungere gli URL del cloud e di Collabora, mentre Collabora deve essere in grado di raggiungere l'endpoint WOPI esposto da Infinite Scale. DNS, firewall e trust TLS devono funzionare in entrambe le direzioni. Un host raggiungibile dal tuo laptop ma non dal container di Collabora non è sufficiente.

L'esempio di implementazione di ownCloud utilizza Traefik come proxy inverso e richiede un certificato SSL valido per la configurazione del server. La configurazione di test locale può utilizzare certificati autofirmati, ma le installazioni pubbliche non dovrebbero disabilitare silenziosamente la verifica del certificato. Decidete quali hostname e certificati utilizzerete prima di configurare lo stack.

2. Parti dall'esempio Compose corrispondente di ownCloud

1. Apri la guida ufficiale di ownCloud per la distribuzione completa e modulare di oCIS con WebOffice e la relativa directory di esempio ocis_full . Per l'ambiente di produzione, seleziona una release o un tag corrispondente alla tua versione di Infinite Scale anziché affidarti al ramo rolling del repository.
2. Esamina il .envfile di esempio. Imposta OCIS_DOMAIN, COLLABORA_DOMAIN, e WOPISERVER_DOMAINsui nomi host che puntano al tuo server. L'esempio abilita Collabora con COLLABORA=:collabora.yml; mantieni questa impostazione se Collabora è l'editor di Office che desideri utilizzare.
3. Imposta credenziali di amministratore sicure e private e segui le indicazioni TLS di produzione dell'esempio. Non lasciare le password di esempio. Se la versione del repository ha modificato i nomi delle variabili d'ambiente o la struttura dei file, utilizza i file della stessa release con tag anziché mescolare istruzioni provenienti da versioni diverse.
4. Prima di avviare Compose, rivedi la sua configurazione. Verifica che i servizi Collabora, Collaboration, Infinite Scale e proxy condividano la rete e la configurazione previste. La guida di ownCloud avverte che, se Collaboration viene eseguito in un container separato, la relativa configurazione di Infinite Scale e i segreti generati devono essere condivisi con gli altri servizi.

L'esempio di implementazione mostra uno stack integrato, non una configurazione universale per ogni installazione esistente. Se utilizzi già Infinite Scale con systemd, Kubernetes o un reverse proxy personalizzato, mantieni tale modello di implementazione e configura il servizio Collaboration e App Registry utilizzando la documentazione relativa a quella versione, anziché avviare un secondo stack completo.

3. Connetti la collaborazione per collaborare con WOPI

Le impostazioni principali identificano l'URL dell'editor e la sorgente WOPI accessibile dall'esterno. Nella documentazione del servizio corrente, COLLABORATION_APP_NAMEè il nome visualizzato dell'app, COLLABORATION_APP_PRODUCTidentifica il prodotto, COLLABORATION_APP_ADDRpunta a Collabora ed COLLABORATION_WOPI_SRCè l'URL che Collabora utilizza per leggere e scrivere file tramite Infinite Scale. Una configurazione concettuale si presenta così:

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=https://wopi.example.com

Utilizza gli URL pubblici effettivi e il formato variabile richiesti dalla tua implementazione. Se i servizi comunicano su una rete interna del container, l'indirizzo interno potrebbe essere appropriato per un contesto, mentre l'URL accessibile dal browser è più adatto a un altro. Non sostituire un nome host specifico del container in un valore che Collabora deve risolvere esternamente.

Il servizio Collaboration richiede anche i valori di runtime di Infinite Scale OCIS_URL, OCIS_JWT_SECRET, OCIS_REVA_GATEWAY, e MICRO_REGISTRY_ADDRESS. Questi devono corrispondere all'istanza in esecuzione; l'esempio full-stack ufficiale fornisce le relazioni di servizio per la propria rete Compose. Non inventare nuovi segreti solo per un servizio né disabilitare i controlli della chiave di prova WOPI per aggirare una mancata corrispondenza. Mantieni la verifica del certificato abilitata per i certificati pubblici attendibili; COLLABORATION_APP_INSECUREè documentato solo come opzione per un certificato dell'app WOPI autofirmato, non come una soluzione generale per la produzione.

Il Registro delle app controlla quale app di Office viene visualizzata per ogni tipo MIME e quale app si apre per impostazione predefinita. Se Collabora è in esecuzione ma i documenti non mostrano l'opzione "Apri con", verifica la configurazione del tipo MIME nel Registro di sistema e il relativo default_appvalore. Il nome utilizzato deve corrispondere al nome dell'app di Office configurata. ownCloud documenta questa impostazione come configurazione YAML; le variabili d'ambiente non sostituiscono la mappatura del tipo MIME.

4. Avviare, testare e diagnosticare l'integrazione

Utilizzando l'esempio ufficiale di Compose, convalida la configurazione generata e quindi avvia lo stack dalla sua directory di distribuzione:

docker compose config
docker compose up -d

Se non si utilizza l'esempio Compose, avviare prima i servizi Gateway, App Provider e Collabora. In modalità supervisionata, la documentazione di ownCloud prevede l'avvio esplicito di Collaboration ocis collaboration server; non si avvia automaticamente. Assicurarsi che le variabili d'ambiente necessarie siano popolate nel processo del servizio Collaboration prima di avviarlo.

1. Apri https://office.example.com/hosting/discoveryin un browser. Un endpoint raggiungibile dovrebbe restituire il file XML di rilevamento di Collabora anziché un errore DNS, TLS o proxy.
2. Accedi a Infinite Scale, apri un documento supportato e scegli Collabora se l'interfaccia utente offre più app di Office. Esegui un test sia su un file esistente sia, se abilitato nel Registro delle app, creando un nuovo documento.
3. Apporta una piccola modifica, attendi che l'indicatore di salvataggio si stabilizzi, chiudi l'editor e riapri il file per verificare che la modifica sia stata salvata.
4. Se l'editor non si apre, esaminare i log di Infinite Scale Collaboration e App Provider, i log di Collabora e i log del reverse proxy allo stesso timestamp. "Host WOPI non autorizzato" indica un problema con la configurazione di attendibilità WOPI di Collabora; un errore di callback o TLS indica un problema di raggiungibilità dell'URL o di attendibilità del certificato; un'opzione app mancante indica un problema con il Registro delle app.

L'integrazione riuscita significa che il browser carica l'editor, la connessione WOPI raggiunge Infinite Scale e le modifiche vengono mantenute dopo la riapertura. I nomi esatti dei container, il collegamento degli URL e la posizione dei file di configurazione dipendono dalla versione di Infinite Scale e dal metodo di implementazione. Per questi dettagli, soprattutto in caso di migrazione dal vecchio server WOPI esterno, consultare la documentazione di ownCloud relativa alla versione in uso.

Riferimenti: configurazione del servizio ownCloud Collaboration , configurazione del registro delle app di ownCloud e note di rilascio e di migrazione di Infinite Scale .