# 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. 15 novembre 2026 · jsonW 1.4.0 · https://jsonw.org/it/newsroom/versione-1-4-0-cifratura-maschere-profili ## 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/jsonw@1.4.0. La 1.4.1, che corregge la vista per permesso, arriva subito dopo: vedi il post sulla 1.4.1. Fonte: https://github.com/developer-wortic/jsonw/releases/tag/v1.4.0