
JSON-जैसी सामग्री दिए जाने पर, JSON Sanitizer इसे मान्य JSON में परिवर्तित करता है।
JSON-जैसे टेक्स्ट को वैध JSON में परिवर्तित करता है, साथ ही HTML स्क्रिप्ट एलिमेंट्स और 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 | हेक्स एस्केप को JSON यूनिकोड एस्केप में बदला जाता है। |
\012 | ऑक्टल एस्केप को JSON यूनिकोड एस्केप में बदला जाता है। |
0xAB | हेक्स पूर्णांक लिटरल को JSON दशमलव संख्याओं में बदला जाता है। |
012 | ऑक्टल पूर्णांक लिटरल को JSON दशमलव संख्याओं में बदला जाता है। |
+.5 | दशमलव संख्याओं को JSON के कड़े प्रारूप में बाध्य किया जाता है। |
[0,,2] | ऐरे में रिक्त स्थानों को null से भरा जाता है। |
[1,2,3,] | अनुगामी अल्पविराम हटा दिए जाते हैं। |
{foo:"bar"} | बिना उद्धरण वाले प्रॉपर्टी नामों को उद्धृत किया जाता है। |
//comments | JS शैली की पंक्ति और ब्लॉक टिप्पणियाँ हटा दी जाती हैं। |
(...) | समूहीकरण कोष्ठक हटा दिए जाते हैं। |
सैनिटाइज़र गायब विराम चिह्न, अंतिम उद्धरण, और बेमेल या गायब बंद कोष्ठकों को ठीक करता है। यदि इनपुट में केवल रिक्त स्थान हो तो वैध JSON स्ट्रिंग null प्रतिस्थापित कर दी जाती है।
आउटपुट में ये गारंटी होती हैं (जो JsonSanitizer Javadoc में भी दर्ज हैं):
[1]],alert(1) बन जाता है [1]।<script, </script, <!-- या --> नहीं होता, इसलिए इसे बिना अतिरिक्त एन्कोडिंग के HTML स्क्रिप्ट एलिमेंट में एम्बेड किया जा सकता है।]]> नहीं होता, इसलिए इसे बिना अतिरिक्त एन्कोडिंग के XML CDATA अनुभाग में एम्बेड किया जा सकता है। (<![CDATA[ स्वयं एस्केप नहीं किया जाता।)JSON.parse इसे स्वीकार करता है। यह एक JavaScript अभिव्यक्ति भी है जिसे कोष्ठकों में लपेटने के बाद eval चला सकता है, सिवाय इसके कि वहाँ __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 से अधिक महत्वपूर्ण अंकों वाले हेक्स और ऑक्टल लिटरल 1e999 बन जाते हैं, JavaScript का Infinity। संख्यात्मक ऑब्जेक्ट कुंजियाँ पाठ्य रूप से स्ट्रिंग रूप में बदली जाती हैं: डबल रेंज से बाहर का घातांक रखा जाता है ({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 स्कोप में JSpecify का उपयोग करते हैं। यदि आपके विश्लेषण टूल्स को इनकी आवश्यकता हो
तो अपने बिल्ड में org.jspecify:jspecify:1.0.1 जोड़ें।आउटपुट को JSON.parse या किसी JSON पार्सर से पार्स करें। सैनिटाइज़ेशन व्यावसायिक नियमों को मान्य नहीं करता,
कार्रवाइयों को अधिकृत नहीं करता, या पार्स किए गए मानों को innerHTML,
SQL, शेल कमांड्स, या बाद के JavaScript निष्पादन के लिए सुरक्षित नहीं बनाता। ऊपर दी गई एम्बेडिंग गारंटी
HTML एट्रिब्यूट्स या मनमाने आउटपुट कॉन्टेक्स्ट पर लागू नहीं होती हैं।
EvalMinifier अप्रचलित है। यह JSON.parse के लिए JSON के बजाय एक JavaScript एक्सप्रेशन उत्पन्न करता है
जिसके लिए निष्पादन आवश्यक होता है; एक सख्त Content Security Policy eval को ब्लॉक करती है।
इसे केवल मौजूदा इंटीग्रेशन के लिए रखें।
3.x श्रृंखला में JDK 17 या बाद के संस्करण और Maven 3.6.3 या बाद के संस्करण के साथ बिल्ड करें:
mvn -B -ntp clean verify
JDK 21 पर CI बिल्ड और Java 8, 11, 17, 21 और 25 पर परीक्षण, Jazzer फ़ज़िंग और एक OSS-Fuzz बिल्ड जाँच के साथ। मॉडल-सहायता प्राप्त समीक्षा के लिए MODELS.md देखें और प्रकाशन के लिए रिलीज़ गाइड देखें। आधुनिकीकरण संग्रह ऐतिहासिक निर्णयों और साक्ष्यों को संरक्षित करता है; यह वर्तमान सेटअप मार्गदर्शन नहीं है।