Skip to content

feat(settings): backup criptografado e sincronização via Nextcloud - #18

Merged
vitormattos merged 9 commits into
mainfrom
feat/nextcloud-settings-sync
Nov 19, 2026
Merged

vitormattos merged 9 commits into
mainfrom
feat/nextcloud-settings-sync

Conversation

@vitormattos

Copy link
Copy Markdown
Member

Problema

As preferências e conexões do Automatic Kimai permanecem no armazenamento local de cada instalação. Configurar um segundo computador exige repetir a definição de fontes, perfil de trabalho e integrações, sem um mecanismo de recuperação seguro.

Solução

Adiciona Preferências → Backup e sincronização como recurso desativado por padrão. Depois de autorizar sua própria conta Nextcloud, a pessoa configura uma senha de recuperação independente e decide se deseja incluir tokens de integrações no backup.

O aplicativo mantém um arquivo cifrado no Nextcloud Files, via WebDAV, e oferece restauração em outra instalação autenticada na mesma conta. A chave é derivada por Argon2id, e o conteúdo é protegido com XChaCha20-Poly1305 antes do upload; a senha de recuperação não é armazenada. A chave em cache de cada instalação é protegida pela chave local da aplicação.

Comportamento entre dispositivos

  • Primeira ativação: cria o backup cifrado com as preferências aprovadas.
  • Novo dispositivo: autentica-se no Nextcloud com uma senha de aplicativo própria e informa a senha de recuperação. A restauração automática ocorre apenas se ainda não existir configuração local relevante.
  • Mudanças subsequentes: são comparados resumos dos estados local/remoto e o ETag do arquivo. Alterações concorrentes ou tentativas de substituir tokens autenticados exigem decisão explícita. Escritas WebDAV usam precondições If-Match e If-None-Match.
  • O recurso faz sincronizações periódicas quando o agendador está ativo, com opção Sincronizar agora e opção de desativação sem excluir o arquivo remoto.

Limites de segurança

Não sincroniza a sessão MTProto do Telegram, autorizações do Nextcloud, chaves locais, bancos SQLite, histórico de atividade, registros de horas ou filas de revisão. A sessão Telegram requer autenticação independente em cada computador. Os grupos autorizados para leitura continuam sujeitos à decisão local. Credenciais Kimai e GitHub só são incluídas mediante consentimento; permissões de publicação automática no Kimai não são restauradas.

Nenhuma credencial ou dado pessoal integra o código, os testes ou os materiais de revisão. O PR não habilita sincronismo em contas reais e não publica arquivos de configuração privados.

Pontos de revisão

  • Limites da allowlist de SettingsSnapshot e preservação de sessões locais.
  • KDF/cifra autenticada, armazenamento da chave derivada e vínculo com identidade Nextcloud.
  • Condições WebDAV, conflito entre dispositivos e tratamento de falha sem sobrescrita silenciosa.
  • Interação entre Login Flow Nextcloud, consentimentos de coleta e ciclo periódico.
  • Fluxos de primeira ativação, restauração, resolução de conflito e desativação.

Validação e limite atual

Testes automatizados com transporte WebDAV simulado cobrem dois dispositivos, restauração, autenticação incompatível, senha incorreta, alteração concorrente, token rotacionado e preservação da sessão Telegram. A suíte completa e a renderização da tela em navegador local foram verificadas. A interoperabilidade com um servidor Nextcloud real e o pacote desktop ainda precisam de homologação antes do merge.

Documentação do usuário e do desenho técnico: docs/SETTINGS_SYNC.md.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
…heme

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
…loading feedback

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@vitormattos
vitormattos marked this pull request as ready for review November 19, 2026 20:11
@vitormattos
vitormattos merged commit 7d17146 into main Nov 19, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant