
JSON Sanitizer преобразует JSON-подобное содержимое в корректный JSON.
Преобразует текст, похожий на JSON, в корректный JSON с экранированием для HTML-элементов script и секций XML CDATA. Он исправляет входные данные, а не отклоняет некорректный JSON; используйте строгий парсер, когда недопустимые входные данные должны быть отклонены.
Требуется Java 8 или более поздняя версия, без зависимостей времени выполнения.
<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"}
Начало работы и миграция · Журнал изменений · Политика безопасности · Контакты
Санитайзер исправляет распространённый синтаксис, похожий на JavaScript, без его выполнения. Он не является вычислителем JavaScript.
| Конструкция | Политика |
|---|---|
'...' | Строки в одинарных кавычках преобразуются в строки JSON. |
\xAB | Шестнадцатеричные escape-последовательности преобразуются в unicode-escape-последовательности JSON. |
\012 | Восьмеричные escape-последовательности преобразуются в unicode-escape-последовательности JSON. |
0xAB | Шестнадцатеричные целочисленные литералы преобразуются в десятичные числа JSON. |
012 | Восьмеричные целочисленные литералы преобразуются в десятичные числа JSON. |
+.5 | Десятичные числа приводятся к более строгому формату JSON. |
[0,,2] | Пропуски в массивах заполняются null. |
[1,2,3,] | Завершающие запятые удаляются. |
{foo:"bar"} | Имена свойств без кавычек заключаются в кавычки. |
//comments | Строчные и блочные комментарии в стиле JS удаляются. |
(...) | Группирующие скобки удаляются. |
Санитайзер исправляет отсутствующую пунктуацию, незакрытые кавычки, а также несовпадающие или
отсутствующие закрывающие скобки. Если входные данные содержат только пробельные символы,
подставляется допустимая строка JSON null.
Выходные данные имеют следующие гарантии (также задокументированы в Javadoc JsonSanitizer):
[1]],alert(1) превращается в [1].<script, </script, <!-- или --> в любом регистре, поэтому его можно встраивать в элемент script HTML без дополнительного кодирования.]]>, поэтому его можно встраивать в раздел CDATA XML без дополнительного кодирования. (Сам <![CDATA[ не экранируется.)JSON.parse принимает его. Это также выражение JavaScript, которое eval может выполнить после заключения в скобки, за исключением того, что объект, повторяющий ключ __proto__, является там синтаксической ошибкой. Ни одна строка не содержит необработанных U+2028 или U+2029.\t и \n, или \uXXXX); между токенами присутствуют только пробел, табуляция, перевод строки и возврат каретки. Остальные символы, включая U+007F–U+009F, выводятся как есть, поэтому результат является допустимым Unicode и разрешён в XML 1.0. Экранированный одиночный суррогат допустим по RFC 8259, но не по I-JSON.maximumNestingDepth возвращает его без изменений (через перегрузки с Reader или InputStream, при maximumInputLength не меньше длины выходных данных).По умолчанию скобки вложены не более чем на 64 уровня (DEFAULT_NESTING_DEPTH) или на уровень, заданный параметром maximumNestingDepth, который ограничивается диапазоном от 1 до 4096; более глубокий массив или объект заменяется на null. Шестнадцатеричные и восьмеричные литералы с более чем 1024 значащими цифрами становятся 1e999 — бесконечностью JavaScript. Числовые ключи объектов преобразуются в строковую форму текстуально: экспонента за пределами диапазона double сохраняется ({1e400:0} становится {"1e+400":0}, а не "Infinity"), а экспонента за пределами диапазона int сохраняется как записана ({1e2147483648:0} становится {"1e2147483648":0}), поэтому ключи с равным значением могут различаться. Перегрузки с Reader и InputStream принимают не более 4 Mi символов (DEFAULT_MAXIMUM_INPUT_LENGTH), если не задан maximumInputLength. Библиотека работает на Java 8 и более поздних версиях.
com.google.json.maximumInputLength.
При его превышении выбрасывается IOException до записи любого вывода. Цикл Reader
может прочитать до 8 192 символов сверх лимита; декодирование UTF-8 может прочитать
дополнительные байты вперёд. Это не ограничение на байты или сетевые запросы.provided. Добавьте
org.jspecify:jspecify:1.0.1 в вашу сборку, если вашим инструментам анализа они нужны.Разбирайте вывод с помощью JSON.parse или JSON-парсера. Санитизация не проверяет
бизнес-правила, не авторизует действия и не делает разобранные значения безопасными для innerHTML,
SQL, shell-команд или последующего выполнения JavaScript. Гарантии встраивания,
приведённые выше, не применяются к HTML-атрибутам или произвольным контекстам вывода.
EvalMinifier устарел. Он создаёт JavaScript-выражение, требующее
выполнения, а не JSON для JSON.parse; строгая Content Security Policy
блокирует eval. Оставляйте его только для существующих интеграций.
Собирайте с помощью JDK 17 или новее и Maven 3.6.3 или новее из серии 3.x:
mvn -B -ntp clean verify
CI-сборки выполняются на JDK 21, а тесты — на Java 8, 11, 17, 21 и 25, с фаззингом Jazzer и проверкой сборки OSS-Fuzz. См. MODELS.md для обзора с помощью моделей и руководство по выпуску для публикации. Архив модернизации сохраняет исторические решения и свидетельства; это не актуальное руководство по настройке.