
عند تقديم محتوى شبيه بـ JSON، يقوم 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 | تُحوَّل تهريبات الست عشري إلى تهريبات يونيكود في JSON. |
\012 | تُحوَّل تهريبات الثماني إلى تهريبات يونيكود في 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، كما هي، لذا تكون المخرجات يونيكود صالحة ومسموحًا بها في XML 1.0. البديل اليتيم المُهرَّب صالح وفق RFC 8259 لكن ليس وفق I-JSON.maximumNestingDepth تُعيده دون تغيير (عبر تحميل زائد لـ Reader أو InputStream، مع maximumInputLength بطول لا يقل عن طول المخرجات).تتداخل الأقواس على عمق 64 مستوى كحد أقصى افتراضيًا (DEFAULT_NESTING_DEPTH)، أو حسب ما تحدده معلمة maximumNestingDepth، التي تُقيَّد بين 1 و4096؛ وتُستبدل أي مصفوفة أو كائن أعمق بـ null. تصبح الأعداد الست عشرية والثمانية التي تحتوي على أكثر من 1024 رقمًا معنويًا 1e999، أي Infinity في JavaScript. تُحوَّل مفاتيح الكائنات الرقمية إلى صيغة نصية: يُحتفظ بالأس إذا كان خارج نطاق double ({1e400:0} تصبح {"1e+400":0}، وليس "Infinity")، ويُحتفظ بما يتجاوز نطاق int كما هو مكتوب ({1e2147483648:0} تصبح {"1e2147483648":0})، لذا يمكن أن تختلف المفاتيح ذات القيمة المتساوية. تقبل التحميلات الزائدة لـ Reader وInputStream 4 ملايين حرف كحد أقصى (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؛ وتحظر سياسة أمان المحتوى الصارمة eval. أبقِ عليه فقط
للتكاملات القائمة.
ابنِ باستخدام JDK 17 أو أحدث وMaven 3.6.3 أو أحدث ضمن سلسلة 3.x:
mvn -B -ntp clean verify
تُجرى عمليات بناء CI على JDK 21 والاختبارات على Java 8 و11 و17 و21 و25، مع اختبار Jazzer fuzzing وفحص بناء OSS-Fuzz. راجع MODELS.md للمراجعة بمساعدة النماذج ودليل الإصدار للنشر. يحفظ أرشيف التحديث القرارات والأدلة التاريخية؛ وهو ليس إرشادات الإعداد الحالية.