Chatyy

Segurança do Chatyy

Como o Chatyy protege mensagens, ligações, chaves e contas. Este documento explica o desenho técnico e diz, item por item, o que já funciona para todo mundo, o que ainda está sendo liberado aos poucos e quais são os limites que conhecemos.

Atualizado em 28 de outubro de 2026 · Versão do documento: seguranca/1.1

Se você quer a versão sem termos técnicos, leia o guia simples de criptografia. Sobre quais dados tratamos e por quê, veja a Política de Privacidade.

1Resumo

O Chatyy usa criptografia de ponta a ponta baseada nos protocolos Olm (conversa entre dois aparelhos) e Megolm (grupos), na implementação de código aberto vodozemac e matrix-sdk-crypto, escritas em Rust e auditadas publicamente pelos seus mantenedores. As chaves privadas são criadas no aparelho e só saem dele cifradas, dentro do backup (se você ligar). O servidor guarda e entrega mensagens cifradas que não consegue ler.

Cada conta tem uma chave de conta que assina os aparelhos dela. É dessa chave que sai o código de segurança de 60 dígitos que duas pessoas podem comparar. Para que ninguém precise comparar códigos para estar protegido contra um servidor que mente, estamos implantando um diretório de chaves auditável (Key Transparency): um registro público, assinado e só de acréscimo, que o próprio app confere sozinho.

Situação hoje. A criptografia de ponta a ponta descrita aqui está em implantação gradual. Ela está ligada para uma parte pequena das contas e vai sendo liberada aos poucos, conforme as versões novas do app chegam às lojas. Nem todas as conversas são cifradas de ponta a ponta hoje. Uma conversa protegida mostra o cadeado e o aviso "As mensagens e ligações agora são protegidas com criptografia de ponta a ponta". Sem esse aviso, a conversa é protegida no caminho (TLS), mas não de ponta a ponta.

RecursoSituação
HTTPS/TLS em todas as conexões do app e do siteNo ar
Criptografia de ponta a ponta em conversas individuais e gruposEm implantação
Conversa individual nova já nascer cifrada quando os dois lados estão prontosEm implantação
Fotos, vídeos, áudios e arquivos cifrados no aparelho, dentro de conversas protegidasEm implantação
Ligações cifradas de ponta a pontaEm implantação
Código de segurança (QR e 60 dígitos) e aviso quando mudaEm implantação, junto com a criptografia
Diretório de chaves auditávelEm implantação (modo sombra, só contas de teste)
Fixação (pinning) de autoridades certificadoras no HTTPS do appPróximos builds
Transporte QUIC com Noise e chave do servidor fixada no appEm implantação (em teste)
Backup de chaves com cofre de tentativas limitadas; backup diário cifradoEm implantação
Passkeys e configurações estritas de segurançaEm implantação

2Termos

Identificador da conta (uid)
Um número interno e estável da conta, usado só pela criptografia. As chaves e o código de segurança usam o uid, nunca o e-mail ou o telefone.
Chave de conta: MSK, SSK e USK
Três pares de chaves Ed25519 de assinatura cruzada (cross-signing). A MSK (chave mestra) é a identidade da conta. Ela assina a SSK (chave de autoassinatura), que assina cada aparelho da própria conta, e a USK (chave de assinatura de usuários), que assina a MSK de contatos que você verificou.
Chaves do aparelho
Cada aparelho tem uma chave de identidade Curve25519 (para o Olm), uma chave Ed25519 (para assinar) e um estoque de chaves de uso único publicadas no servidor para que outros possam abrir sessões com ele.
Aparelho principal
O celular que tem as chaves privadas MSK, SSK e USK. Elas são criadas nele na ativação, ou restauradas do backup. Uma conta que só usa a web pode criar a chave de conta na web; nesse caso o app exige ligar o backup antes.
Aparelho vinculado
Web, tablet, computador ou outro celular ligado à conta pelo QR. Recebe a assinatura do principal, mas não recebe as chaves privadas da conta. Cada conta pode ter 1 aparelho principal e até 4 vinculados ativos.
Sessão Olm e sessão Megolm
Olm é a sessão cifrada entre dois aparelhos. Megolm é a sessão de saída de um remetente numa conversa: a chave dela é entregue a cada aparelho participante por Olm.
Hierarquia da chave de conta A chave mestra MSK assina duas chaves: a SSK, que assina o aparelho principal e os aparelhos vinculados, e a USK, que assina a chave mestra de contatos verificados. MSK chave mestra = identidade SSK assina meus aparelhos USK assina quem verifiquei Principal Vinculado Vinculado MSK do contato (depois de verificar) até 4 vinculados por conta
A MSK é a raiz. Um aparelho só é confiável para os seus contatos se estiver assinado pela SSK da conta.

3Registro e aparelhos vinculados

Ativação no aparelho principal Em implantação

  1. O app gera, dentro do aparelho, as chaves do aparelho e um lote de chaves de uso único, e publica no servidor só as partes públicas, assinadas.
  2. No celular principal, o app cria a MSK, a SSK e a USK, assina o próprio aparelho com a SSK e publica as chaves públicas.
  3. O servidor aceita no máximo 1 principal e 4 vinculados por conta e recusa publicar um aparelho com identificador que já pertence a outra conta.

Onde as chaves ficam no aparelho

Vincular outro aparelho pelo QR Em implantação

  1. O aparelho novo (por exemplo, a web) mostra um QR com um identificador do pedido, uma chave pública temporária dele e um segredo aleatório de 32 bytes.
  2. O celular principal lê o QR e abre um canal cifrado direto com o aparelho novo (ECIES do vodozemac). A primeira mensagem do celular leva o segredo do QR; o aparelho novo recusa se não conferir. O servidor só repassa bytes cifrados.
  3. Os dois mostram um código de 2 dígitos para conferência opcional.
  4. O aparelho novo manda a sua chave pública pelo canal. O celular só assina o aparelho se a chave publicada no servidor for igual à recebida pelo canal. Assim o servidor não consegue colocar outro aparelho no lugar.
  5. O aparelho novo só confia na MSK recebida pelo canal e recusa se o servidor mostrar outra.
  6. O celular pode enviar pelo canal as chaves das conversas antigas, para que o histórico abra no aparelho novo (tudo, ou só os últimos 3 meses).

Com as configurações estritas ligadas (seção 10), vincular um aparelho também pede o PIN da verificação em duas etapas.

Quando um aparelho vinculado é desconectado, os outros aparelhos da conta são avisados e ele deixa de receber chaves de mensagens novas.

4Mensagens individuais e em grupo

Em implantação A criptografia de ponta a ponta liga por conversa. Hoje ela vale só quando todos os participantes estão em contas já liberadas e com uma versão do app que tem o núcleo de criptografia. Uma conversa individual nova entre duas contas prontas já nasce cifrada; conversas antigas passam a ser cifradas a partir do aviso do cadeado. A liberação para mais contas é gradual.

Olm: entre dois aparelhos

Para falar com um aparelho, o remetente busca no servidor a chave de identidade dele e uma chave de uso único, e combina as duas com as próprias chaves num acordo de chaves triplo sobre Curve25519 (o desenho do Olm). Daí em diante a sessão segue uma catraca dupla (Double Ratchet): cada mensagem usa uma chave nova, e as antigas são descartadas. Olm é usado para entregar chaves e mensagens de controle entre aparelhos, nunca o texto das conversas diretamente.

Megolm: a conversa

Em cada conversa protegida, inclusive as individuais, cada aparelho remetente cria uma sessão Megolm de saída e manda a chave dela, por Olm, a cada aparelho assinado de cada participante. A mensagem é cifrada com AES-256 e autenticada com HMAC-SHA-256, usando uma chave que avança a cada mensagem por uma catraca de hash. A sessão também é assinada com a chave Ed25519 do aparelho, o que permite ao destinatário saber de qual aparelho a mensagem veio.

Não entram na criptografia de ponta a ponta: canais e comunidades públicas, lives, mural, status, e-mails, conversas com robôs e integrações, e contas infantis supervisionadas (por enquanto). O app mostra um selo nesses casos.

5Mídia, ligações e notificações

Fotos, vídeos, áudios e arquivos Em implantação

Ligações Em implantação

Notificações

6Verificar um contato: o código de segurança

Toda conversa protegida entre duas pessoas tem um código de segurança: 60 dígitos, mostrados em 12 grupos de 5, e um QR. O código é calculado a partir da MSK de cada um. Se o servidor entregasse uma chave falsa a algum dos dois, os códigos nos dois celulares seriam diferentes.

Como o código é calculado

Cada lado contribui com 30 dígitos, a partir do seu uid e da sua MSK (32 bytes):

h = SHA-512( versão(2 bytes, 0) ‖ MSK ‖ uid )
repete 5200 vezes:  h = SHA-512( h ‖ MSK )
pega os 30 primeiros bytes de h, em 6 blocos de 5 bytes
cada bloco → inteiro de 40 bits mod 100000 → 5 dígitos

código = 30 dígitos do menor uid ‖ 30 dígitos do outro uid

As 5200 iterações seguem o desenho do número de segurança do Signal e encarecem a busca por uma chave falsa que produza o mesmo código. O QR leva os dois uids e as duas MSKs: ao ler o QR do outro, o app compara as chaves inteiras, não só os dígitos.

Como conferir

Quando o código muda

Se a MSK do contato mudar, aparece na conversa "O código de segurança de {nome} mudou". Quase sempre a pessoa trocou de celular ou reinstalou o app sem restaurar o backup (quem restaura mantém a mesma MSK e o mesmo código). Como no WhatsApp, o aviso avisa e não bloqueia: a conversa continua. Se você tinha verificado o contato, a marca de verificado sai e o app sugere conferir de novo.

Em grupos não há um código único: cada par de pessoas tem o seu.

7Diretório de chaves auditável (Key Transparency)

Em implantação O diretório roda em modo sombra, ligado só para contas de teste: o app confere e apenas registra o resultado, sem mostrar nada ao usuário. O diretório, a testemunha e os endereços públicos de auditoria descritos abaixo já estão no ar (desde 25/10/2026); o que ainda não está ligado para todos é a conferência no app. O formato é chatyy-kt/1.

O problema que ele resolve

A criptografia de ponta a ponta protege o conteúdo, mas quem entrega as chaves públicas é o servidor. Um servidor invadido, malicioso ou obrigado por alguém poderia entregar uma MSK falsa e ficar no meio da conversa. O código de segurança pega isso, mas só se as pessoas compararem, e quase ninguém compara. O diretório torna esse ataque detectável automaticamente, no mesmo espírito do diretório de chaves que o WhatsApp publicou em 2023.

Como funciona

Fluxo do diretório de chaves O construtor, fora do servidor web, assina a cabeça. A testemunha, em outro provedor, confere e co-assina. O servidor web, só de leitura, entrega cabeças e provas. O app e qualquer auditor conferem sozinhos. Construtor do diretório único com a chave de assinatura Testemunha outra máquina, outro provedor: co-assina Servidor web entrega cabeças e provas; não assina App confere a chave do contato e a própria Qualquer auditor refaz tudo a partir do log público
Para enganar alguém sem ser pego, o servidor teria de publicar a chave falsa no diretório, onde o dono da conta a vê e os auditores ficam com a prova assinada.

O que o app confere sozinho

  1. Ao abrir uma conversa protegida e sempre que o código de segurança muda, o app pega a MSK que recebeu do servidor de chaves.
  2. Baixa a cabeça mais nova e confere a assinatura com a chave do diretório fixada no app, a co-assinatura da testemunha (também fixada), a prova de consistência com a última cabeça que aquele aparelho já viu (detecta histórico reescrito ou diretório voltado para trás) e a idade (mais de 3 horas = diretório possivelmente congelado).
  3. Pede a prova do contato, recalcula a raiz da árvore e confere se o compromisso da MSK recebida é o que está na folha. Chave recém-trocada tem até 12 minutos de tolerância, o tempo de uma época com folga.
  4. Faz o mesmo para a própria conta: detecta se o servidor publicou outra chave em seu nome.

Quando sair do modo sombra, uma divergência vira um aviso discreto na conversa ("Não foi possível confirmar a chave de {nome} no diretório público de chaves") e uma linha na tela do código de segurança. Como no resto do app, avisa e não bloqueia; comparar os 60 dígitos continua sendo a verificação mais forte. Se o diretório estiver fora do ar, as mensagens continuam funcionando.

Como qualquer pessoa audita

O auditor está no repositório público do Chatyy. Com Node.js instalado, na raiz do repositório:

npm i tweetnacl && node tools/kt-audit/kt-audit.js

Ele baixa as cabeças e o log público e confere, sem confiar no servidor: a assinatura de cada cabeça, o encadeamento (época +1, hash da anterior, horário crescente), que o log só cresce, que cada entrada nova sobe a versão em exatamente 1 e que a raiz da árvore recalculada do zero bate com a assinada. Qualquer divergência encerra com erro. A opção --state arquivo.json guarda a última cabeça vista, para comparar na próxima execução.

Endereços públicos (GET, sem login), em /api/email.php?action=…:

Cópia pública das cabeças assinadas

Desde 14/11/2026, cada cabeça assinada (com a co-assinatura da testemunha) também é publicada fora da API, num arquivo que nunca é trocado depois de publicado: https://media.chatyy.com.br/kt/<ns>/heads/<época>.json (ns prod e v2). A situação atual de cada diretório (última época, raízes, testemunhas) fica em /p/kt-status.json. Se o servidor um dia mostrar outra cabeça para uma época já publicada, a cópia pública é a prova.

chatyy-kt/2: posição escondida por VRF

O diretório v2 (formato chatyy-kt/2, no estilo do AKD do WhatsApp) roda em paralelo desde 14/11/2026. A posição de cada conta passa a ser a saída de uma VRF (RFC 9381, ECVRF-EDWARDS25519-SHA512-TAI) e o compromisso da chave leva um segredo por versão. Quem lê o log público vê só posições opacas: não dá para saber qual conta é qual, nem quantas vezes uma conta específica trocou de chave. O app confere a prova da VRF com uma chave pública fixada nele. O auditor e a testemunha funcionam igual (--ns v2). A conferência no app entra em modo sombra a partir do build 975.

Proteção contra o próprio servidor

Limites desta versão

8Transporte

9Backup e troca de aparelho

Como as chaves só existem nos aparelhos, perder o celular sem backup significa perder o acesso às mensagens protegidas antigas. O Chatyy oferece duas camadas, ambas Em implantação.

Backup das chaves

Limite O cofre é um "HSM em software", não um módulo de hardware. Ele limita tentativas para quem usa o app ou a API, mas alguém com controle total do servidor do cofre poderia tentar adivinhar senhas fora dele, mais devagar por causa do Argon2id (derivação de chave lenta, 64 MiB de memória). Para proteção máxima, use uma senha longa. No modo padrão, o Chatyy guarda uma cópia cifrada da chave do backup e por isso consegue, tecnicamente, abrir o backup. Com "Backup com senha", se você perder a senha e o aparelho, nem nós conseguimos recuperar.

Backup diário das conversas

Troca de aparelho

10Proteção da conta

  • Limite entrar com a senha do e-mail ainda não pede o PIN: a verificação em duas etapas vale para o registro por telefone, como no WhatsApp.
  • Limite no modo estrito, uma ligação recebida com o app fechado ainda toca; o silêncio vale dentro do app.

11O que o servidor vê e o que não vê

Numa conversa protegida de ponta a ponta, o servidor não vê: o texto, a legenda, a citação, o nome do arquivo, a foto, o vídeo, o áudio, a miniatura, a transcrição, as coordenadas de localização, as opções de enquete e o emoji das reações.

Para entregar as mensagens, o servidor vê (metadados):

Limite Conversas que ainda não entraram na criptografia de ponta a ponta, e também os e-mails, são protegidas no caminho e no armazenamento pelo próprio servidor, mas o servidor tem acesso técnico ao conteúdo. Mensagens enviadas antes do aviso do cadeado continuam como estavam. Quando você pede à Bia uma tradução, um resumo ou outra ação sobre um trecho, esse trecho sai da proteção, e o app avisa antes.

Numa denúncia, vai para análise só o que você escolher anexar. Veja a Política de Privacidade.

12Limites conhecidos e próximos passos

Limites que conhecemos hoje

O que vem a seguir

13Como reportar uma vulnerabilidade

Se você encontrou uma falha de segurança no Chatyy, escreva para [email protected] com o assunto "Segurança".

Respondemos assim que possível e avisamos quando a correção estiver no ar.