Tecnologia

jsonW: guardar dados cifrados em disco com wjsw cifrar

No jsonW, o wjsw cifrar deixa um arquivo .jsw cifrado em disco, com a chave de 64 caracteres fora dele. Veja os comandos, os erros e a ressalva da 1.4.1.

Por Equipe Wortic 8 min de leitura

Para guardar um arquivo .jsw cifrado no disco, rode wjsw cifrar com a chave indicada em --chave. O jsonW usa XChaCha20-Poly1305 e mantém a chave fora do arquivo, num arquivo de 64 caracteres hexadecimais. Sem essa chave, o conferir falha e avisa que falta a chave.

O que a cifra em repouso faz?

Desde a versão 1.4.0, segundo o README do jsonW no GitHub, um arquivo .jsw pode ficar cifrado em disco com XChaCha20-Poly1305. Cifra em repouso quer dizer que o arquivo está parado, guardado, e não em uso. A cifra protege esse arquivo parado: quem copia o arquivo sem a chave não lê os dados.

A chave não vai dentro do arquivo. O README diz que ela fica num arquivo de 64 caracteres hexadecimais, apontado pela variável WJSW_CHAVE_ARQ ou pela opção --chave. Essa separação é o ponto central da funcionalidade, porque o arquivo e a chave precisam estar em lugares diferentes para que a cifra tenha efeito.

O mesmo README lista cifrar e decifrar entre as operações que ficam fora da visão por permissão. Isso é importante, e volta na seção sobre a versão 1.4.1, mais adiante.

Como gerar a chave, cifrar e conferir?

Primeiro, gere a chave. Com o openssl, o comando abaixo escreve 32 bytes aleatórios e os mostra como 64 caracteres hexadecimais. O arquivo de chave deve ficar com acesso restrito, porque quem lê a chave consegue abrir o arquivo.

openssl rand -hex 32 > chave.hex

Depois, faça uma cópia do arquivo que você quer cifrar, para não perder o original caso algo dê errado. Em seguida, cifre a cópia. A documentação mostra o comando de cifra com a opção --chave:

cp dados.jsw cifrado.jsw
wjsw cifrar cifrado.jsw --chave chave.hex

No nosso teste, criamos um arquivo de duas linhas com o comando de texto para jsonW, com as colunas id e cliente. O arquivo de chave saiu com 64 caracteres hexadecimais e o fim de linha. O cifrar rodou sem mensagem de erro, e o arquivo cifrado ficou no mesmo lugar, agora com o conteúdo protegido.

Para conferir, use wjsw conferir. Sem a chave, o comando falha e avisa que falta a chave. Esse aviso é a forma de saber que o arquivo está cifrado e que o conferir não pode ler o conteúdo sem a chave. Para ler o conteúdo, use para-texto com a mesma chave. No nosso teste, a saída foi estas duas linhas:

wjsw para-texto cifrado.jsw --chave chave.hex
{id:1,cliente:"Ana"}
{id:2,cliente:"Bruno"}

Quais erros aparecem e o que significam?

O primeiro erro que vale conhecer é o da chave com formato errado. Num teste com um arquivo de chave de seis caracteres, o cifrar recusou a chave. A mensagem começa pela palavra cifrar, diz que o formato da chave é inválido e termina com a orientação use 32 bytes ou 64 hex. A correção é gerar a chave de novo com o openssl, como no passo anterior.

O segundo erro é o da chave que não corresponde ao arquivo. Num teste, usamos no arquivo cifrado uma chave nova, gerada na hora, em vez da que o cifrou. O para-texto respondeu que a chave não é a deste arquivo, e a saída não trouxe nenhum dado. A mensagem é clara, mas quem guarda muitos arquivos cifrados precisa manter uma relação clara entre cada arquivo e a chave que o abre, por exemplo com nomes que combinem.

O terceiro erro é a chave esquecida. Sem a chave, o conferir falha, e a mensagem começa com FALHOU: arquivo cifrado: falta a chave. A documentação que lemos não descreve como recuperar uma chave perdida, então não prometemos nada nesse caso. Guarde a chave com o mesmo cuidado que guarda o arquivo, e de preferência em outro lugar.

Como decifrar um arquivo?

A documentação lista o comando decifrar entre as operações do dono do arquivo. No nosso teste, copiamos o arquivo cifrado e rodamos decifrar com a chave. O comando terminou sem mensagem. Depois, o conferir respondeu que o arquivo estava íntegro, com duas linhas e um bloco, e o para-texto, sem a opção de chave, passou a mostrar as linhas como num arquivo comum.

Usamos a cópia de propósito. Decifrar um arquivo no disco deixa o conteúdo legível para quem tiver acesso a ele. Por isso, a decifragem deve ser feita só quando for necessária, e o arquivo decifrado deve ficar num lugar que só quem precisa ler tem acesso. Quando o trabalho termina, a versão decifrada deve ser apagada, e a versão cifrada deve continuar como guarda principal.

O que mudou na versão 1.4.1?

Na 1.4.0, só o ver e o servidor web aplicavam a visão por permissão, e os outros comandos de leitura liam todas as colunas. A 1.4.1, segundo o README, corrige isso: a visão passa a valer também para para-texto, filtrar, calcular, escolher, avaliar, comparar e info. O mesmo texto diz que, no teste do arquivo com coluna escondida, a 1.4.0 falhou em 23 de 37 verificações e a 1.4.1 não falhou em nenhuma.

O README também diz que cifrar, decifrar, regravar, de-texto, de-json, conferir, reparar e medir ficam fora da visão, porque são operações de quem é dono do arquivo e copiam o arquivo inteiro. Por isso, não entregue o .jsw cru a quem deve ver só parte dele. Dê a essa pessoa a saída do ver ou do servidor web. O formato do arquivo não mudou: a 1.4.1 lê todo arquivo escrito pela 1.4.0, pela 1.3.x e pela 1.2.1.

Quem consegue ler um arquivo cifrado?

Leitores antigos, como a 1.3.14 e a 1.2.1, recusam o arquivo cifrado em vez de ler o texto cifrado como se fosse dado. O README descreve essa recusa como uma mensagem de versão desconhecida. Já um arquivo da 1.4.0 sem cifra é igual, byte a byte, ao que a 1.3.14 gravaria com os mesmos dados.

Na prática, isso permite atualizar a ferramenta sem converter tudo de uma vez. Mas um arquivo cifrado só é lido pela versão nova, e isso precisa estar no plano de quem mantém os dados. Antes de cifrar um arquivo que outras pessoas usam, confirme que todas as ferramentas que leem esse arquivo estão na versão certa.

Onde guardar a chave?

O README diz que a chave fica fora do arquivo. Esse é o ponto da cifra em repouso: quem copia o .jsw não leva a chave junto. Guarde o arquivo de chave separado do arquivo cifrado, com permissão só para quem precisa ler, e não cole a chave em conversas, em prints ou em código que vai para um repositório público.

Uma prática simples é gerar uma chave por arquivo, ou por conjunto de arquivos que são sempre abertos juntos. Assim, se uma chave vazar, o estrago fica restrito ao que ela abre. A documentação não descreve rotação de chave, então esta é uma recomendação nossa, e não uma regra do jsonW.

Quando usar a cifra e quando não usar?

Use a cifra quando o arquivo fica parado num disco, numa cópia de backup ou num local que outras pessoas podem acessar, e você quer que ele não seja legível sem a chave. Não use a cifra como forma de entregar parte dos dados a alguém. A cifra não faz visão por permissão: quem tem a chave lê o arquivo inteiro. Para entregar só uma parte, a documentação indica a saída do ver ou do servidor web.

Também não espere que a cifra resolva o acesso ao banco de origem. Ela cuida do arquivo que já foi gerado. Quem tem acesso às tabelas de onde o arquivo saiu continua tendo acesso a elas, e isso se resolve no banco, e não no arquivo.

E a Wortic nisso?

A Wortic criou e mantém o jsonW. Quem trabalha com API aberta encontra o ponto de partida em a página para desenvolvedores da Wortic, com as APIs de CNPJ e CEP, abertas e grátis. Quem quer usar dados da Wortic dentro do Claude ou do ChatGPT vê como conectar a conta Wortic à IA. Os planos ficam em a página de planos. O código do jsonW está no repositório público do jsonW.

Perguntas frequentes

O que é o wjsw cifrar?

É o comando que cifra um arquivo .jsw em disco com XChaCha20-Poly1305, segundo o README do jsonW. A cifra existe desde a versão 1.4.0. A chave tem 64 caracteres hexadecimais e fica fora do arquivo.

Como guardar um arquivo cifrado com wjsw cifrar?

Gere a chave com openssl rand -hex 32, copie o .jsw e rode wjsw cifrar com a opção --chave. Para ler, use wjsw para-texto com a mesma chave. Sem a chave, o wjsw conferir falha e avisa que falta a chave.

Quem consegue ler o arquivo cifrado?

Quem tem o arquivo e a chave. As versões 1.3.14 e 1.2.1 recusam o arquivo cifrado. Na versão 1.4.1, o README pede que o arquivo cru não seja entregue a quem deve ver só parte dele.

Fontes

Conheça: jsonW (json Wondrous): o formato de dados da Wortic.

Quer isso funcionando na sua empresa?

Um consultor da Wortic olha o seu caso e mostra o caminho, sem compromisso.

Falar com um consultor

Equipe editorial

Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.

  • Automacao com IA
  • Gestao empresarial
  • CRM
  • ERP
  • Marketing digital

Isso funcionando no seu negócio.

Um consultor mostra o sistema do seu ramo, com a IA dentro.