Éliminer les avertissements d'intégrité de Nextcloud en restaurant les fichiers appropriés

Pour faire disparaître l'avertissement « Certains fichiers n'ont pas passé le contrôle d'intégrité » de Nextcloud, ouvrez d'abord les paramètres d'administration → Vue d'ensemble → Liste des fichiers invalides… , puis restaurez ou supprimez uniquement les fichiers identifiés dans le rapport. Ne modifiez pas signature.jsonet ne désactivez pas le contrôle : les erreurs d'intégrité peuvent indiquer une mise à jour incomplète, une personnalisation accidentelle ou un fichier inattendu nécessitant une investigation.

Veuillez lire le rapport avant de modifier les fichiers.

L'avertissement apparaît sur la page Vue d'ensemble de l'administration. La documentation de Nextcloud relative à la signature de code y décrit deux actions utiles : consulter la liste des fichiers invalides et lancer une nouvelle analyse. Le rapport regroupe les problèmes par composant, comme coreun module ou une application, et indique le type d'erreur et le chemin d'accès au fichier. Le manuel d'administration de Nextcloud 35 décrit ces mêmes actions ainsi que les occcommandes d'intégrité.

• INVALID_HASHUn fichier présente une différence par rapport au hachage enregistré dans sa signature. Cela peut être dû à une modification locale, un remplacement incomplet lors d'une mise à jour ou une modification inattendue.
• MISSING_FILE: Un fichier signé est manquant. Il a peut-être été supprimé accidentellement ou omis lors d'une mise à jour.
• EXTRA_FILEUn fichier existe dans l'installation, mais ne fait pas partie de l'ensemble signé. Il peut s'agir d'un fichier local, d'un vestige d'une ancienne version ou d'un élément nécessitant une vérification de sécurité.
• EXCEPTIONLe vérificateur n'a pas pu valider la signature, par exemple parce que les données de signature requises sont manquantes ou invalides. Vérifiez l'application mentionnée et son code source.

Ces étiquettes décrivent le résultat du contrôle, et non sa cause. Un fichier supplémentaire n'est pas automatiquement malveillant, et une différence de hachage ne constitue pas une preuve de compromission. Notez le composant, le chemin d'accès et l'erreur, puis comparez-les avec votre méthode de déploiement et les modifications récentes.

Effectuez une vérification ciblée

Si vous disposez d'un accès shell, exécutez la commande occen tant qu'utilisateur du serveur web depuis le répertoire d'installation de Nextcloud. Le compte et la commande PHP appropriés peuvent varier selon le système d'exploitation, l'image conteneur, Snap ou l'hébergeur. Sur une installation Apache standard sous Debian ou Ubuntu, avec Nextcloud installé /var/www/nextcloudet l'utilisateur web spécifié www-data, utilisez :

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

Remplacez calendarpar l'identifiant de l'application indiqué dans votre rapport. La vérification principale contrôle les fichiers du serveur Nextcloud ; la vérification de l'application contrôle une application spécifique. Le manuel de Nextcloud 35 explique également occ integrity:check-app --allcomment vérifier les applications installées. Une vérification réussie peut ne produire aucun résultat ; utilisez -vcette méthode pour obtenir une confirmation. Si votre installation est conteneurisée ou gérée par un paquet, utilisez la méthode documentée pour l'exécuter occet son interface web, plutôt que de copier ces chemins sans les reproduire.

Restaurez les fichiers à partir d'une source fiable

Pour les fichiers principaux

Pour les versions antérieures INVALID_HASHou MISSING_FILEsupérieures core, utilisez la version exacte de Nextcloud actuellement installée. Téléchargez une archive propre depuis la source officielle ou restaurez les fichiers correspondants à partir d'une sauvegarde ou d'un artefact de déploiement fonctionnel. Comparez la version installée avant de remplacer les fichiers et conservez la configuration spécifique au site ainsi que le répertoire de données. Si plusieurs fichiers essentiels sont corrompus après une mise à niveau interrompue, réparez le déploiement ou relancez la procédure de mise à niveau recommandée pour ce type d'installation au lieu de remplacer les fichiers individuellement.

Pour EXTRA_FILEvérifier le chemin d'accès et identifier le créateur du fichier, déplacez-le hors du répertoire de code Nextcloud s'il ne fait pas partie de l'installation. Conservez-en une copie au préalable s'il contient des éléments personnalisés nécessaires. Si le fichier vous semble inconnu ou suspect, conservez-le pour analyse et consultez les journaux d'accès et l'historique des déploiements avant de le supprimer. Ne supprimez pas de fichiers au hasard simplement pour faire disparaître l'avertissement.

Pour les fichiers d'application

Pour une application signée présentant des fichiers modifiés ou manquants, réinstallez la même version compatible depuis la boutique d'applications Nextcloud officielle ou le canal de distribution de confiance du développeur. Sauvegardez d'abord le répertoire de l'application s'il contient des modifications locales. S'il s'agit d'une application personnalisée ou non signée, un message d'intégrité peut indiquer son statut de signature ou son implémentation ; vérifiez auprès de son développeur plutôt que de générer des données de signature. La documentation de Nextcloud déconseille de modifier le code de l'application signature.json. La signature de code pour le noyau et les applications permet de détecter les modifications et les mises à jour incomplètes ; modifier les hachages enregistrés annule donc cet effet.

Lors du transfert de fichiers de remplacement par FTP, Nextcloud recommande expressément le mode binaire. La conversion en mode texte peut altérer les octets et créer une nouvelle incohérence de hachage.

Effectuez une nouvelle analyse et confirmez le résultat.

1. Exécutez à nouveau la commande d'intégrité du noyau ou de l'application correspondante, ou retournez dans les paramètres d'administration → Vue d'ensemble et sélectionnez Analyser à nouveau… .
2. Vérifiez que le composant concerné ne figure plus dans la liste des fichiers invalides. Si vous avez utilisé l'interface de ligne de commande (CLI), une vérification réussie de l'application ne produit aucun résultat, ou une vérification détaillée confirme le résultat.
3. Rechargez la page Vue d'ensemble et vérifiez que l'avertissement a disparu. S'il persiste, ouvrez le rapport mis à jour ; il peut identifier un autre fichier ou un composant différent.

Si la même erreur se reproduit immédiatement, vérifiez si votre processus de déploiement, une personnalisation ou un volume monté restaure le fichier modifié. En cas d'exception de signature, consultez la version prise en charge de l'application et contactez son responsable. Si le rapport identifie un fichier système dont vous ne pouvez expliquer la présence, considérez-le comme un problème de sécurité et de déploiement, et examinez les sauvegardes fiables et les journaux du serveur avant de poursuivre.

Consultez la documentation officielle de Nextcloud sur la signature de code et l'intégrité , la référence des commandes d'intégrité de Nextcloud 35 et les archives officielles des versions du serveur Nextcloud .