Entrixy — cifragem ponta a ponta

• Confidencialidade do conteúdo. O servidor não conhece nem o endereço da cancela nem o número de telefone, nem o endereço do webhook, nem as coordenadas, nem o BSSID do Wi-Fi nem o texto da saudação.
• Integridade verificável. Qualquer adulteração de um blob no servidor quebra a decifragem (AES-GCM), e o cliente avisa de dados danificados.
• Compatibilidade futura das chaves. Um convidado acede apenas aos objetos que lhe foram concedidos. Comprometer uma chave de convidado não revela nada sobre as restantes.
• O limite do conhecimento zero. O servidor vê, sim, que existe uma chave, as marcas temporais de atividade e os identificadores dos objetos — precisa deles para o encaminhamento. Ocultar metadados (esquemas em cebola) está fora do âmbito.

Algorithm: AES-256-GCM. Disponível de origem na JVM (através de javax.crypto), e suportado pelo Android Keystore. Dá em simultâneo confidencialidade e autenticação.

Formato do texto cifrado

v1:<base64url(nonce || ciphertext || tag)>

• v1: — um prefixo de versão, para mudar o formato mais tarde.
• nonce — 12 bytes aleatórios, novos a cada cifragem.
• ciphertext+tag — tudo o que devolve Cipher.doFinal; a etiqueta de 128 bits está incluída.
• base64url sem enchimento — seguro tanto num endereço como em JSON.

Fonte de entropia

K_master — a chave-mestra do proprietário

• 32 bytes aleatórios, gerados no primeiro arranque.
• Guardada em EncryptedSharedPreferences com o nome master_key e nunca sai do dispositivo em claro.
• Usa-se apenas para envolver K_obj para o armazenamento local.

K_obj — a chave do objeto

• 32 bytes aleatórios, gerados ao criar cada objeto.
• Guardada localmente como encrypt_k_master(K_obj) sob a chave obj_key_{id}.
• Cifra o JSON de todos os campos sensíveis do objeto (data_cipher no servidor).
• Rodar significa um novo K_obj_new → voltar a cifrar o data_cipher e todos os pacotes que o continham.

K_guest — a chave do pacote de convidado

• 32 bytes aleatórios, gerados ao criar uma chave de convidado.
• Cifra o bundle — um JSON pequeno {obj_id: K_obj} com os objetos permitidos ao convidado.
• Ao servidor chega only bundle_cipher. O K_guest em si o servidor nunca vê.
• K_guest chega ao convidado no fragmento do endereço: entrixy.com/key#<user_key><base64url(K_guest)> — um único bloco de 75 caracteres. O fragmento não segue para o servidor com o pedido HTTP: é uma garantia básica do navegador.

No dispositivo do proprietário (EncryptedSharedPreferences)

No servidor

https://entrixy.com/key#<user_key(32)><K_guest_base64url(43)>

• O fragmento é um bloco de 75 caracteres: 32 caracteres de user_key e 43 caracteres da chave de convidado.
• user_key — o identificador do lado do servidor. Sem ele o servidor não entrega o pacote.
• O fragmento (#...) nunca chega ao registo do servidor — é uma garantia do navegador.
• A página /key — JS comum: lê location.hash, analisa o bloco e entrega a chave à aplicação ou à versão web /app/. O servidor nunca vê a chave.
• Se a aplicação não estiver instalada, a página copia a ligação para a área de transferência e envia-o para /download/android, de onde a aplicação apanha a chave sozinha.

Criar um objeto

1. O proprietário carrega em Adicionar — gera-se K_obj.
2. Os campos são empacotados em JSON e cifrados com K_obj → data_cipher.
3. POST /api/number_add com data_cipher mais o tipo. O servidor devolve um id.
4. Guarda-se localmente: obj_key_{id} = encrypt_k_master(K_obj).

Atualizar um objeto

Construir o novo JSON localmente, cifrá-lo com a K_obj → POST /api/number_update. K_obj existente, que não muda.

Criar uma chave de convidado

1. O proprietário escolheu [obj1, obj2, obj3]. Gera-se K_guest.
2. Monta-se o JSON do pacote: {obj_ids: [...], obj_keys: {1: K_obj1, ...}, welcome_cipher: ...}.
3. Cifrado com K_guest → bundle_cipher.
4. POST /api/key_create com bundle_cipher, obj_ids (em claro — para a matriz de acesso).
5. O servidor devolve user_key.
6. Ao proprietário mostra-se um código QR com a ligação entrixy.com/key#{user_key}{base64url(K_guest)}.

O convidado aceita a chave

1. O convidado abre o código QR ou a ligação. A página /key reads location.hash e entrega a chave à aplicação ou à versão web.
2. O cliente pede POST /api/key_bundle.php com user_key → recebe bundle_cipher e a lista de obj_ids.
3. Decifra o pacote com K_guest→ obtendo {obj_keys, welcome}.
4. K_guest e os decifrados obj_keys são guardados em EncryptedSharedPreferences do cliente convidado.
5. A partir daí, a cada chamada: GET do cifrado data_cipher do objeto → decifragem com a obj_key_{id}.

Revogar uma chave de convidado

O proprietário carrega em Apagar → POST /api/key_revoke.php → o servidor apaga o registo da chave. No pedido seguinte do pacote o convidado é recusado e perde o acesso.

Rodar a chave de um objeto

O proprietário carrega em Regenerar chave nas definições do objeto. Gera-se K_obj_new, e voltam a cifrar-se todos os bundle_cipher que contêm esse objeto. O cliente não os sabe de cor, por isso o cliente do proprietário reconstrói os pacotes: vai buscar o bundle_cipher de cada uma das suas chaves, decifra-o, insere K_obj_newe volta a cifrar. Os novos blobs seguem para o servidor num só lote.

Losing K_master significa perder o acesso a todos os objetos e chaves, e por isso a exportação é indispensável.

• O proprietário define uma passphrase (com pelo menos 8 caracteres).
• KDF: Argon2id (64 MB de memória, 3 iterações, 1 fio) → chave derivada de 32 bytes.
• A chave derivada cifra K_master → produzindo master_backup_blob.
• O blob é mostrado como Código QR e guarda-se em Transferências. Pode ser impresso e fechado num cofre.
• Restauro num dispositivo novo: ler o código QR, introduzir a frase-passe, K_master é recuperada e o cliente descarrega previamente todos os obj_keys do servidor — estão no pacote das próprias chaves do proprietário — e volta a cifrá-los localmente.