O Duplicator Pro está falhando ao enviar backups para o OneDrive, ou a conexão continua falhando na autorização? Alguns ajustes nas configurações de armazenamento e permissões do OneDrive resolvem ambos os problemas.

Este guia abrange a solução de problemas de armazenamento do OneDrive no Duplicator Pro, desde falhas de upload até erros de conexão e autorização.

Para começar, certifique-se de que está usando a versão mais recente do Duplicator Pro. Verifique o changelog e os requisitos do sistema. Além disso, certifique-se de testar o armazenamento primeiro para garantir que as configurações estão corretas usando o botão de validação.

Resolvendo Falhas de Upload do OneDrive Durante Builds

Se o processo de upload para o OneDrive falhar durante uma compilação, use as soluções abaixo para solucionar o problema.

Solução 1: Reduzir o Tamanho do Bloco de Upload

Isso pode estar relacionado a uma condição de rede temporária. Navegue até Duplicator Pro » Configurações » Armazenamento, expanda a seção OneDrive e reduza o Tamanho do Bloco de Upload abaixo do padrão de 3200 KB. O valor deve ser um múltiplo de 320 KB (mínimo 320 KB).

Solução 2: Reduzir o Tamanho do Bloco de Download

Se os downloads do OneDrive estiverem falhando, reduza o Tamanho do Bloco de Download abaixo do padrão de 10240 KB (mínimo 2048 KB) na mesma seção do OneDrive.

Resolvendo Mensagem de Erro de Conexão

Se o OneDrive mostrar um erro de conexão ou autorização ao tentar adicionar ou usar o armazenamento, veja o que o erro significa e como resolvê-lo.

Se você vir um erro referenciando "wl.offline_access," essa mensagem vem da API legada Live Connect da Microsoft e não se aplica à integração atual do OneDrive com o Duplicator Pro. O Duplicator Pro agora é executado no Microsoft Graph, solicitando os escopos offline_access e files.readwrite.appfolder. Se a autorização falhar, o Duplicator Pro exibirá uma destas mensagens: "Falha ao buscar informações do OneDrive. Certifique-se de que o token é válido.", "Token do OneDrive inválido." ou "Não conectado."

Solução 1: Verificar Configurações de Permissão

Crie um novo endpoint de armazenamento OneDrive e ative a opção Permissão de leitura/escrita para todas as pastas durante a configuração.

Solução 2: Reconectar Armazenamento OneDrive

Se o erro de conexão persistir, exclua a entrada de armazenamento existente e reconecte. Vá para Duplicator Pro » Armazenamento, exclua a entrada OneDrive existente e clique em Adicionar Novo para reconectar e reautorizar com os escopos corretos do Microsoft Graph.

É Possível Personalizar o Diretório do Aplicativo?

O caminho padrão para o armazenamento OneDrive, atualmente definido como o diretório /Apps/, pode ser personalizado?

Não. O armazenamento do OneDrive é limitado à pasta /Apps/Duplicator Pro/, pois o escopo do Microsoft Graph do Duplicator Pro o restringe lá por motivos de segurança. Este local não pode ser alterado para uma pasta fora dele.

Resolvendo Problemas com Plugins de Segurança e wp-config.php

Se um plugin de segurança (incluindo ferramentas de segurança relacionadas ao M365) rotacionar automaticamente as chaves secretas em wp-config.php, a conexão do OneDrive pode invalidar da mesma forma que acontece com outros provedores de armazenamento em nuvem, pois o Duplicator Pro usa essas chaves para criptografia.

Solução 1: Desativar Rotação Automática de Chave Secreta

Verifique as configurações do seu plugin de segurança para uma opção de desativar a rotação automática de chaves secretas.

Solução 2: Verificar Configurações de Permissão

Ao configurar o armazenamento do OneDrive, certifique-se de que a opção Permissão de leitura/gravação para todas as pastas esteja ativada.

Observação: Este problema envolvendo configurações de conta regionais, comumente relatado na Alemanha, estava vinculado aos endpoints legados e específicos da região do Live Connect da Microsoft. A integração do OneDrive do Duplicator Pro agora se conecta através de um único endpoint global do Microsoft Graph, portanto, é improvável que isso ainda seja específico da região.

Gerenciando Autorização do OneDrive

Opção 1: Reconectar Armazenamento OneDrive (Recomendado)

Se o OneDrive retornar um erro de token ou autorização, exclua a entrada de armazenamento existente e reconecte. Vá para Duplicator Pro » Armazenamento, exclua a entrada OneDrive existente e, em seguida, clique em Adicionar Novo para reconectar e reautorizar com os escopos corretos do Microsoft Graph.

Opção 2: Desconectar OneDrive do Duplicator Pro

Edite a entrada de armazenamento do OneDrive e clique em Cancelar Autorização para desconectar o armazenamento localmente. Isso requer reautorização antes que o armazenamento possa ser usado novamente.

Opção 3: Revogar Acesso ao OneDrive da Sua Conta Microsoft

Revogar o acesso do Duplicator Pro no nível da conta Microsoft acontece no lado da Microsoft, não dentro do Duplicator Pro. Isso é útil quando um dispositivo não está mais sob seu controle.

Para uma conta Microsoft pessoal, vá para Aplicativos e serviços, encontre o Duplicator Pro e selecione Remover estas permissões.

Para uma conta corporativa ou escolar (Microsoft 365), revogue seu próprio consentimento para um aplicativo através do portal Meus Aplicativos. Uma revogação completa da sessão de entrada, que invalida todos os tokens de atualização da conta, é uma ação exclusiva de administrador realizada pela TI através do centro de administração do Microsoft Entra. Não está disponível em contas Microsoft pessoais e não pode ser acionada por um usuário individual.

Observação: Revogar o acesso remove todas as conexões do OneDrive vinculadas ao Duplicator Pro em todos os sites e dispositivos que usam essa conta, portanto, faça isso apenas se você usar um número limitado ou único de conexões de armazenamento do OneDrive. Cada site afetado precisará se reconectar depois.

Limpando Pastas Antigas de Backup do OneDrive

Se o OneDrive estiver com pouco espaço, ou se backups de sites que você não gerencia mais ainda estiverem ocupando espaço, limpe essas pastas antigas para liberar espaço.

Para gerenciar o espaço de armazenamento, remova periodicamente pastas de sites desatualizadas dentro do diretório /Apps/Duplicator Pro/ no OneDrive. Por exemplo, exclua uma pasta como /Apps/Duplicator Pro/oldsite.com quando não for mais necessária.

É isso! Com o Tamanho do Bloco de Upload ajustado e a conexão do OneDrive reautorizada com os escopos corretos do Microsoft Graph, o Duplicator Pro envia backups para o OneDrive de forma confiável novamente.

Configurando o armazenamento do OneDrive pela primeira vez? Confira nosso tutorial em Armazenando Seu Backup no OneDrive. Para uma visão geral completa de todas as opções de armazenamento que o Duplicator Pro suporta, veja Um Guia Completo das Opções de Armazenamento do Duplicator.