跳到正文
jsonW 论文 GitHub

版本与安全

jsonW 1.4.0:静态加密、文档掩码与代理协议配置文件

.jsw 文件可以在磁盘上保持加密,密钥存放在文件之外。CPF 与 CNPJ 使用掩码,遇到无效值时会拒绝写入。49 个代理协议对象各自有一份经往返验证的配置文件。

· jsonW 1.4.0

1.4.0 带来什么

三项内容。静态加密,适用于保存在磁盘上的文件。多个国家的文档掩码,写入时拒绝无效值。以及代理协议的 jsonW 配置文件,每个对象都有已保存并经核对的样本。不使用这些功能的人不会察觉差异:未加密且不含新类型的文件,与 1.3.14 写出的文件逐字节相同。

静态加密

.jsw 文件可以在磁盘上保持加密(XChaCha20-Poly1305)。租户密钥存放在文件之外:一个由 64 个十六进制字符组成的文件,通过 WJSW_CHAVE_ARQ 或 --chave 选项指定。没有密钥,加密文件无法打开。

$ 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"}

wjsw 1.4.1 的真实输出。工具的提示信息为葡萄牙语。cifrar 不输出任何内容。没有密钥时,conferir 以退出码 1 结束。

文档掩码

在 mascara(类型) 列中,jsonW 接受带标点或不带标点的文档号,保存规范形式,并拒绝无效值。下例读取带标点的 CPF 和 CNPJ,只保存数字。

$ 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

最后一条命令以退出码 1 结束:CPF 111.111.111-11 无效。

类型包括 CPF、CNPJ、CEP、电话、PIS、RENAVAM、IBAN、葡萄牙 NIF、法国 SIREN 与 SIRET、美国 EIN 与 SSN、墨西哥 CURP 与 RFC、智利 RUT 以及意大利 partita IVA。完整列表见 mascara/wmascara.h。

代理协议的配置文件

perfis/ 目录为每个协议提供一个文件,包含每个对象的 jsonW 模式:A2A、UCP、ACP、AP2、Verifiable Intent、x402、MPP、AG-UI 与 OpenTelemetry,另有 L402 与 PIX。每个对象都有已保存的样本和经核对的完整性记录,往返之后与输入一致。

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

兼容性

在两个版本上用同一模式测量。1.4.1 写出的未加密文件,与 1.3.14 写出的文件逐字节相同。1.3.14 无法打开加密文件:它会拒绝并显示 versao do jsonW desconhecida,而不是把密文当作数据读取。

$ wjsw para-texto cifrado.jsw   # 使用 1.3.14 的二进制文件
versao do jsonW desconhecida

在哪里获取

在 wjsw 工具、库和各 SDK 中。npm 安装命令为 npm install @wortictecnologia/[email protected]。修复权限视图的 1.4.1 紧随其后,见 1.4.1 的文章。

jsonW 1.4.0(GitHub,版本说明) →