Saltar al contenido
jsonW Artículo GitHub

Versiones y seguridad

jsonW 1.4.0: cifrado en reposo, máscaras de documentos y perfiles de los protocolos de agentes

El archivo .jsw puede quedar cifrado en el disco, con la clave fuera de él. CPF y CNPJ entran con una máscara que rechaza el valor inválido. Y 49 objetos de los protocolos de agentes tienen un perfil probado con ida y vuelta.

· jsonW 1.4.0

Qué trae la 1.4.0

Tres cosas. El cifrado en reposo, para el archivo que vive en el disco. Las máscaras de documentos de varios países, que rechazan el valor inválido al grabar. Y los perfiles jsonW de los protocolos de agentes, con cada objeto muestreado y verificado. Quien no usa ninguna de ellas no nota diferencia: un archivo sin cifrado y sin tipo nuevo sale byte a byte igual al de la 1.3.14.

Cifrado en reposo

El archivo .jsw puede quedar cifrado en el disco (XChaCha20-Poly1305). La clave del tenant queda fuera del archivo: un archivo de 64 caracteres hexadecimales, indicado por WJSW_CHAVE_ARQ o por la opción --chave. Sin la clave, el archivo cifrado no se abre.

$ wjsw cifrar cifrado.jsw --chave chave.hex
$ wjsw conferir cifrado.jsw
FALHOU: arquivo cifrado: falta a chave do tenant (WJSW_CHAVE_ARQ ou credencial wjsw-chave)
$ wjsw para-texto cifrado.jsw --chave chave.hex
{id:1,cpf:"12345678909",cnpj:"11222333000181"}
{id:2,cpf:"12345678909",cnpj:"11222333000181"}

Salida real de wjsw 1.4.1. Los mensajes de la herramienta están en portugués. cifrar no imprime nada. Sin la clave, conferir sale con código 1.

Máscaras de documentos

En la columna mascara(tipo), jsonW acepta el documento con o sin puntuación, guarda la forma canónica y rechaza lo que no es válido. El archivo de entrada clientes.jsw.txt trae el CPF y el CNPJ con puntuación; la grabación guarda solo los dígitos.

$ wjsw de-texto "id:i64,cpf:mascara(cpf),cnpj:mascara(cnpj)" clientes.jsw.txt docs.jsw
2 linhas -> docs.jsw
$ wjsw para-texto docs.jsw
{id:1,cpf:"12345678909",cnpj:"11222333000181"}
{id:2,cpf:"12345678909",cnpj:"11222333000181"}
$ wjsw de-texto "id:i64,cpf:mascara(cpf),cnpj:mascara(cnpj)" invalido.jsw.txt inv.jsw
valor 1 nao coube no esquema

El último comando sale con código 1: el CPF 111.111.111-11 no es válido.

Entre los tipos están CPF, CNPJ, CEP, teléfono, PIS, RENAVAM, IBAN, NIF de Portugal, SIREN y SIRET de Francia, EIN y SSN de Estados Unidos, CURP y RFC de México, RUT de Chile y partita IVA de Italia. La lista está en mascara/wmascara.h.

Perfiles de los protocolos de agentes

La carpeta perfis/ tiene un archivo por protocolo, con el esquema jsonW de cada objeto: A2A, UCP, ACP, AP2, Verifiable Intent, x402, MPP, AG-UI y OpenTelemetry, además de L402 y PIX. Cada objeto tiene una muestra grabada y una custodia verificada, y vuelve igual a lo que entró.

$ bash perfis/provar-perfis.sh bin/macos-arm64/wjsw | tail -1
perfis: 49 ok, 0 falhas

Compatibilidad

Medido con el mismo esquema en las dos versiones. El archivo sin cifrado grabado por la 1.4.1 salió igual, byte a byte, al grabado por la 1.3.14. La 1.3.14 no abre el archivo cifrado: rechaza con versao do jsonW desconhecida, en vez de leer el texto cifrado como si fuera un dato.

$ wjsw para-texto cifrado.jsw   # con el binario 1.3.14
versao do jsonW desconhecida

Dónde está

En la herramienta wjsw, en la biblioteca y en los SDK. En npm, npm install @wortictecnologia/[email protected]. La 1.4.1, que corrige la visión por permiso, llega enseguida: vea el post de la 1.4.1.

jsonW 1.4.0 (GitHub, notas de la versión) →