Corrigir o erro "Falha na verificação de integridade" do ownCloud após uma atualização de versão.

Se o ownCloud exibir a mensagem “Falha na verificação de integridade” após uma atualização, use o relatório de arquivos inválidos para identificar o que falhou antes de alterar os arquivos. Uma nova verificação apenas repete a verificação; ela não restaura arquivos ausentes, desfaz edições personalizadas ou instala uma versão corrigida do aplicativo. Para arquivos principais, compare com a versão exata do ownCloud para a qual você atualizou. Para um problema de assinatura do aplicativo, procure uma atualização compatível e assinada corretamente ou entre em contato com o mantenedor.

A solução adequada depende do escopo do aviso. Substituir toda a instalação pode ser mais seguro após uma atualização parcial ou com versões mistas, mas exige mais tempo de inatividade e a preservação cuidadosa da configuração e dos dados do usuário. Substituir um arquivo principal confirmado é mais rápido, mas somente quando você pode verificar se o arquivo pertence à versão instalada. Desativar a validação de assinatura pode tornar um aplicativo específico utilizável, mas reduz a proteção e deve ser uma exceção documentada, não uma correção de rotina.

Primeiro, descubra o que falhou.

Faça login como administrador e abra a página de administração. Siga as instruções do aviso de integridade até a lista de arquivos inválidos. Na documentação atual do ownCloud, o relatório agrupa os problemas por componente, como arquivos principais ou um aplicativo, e usa rótulos como ` <component>`, ` <path>` INVALID_HASH, `<app>` e ` <error>`. Esses rótulos apontam para causas diferentes, portanto, anote o componente, o caminho e o erro antes de fazer alterações.FILE_MISSINGEXTRA_FILEEXCEPTION

• INVALID_HASHSignifica que o conteúdo atual de um arquivo não corresponde ao hash em seus dados de assinatura. Explicações comuns incluem uma atualização parcial, um arquivo antigo deixado no local ou uma edição local.
• FILE_MISSINGSignifica que um arquivo assinado está ausente. Uma extração ou implantação incompleta do arquivo pode causar isso.
• EXTRA_FILESignifica que a instalação contém um arquivo não listado na assinatura. Pode ser um arquivo residual acidental, um arquivo personalizado ou uma adição local legítima que precisa ser revisada.
• EXCEPTIONSignifica que o ownCloud não conseguiu verificar a assinatura. O relatório pode indicar que faltam dados de assinatura, que o certificado é inválido ou revogado, ou que a verificação não pôde ser concluída.

Não exclua um arquivo apenas porque ele aparece como extra. Confirme a sua função e quem o adicionou. Em particular, nunca edite o arquivo de configuração de um aplicativo signature.jsonpara silenciar o aviso; as diretrizes de assinatura de código do ownCloud afirmam explicitamente que ele não deve ser modificado.

Escolha um reparo com base nas evidências.

O ownCloud 11 adiciona uma consideração específica da versão: aplicativos de terceiros devem ter assinaturas válidas para serem instalados, atualizados ou ativados, e um aplicativo inválido pode ser bloqueado em vez de apenas sinalizado. A partir de 6 de outubro de 2026, a documentação do ownCloud 11.0 indica que os aplicativos que usam o esquema de assinatura anterior são aceitos com um aviso até 31 de dezembro de 2026; após essa data, somente as assinaturas sob a nova PKI serão consideradas confiáveis. Se você estiver usando o ownCloud 10.x, consulte a documentação da sua versão específica em vez de presumir que as regras de aplicação da versão 11.0 se aplicam.

Prepare-se antes de alterar a instalação.

1. Confirme a versão do servidor em execução e a versão de destino exibida pelo processo de atualização. Verifique as notas de versão e os requisitos de sistema correspondentes, incluindo as versões do PHP suportadas.
2. Faça um backup completo do banco de dados, da configuração e do diretório de dados. Mantenha a árvore de código atual ou um snapshot do sistema de arquivos, quando o seu método de implantação permitir.
3. Antes de substituir qualquer código durante um reparo, coloque o servidor em modo de manutenção. Utilize o método documentado para a sua instalação e certifique-se de que nenhum usuário esteja gravando arquivos durante a operação.
4. Identifique como o ownCloud foi instalado: arquivo compactado/manual, pacote do sistema operacional ou Docker. Siga o procedimento de atualização dessa instalação. Não misture arquivos de um arquivo tar.gz em uma instalação gerenciada por pacote.
5. Guarde o relatório original e anote todos os arquivos que você mover ou substituir. Isso facilita muito a reversão e o diagnóstico posterior.

Essas precauções são importantes porque um aviso de integridade diz respeito ao código executável do aplicativo, enquanto o banco de dados e os arquivos do usuário são partes separadas da instalação. Restaurar um diretório de código antigo sobre arquivos gerenciados por pacotes mais recentes pode, por si só, criar incompatibilidades. As orientações de atualização do ownCloud recomendam um backup recente, a revisão das notas de versão e dos requisitos, e a verificação da compatibilidade de aplicativos de terceiros antes de uma atualização.

Reparar arquivos principais após uma atualização parcial

Se o relatório mencionar caminhos oficiais do núcleo, como `<caminho_do_núcleo> index.php`, version.php`<caminho_do_núcleo>` ou arquivos na árvore do núcleo, obtenha o arquivo oficial da versão exata que você pretende executar. Não use um arquivo mais recente apenas porque está disponível: os hashes de integridade correspondem a uma versão específica.

Para pequenas incompatibilidades bem compreendidas, compare o caminho relatado com o mesmo caminho no arquivo compactado. Após confirmar que se trata de um arquivo oficial não modificado, substitua apenas o arquivo afetado, preservando a propriedade e as permissões exigidas pelo seu servidor web. Se vários arquivos estiverem faltando ou apresentarem incompatibilidades, ou se você não conseguir determinar qual versão forneceu os arquivos ativos, uma atualização limpa a partir de um diretório de lançamento recente geralmente é a opção mais confiável.

Para uma instalação manual de arquivos compactados, o padrão seguro é preparar a versão separadamente, preservar os arquivos de configuração confige data, em seguida, seguir os passos oficiais de atualização para mover o código para o local correto. Não sobrescreva o diretório de dados do usuário com o conteúdo do arquivo compactado. Implantações de pacotes e contêineres têm seus próprios procedimentos de atualização; use-os em vez de aplicar o método de instalação manual de arquivos compactados. Se estiver transferindo arquivos individuais via FTP, a documentação de integridade do ownCloud especifica o modo de transferência binária.

Gerencie os avisos do aplicativo separadamente.

Se o relatório mencionar um aplicativo em vez do núcleo, verifique primeiro se esse aplicativo é compatível com a sua versão do ownCloud. Instale uma versão oficial ou fornecida pelo mantenedor que seja compatível com o servidor e possua uma assinatura válida. Se não houver uma versão compatível, desative o aplicativo e confirme se isso não interromperá nenhum fluxo de trabalho necessário. Remover um aplicativo é uma opção mais permanente e deve seguir as instruções de remoção do próprio aplicativo.

No ownCloud 11, desabilitar a validação para um aplicativo específico é uma exceção controlada pelo administrador, que é registrada e resulta na perda da integridade e da proteção contra revogação para esse aplicativo. Use-a somente após avaliar a origem e o impacto do aplicativo e documente quem aprovou a exceção e o motivo. Não se trata de uma forma de reparar uma instalação do núcleo corrompida ou adulterada. Para versões anteriores, o comportamento de aplicação disponível difere; portanto, consulte a documentação da sua versão instalada.

Execute uma nova verificação e confirme o resultado.

Após corrigir os arquivos subjacentes, use a opção de reverificação na página de administração, se disponível. Você também pode executar as occverificações documentadas. Para o Docker Compose, o guia atual de assinatura de código do ownCloud fornece os seguintes exemplos:

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

Substitua calendarpelo ID do aplicativo mencionado no seu relatório. Para instalações que não utilizam contêineres, execute o occarquivo a partir do diretório do ownCloud como o usuário do servidor web; o caminho e o usuário exatos variam de acordo com o sistema operacional e o método de instalação. O comando documentado verifica o núcleo ou um aplicativo específico; o guia atual indica que não existe um único comando para verificar manualmente todos os aplicativos.

A correção é verificada quando um novo relatório não lista mais os arquivos corrigidos e o recurso relevante funciona normalmente. Se o mesmo erro de hash persistir, verifique se há alguma implantação automatizada, patch local, tarefa de sincronização ou incidente de segurança que esteja alterando o arquivo novamente. Se o relatório apontar para um certificado revogado, assinatura de aplicativo ausente ou uma incompatibilidade de versão que você não consegue resolver com base em uma versão oficial, pare de repetir a verificação e entre em contato com o mantenedor do aplicativo ou com o suporte do ownCloud, informando o relatório e a versão exata do servidor.

Qual abordagem você deve usar?

Escolha uma substituição de arquivo direcionada quando o relatório identificar um arquivo principal oficial, a versão exata for conhecida e você puder obter o original correspondente. Repita a atualização limpa quando muitos arquivos principais falharem, a atualização for interrompida ou a instalação contiver arquivos de mais de uma versão. Para erros exclusivos do aplicativo, priorize uma atualização do mantenedor ou a desativação de um aplicativo não utilizado; isso resolve o problema do componente afetado sem substituir arquivos principais não relacionados. Reserve exceções de validação para um aplicativo específico e avaliado quando não houver uma substituição assinada e a necessidade operacional superar a perda da proteção de integridade.

Para a próxima atualização, revise primeiro as notas de versão e os requisitos, desative aplicativos de terceiros incompatíveis conforme recomendado pelo ownCloud e faça um novo backup. Essas etapas exigem planejamento, mas facilitam o diagnóstico de avisos de integridade pós-atualização e tornam a recuperação mais segura.

Referências oficiais

• ownCloud 11.0: Assinatura de código e correção de mensagens de integridade de código inválidas
• ownCloud 10.15: Erros de assinatura de código
• ownCloud 10.16: Como atualizar seu ownCloud Classic
• ownCloud 10.15: Fazendo backup do ownCloud
• ownCloud 10.15: Restaurando o ownCloud