Aplicação Android¶
A aplicação Android leva todos os servidores BombVault do teu grupo para o telemóvel. Abre numa lista dos teus servidores com o registo de atividade de todos eles no topo, as mesmas linhas que a visão geral mostra, e abre a vista de telemóvel do servidor em que tocares. A aplicação não faz nenhum backup por si.

Obter a aplicação¶
- Definições, Aplicações: o cartão da aplicação Android oferece o APK da versão que o teu servidor executa, com um código QR para ler a partir do telemóvel, e liga a página da aplicação no F-Droid.
- APK: cada versão tem
bombvault-android.apkna sua página de release, e esta ligação descarrega sempre a compilação mais recente. Precisa de Android 10 ou posterior, e o Android pergunta uma vez se a aplicação com que abre o ficheiro pode instalar aplicações. - Google Play: BombVault no Google Play. É assinada com a mesma chave que o APK, por isso uma instala-se por cima da outra.
- F-Droid: BombVault no F-Droid. O F-Droid compila a aplicação a partir do código-fonte e assina-a com a sua própria chave, por isso uma versão nova chega lá alguns dias depois. Para trocar entre a aplicação do F-Droid e o APK, desinstala primeiro a outra.
Emparelha a aplicação com servidores na versão 9.7.0 ou posterior. Um servidor numa versão mais antiga pode estar no mesmo grupo, mas mostra o telemóvel como uma instância normal, e a aplicação só lê a atividade desse servidor depois de iniciar sessão.
Emparelhar por código QR¶
- Em qualquer servidor do teu grupo, abre Definições, Emparelhamento e escolhe Mostrar frase. As doze palavras aparecem com um código QR ao lado.
- Na aplicação, toca em Digitalizar código QR e aponta o telemóvel para o código. Também podes colar ou escrever as palavras.
- A aplicação lista os servidores desse grupo antes de guardar o que quer que seja. Adicionar as N adiciona-os todos.
A partir daí o telemóvel junta-se ao grupo como mais uma instância. Lê o que corre em cada servidor através do grupo sem iniciar sessão, diretamente em casa e através do retransmissor fora de casa. O funcionamento do próprio grupo está descrito em Emparelhamento de instâncias.
A aplicação junta-se ao grupo através do retransmissor, também em casa. Se a tua instância estiver em Sem relay, escolhe um em Definições, Emparelhamento antes de digitalizares o código.
Fora de casa¶
A aplicação tenta primeiro o servidor no seu próprio endereço. Quando esse não responde, por exemplo na rede móvel, abre antes a interface do servidor através do retransmissor do grupo. Um servidor do grupo cujo endereço a aplicação ainda não conhece abre da mesma forma. Se nem o endereço nem o retransmissor responderem, o ecrã inicial indica-o no cartão do servidor.
Através do retransmissor, a página chega ao que um telemóvel emparelhado alcança em casa, como descrito mais abaixo. Iniciar sessão com a palavra-passe e guardar ficheiros só funcionam no endereço do próprio servidor. As barras de progresso atualizam a cada dois segundos, em vez de continuamente. Os ficheiros da interface ficam no telemóvel depois da primeira visita, por isso as visitas seguintes carregam mais depressa. Um servidor anterior à 10.0.0 só abre no seu próprio endereço.
A aplicação só aceita uma resposta se o servidor a assinou com a chave que a aplicação fixou da primeira vez que encontrou esse servidor. Se o servidor responder mais tarde com outra chave, o ecrã inicial mostra a impressão digital da nova chave e a página só abre depois de confiares nela.
Mudar de servidor¶
Com um servidor aberto, o topo da sua visão geral mostra o nome do servidor, com uma seta para voltar antes dele. A seta leva à visão geral da aplicação, o ecrã inicial, que lista todos os servidores que a aplicação conhece com o seu estado: Ligada, Não ligada, Início de sessão necessário ou Verificar certificado. Um servidor do grupo que não responde aparece como Inativa, a cinzento, com a última vez que o grupo o viu, e um de que a aplicação ainda não teve notícias mostra A verificar. Sempre que se liga, a aplicação lê a lista do grupo numa das suas instâncias, por isso também aparece uma instância que nunca encontrou pelo relay, por exemplo uma que estava desligada quando o telemóvel entrou no grupo. Toca aí noutro para o abrir, diretamente em casa e, fora dela, pelo relay.
Sessão iniciada num telemóvel emparelhado¶
Um telemóvel emparelhado com o teu grupo abre cada um dos servidores já com sessão iniciada. Antes de carregar uma página, pede uma sessão a esse servidor através do grupo, e um servidor só a concede a um membro que seja um telemóvel. Um telemóvel emparelhado não recebe tudo o que uma palavra-passe dá. A sessão dele chega a uma lista fixa do que a aplicação mostra: a visão geral, as execuções e o registo de atividade, os backups para ver, iniciar e restaurar, as anomalias para ler e a página Instâncias para ver, sem os repositórios recebidos e as origens de recolha dos seus membros. Os destinos e os comandos voltam sem os endereços e os segredos. Um restauro que substitui o original faz primeiro backup do estado atual. Um restauro para uma pasta vai para uma pasta nova dentro da pasta de restauro definida em Definições, Restauro, e a janela não oferece outra. As chaves, o kit de recuperação, os depósitos de chaves, as definições e a eliminação de backups ficam com um início de sessão no próprio servidor, e tudo o resto responde que precisa desse início de sessão. Através do retransmissor aplica-se a mesma lista, também num servidor sem palavra-passe.
O interruptor para isto é Os telemóveis podem emparelhar com as doze palavras do grupo, no cartão App Android em Definições, Segurança. Uma reposição da palavra-passe desativa-o e termina a sessão de todos os telemóveis, até o voltares a ativar aí.
Certificados¶
Um certificado autoassinado é aceite uma vez pela sua impressão digital SHA-256. Se mais tarde o servidor mostrar outro, a aplicação avisa-te e só o abre depois de confiares no novo certificado.
O telemóvel na página Instâncias¶
O telemóvel recebe um cartão próprio na página Instâncias de cada servidor do grupo, marcado como aplicação Android e com o nome que deste ao telemóvel. Não tem scorecard porque não faz backups. Remover retira-o da página e termina logo a sua sessão, tal como desligar Consultar esta instância em Monitorização nos seus detalhes. O telemóvel continua a conhecer as palavras, por isso volta a aparecer quando a sua aplicação abre, mas desligado, e não recebe sessão até alguém o ligar. Para um telemóvel perdido, remove o seu cartão em cada servidor, ou desativa Os telemóveis podem emparelhar com as doze palavras do grupo em Definições, Segurança, ou faz Sair do grupo em cada instância e emparelha-as de novo com palavras novas.
Um telemóvel emparelhado antes da 10.0.0 começa a assinar as suas chamadas na primeira visita depois da atualização, e cada servidor guarda a primeira chave que recebe para o telemóvel. Se outra pessoa que conhece as palavras do grupo chegar primeiro enquanto o telemóvel está offline, esse servidor passa a recusar o telemóvel, e a aplicação já não consegue abri-lo através do relay. Para resolver, inicia sessão nesse servidor num navegador, escolhe Esquecer a chave no cartão do telemóvel na página Instâncias e depois Confirmar esquecimento, e abre a aplicação de novo. O servidor fica com a chave própria do telemóvel na chamada seguinte. Se o telemóvel for recusado outra vez, outra pessoa tem as palavras: faz Sair do grupo em cada instância e emparelha-as de novo com palavras novas, como para um telemóvel perdido.
Nós¶
Os nós geres-os na interface web. A sessão de um telemóvel emparelhado não chega até eles, por isso a aplicação não mostra cartões de nós na página Instâncias, nem o cartão Nós na visão geral, nem secções de nós em Backups, e Adicionar nó responde que precisa de um início de sessão no próprio servidor. Abre o servidor num navegador e inicia sessão com a palavra-passe para adicionar um nó, mudar para onde vão os seus backups ou restaurar uma das suas entradas.
Definições¶
A roda dentada ao lado do botão + abre as definições da aplicação:
- o idioma e o nome que o telemóvel mostra na página Instâncias (vazio significa o modelo do telemóvel),
- o aspeto, que segue o primeiro servidor da lista até definir o seu, e as animações, que têm uma definição própria,
- um relatório para copiar quando comunicares um problema. Não contém nenhum endereço, nome ou frase,
- o cartão Sobre com a política de privacidade,
- Remover todos os servidores, que retira todos os servidores da aplicação e sai do grupo. Cada servidor que o telemóvel ainda alcança retira-o da sua página Instâncias.
Transferências e envios¶
Exportações, kits de recuperação, ZIP do flash e dumps de bases de dados vão para a pasta Transferências do telemóvel, tal como a partir de um browser. Uma importação de definições abre o seletor de ficheiros do telemóvel. Através do retransmissor não se guarda nenhum ficheiro. Para isso, abre o servidor no seu próprio endereço.
Num ecrã tátil¶
Debaixo de um dedo não há hover, por isso um controlo escurece enquanto está premido, e um botão com o logótipo de uma marca acende-se na cor dessa marca até o dedo se levantar. Um toque longo num botão conta como um toque lento e não abre nenhum menu de ligação. Um toque num botão esbatido mostra porque está esbatido, até tocares noutro sítio.
Ou num browser¶
O Chrome e o Edge conseguem instalar a interface web do BombVault como uma aplicação numa janela própria, tanto num telemóvel como num computador. Nada fica em cache, por isso uma atualização aparece de imediato.
Privacidade¶
A aplicação não tem contas, publicidade nem análises, e não corre nada em segundo plano. A sua política de privacidade indica o que guarda e o que envia, e para onde.