Correggi il controllo host WOPI di CODE abbinando l'origine host

Quando Collabora Online CODE segnala "Host WOPI non autorizzato", aggiungi l'host di archiviazione file effettivo, solitamente l'origine Nextcloud, all'elenco degli host WOPI consentiti da CODE. L'host deve corrispondere all'origine che CODE riceve nella richiesta WOPI, non all'URL pubblico del server Collabora. In Docker, questa impostazione viene generalmente configurata tramite una aliasgroup1variabile d'ambiente.

Cosa sta rifiutando il CODICE

WOPI sta per Web Application Open Platform Interface, il protocollo utilizzato da un server aziendale per aprire e salvare file tramite una piattaforma di archiviazione. L' host WOPI è tale piattaforma di archiviazione, come ad esempio Nextcloud. CODE verifica l'host specificato nella richiesta WOPI confrontandolo con gli host di cui si fida. Se la richiesta specifica un host cloud.example.comdiverso da quello di cui CODE è configurato per fidarsi office.example.com, l'editor può rifiutare la sessione prima che venga aperta.

In una configurazione self-hosted, il nome host nella richiesta potrebbe essere un nome interno di Docker, anziché nextcloudil nome host visibile al browser. Anche un proxy inverso, una porta diversa o URL pubblici e interni separati possono far sì che l'origine sia diversa. Configura ciò che la richiesta utilizza effettivamente, non quello che sembra essere il nome del server "principale".

Trova il CODICE host che viene rifiutato

1. Riproduci l'errore una volta, quindi controlla il log del container CODE in quel momento. Con Docker Compose, esegui docker compose logs --since=10m collabora, sostituendo collaboracon il nome del tuo servizio.
2. Cerca un messaggio simile a questo No acceptable WOPI hosts found matching the target host [cloud.example.com] in config. Annota l'host di destinazione mostrato tra parentesi. Non copiare o condividere un URL WOPI completo: potrebbe contenere un token di accesso di breve durata.
3. Confronta quel nome host e quello schema con l'URL che la tua integrazione di archiviazione pubblicizza a CODE. In Nextcloud, la guida alla risoluzione dei problemi consiglia di verificare che l'URL configurato sia l'URL di Nextcloud e che CODE possa raggiungerlo. Controlla l' WOPISrchost, se disponibile nei log di integrazione, mantenendo riservato qualsiasi token della stringa di query.

Consenti l'origine corretta nel CODICE

Per l'immagine Docker ufficiale di CODE, impostarla aliasgroup1sull'origine WOPI attendibile esatta. Per una singola installazione di Nextcloud, un servizio Compose può includere:

services:
  collabora:
    image: collabora/code
    environment:
      aliasgroup1: "https://cloud.example.com:443"

Sostituisci l'esempio con il tuo host Nextcloud reale e con lo schema e la porta utilizzati dalla richiesta WOPI. Mantieni il tag dell'immagine, le impostazioni dell'amministratore, la rete e le altre opzioni di servizio esistenti nel tuo file Compose. L'esempio utilizza un'origine HTTPS con la porta 443; una diversa implementazione potrebbe utilizzare un'altra porta o un'origine interna.

Dopo aver modificato il file Compose, ricrea il contenitore CODE in modo che riceva l'ambiente aggiornato:

docker compose up -d --force-recreate collabora

Utilizza il nome effettivo del tuo servizio Compose al posto di collabora. Un semplice riavvio potrebbe non caricare i valori modificati dell'ambiente del container; la ricreazione del servizio applica la configurazione aggiornata. Se configuri CODE tramite il suo file XML, controlla storage.wopiinvece i gruppi di alias nella configurazione effettiva. Il manuale ufficiale di Collabora SDK documenta i gruppi di alias Docker e gli alias host WOPI; segui la sintassi per la versione di CODE in esecuzione.

Mantieni separate le due liste di elementi consentiti.

Collabora e Nextcloud possono entrambi imporre una restrizione relativa a WOPI, ma rispondono a domande diverse:

La modifica dell'elenco degli indirizzi IP consentiti di Nextcloud non risolverà il problema del rifiuto di un nome host da parte di CODE. Viceversa, l'aggiunta di un nome host a CODE non autorizza l'indirizzo IP di origine di CODE su Nextcloud. La documentazione di Nextcloud raccomanda di limitare le richieste WOPI agli indirizzi IP del server Collabora; utilizzare l'indirizzo osservato da Nextcloud, che può essere diverso in presenza di container o di un proxy inverso.

Verifiche rapide prima di chiudere l'incidente

• Target dice cloud.example.com: consenti che l'host Nextcloud e l'origine appropriata nel CODICE.
• Target segnala nextcloud: CODE sta probabilmente ricevendo un hostname di rete Docker; decidi se tale origine interna è quella prevista, quindi configura l'host attendibile corrispondente e assicurati della raggiungibilità DNS/di rete.
• L'obiettivo corrisponde, ma il rifiuto persiste: verificare che la variabile modificata appartenga al servizio CODE in esecuzione, che Compose abbia ricreato il contenitore e che nessuna configurazione successiva dell'ambiente o XML sovrascriva l'impostazione.
• Il log cambia in un errore DNS, TLS, timeout o CheckFileInfo: il controllo di autorizzazione dell'host potrebbe ora avere esito positivo. Invece di ampliare l'elenco degli host WOPI, è consigliabile esaminare la risoluzione dei nomi, l'attendibilità dei certificati, il routing o la risposta di informazioni sui file dell'integrazione di archiviazione.
• Nextcloud segnala un indirizzo di richiesta non autorizzato: controlla l'elenco degli indirizzi IP consentiti di Nextcloud e l'indirizzo IP del client effettivamente rilevato.

Non risolvere un'incongruenza fidandoti di ogni host o utilizzando un carattere jolly illimitato in un ambiente di produzione. Mantieni l'elenco degli host consentiti limitato alle origini di archiviazione note. Se si utilizzano più host di archiviazione, configura i gruppi di alias documentati per la versione di CODE installata, anziché fare supposizioni sul comportamento dei caratteri jolly.

Verifica la correzione

Apri un documento tramite la stessa integrazione Nextcloud che ha generato l'errore. Quindi controlla i log di CODE aggiornati: il messaggio di errore "Nessun host WOPI accettabile" dovrebbe essere scomparso. Verifica che il documento venga caricato e possa essere salvato; se compare un nuovo errore, utilizza il relativo messaggio per identificare il livello successivo. Per i due controlli degli host e la procedura di risoluzione dei problemi di Nextcloud, consulta la sezione Risoluzione dei problemi di Nextcloud Office e Configurazione di Nextcloud Office . Per i gruppi di alias Docker di CODE, consulta il manuale di Collabora Online SDK 25.04 ; se la configurazione è diversa, utilizza la documentazione corrispondente alla versione installata.