
Dato un contenuto simile a JSON, The JSON Sanitizer lo converte in JSON valido.
Converte testo simile a JSON in JSON valido, con escaping per gli elementi script HTML e le sezioni CDATA XML. Ripara l'input anziché rifiutare JSON malformato; usa un parser rigoroso quando l'input non valido deve essere rifiutato.
Richiede Java 8 o successivo, senza dipendenze a runtime.
<dependency>
<groupId>org.owasp.json-sanitizer</groupId>
<artifactId>json-sanitizer</artifactId>
<version>1.3.0</version>
</dependency>
import com.google.json.JsonSanitizer;
String json = JsonSanitizer.sanitize("{name:'Ada',}");
// {"name":"Ada"}
Per iniziare e migrazione · Changelog · Politica di sicurezza · Contatti
Il sanitizer corregge la sintassi comune di tipo JavaScript senza eseguirla. Non è un valutatore JavaScript.
| Costrutto | Politica |
|---|---|
'...' | Le stringhe tra apici singoli vengono convertite in stringhe JSON. |
\xAB | Le sequenze di escape esadecimali vengono convertite in escape unicode JSON. |
\012 | Le sequenze di escape ottali vengono convertite in escape unicode JSON. |
0xAB | I letterali interi esadecimali vengono convertiti in numeri decimali JSON. |
012 | I letterali interi ottali vengono convertiti in numeri decimali JSON. |
+.5 | I numeri decimali vengono forzati al formato più rigoroso di JSON. |
[0,,2] | Le elisioni negli array vengono riempite con null. |
[1,2,3,] | Le virgole finali vengono rimosse. |
{foo:"bar"} | I nomi di proprietà senza virgolette vengono racchiusi tra virgolette. |
//comments | I commenti di riga e di blocco in stile JS vengono rimossi. |
(...) | Le parentesi di raggruppamento vengono rimosse. |
Il sanitizer corregge la punteggiatura mancante, le virgolette di chiusura e le parentesi di chiusura non corrispondenti o mancanti. Se un input contiene solo spazi bianchi, viene sostituita la stringa JSON valida null.
L'output fornisce queste garanzie (documentate anche nel Javadoc di JsonSanitizer):
[1]],alert(1) diventa [1].<script, </script, <!-- o -->, in nessuna combinazione di maiuscole e minuscole, quindi può essere incorporato in un elemento script HTML senza ulteriore codifica.]]>, quindi può essere incorporato in una sezione CDATA XML senza ulteriore codifica. (<![CDATA[ stesso non viene sottoposto a escape.)JSON.parse lo accetta. È anche un'espressione JavaScript che eval può eseguire dopo essere stata racchiusa tra parentesi, tranne per il fatto che un oggetto che ripete la chiave __proto__ è un errore di sintassi in quel contesto. Nessuna stringa contiene U+2028 o U+2029 non elaborati.\t e \n, oppure \uXXXX); tra i token compaiono solo spazio, tabulazione, avanzamento riga e ritorno carrello. Gli altri caratteri, inclusi da U+007F a U+009F, compaiono così come sono, quindi l'output è Unicode valido e consentito in XML 1.0. Un surrogato isolato sottoposto a escape è valido secondo RFC 8259 ma non secondo I-JSON.maximumNestingDepth restituisce l'output invariato (tramite un overload Reader o InputStream, con un maximumInputLength almeno lungo quanto l'output).Le parentesi si annidano al massimo a 64 livelli di profondità per impostazione predefinita (DEFAULT_NESTING_DEPTH), oppure come impostato da un parametro maximumNestingDepth, che viene limitato tra 1 e 4096; un array o oggetto più profondo viene sostituito con null. I letterali esadecimali e ottali con più di 1024 cifre significative diventano 1e999, l'Infinity di JavaScript. Le chiavi numeriche degli oggetti vengono convertite in una forma stringa testualmente: un esponente al di fuori dell'intervallo double viene mantenuto ({1e400:0} diventa {"1e+400":0}, non "Infinity"), e uno oltre l'intervallo int viene mantenuto così come scritto ({1e2147483648:0} diventa {"1e2147483648":0}), quindi chiavi di uguale valore possono differire. Gli overload Reader e InputStream accettano al massimo 4 Mi caratteri (DEFAULT_MAXIMUM_INPUT_LENGTH) a meno che non venga fornito un maximumInputLength. La libreria funziona su Java 8 e versioni successive.
com.google.json.maximumInputLength.
Superarlo genera un'IOException prima che venga scritto qualsiasi output. Il ciclo del Reader
può leggere fino a 8.192 caratteri oltre il limite; la decodifica UTF-8 può leggere
byte aggiuntivi in anticipo. Questo non è un limite di byte o di richieste di rete.provided. Aggiungi
org.jspecify:jspecify:1.0.1 alla tua build se i tuoi strumenti di analisi ne hanno bisogno.Analizza l'output con JSON.parse o un parser JSON. La sanificazione non convalida
regole di business, non autorizza azioni e non rende i valori analizzati sicuri per innerHTML,
SQL, comandi shell o successive esecuzioni JavaScript. Le garanzie di embedding
sopra non si applicano agli attributi HTML o a contesti di output arbitrari.
EvalMinifier è deprecato. Produce un'espressione JavaScript che richiede
esecuzione, anziché JSON per JSON.parse; una Content Security Policy rigorosa
blocca eval. Mantienilo solo per integrazioni esistenti.
Compila con JDK 17 o successivo e Maven 3.6.3 o successivo nella serie 3.x:
mvn -B -ntp clean verify
Le build CI su JDK 21 e i test su Java 8, 11, 17, 21 e 25, con fuzzing Jazzer e un controllo di build OSS-Fuzz. Vedi MODELS.md per la revisione assistita dal modello e la guida al rilascio per la pubblicazione. L'archivio di modernizzazione conserva decisioni e prove storiche; non costituisce una guida attuale alla configurazione.