
Dado conteúdo semelhante a JSON, o Sanitizador JSON o converte em JSON válido.
Converte texto semelhante a JSON em JSON válido, com escape para elementos de script HTML e seções CDATA de XML. Ele corrige a entrada em vez de rejeitar JSON malformado; use um parser estrito quando entradas inválidas precisarem ser rejeitadas.
Requer Java 8 ou superior, sem dependências de tempo de execução.
<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"}
Primeiros passos e migração · Registro de alterações · Política de segurança · Contato
O sanitizador corrige sintaxe comum semelhante a JavaScript sem executá-la. Não é um avaliador de JavaScript.
| Construção | Política |
|---|---|
'...' | Strings entre aspas simples são convertidas em strings JSON. |
\xAB | Escapes hexadecimais são convertidos em escapes unicode JSON. |
\012 | Escapes octais são convertidos em escapes unicode JSON. |
0xAB | Literais inteiros hexadecimais são convertidos em números decimais JSON. |
012 | Literais inteiros octais são convertidos em números decimais JSON. |
+.5 | Números decimais são convertidos para o formato mais estrito do JSON. |
[0,,2] | Elisões em arrays são preenchidas com null. |
[1,2,3,] | Vírgulas finais são removidas. |
{foo:"bar"} | Nomes de propriedades sem aspas recebem aspas. |
//comments | Comentários de linha e de bloco no estilo JS são removidos. |
(...) | Parênteses de agrupamento são removidos. |
O sanitizador corrige pontuação ausente, aspas de fechamento e colchetes de
fechamento ausentes ou incompatíveis. Se uma entrada contiver apenas espaços em branco,
a string JSON válida null é substituída.
A saída tem estas garantias (também documentadas no Javadoc de JsonSanitizer):
[1]],alert(1) torna-se [1].<script, </script, <!-- ou -->, em nenhuma capitalização, portanto pode ser incorporada em um elemento script HTML sem codificação adicional.]]>, portanto pode ser incorporada em uma seção CDATA XML sem codificação adicional. (<![CDATA[ em si não é escapado.)JSON.parse a aceita. Também é uma expressão JavaScript que eval pode executar depois de ser envolvida em parênteses, exceto que um objeto que repete a chave __proto__ é um erro de sintaxe ali. Nenhuma string contém U+2028 ou U+2029 brutos.\t e \n, ou \uXXXX); entre tokens aparecem apenas espaço, tabulação, avanço de linha e retorno de carro. Outros caracteres, incluindo U+007F a U+009F, aparecem como estão, portanto a saída é Unicode válido e permitido em XML 1.0. Um surrogate isolado escapado é RFC 8259 válido, mas não I-JSON.maximumNestingDepth a retorna inalterada (por meio de uma sobrecarga Reader ou InputStream, com um maximumInputLength pelo menos tão longo quanto a saída).Colchetes aninham-se no máximo 64 níveis de profundidade por padrão (DEFAULT_NESTING_DEPTH), ou conforme definido por um parâmetro maximumNestingDepth, que é limitado a 1 até 4096; um array ou objeto mais profundo é substituído por null. Literais hexadecimais e octais com mais de 1024 dígitos significativos tornam-se 1e999, o Infinity do JavaScript. Chaves de objeto numéricas são convertidas para uma forma de string textualmente: um expoente fora do intervalo de double é mantido ({1e400:0} torna-se {"1e+400":0}, não "Infinity"), e um além do intervalo de int é mantido como escrito ({1e2147483648:0} torna-se {"1e2147483648":0}), portanto chaves de valor igual podem diferir. As sobrecargas Reader e InputStream aceitam no máximo 4 Mi chars (DEFAULT_MAXIMUM_INPUT_LENGTH), a menos que recebam um maximumInputLength. A biblioteca funciona em Java 8 e posteriores.
com.google.json.maximumInputLength.
Excedê-lo lança IOException antes de qualquer saída ser escrita. O loop do Reader
pode ler até 8.192 caracteres além do limite; a decodificação UTF-8 pode ler
bytes adicionais à frente. Este não é um limite de bytes ou de requisições de rede.provided. Adicione
org.jspecify:jspecify:1.0.1 à sua build se as suas ferramentas de análise precisarem delas.Analise a saída com JSON.parse ou um parser JSON. A sanitização não valida
regras de negócio, não autoriza ações, nem torna os valores analisados seguros para innerHTML,
SQL, comandos de shell ou execução posterior de JavaScript. As garantias de incorporação
acima não se aplicam a atributos HTML ou contextos de saída arbitrários.
EvalMinifier está obsoleto. Produz uma expressão JavaScript que requer
execução, em vez de JSON para JSON.parse; uma Content Security Policy estrita
bloqueia eval. Mantenha-o apenas para integrações existentes.
Compile com JDK 17 ou posterior e Maven 3.6.3 ou posterior da série 3.x:
mvn -B -ntp clean verify
Os builds de CI são feitos no JDK 21 e os testes no Java 8, 11, 17, 21 e 25, com fuzzing do Jazzer e uma verificação de build do OSS-Fuzz. Consulte MODELS.md para revisão assistida por modelo e o guia de lançamento para publicação. O arquivo de modernização preserva decisões e evidências históricas; não é orientação de configuração atual.