
Étant donné un contenu de type JSON, le JSON Sanitizer le convertit en JSON valide.
Convertit du texte de type JSON en JSON valide, avec échappement pour les éléments de script HTML et les sections CDATA XML. Il répare l'entrée plutôt que de rejeter du JSON malformé ; utilisez un analyseur strict lorsqu'une entrée invalide doit être rejetée.
Nécessite Java 8 ou ultérieur, sans dépendances à l'exécution.
<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"}
Premiers pas et migration · Journal des modifications · Politique de sécurité · Contact
Le désinfecteur répare la syntaxe courante de type JavaScript sans l'exécuter. Ce n'est pas un évaluateur JavaScript.
| Construction | Politique |
|---|---|
'...' | Les chaînes entre guillemets simples sont converties en chaînes JSON. |
\xAB | Les échappements hexadécimaux sont convertis en échappements unicode JSON. |
\012 | Les échappements octaux sont convertis en échappements unicode JSON. |
0xAB | Les littéraux entiers hexadécimaux sont convertis en nombres décimaux JSON. |
012 | Les littéraux entiers octaux sont convertis en nombres décimaux JSON. |
+.5 | Les nombres décimaux sont contraints au format plus strict de JSON. |
[0,,2] | Les élisions dans les tableaux sont remplies avec null. |
[1,2,3,] | Les virgules finales sont supprimées. |
{foo:"bar"} | Les noms de propriétés non entre guillemets sont mis entre guillemets. |
//comments | Les commentaires de ligne et de bloc de style JS sont supprimés. |
(...) | Les parenthèses de regroupement sont supprimées. |
Le désinfecteur corrige la ponctuation manquante, les guillemets de fin, ainsi que les crochets fermants manquants ou non appariés. Si une entrée ne contient que des espaces blancs, la chaîne JSON valide null est substituée.
La sortie offre ces garanties (également documentées dans la Javadoc de JsonSanitizer) :
[1]],alert(1) devient [1].<script, </script, <!-- ni -->, quelle que soit la casse, de sorte qu'elle peut être intégrée dans un élément script HTML sans encodage supplémentaire.]]>, de sorte qu'elle peut être intégrée dans une section CDATA XML sans encodage supplémentaire. (<![CDATA[ lui-même n'est pas échappé.)JSON.parse l'accepte. C'est aussi une expression JavaScript que eval peut exécuter après avoir été entourée de parenthèses, sauf qu'un objet répétant la clé __proto__ y constitue une erreur de syntaxe. Aucune chaîne ne contient de U+2028 ou U+2029 brut.\t et \n, ou \uXXXX) ; entre les jetons n'apparaissent que l'espace, la tabulation, le saut de ligne et le retour chariot. Les autres caractères, y compris U+007F à U+009F, apparaissent tels quels, de sorte que la sortie est de l'Unicode valide et autorisée en XML 1.0. Un substitut isolé échappé est valide selon la RFC 8259 mais pas selon I-JSON.maximumNestingDepth le renvoie inchangé (via une surcharge Reader ou InputStream, avec un maximumInputLength au moins aussi long que la sortie).Les crochets s'imbriquent au plus sur 64 niveaux par défaut (DEFAULT_NESTING_DEPTH), ou selon la valeur définie par un paramètre maximumNestingDepth, qui est borné entre 1 et 4096 ; un tableau ou un objet plus profond est remplacé par null. Les littéraux hexadécimaux et octaux de plus de 1024 chiffres significatifs deviennent 1e999, l'Infinity de JavaScript. Les clés d'objet numériques sont converties en une forme chaîne de manière textuelle : un exposant hors de la plage des doubles est conservé ({1e400:0} devient {"1e+400":0}, et non "Infinity"), et un exposant au-delà de la plage des int est conservé tel qu'écrit ({1e2147483648:0} devient {"1e2147483648":0}), de sorte que des clés de valeur égale peuvent différer. Les surcharges Reader et InputStream acceptent au plus 4 Mi caractères (DEFAULT_MAXIMUM_INPUT_LENGTH) sauf si un maximumInputLength est fourni. La bibliothèque fonctionne sur Java 8 et versions ultérieures.
com.google.json.maximumInputLength.
La dépasser lève une IOException avant que toute sortie ne soit écrite. La boucle Reader
peut lire jusqu'à 8 192 caractères au-delà de la limite ; le décodage UTF-8 peut lire
des octets supplémentaires en avance. Ce n'est pas une limite d'octets ni de requêtes réseau.provided. Ajoutez
org.jspecify:jspecify:1.0.1 à votre build si vos outils d'analyse en ont besoin.Analysez la sortie avec JSON.parse ou un analyseur JSON. La désinfection ne valide pas
les règles métier, n'autorise pas les actions et ne rend pas les valeurs analysées sûres pour innerHTML,
SQL, les commandes shell ou une exécution JavaScript ultérieure. Les garanties d'encapsulation
ci-dessus ne s'appliquent pas aux attributs HTML ni aux contextes de sortie arbitraires.
EvalMinifier est obsolète. Il produit une expression JavaScript nécessitant
une exécution, plutôt que du JSON pour JSON.parse ; une Content Security Policy stricte
bloque eval. Ne le conservez que pour les intégrations existantes.
Compilez avec JDK 17 ou version ultérieure et Maven 3.6.3 ou version ultérieure de la série 3.x :
mvn -B -ntp clean verify