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.