Risolvi gli avvisi di integrità di Nextcloud ripristinando i file corretti

Per eliminare l'avviso di Nextcloud "Alcuni file non hanno superato il controllo di integrità", apri innanzitutto le impostazioni di amministrazione → Panoramica → Elenco dei file non validi… , quindi ripristina o rimuovi solo i file identificati nel report. Non modificare signature.jsono disattivare il controllo: gli errori di integrità possono indicare un aggiornamento incompleto, una personalizzazione accidentale o un file imprevisto che richiede un'analisi.

Leggere il rapporto prima di modificare i file.

L'avviso viene visualizzato nella pagina Panoramica dell'amministratore. La documentazione di Nextcloud sulla firma del codice descrive due azioni utili: visualizzare l'elenco dei file non validi e avviare una nuova scansione. Il report raggruppa i problemi per componente, ad esempio coreun'applicazione, e fornisce il tipo di errore e il percorso del file. Il manuale di amministrazione di Nextcloud 35 documenta queste stesse azioni e i occcomandi di integrità.

• INVALID_HASH: un file differisce dall'hash registrato nella sua firma. Una modifica locale, una sostituzione incompleta durante un aggiornamento o una modifica imprevista potrebbero spiegarlo.
• MISSING_FILE: Il file firmato è assente. Potrebbe essere stato rimosso accidentalmente o omesso durante un aggiornamento.
• EXTRA_FILE: un file è presente nell'installazione ma non fa parte del set di file firmati. Potrebbe trattarsi di un file locale, di un residuo di una versione precedente o di un file che richiede una verifica di sicurezza.
• EXCEPTION: il verificatore non è riuscito a convalidare una firma, ad esempio perché i dati di firma richiesti sono mancanti o non validi. Controlla l'app indicata e la sua origine.

Queste etichette descrivono il risultato del controllo, non la causa. Un file aggiuntivo non è automaticamente dannoso e una mancata corrispondenza dell'hash non è prova di compromissione. Registra il componente, il percorso e l'errore e confrontali con il metodo di distribuzione e le modifiche recenti.

Eseguire un controllo mirato

Se hai accesso alla shell, esegui il comando occcome utente del server web dalla directory di installazione di Nextcloud. L'account corretto e il comando PHP possono variare a seconda del sistema operativo, dell'immagine container, di Snap o del provider di hosting. Su una comune installazione di Apache su Debian o Ubuntu, con Nextcloud in /var/www/nextcloude l'utente web www-data, usa:

cd /var/www/nextcloud
sudo -E -u www-data php occ integrity:check-core
sudo -E -u www-data php occ integrity:check-app calendar

Sostituisci calendarcon l'identificativo dell'app mostrato nel tuo report. Il controllo principale verifica i file del server Nextcloud; il controllo dell'app verifica una singola app specifica. Il manuale di Nextcloud 35 documenta anche la procedura occ integrity:check-app --allper il controllo delle app installate. Un controllo riuscito potrebbe non produrre alcun output; utilizzalo -vquando hai bisogno di conferma. Se la tua installazione è containerizzata o gestita da un pacchetto, utilizza il metodo documentato per richiamarlo occe il suo utente web effettivo, anziché copiare questi percorsi senza verificarli.

Ripristina i file da una fonte attendibile

Per i file principali

Per le versioni precedenti INVALID_HASHo MISSING_FILEinferiori core, utilizzare esattamente la versione di Nextcloud attualmente installata. Ottenere un archivio pulito dalla fonte di download ufficiale o ripristinare i file corrispondenti da un backup o un artefatto di distribuzione funzionante. Confrontare la versione installata prima di sostituire i file e preservare la configurazione specifica del sito e la directory dei dati. Se diversi file principali risultano danneggiati dopo un aggiornamento interrotto, riparare la distribuzione o rieseguire la procedura di aggiornamento supportata per quel tipo di installazione anziché sostituire i singoli file in modo casuale.

Per EXTRA_FILE, ispeziona il percorso e stabilisci chi lo ha creato. Sposta un file locale riconoscibile al di fuori della directory del codice di Nextcloud se non fa parte dell'installazione; conservane prima una copia se potrebbe contenere modifiche personalizzate necessarie. Se il file non è familiare o sembra sospetto, conservalo per ulteriori indagini e rivedi i log di accesso e la cronologia delle distribuzioni prima di rimuoverlo. Non eliminare file a caso solo per far scomparire l'avviso.

Per i file dell'app

Per un'app firmata con file modificati o mancanti, reinstalla la stessa versione compatibile dell'app dallo store ufficiale di Nextcloud o dal canale di rilascio affidabile del manutentore dell'app. Esegui prima un backup della directory dell'app se contiene modifiche locali. Se si tratta di un'app personalizzata o non firmata, un messaggio di integrità può riflettere il suo stato di firma o la sua implementazione; verifica con lo sviluppatore anziché generare i dati di firma. La documentazione di Nextcloud sconsiglia di modificare il codice dell'app signature.json. La firma del codice per le app e il core fornisce un modo per rilevare modifiche e aggiornamenti incompleti, quindi la modifica degli hash registrati vanifica tale scopo.

Quando si trasferiscono file sostitutivi tramite FTP, Nextcloud consiglia specificamente la modalità di trasferimento binaria. La conversione in modalità testo può alterare i byte e creare una nuova discrepanza di hash.

Eseguire nuovamente la scansione e confermare il risultato.

1. Eseguire nuovamente il comando di integrità del core o dell'app corrispondente, oppure tornare alle impostazioni di amministrazione → Panoramica e selezionare Riesegui scansione… .
2. Verifica che il componente interessato non compaia più nell'elenco dei file non validi. Se hai utilizzato la CLI, un controllo dell'applicazione superato non produce alcun output, oppure un controllo dettagliato conferma il risultato.
3. Ricarica la pagina Panoramica e verifica che l'avviso sia scomparso. Se persiste, apri il report aggiornato; potrebbe identificare un altro file o un componente diverso.

Se lo stesso errore si ripresenta immediatamente, verifica se il processo di distribuzione, la personalizzazione o un volume montato stanno ripristinando il file modificato. Per le eccezioni di firma, controlla la versione supportata dell'app e consulta il suo manutentore. Se il report identifica un file di sistema di cui non riesci a trovare la causa, consideralo un problema di sicurezza e di distribuzione e controlla i backup attendibili e i log del server prima di procedere.

Consultare la documentazione ufficiale di Nextcloud relativa alla firma del codice e all'integrità , il riferimento ai comandi di integrità di Nextcloud 35 e l' archivio ufficiale delle release del server Nextcloud .