"Convalida della prova WOPI non riuscita" significa che un host WOPI non è riuscito a verificare una richiesta firmata da Collabora Online. In una tipica configurazione di Nextcloud Office, Nextcloud è l'host WOPI e Collabora è il client WOPI: Collabora invia la richiesta firmata e l'host la verifica. La formulazione esatta varia a seconda dell'integrazione e della versione, quindi è necessario innanzitutto identificare quale componente ha emesso il messaggio e quale richiesta non è andata a buon fine.
La verifica è un controllo di sicurezza, non un test di connettività generico. Associa una richiesta al token di accesso, all'URL completo della richiesta e a un timestamp, quindi firma tali dati con la chiave di prova privata di Collabora. L'host verifica la firma utilizzando una chiave di prova pubblica pubblicata nel file XML di discovery di Collabora. La definizione del protocollo WOPI descrive i campi e le intestazioni firmati.
Prima azione: riprodurre l'errore una volta, annotare l'ora, l'azione sul file, lo stato HTTP e l'ID della richiesta o della correlazione, quindi esaminare sia il registro della piattaforma di archiviazione che coolwsdil registro di Collabora per lo stesso evento. Non pubblicare token di accesso, intestazioni di prova o chiavi private nel ticket.
| Prova | Area probabile da ispezionare | Prossima azione |
|---|---|---|
| L'errore si è verificato dopo la rigenerazione o la sostituzione della chiave di prova di Collabora. | XML di rilevamento memorizzato nella cache lato storage o chiave non corrispondente | Aggiorna la procedura di rilevamento sull'host WOPI e verifica che visualizzi la chiave pubblica per l'istanza Collabora attiva. |
| Il guasto si verifica solo su alcune richieste o in modo intermittente | Più nodi Collabora con chiavi di prova diverse o cache di rilevamento incoerente | Confronta i valori della chiave di prova pubblicati da ogni nodo e verifica il routing del bilanciatore di carico. |
| L'errore si verifica dopo una modifica del proxy, del nome host o dell'URL. | URL di richiesta diversi utilizzati per la firma e la verifica | Confronta l'URL completo chiamato da Collabora con l'URL utilizzato dall'host WOPI per convalidare la prova. |
| Si verifica un solo errore in un host o in un percorso di rete. | Configurazione di raggiungibilità, proxy inverso o lista di host consentiti | Verificare la connettività in entrambe le direzioni e ispezionare separatamente la lista degli host consentiti WOPI dalla convalida della prova. |
| Nessuna modifica recente alla configurazione e un timestamp di prova vengono rifiutati | Sincronizzazione dell'orologio o analisi/verifica della validità dei timestamp | Verificare l'ora UTC e lo stato NTP su entrambi i sistemi; verificare l'interpretazione del timestamp dell'host e la durata consentita. |
Collabora pubblica le sue funzionalità WOPI e le informazioni sulla chiave di prova all'endpoint di rilevamento. Da una macchina in grado di raggiungere l'URL di Collabora utilizzato dal server di archiviazione, ispeziona:
curl -fsS https://office.example.com/hosting/discoveryCerca nel file XML un proof-keyelemento con un ID corrente valuee, se presente, un ID oldvalue. Non confondere questo materiale pubblico con la chiave privata memorizzata sul server Collabora. Il confronto più utile è la risposta di rilevamento ottenuta dall'host WOPI stesso, poiché un browser o la workstation di un amministratore potrebbero ricevere una risposta diversa tramite DNS, un proxy o una cache.
Verificato: l'integrazione WOPI di Collabora utilizza firme di prova e la chiave pubblica viene resa disponibile tramite il processo di rilevamento. Azione: recuperare i dati di rilevamento dall'host/container effettivo che convalida le richieste, quindi verificare che l'XML sia valido e corrisponda all'endpoint di Collabora configurato nella piattaforma di archiviazione. La guida al binding di Collabora per SharePoint descrive la generazione della chiave di prova e il comportamento di rilevamento.
Su Collabora, controlla il log di avvio per individuare eventuali avvisi relativi alla mancanza o all'illeggibilità del file della chiave di prova. Il servizio Collabora deve essere in grado di leggere la chiave privata per la firma. Per le distribuzioni preconfigurate, il percorso di configurazione e l'account di servizio possono variare; verifica la directory configurata del servizio e i relativi punti di montaggio del volume del container, anziché presumere un percorso host.
Documentare coolconfig generate-proof-keyi casi in cui la configurazione automatica della chiave non ha funzionato. Non eseguire questo comando come procedura di risoluzione dei problemi di routine su un cluster funzionante. La generazione di una nuova chiave modifica l'identità di firma. Se il sistema di archiviazione si fida ancora di una risposta di rilevamento precedente, le richieste potrebbero continuare a fallire finché l'host non aggiorna la chiave pubblica utilizzata.
sudo coolconfig generate-proof-keyUtilizza quel comando solo dopo aver verificato che la chiave sia assente o non valida e dopo aver pianificato come ogni nodo Collabora e host WOPI riceverà le informazioni sulla chiave corrispondente. Quindi segui la procedura di ricaricamento del servizio documentata per la distribuzione del pacchetto o del container e recupera nuovamente il rilevamento dal percorso di rete del validatore.
Un singolo server Collabora può funzionare correttamente mentre una distribuzione con bilanciamento del carico presenta errori intermittenti. Ad esempio, un nodo potrebbe avere una chiave privata appena generata, mentre un altro potrebbe ancora utilizzare la vecchia chiave per firmare; un host con dati di rilevamento memorizzati nella cache potrebbe non fidarsi di nessuna delle due chiavi in modo coerente. Questa è una causa dipendente dalla distribuzione, non una prova che ogni errore intermittente sia causato dalla rotazione delle chiavi.
Azione: recuperare i dati /hosting/discoverytramite il bilanciatore di carico e direttamente da ciascun backend, se consentito. Confrontare i valori della chiave pubblica e verificare che la cache di rilevamento dell'host WOPI sia aggiornata. Se i nodi utilizzano intenzionalmente chiavi separate, verificare che l'integrazione dello storage supporti tale topologia; in caso contrario, mantenere la configurazione della chiave di prova coerente in tutto il cluster. L'aggiornamento del rilevamento deve utilizzare il meccanismo supportato dall'integrazione. Evitare di modificare la cache del database o di riavviare servizi non correlati senza prove.
La prova copre l'URL assoluto della richiesta WOPI in maiuscolo, così come il token e il timestamp. Questo rende rilevante la riscrittura dell'URL. Un proxy inverso può modificare il nome host, lo schema, la porta, il percorso o l'escape visibili esternamente. Se Collabora firma una richiesta per un URL ma l'host WOPI ricostruisce un URL diverso per la verifica, una firma corretta può risultare non valida.
Azione: correlare una richiesta fallita a livello di proxy e di applicazione. Confrontare lo schema, il nome host, la porta esplicita, il percorso e i caratteri codificati rilevati dal validatore con l'URL utilizzato nel codice di validazione della prova. Verificare la gestione di forwarded-host e forwarded-proto solo se l'applicazione si basa su tali intestazioni. Preservare l'URL reale della richiesta; non "risolvere" il problema disabilitando i controlli della firma o fidandosi di intestazioni inoltrate arbitrarie.
La prova WOPI include X-WOPI-TimeStamp. Nella specifica WOPI di Microsoft, questa intestazione è un intero a 64 bit misurato a intervalli di 100 nanosecondi a partire dal 1° gennaio 0001, non un timestamp Unix in secondi. Un validatore personalizzato che lo analizza come secondi Unix, omette cifre, modifica la codifica o assembla i byte firmati in modo errato può rifiutare richieste valide.
La discrepanza dell'orologio è una possibile causa quando un host impone una finestra di validità, ma la tolleranza esatta dipende dall'implementazione della convalida. Le linee guida di Microsoft per Microsoft 365 per il Web utilizzano un controllo di validità di 20 minuti; non si deve presumere che questo valore si applichi a tutte le integrazioni con Collabora. Azione: verificare la sincronizzazione NTP e l'ora UTC sui sistemi Collabora e di archiviazione, quindi esaminare la regola di timestamp e il codice di analisi documentati dall'host.
Verifica anche la struttura a livello di byte se gestisci un host WOPI personalizzato. Il token è in formato UTF-8; le lunghezze sono espresse in byte; l'URL è l'URL assoluto completo in maiuscolo; e il valore del timestamp deve essere rappresentato esattamente come specificato. La chiave pubblica deve corrispondere alla chiave privata utilizzata dall'istanza di Collabora che ha inviato la richiesta.
Una lista di host consentiti WOPI determina quali host di archiviazione Collabora può contattare. La convalida TLS determina se il certificato di un peer di rete è attendibile. La convalida della prova verifica la firma di una richiesta WOPI. Questi controlli sono correlati all'integrazione sicura, ma non sono intercambiabili. Aggiungere un host a una lista di host consentiti non risolverà un'eventuale mancata corrispondenza della firma; disattivare i controlli TLS non correggerà una chiave di prova pubblica obsoleta.
Per le implementazioni di Nextcloud, la guida ufficiale alla risoluzione dei problemi raccomanda di verificare i percorsi HTTP(S) richiesti in entrambe le direzioni, di esaminare i log di Nextcloud e Collabora e di confermare le voci dell'elenco di autorizzazione host WOPI per eventuali avvisi. Azione: seguire la categoria di errore nel log. Testare l'endpoint di rilevamento e la raggiungibilità di rete separatamente dal validatore di prova. Non estendere un elenco di autorizzazione *come soluzione alternativa.
Se il problema persiste, raccogli i log anonimizzati da entrambe le estremità, le versioni di Collabora e di archiviazione, il tipo di implementazione, se sono coinvolti uno o più nodi, l'XML di discovery con i segreti rimossi e il percorso proxy per la richiesta non riuscita. Condividi queste informazioni con il fornitore o i responsabili dell'integrazione. La sola stringa di errore esatta non è sufficiente a stabilire se la causa è un discovery obsoleto, la canonizzazione dell'URL, un problema di orologio o un bug del validatore personalizzato; le prove a livello di richiesta determinano quale percorso seguire.
Scopri come personalizzare ONLYOFFICE Docs con un logo nell'intestazione e i colori dell'interfaccia, inclusi i limiti di licenza, la configurazione del tema JSON, i percorsi Docker e i test.
Per correggere il testo di difficile lettura in LibreOffice Calc, controlla il tema dell'applicazione, il carattere delle celle, i colori di riempimento, gli stili e la formattazione condizionale, quindi verifica l'output di stampa.
Rimuovi in modo sicuro l'avviso di blocco da utente sconosciuto di LibreOffice. Verifica le sessioni attive, proteggi una copia, rimuovi solo i blocchi obsoleti verificati e testa il documento.
Correggi il testo arabo o ebraico che scorre, si allinea o si mescola in modo errato con l'inglese in LibreOffice Writer. Abilita layout di testo complessi, imposta la direzione del paragrafo e verifica il risultato.
Scopri come utilizzare le funzioni CERCA.VERT e CERCA.X in LibreOffice Calc, incluse le corrispondenze esatte, le ricerche a sinistra, i risultati non trovati, la ricerca inversa, le alternative a INDICE/CONFRONTA e gli errori più comuni.
Risolvere i problemi di convalida della prova WOPI di Collabora Online verificando le chiavi di individuazione, la rotazione delle chiavi, gli URL proxy, i timestamp e le liste di host consentiti.
Abilita la funzione "Revisioni" per tutti gli utenti in un documento ONLYOFFICE, mantienila attiva anche dopo la riapertura e comprendi i limiti di un'impostazione predefinita globale.
Confronta i timeout di Collabora Online per singola visualizzazione, fuori fuoco, inattività del documento, salvataggio automatico e proxy, quindi scegli e verifica le impostazioni per la tua implementazione.
Risolvi un problema con la lingua del correttore ortografico di ONLYOFFICE che non cambia. Scopri quando impostare la lingua del documento, selezionare il testo, regolare il rilevamento degli editor desktop e consultare i dizionari.
Ripristina i caratteri Calibri e Arial mancanti in LibreOffice controllando i caratteri di sistema, installando caratteri con licenza o alternative compatibili, aggiornando la cache dei caratteri e verificando l'output di Writer.
