@:~$neofetch
Logotipo de lintux

lintux

@
postagens
...
páginas
...
menu
@:~/postagens$less 1461846884865044823 postagem

CriptSage: web app que cifra textos no navegador com AES-256 e PBKDF2

Para quando o gpg é demais e mandar o texto aberto é de menos.

CriptSage: web app que cifra textos no navegador com AES-256 e PBKDF2

Quem vive no terminal conhece bem a sensação: para guardar um segredo, a gente abre o gpg, lembra (ou não) das opções certas, gera chaves, exporta chaves, explica para o outro lado como importar chaves. Funciona, e funciona muito bem. Mas às vezes tudo o que se quer é mandar um texto curto para alguém, protegido por uma frase que só os dois conhecem. Foi para esse caso que nasceu o CriptSage.

O CriptSage é um web app de arquivo único que cifra e decifra textos dentro do próprio navegador. Você escreve a mensagem, escolhe uma palavra-passe e recebe um bloco de letras que ninguém lê sem ela. Sem conta, sem cadastro, sem servidor recebendo nada. Depois que a página carrega, dá até para puxar o cabo de rede.

O que roda por baixo

Nada de biblioteca de terceiros. Toda a criptografia vem da Web Crypto API, a implementação nativa que os navegadores já trazem, auditada e acelerada por hardware. A cada cifragem, o caminho é sempre o mesmo:

palavra-passe ─┐
               ├─→ PBKDF2 (600.000 repetições) ─→ chave AES de 256 bits ─┐
sal (16 bytes) ─┘                                                        │
                                                                         ▼
                                            mensagem ─────────→ AES-256 cifra e assina
                                                                         │
                                                                         ▼
                                                                   CSG1:AQEBAA…
  1. A frase é padronizada. A palavra-passe passa por normalização Unicode (NFC), para que um "ç" digitado no Linux e no celular gere a mesma chave.
  2. Entra o sal. Dezesseis bytes sorteados na hora. Por isso a mesma mensagem, com a mesma palavra-passe, sai diferente a cada vez, e tabelas de senhas pré-calculadas não servem para nada.
  3. A chave é forjada. O PBKDF2 repete a mistura 600.000 vezes no custo padrão até chegar a uma chave de 256 bits. Para quem sabe a frase, é um instante; para quem tenta adivinhar, cada tentativa custa caro.
  4. O texto é cifrado e selado. O AES-256 embaralha a mensagem, e a autenticação cobre também o cabeçalho. Palavra-passe errada e texto adulterado recebem a mesma recusa, sem revelar qual dos dois aconteceu.

A palavra-passe nunca é gravada nem transmitida. Ela só existe enquanto a chave está sendo calculada, e os bytes intermediários são zerados logo depois.

Escolha o algoritmo, se quiser

O padrão atende bem à maioria dos casos, mas quem gosta de mexer nas configurações encontra três algoritmos e duas funções de derivação:

  • AES-256-GCM (padrão): cifra e autentica de uma vez, com etiqueta de 128 bits.
  • AES-256-CBC com HMAC-SHA-256: blocos encadeados, com assinatura calculada por uma segunda chave.
  • AES-256-CTR com HMAC-SHA-256: modo de contador, também assinado.
  • PBKDF2-SHA-256 (padrão, 600.000 repetições) ou PBKDF2-SHA-512 (210.000 repetições), seguindo as recomendações atuais da OWASP.

O custo ainda pode ser dobrado ou quadruplicado, nos níveis "Reforçado" e "Máximo". Cada tentativa de adivinhação fica proporcionalmente mais cara, e a abertura demora um pouco mais, sobretudo no celular. Nenhum modo permite cifrar sem autenticar.

O bloco CSG1

O resultado sempre começa com CSG1:, o formato próprio do CriptSage, seguido de Base64 seguro para endereços da web. Dentro dele viajam a versão, o algoritmo, a derivação, o número de repetições, o sal e o vetor de inicialização. Isso significa que quem recebe a mensagem precisa apenas de duas coisas: o bloco e a palavra-passe. Nada de combinar configurações.

CSG1:AQEBAAknwMd-mqTkM-kYkfl1EXJvZGFww6k...
     └┬┘│ │ └──┬──┘ └────┬────┘ └───┬───┘
      │ │ │    │         │          └─ vetor de inicialização e texto cifrado
      │ │ │    │         └─ sal de 16 bytes
      │ │ │    └─ número de repetições
      │ │ └─ derivação
      │ └─ algoritmo
      └─ versão do formato

A especificação completa do CSG1 descreve o formato byte a byte, o suficiente para alguém escrever uma implementação compatível em Python, Rust, Go ou na linguagem que preferir.

Rodando na sua máquina

Não há etapa de compilação, não há node_modules, não há empacotador. O que está no repositório é exatamente o que roda no navegador. No Linux, bastam Git e Python:

$ git clone https://github.com/miqueiasklippel/criptsage.git
$ cd criptsage
$ python3 -m http.server 8000
# abra http://localhost:8000 no navegador

Abrir o index.html direto pelo file:// também cifra e decifra. O que não funciona assim é o service worker, responsável pelo uso offline, que exige http://localhost ou HTTPS.

Os testes extraem o núcleo criptográfico do próprio index.html, então verificam exatamente o código que vai para o ar. Basta o Node.js 18 ou superior:

$ node tests/criptsage.test.mjs
...
48 testes aprovados.

São dezoito combinações de algoritmo, derivação e tipo de mensagem, com acentos, emoji, texto de um único caractere e texto longo. Cada uma confirma que o texto volta igual, que a palavra-passe errada é recusada, que um byte alterado é detectado e que as formas NFC e NFD da mesma frase produzem a mesma chave.

Por que um arquivo só

Marcação, estilo e script moram juntos no mesmo index.html. Numa ferramenta de criptografia, isso é transparência: qualquer pessoa pode abrir o arquivo num editor, ler tudo e conferir que não existe chamada de rede escondida. E, salvo no disco, ele continua funcionando sozinho. É a velha filosofia Unix aplicada à web: uma ferramenta pequena, que faz uma coisa e faz bem.

Com honestidade: o que ele não faz

  • Não existe recuperação. Sem a palavra-passe, ninguém abre a mensagem, nem quem fez o CriptSage. Não há senha mestra nem porta dos fundos.
  • O tamanho não é escondido. O comprimento do texto cifrado revela o tamanho aproximado da mensagem original.
  • Não substitui o GnuPG. O CSG1 não conversa com ferramentas de PGP. Para quem já troca chaves públicas, o gpg continua sendo o caminho.
  • Sem auditoria externa. Os algoritmos e parâmetros são padronizados, mas este é um projeto independente que ainda não passou por auditoria de terceiros. O medidor de força da palavra-passe também é só uma estimativa.
  • As fontes vêm do Google Fonts. É a única requisição externa, feita apenas na primeira visita e depois guardada pelo service worker. Quem quiser zerar até isso pode trocar a declaração de fontes por uma pilha de fontes do sistema.

Uma dica final: uma frase longa e incomum vale mais do que uma palavra curta cheia de símbolos. Quatro ou cinco palavras que só você juntaria já dão uma chave forte e fácil de lembrar. E combine essa frase por um caminho diferente daquele por onde a mensagem vai viajar, porque mandar as duas coisas pelo mesmo aplicativo anula a proteção.

Código aberto

O CriptSage é distribuído sob a licença MIT. Sugestões, relatos de problema e melhorias são bem-vindos no repositório, e falhas de segurança podem ser relatadas em particular, conforme a política de segurança do projeto.

$ abrir criptsage.klippelbit.app.br
$ git clone github.com/miqueiasklippel/criptsage

Experimente: carregue a página, desligue a internet e cifre uma mensagem. Se tudo continuar funcionando, você acabou de comprovar que nada saiu da sua máquina.

@:~/postagens$tail comentarios.log

Comentários