Come configurare la password della console di amministrazione per Collabora Online

Se riesci ad aprire Collabora Online ma non riesci ad accedere alla sua Console di amministrazione, è possibile che le credenziali non siano mai state configurate per il server Collabora. La soluzione dipende da come è stato installato Collabora: un'installazione tramite pacchetto Linux utilizza l' coolconfigutility, mentre l'immagine Docker ufficiale di CODE accetta le variabili d'ambiente usernamee password. Si tratta di percorsi di configurazione separati; scegli quello che corrisponde alla tua implementazione.

La Console di amministrazione è una pagina di gestione lato server. Non corrisponde all'account dell'amministratore di Nextcloud, all'account di accesso di un utente di documenti o alle credenziali di integrazione WOPI. Il Manuale SDK di Collabora 24.04 documenta l'indirizzo della console, il metodo di configurazione Linux e le variabili dell'immagine Docker. Poiché i dettagli di implementazione possono variare tra le diverse versioni, consultare la documentazione relativa alla versione in uso prima di apportare modifiche in produzione: Manuale SDK di Collabora Online 24.04 .

Scegli il metodo di configurazione più adatto alla tua installazione

Innanzitutto, identifica la distribuzione. Se coolwsdviene eseguito direttamente come servizio di sistema e l'host dispone del coolconfigcomando, utilizza il metodo del pacchetto. Se il servizio viene eseguito in un container basato su collabora/code, configura invece il suo ambiente. Evita di impostare una password sull'host e di aspettarti che modifichi un container già in esecuzione.

Per l'installazione di un pacchetto Linux, impostare una password in modo interattivo

1. Apri un terminale sul server Collabora oppure connettiti tramite SSH utilizzando un account con privilegi di sudo.
2. Correre sudo coolconfig set-admin-password.
3. Quando richiesto, inserisci il nome utente e la password della console di amministrazione, quindi conferma la password. Il terminale non dovrebbe visualizzare la password durante la digitazione.
4. Se l'installazione richiede il riavvio del servizio dopo una modifica della configurazione, eseguire sudo systemctl restart coolwsd. Verificare lo stato del servizio con sudo systemctl status coolwsd.
5. Apri l'URL della Console di amministrazione ed effettua l'accesso con le credenziali che hai appena impostato.

L'utility documentata richiede nome utente e password in modo interattivo e memorizza la password come hash con salt nel file di configurazione. Questo è preferibile rispetto all'inserimento di una password in chiaro direttamente nella riga di comando o alla scrittura manuale di una password in XML. Trattare il comando come un'azione amministrativa: eseguirlo sull'host di Collabora, non sull'host di Nextcloud a meno che Collabora non sia installato anche lì.

Se coolconfignon viene trovato, verificare che si tratti di un'installazione di Collabora basata su pacchetto e di essere sul server corretto. Un container CODE ha un proprio meccanismo di configurazione. Se il comando ha esito positivo ma l'autenticazione continua a fallire, verificare il nome host e la porta, riprovare con il nome utente esatto impostato e controllare i log del servizio prima di modificare impostazioni proxy o WOPI non correlate.

Per l'immagine Docker CODE, impostare entrambe le variabili d'ambiente

L'immagine ufficiale di CODE legge usernamee passworddal suo ambiente all'avvio del container. Aggiungi entrambi i valori alla configurazione del container; impostare solo una password non è sufficiente. Per Docker Compose, una mappatura potrebbe essere simile a questa:

services:
  collabora:
    image: collabora/code
    restart: unless-stopped
    ports:
      - "9980:9980"
    environment:
      username: collabora_admin
      password: ${COLLABORA_ADMIN_PASSWORD}

Conservate la password effettiva in un file di ambiente protetto o in un archivio di segreti di distribuzione, anziché inserirla in un repository del codice sorgente o incollarla in una richiesta di supporto pubblica. Un .envfile Compose è comodo per la sostituzione delle variabili, ma rimane comunque un file contenente dati sensibili: limitate chi può leggerlo. Chiunque abbia accesso al demone Docker può generalmente ispezionare la configurazione del container, quindi le variabili d'ambiente non sostituiscono i controlli di accesso sull'host.

Salva il file Compose e ricrea il container in modo che Docker passi l'ambiente aggiornato all'avvio. Per un servizio denominato collabora, questo è in genere docker compose up -d --force-recreate collabora. Un semplice riavvio del container non sostituisce i valori dell'ambiente memorizzati al momento della creazione del container. Verifica la versione di Compose e il nome del servizio prima di eseguire il comando ed evita di visualizzare la password letterale nella cronologia della shell.

Per una docker rundistribuzione diretta, le impostazioni equivalenti sono variabili d'ambiente passate con -e, come -e username=collabora_admine -e password=.... Utilizza il tuo approccio di gestione dei segreti per fornire il valore; non copiare una password di esempio da un tutorial in un servizio esposto a Internet.

Apri la Console di amministrazione e verifica l'accesso.

Il percorso della console documentato è /browser/dist/admin/admin.html. Sulla porta predefinita, l'URL completo è https://your-collabora-host:9980/browser/dist/admin/admin.html. Se la connessione TLS termina su un proxy inverso, utilizzare il nome host HTTPS pubblico e la porta esposti da tale proxy. L'indirizzo potrebbe essere diverso se l'amministratore ha configurato una porta o un routing URL non predefiniti.

Accedi e verifica che la console carichi le informazioni di monitoraggio. Il manuale dell'SDK descrive il monitoraggio delle sessioni in tempo reale, inclusi i documenti aperti e gli utenti. Poiché la console può esporre dettagli operativi e consentire azioni amministrative come la chiusura delle sessioni dei documenti, limita l'accesso agli amministratori attendibili, utilizza HTTPS ed evita di esporre l'endpoint di gestione a Internet pubblico. Applica restrizioni di rete al firewall o al proxy inverso, se la tua implementazione lo supporta.

Per l'installazione di un pacchetto, verifica che il servizio sia integro con sudo systemctl status coolwsd. Per Docker, ispeziona lo stato del container con docker compose pse i suoi log recenti con docker compose logs --tail=100 collabora. Un servizio integro da solo non dimostra che la password sia corretta; la verifica finale è un accesso riuscito all'URL della Console di amministrazione.

Idee sbagliate comuni e cosa fare invece

"La console di amministrazione utilizza la mia password di Nextcloud."

Non per impostazione predefinita. Le credenziali della console di amministrazione di Collabora sono configurate sul server Collabora, indipendentemente dagli account utente di Nextcloud. Azione: utilizzare coolconfig set-admin-passworddurante l'installazione di un pacchetto oppure aggiornare l'ambiente del container CODE e ricreare il container.

"Ho modificato il file Docker Compose, quindi il container in esecuzione ha la nuova password."

La modifica del file non altera l'ambiente salvato di un container esistente. Azione: ricreare il servizio Compose pertinente, quindi testare le nuove credenziali. Evitare di includere la password nell'output dei comandi e nel controllo di versione.

"Se l'URL della console di amministrazione si apre, il server è protetto."

L'accesso alla pagina dimostra solo che il percorso risponde; non dimostra che siano configurate credenziali sicure o che l'accesso alla rete sia limitato. Il manuale dell'SDK afferma che la console viene disabilitata quando non vengono impostati il ​​nome utente o la password richiesti e descrive le funzioni di monitoraggio amministrativo. Azione: impostare una password univoca, verificare che sia richiesta l'autenticazione e limitare chi può raggiungere l'endpoint della console.

"La Console di amministrazione è il luogo in cui impostare le credenziali di modifica dei documenti."

La password della console protegge l'interfaccia di gestione. Non sostituisce la configurazione host WOPI né il sistema di identità utilizzato dalla piattaforma file. Azione: lasciare invariate le impostazioni di WOPI e del reverse proxy, a meno che non si stiano risolvendo problemi relativi a tali connessioni separate.

Se l'accesso continua a non riuscire

• Verifica se Collabora viene eseguito come servizio host o in un container CODE, quindi utilizza solo il percorso di configurazione corrispondente.
• Verifica l'URL esatto della console pubblica, inclusi HTTPS, porta e /browser/dist/admin/admin.html.
• Per Docker, verificare che entrambi usernamesiano passwordpresenti nella configurazione del servizio effettiva e ricreare il container dopo le modifiche.
• Per installare un pacchetto, rieseguire il coolconfigcomando interattivo sull'host Collabora e verificare coolwsdlo stato e i log.
• Se è coinvolto un proxy inverso, chiedi al suo amministratore di verificare che il percorso della Console di amministrazione e tutto il traffico WebSocket necessario vengano instradati correttamente. Non indebolire l'autenticazione per aggirare un problema del proxy.

Una volta effettuato l'accesso e verificato che il servizio funzioni correttamente, memorizza le nuove credenziali nel tuo gestore di password approvato e documenta quale host o container ne è proprietario. La configurazione della console di amministrazione di Collabora può variare a seconda della versione e del metodo di packaging; il manuale dell'SDK 24.04 citato in precedenza è specifico per la versione, quindi utilizza la documentazione corrispondente per una distribuzione più recente o personalizzata dal fornitore.