Versioni e sicurezza
jsonW 1.4.0: cifratura a riposo, maschere dei documenti e profili dei protocolli degli agenti
Il file .jsw può restare cifrato sul disco, con la chiave conservata fuori. CPF e CNPJ ricevono una maschera che rifiuta il valore non valido. E 49 oggetti dei protocolli degli agenti hanno un profilo provato con andata e ritorno.
· jsonW 1.4.0
Cosa porta la 1.4.0
Tre cose. La cifratura a riposo, per il file che vive sul disco. Le maschere dei documenti di diversi paesi, che rifiutano il valore non valido in scrittura. E i profili jsonW dei protocolli degli agenti, con ogni oggetto campionato e verificato. Chi non ne usa nessuno non nota differenze: un file senza cifratura e senza tipo nuovo esce identico, byte per byte, a quello scritto dalla 1.3.14.
Cifratura a riposo
Il file .jsw può restare cifrato sul disco (XChaCha20-Poly1305). La chiave del tenant resta fuori dal file: un file di 64 caratteri esadecimali, indicato da WJSW_CHAVE_ARQ o dall'opzione --chave. Senza la chiave, il file cifrato non si apre.
$ 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"}
Output reale di wjsw 1.4.1. I messaggi dello strumento sono in portoghese. cifrar non stampa nulla. Senza la chiave, conferir esce con codice 1.
Maschere dei documenti
Nella colonna mascara(tipo), jsonW accetta il documento con o senza punteggiatura, salva la forma canonica e rifiuta ciò che non è valido. Il file di input clientes.jsw.txt porta CPF e CNPJ con punteggiatura; la scrittura conserva solo le cifre.
$ 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
L'ultimo comando esce con codice 1: il CPF 111.111.111-11 non è valido.
Tra i tipi ci sono CPF, CNPJ, CEP, telefono, PIS, RENAVAM, IBAN, NIF del Portogallo, SIREN e SIRET della Francia, EIN e SSN degli Stati Uniti, CURP e RFC del Messico, RUT del Cile e partita IVA dell'Italia. L'elenco è in mascara/wmascara.h.
Profili dei protocolli degli agenti
La cartella perfis/ ha un file per protocollo, con lo schema jsonW di ogni oggetto: A2A, UCP, ACP, AP2, Verifiable Intent, x402, MPP, AG-UI e OpenTelemetry, oltre a L402 e PIX. Ogni oggetto ha un campione salvato e una custodia verificata, e torna identico dopo andata e ritorno.
$ bash perfis/provar-perfis.sh bin/macos-arm64/wjsw | tail -1
perfis: 49 ok, 0 falhas
Compatibilità
Misurato con lo stesso schema nelle due versioni. Il file senza cifratura scritto dalla 1.4.1 è uscito identico, byte per byte, a quello scritto dalla 1.3.14. La 1.3.14 non apre il file cifrato: rifiuta con versao do jsonW desconhecida, invece di leggere il testo cifrato come un dato.
$ wjsw para-texto cifrado.jsw # con il binario 1.3.14
versao do jsonW desconhecida
Dove si trova
Nello strumento wjsw, nella libreria e negli SDK. Su npm: npm install @wortictecnologia/[email protected]. La 1.4.1, che corregge la vista per permesso, arriva subito dopo: vedi il post sulla 1.4.1.