Behebung des ownCloud-Fehlers „Integritätsprüfung fehlgeschlagen“ nach einem Versionsupgrade

Wenn ownCloud nach einem Upgrade die Meldung „Integritätsprüfung fehlgeschlagen“ anzeigt, verwenden Sie den Bericht über ungültige Dateien, um die Fehlerursache zu ermitteln, bevor Sie Änderungen an den Dateien vornehmen. Ein erneuter Scan wiederholt lediglich die Überprüfung; er stellt keine fehlenden Dateien wieder her, macht keine benutzerdefinierten Änderungen rückgängig und installiert keine korrigierte App-Version. Vergleichen Sie die Kerndateien mit der exakten ownCloud-Version, auf die Sie aktualisiert haben. Bei einem Problem mit der App-Signatur suchen Sie nach einem kompatiblen, korrekt signierten App-Update oder kontaktieren Sie den Entwickler.

Die richtige Vorgehensweise hängt vom Umfang der Warnung ab. Nach einem teilweisen oder gemischten Versions-Upgrade kann das Ersetzen der gesamten Installation sicherer sein, erfordert jedoch längere Ausfallzeiten und die sorgfältige Sicherung von Konfiguration und Benutzerdaten. Das Ersetzen einer bestätigten Kerndatei ist schneller, aber nur, wenn Sie sicherstellen können, dass die Datei zur installierten Version gehört. Das Deaktivieren der Signaturprüfung kann eine bestimmte Anwendung zwar nutzbar machen, verringert aber den Schutz und sollte als dokumentierte Ausnahme und nicht als routinemäßige Lösung behandelt werden.

Zuerst muss herausgefunden werden, was schiefgelaufen ist.

Melden Sie sich als Administrator an und öffnen Sie die Admin-Seite. Folgen Sie der Integritätswarnung zur Liste der ungültigen Dateien. In der aktuellen ownCloud-Dokumentation gruppiert der Bericht Probleme nach Komponenten, z. B. Kerndateien oder einer App, und verwendet Bezeichnungen wie „<Komponentenname>“, INVALID_HASH„ FILE_MISSING<Pfad> “, „<App-Name> EXTRA_FILE“ und EXCEPTION„<Fehlerursache>“. Diese Bezeichnungen weisen auf unterschiedliche Ursachen hin. Notieren Sie sich daher Komponente, Pfad und Fehler, bevor Sie Änderungen vornehmen.

  • INVALID_HASHDies bedeutet, dass der aktuelle Inhalt einer Datei nicht mit dem Hashwert in ihren Signaturdaten übereinstimmt. Häufige Ursachen sind ein unvollständiges Upgrade, eine verbliebene alte Datei oder eine lokale Bearbeitung.
  • FILE_MISSINGDas bedeutet, dass eine signierte Datei fehlt. Dies kann durch eine unvollständige Archivextraktion oder -bereitstellung verursacht werden.
  • EXTRA_FILEDies bedeutet, dass die Installation eine Datei enthält, die nicht in der Signatur aufgeführt ist. Es könnte sich um einen versehentlich hinzugefügten Überrest, eine benutzerdefinierte Datei oder eine legitime lokale Ergänzung handeln, die überprüft werden muss.
  • EXCEPTIONDies bedeutet, dass ownCloud die Signatur nicht verifizieren konnte. Der Bericht kann beispielsweise darauf hinweisen, dass Signaturdaten fehlen, das Zertifikat ungültig oder widerrufen ist oder die Überprüfung nicht abgeschlossen werden konnte.

Löschen Sie keine Datei, nur weil sie als überflüssig angezeigt wird. Prüfen Sie ihre Funktion und wer sie hinzugefügt hat. Bearbeiten Sie insbesondere niemals die App-Konfiguration, signature.jsonum die Warnung zu unterdrücken; die Richtlinien von ownCloud zur Codesignierung verbieten ausdrücklich jegliche Änderungen.

Wählen Sie eine Reparaturmethode auf Grundlage der vorliegenden Beweise.

FindenBevorzugter nächster SchrittAbtausch
Nach einem manuellen Upgrade weisen mehrere Kerndateien ungültige Hashwerte auf oder fehlen.Erstellen Sie eine neue Kopie der exakten Zielversion und stellen Sie die betroffenen offiziellen Dateien wieder her, oder wiederholen Sie das manuelle Upgrade vollständig.Ein sauberes Upgrade ist zwar aufwändiger und kann Ausfallzeiten erfordern, verringert aber das Risiko, einen Code-Baum mit gemischten Versionen zu hinterlassen.
Eine Kerndatei ist ungültig, und Sie wissen, dass sie lokal bearbeitet wurde.Vergleichen Sie die Bearbeitung mit der entsprechenden Release-Datei; behalten Sie die benutzerdefinierte Änderung außerhalb des signierten Kernbaums bei und wenden Sie sie nur dann erneut an, wenn dies unterstützt wird.Das Beibehalten der Änderung kann das lokale Verhalten erhalten, während die Bearbeitung signierter Kerndateien weiterhin zu fehlgeschlagenen Integritätsprüfungen führt.
Eine App meldet fehlende oder ungültige SignaturdatenInstallieren Sie eine kompatible Version vom Entwickler der App oder deaktivieren/entfernen Sie die App, falls sie nicht mehr benötigt wird.Ein Update erhält die Funktionalität; durch Deaktivierung wird der Code der App umgangen, aber es können Funktionen entfernt werden, auf die Benutzer angewiesen sind.
Ein App-Zertifikat wurde widerrufen oder ist ungültig.Bitten Sie den App-Entwickler um eine neu signierte, kompatible Version; verwenden oder verändern Sie keine Signaturdateien.Dies kann zwar einige Zeit in Anspruch nehmen, gewährleistet aber die Gültigkeit der Signaturvalidierung.
Eine zusätzliche Datei wurde identifiziertPrüfen Sie vor dem Verschieben aus dem Installationsverzeichnis, wem die Datei gehört, welchen Zweck sie hat und ob sie Teil einer Anpassung ist.Das Entfernen einer unbekannten Datei kann eine lokale Integration beeinträchtigen oder wichtige Daten löschen.

ownCloud 11 führt eine versionsspezifische Änderung ein: Drittanbieter-Apps benötigen gültige Signaturen, um installiert, aktualisiert oder aktiviert werden zu können. Nicht signierte Apps können blockiert statt nur markiert werden. Laut der ownCloud-Dokumentation 11.0 werden Apps mit dem alten Signaturverfahren bis zum 31. Dezember 2026 mit einer Warnung akzeptiert (Stand: 6. Oktober 2026). Danach werden nur noch Signaturen der neuen PKI als vertrauenswürdig eingestuft. Wenn Sie ownCloud 10.x verwenden, konsultieren Sie bitte die Dokumentation Ihrer spezifischen Version und gehen Sie nicht davon aus, dass die Regeln von Version 11.0 automatisch gelten.

Bereiten Sie vor, bevor Sie die Installation ändern.

  1. Prüfen Sie die aktuelle Serverversion und die vom Upgrade-Prozess angezeigte Zielversion. Überprüfen Sie die zugehörigen Versionshinweise und Systemvoraussetzungen, einschließlich der unterstützten PHP-Versionen.
  2. Erstellen Sie eine aktuelle Sicherungskopie der Datenbank, der Konfiguration und des Datenverzeichnisses. Bewahren Sie den aktuellen Codebaum oder einen Dateisystem-Snapshot auf, sofern Ihre Bereitstellungsmethode dies unterstützt.
  3. Versetzen Sie den Server vor dem Austausch von Code während einer Reparatur in den Wartungsmodus. Verwenden Sie die für Ihre Installation dokumentierte Methode und stellen Sie sicher, dass Benutzer während des Vorgangs keine Dateien schreiben.
  4. Ermitteln Sie, wie ownCloud installiert wurde: per Archiv/manuell, als Betriebssystempaket oder über Docker. Befolgen Sie die entsprechende Aktualisierungsprozedur. Verwenden Sie keine Dateien aus einem Tarball in einer paketverwalteten Installation.
  5. Bewahren Sie den Originalbericht auf und notieren Sie jede Datei, die Sie verschieben oder ersetzen. Dies erleichtert das Zurücksetzen und die spätere Fehlersuche erheblich.

Diese Vorsichtsmaßnahmen sind wichtig, da eine Integritätswarnung den ausführbaren Anwendungscode betrifft, während Datenbank und Benutzerdateien separate Bestandteile der Installation sind. Das Wiederherstellen eines alten Codeverzeichnisses über neuere, paketverwaltete Dateien kann selbst zu Inkompatibilitäten führen. ownCloud empfiehlt in seinen Upgrade-Richtlinien, vor einem Upgrade ein aktuelles Backup zu erstellen, die Versionshinweise und Systemvoraussetzungen zu prüfen und die Kompatibilität mit Drittanbieter-Apps zu überprüfen.

Repariere Kerndateien nach einem Teil-Upgrade

Wenn im Bericht offizielle Core-Pfade wie z. B. , oder Dateien im Core-Verzeichnis genannt werden index.php, version.phpbesorgen Sie sich das offizielle Archiv für die exakt vorgesehene Version. Verwenden Sie kein neueres Archiv, nur weil es verfügbar ist: Die Integritäts-Hashes beziehen sich auf eine bestimmte Version.

Bei einer kleinen, nachvollziehbaren Abweichung vergleichen Sie den gemeldeten Pfad mit dem entsprechenden Pfad im Archiv. Nachdem Sie bestätigt haben, dass es sich um eine unveränderte offizielle Datei handelt, ersetzen Sie nur die betroffene Datei und achten Sie dabei auf die Einhaltung der für Ihren Webserver erforderlichen Eigentumsrechte und Berechtigungen. Falls mehrere Dateien fehlen oder nicht übereinstimmen oder Sie nicht feststellen können, welche Version die Live-Dateien bereitgestellt hat, ist ein vollständiges Upgrade aus einem aktuellen Release-Verzeichnis in der Regel die zuverlässigere Option.

Bei einer manuellen Archivinstallation empfiehlt es sich, die Version separat bereitzustellen, die entsprechenden Dateien zu sichern configund dataanschließend die offiziellen Upgrade-Schritte zum Verschieben des Codes zu befolgen. Das Benutzerdatenverzeichnis darf nicht mit Archivinhalten überschrieben werden. Paket- und Containerbereitstellungen verfügen über eigene Aktualisierungsverfahren; verwenden Sie diese anstelle der manuellen Archivierungsmethode. Bei der Übertragung einzelner Dateien per FTP ist in der ownCloud-Dokumentation der binäre Übertragungsmodus angegeben.

App-Warnungen separat behandeln

Wenn im Bericht eine App anstelle des Kerns genannt wird, prüfen Sie zunächst, ob diese App Ihre ownCloud-Version unterstützt. Installieren Sie eine offizielle oder vom Entwickler bereitgestellte Version, die mit dem Server kompatibel ist und eine gültige Signatur besitzt. Falls keine kompatible Version existiert, deaktivieren Sie die App und stellen Sie sicher, dass dadurch kein erforderlicher Arbeitsablauf unterbrochen wird. Das Entfernen einer App ist eine endgültige Lösung und sollte gemäß den Anweisungen des App-Entwicklers erfolgen.

Bei ownCloud 11 ist die Deaktivierung der Validierung für eine bestimmte App eine vom Administrator gesteuerte Ausnahme, die protokolliert wird und den Integritäts- und Widerrufsschutz für diese App aufhebt. Verwenden Sie diese Option nur nach Prüfung der Quelle und der Auswirkungen der App und dokumentieren Sie, wer die Ausnahme genehmigt hat und warum. Sie eignet sich nicht zur Reparatur einer beschädigten oder manipulierten Core-Installation. Bei älteren Versionen kann das Verhalten der Validierung abweichen. Lesen Sie daher die Dokumentation Ihrer installierten Version.

Führen Sie eine erneute Überprüfung durch und bestätigen Sie das Ergebnis.

Nachdem Sie die zugrunde liegenden Dateien korrigiert haben, verwenden Sie die Funktion „Erneuter Scan“ auf der Admin-Seite, sofern verfügbar. Alternativ können Sie die dokumentierten occPrüfungen ausführen. Für Docker Compose enthält die aktuelle ownCloud-Codesignaturanleitung folgende Beispiele:

docker compose exec owncloud occ integrity:check-core
docker compose exec owncloud occ integrity:check-app calendar

Ersetzen Sie calendar<App-ID> durch die in Ihrem Bericht angegebene App-ID. Bei Installationen ohne Container rufen Sie die occDatei aus Ihrem ownCloud-Verzeichnis als Webserver-Benutzer auf. Der genaue Pfad und Benutzer variieren je nach Betriebssystem und Installationsmethode. Der dokumentierte Befehl prüft entweder den Kern oder eine bestimmte App. Laut der aktuellen Anleitung gibt es keinen Befehl zum manuellen Scannen aller Apps.

Eine Reparatur gilt als abgeschlossen, wenn ein neuer Bericht die korrigierten Dateien nicht mehr auflistet und die betreffende Funktion normal funktioniert. Sollte derselbe Hash-Fehler erneut auftreten, suchen Sie nach einer automatisierten Bereitstellung, einem lokalen Patch, einem Synchronisierungsauftrag oder einem Sicherheitsvorfall, der die Datei erneut verändert. Weist der Bericht auf ein widerrufenes Zertifikat, eine fehlende App-Signatur oder eine Versionsabweichung hin, die Sie nicht durch eine offizielle Version beheben können, beenden Sie den Scan und wenden Sie sich mit dem Bericht und der genauen Serverversion an den App-Entwickler oder den ownCloud-Support.

Welchen Ansatz sollten Sie wählen?

Wählen Sie einen gezielten Dateiaustausch, wenn der Bericht eine offizielle Kerndatei identifiziert, die genaue Version bekannt ist und Sie die passende Originaldatei beschaffen können. Wiederholen Sie das saubere Upgrade, wenn viele Kerndateien fehlschlagen, das Upgrade unterbrochen wurde oder die Installation Dateien aus mehreren Versionen enthält. Bei App-spezifischen Fehlern empfiehlt sich ein Update durch den Maintainer oder die Deaktivierung einer nicht verwendeten App. Dadurch wird die betroffene Komponente behoben, ohne dass nicht zugehörige Kerndateien ersetzt werden müssen. Validierungsausnahmen sollten für eine bestimmte, geprüfte App reserviert werden, wenn kein signierter Ersatz verfügbar ist und der betriebliche Bedarf den Verlust des Integritätsschutzes überwiegt.

Vor dem nächsten Upgrade sollten Sie zunächst die Versionshinweise und Systemvoraussetzungen prüfen, inkompatible Drittanbieter-Apps gemäß den Empfehlungen von ownCloud deaktivieren und ein aktuelles Backup erstellen. Diese Schritte erfordern zwar etwas Planungszeit, erleichtern aber die Diagnose von Integritätswarnungen nach dem Upgrade und gewährleisten eine sicherere Wiederherstellung.

Offizielle Referenzen

Einen Kommentar hinterlassen

Die 10 besten Ping-Sweep-Tools zum Auffinden von Geräten in Ihrem Netzwerk

Die 10 besten Ping-Sweep-Tools zum Auffinden von Geräten in Ihrem Netzwerk

Vergleichen Sie 10 Ping-Sweep-Tools für die schnelle LAN-Erkennung, plattformübergreifende Scans und IP-Adressverwaltung. Erfahren Sie, was ein Sweep liefern kann – und was nicht.

Die 6 besten Netzwerkmanagement-Tools zur Leistungsüberwachung

Die 6 besten Netzwerkmanagement-Tools zur Leistungsüberwachung

Vergleichen Sie sechs Netzwerkmanagement-Tools für die Leistungsüberwachung, einschließlich SNMP-Abdeckung, Mapping, Warnmeldungen, Bereitstellungsmodelle und Kosten-Nutzen-Verhältnisse.

Die besten WLAN-Analysatoren für Windows, iOS und Android

Die besten WLAN-Analysatoren für Windows, iOS und Android

Vergleichen Sie die besten Wi-Fi-Analyseprogramme für Windows, iPhone und Android, einschließlich Tools für Kanalüberlastung, Signalabdeckung, Heatmaps und Netzwerk-Fehlerbehebung.

QoS in Netzwerken: Was Quality of Service bewirkt und wie es funktioniert

QoS in Netzwerken: Was Quality of Service bewirkt und wie es funktioniert

Erfahren Sie, was QoS in der Netzwerktechnik bedeutet, wie DSCP-Markierungen und Datenverkehrswarteschlangen Sprach-, Video- und Geschäftsanwendungen priorisieren und was QoS nicht beheben kann.

Beste SFTP-Server-Software für sichere Dateiübertragungen

Beste SFTP-Server-Software für sichere Dateiübertragungen

Vergleichen Sie zuverlässige SFTP-Server-Software für Windows und Linux, darunter OpenSSH, Bitvise, SolarWinds und SFTPGo. Finden Sie die passende Lösung für Ihre Sicherheits- und Dateitransferanforderungen.

Die 10 besten Tools zum Scannen und Analysieren drahtloser Geräte für Windows, iOS und Android

Die 10 besten Tools zum Scannen und Analysieren drahtloser Geräte für Windows, iOS und Android

Vergleichen Sie 10 Tools zum Scannen und Analysieren drahtloser Netzwerke für Windows, iOS und Android mit klaren Hinweisen zu Wi-Fi-Kanälen, Abdeckungskarten, LAN-Prüfungen und Plattformbeschränkungen.

Bewährte Methoden für die Netzwerküberwachung: Was sollte überwacht werden und welche Tools eignen sich?

Bewährte Methoden für die Netzwerküberwachung: Was sollte überwacht werden und welche Tools eignen sich?

Erstellen Sie eine praktische Netzwerküberwachung mit klarer Geräteabdeckung, nützlichen Leistungskennzahlen, umsetzbaren Warnmeldungen und einem Vergleich von SolarWinds NPM, PRTG und OpManager.

Die 7 besten IP-Adressverwaltungstools für Netzwerkteams

Die 7 besten IP-Adressverwaltungstools für Netzwerkteams

Vergleichen Sie sieben IP-Adressverwaltungstools für Subnetzerkennung, DNS- und DHCP-Koordination, Netzwerkinventarisierung und Open-Source-IPAM.

Die 10 besten Netzwerk-Scanner-Tools zur Erkennung von Geräten und IPs

Die 10 besten Netzwerk-Scanner-Tools zur Erkennung von Geräten und IPs

Vergleichen Sie Netzwerk-Scanner-Tools für die schnelle Geräteerkennung, plattformübergreifende IP-Scans und Enterprise IPAM mit Hinweisen zur Auswahl der passenden Option für Ihr Netzwerk.

Wie man Nmap für Traceroute verwendet und den Netzwerkpfad liest

Wie man Nmap für Traceroute verwendet und den Netzwerkpfad liest

Verwenden Sie die Option --traceroute von Nmap, um Hops einem autorisierten Host zuzuordnen, die Hop- und RTT-Ausgabe zu verstehen und fehlende Antworten zu beheben, ohne übermäßig zu scannen.