
JSON과 유사한 콘텐츠가 주어지면, The JSON Sanitizer는 이를 유효한 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 | 16진수 이스케이프는 JSON 유니코드 이스케이프로 변환됩니다. |
\012 | 8진수 이스케이프는 JSON 유니코드 이스케이프로 변환됩니다. |
0xAB | 16진수 정수 리터럴은 JSON 10진수로 변환됩니다. |
012 | 8진수 정수 리터럴은 JSON 10진수로 변환됩니다. |
+.5 | 10진수는 JSON의 더 엄격한 형식으로 강제 변환됩니다. |
[0,,2] | 배열의 생략된 요소는 null로 채워집니다. |
[1,2,3,] | 후행 쉼표는 제거됩니다. |
{foo:"bar"} | 따옴표 없는 속성 이름은 따옴표로 감싸집니다. |
//comments | JS 스타일 줄 및 블록 주석은 제거됩니다. |
(...) | 그룹화 괄호는 제거됩니다. |
새니타이저는 누락된 구두점, 끝 따옴표, 그리고 일치하지 않거나
누락된 닫는 괄호를 수정합니다. 입력이 공백만 포함하는 경우
유효한 JSON 문자열 null로 대체됩니다.
출력은 다음과 같은 보장을 가집니다 (JsonSanitizer Javadoc에도 문서화되어 있음):
[1]],alert(1)은 [1]이 됩니다.<script, </script, <!-- 또는 -->를 포함하지 않으므로 추가 인코딩 없이 HTML script 요소에 포함할 수 있습니다.]]>를 포함하지 않으므로 추가 인코딩 없이 XML CDATA 섹션에 포함할 수 있습니다. (<![CDATA[ 자체는 이스케이프되지 않습니다.)JSON.parse가 이를 허용합니다. 또한 괄호로 감싼 후 eval이 실행할 수 있는 JavaScript 표현식이기도 합니다. 단, __proto__ 키를 반복하는 객체는 여기서 구문 오류입니다. 어떤 문자열에도 원시 U+2028 또는 U+2029가 포함되지 않습니다.\t 및 \n과 같은 짧은 형식 또는 \uXXXX)를 사용합니다. 토큰 사이에는 공백, 탭, 줄 바꿈 및 캐리지 리턴만 나타납니다. U+007F부터 U+009F까지를 포함한 다른 문자는 그대로 나타나므로 출력은 유효한 유니코드이며 XML 1.0에서 허용됩니다. 이스케이프된 단독 서로게이트는 유효한 RFC 8259이지만 I-JSON은 아닙니다.maximumNestingDepth로 다시 새니타이징하면 변경되지 않고 반환됩니다 (Reader 또는 InputStream 오버로드를 통해, maximumInputLength가 출력만큼 길어야 함).괄호는 기본적으로 최대 64단계까지 중첩됩니다 (DEFAULT_NESTING_DEPTH). 또는 maximumNestingDepth 매개변수로 설정할 수 있으며, 이는 1에서 4096으로 제한됩니다. 더 깊은 배열이나 객체는 null로 대체됩니다. 1024개 이상의 유효 숫자를 가진 16진수 및 8진수 리터럴은 1e999, 즉 JavaScript의 Infinity가 됩니다. 숫자 객체 키는 텍스트적으로 문자열 형식으로 변환됩니다: double 범위를 벗어난 지수는 유지되며 ({1e400:0}은 "Infinity"가 아닌 {"1e+400":0}이 됨), int 범위를 벗어난 지수는 작성된 대로 유지되므로 ({1e2147483648:0}은 {"1e2147483648":0}이 됨) 동일한 값을 가진 키가 다를 수 있습니다. Reader 및 InputStream 오버로드는 maximumInputLength가 주어지지 않는 한 최대 4 Mi 문자(DEFAULT_MAXIMUM_INPUT_LENGTH)를 허용합니다. 이 라이브러리는 Java 8 이상에서 실행됩니다.
com.google.json.maximumInputLength로 설정할 수 있습니다.
이를 초과하면 출력이 작성되기 전에 IOException이 발생합니다. Reader
루프는 제한을 넘어 최대 8,192자까지 읽을 수 있으며, UTF-8 디코딩은 추가
바이트를 미리 읽을 수 있습니다. 이는 바이트 또는 네트워크 요청 제한이 아닙니다.provided 범위에서 JSpecify를 사용합니다. 분석 도구에
필요하다면 빌드에 org.jspecify:jspecify:1.0.1을 추가하십시오.JSON.parse 또는 JSON 파서로 출력을 파싱하십시오. 새니타이제이션은 비즈니스
규칙을 검증하거나, 작업을 승인하거나, 파싱된 값을 innerHTML, SQL, 셸 명령 또는
이후의 JavaScript 실행에 안전하게 만들지 않습니다. 위의 임베딩 보장은 HTML
속성이나 임의의 출력 컨텍스트에는 적용되지 않습니다.
EvalMinifier는 더 이상 사용되지 않습니다. 이는 JSON.parse용 JSON이 아니라
실행이 필요한 JavaScript 표현식을 생성하며, 엄격한 Content Security Policy는
eval을 차단합니다. 기존 통합을 위해서만 유지하십시오.
JDK 17 이상 및 3.x 계열의 Maven 3.6.3 이상으로 빌드하십시오:
mvn -B -ntp clean verify
CI는 JDK 21에서 빌드하고 Java 8, 11, 17, 21, 25에서 테스트하며, Jazzer 퍼징과 OSS-Fuzz 빌드 검사를 수행합니다. 모델 지원 리뷰는 MODELS.md를, 게시 방법은 릴리스 가이드를 참고하세요. 현대화 아카이브는 과거의 결정과 근거를 보존하고 있으며, 현재 설정 지침은 아닙니다.