JSON Toolkit

JSON واحد، حُكمان مختلفان: اختلافات المُحلِّلات وحدود الثقة في التحقق

الخلاصة: عندما يقبل أداة تحقق المستند بينما ينهار الخدمة التالية، فعادةً ما يكون محللان قد اختلفا حول النص نفسه. تقارن هذه المقالة المفاتيح المكررة وبايتات NUL وUTF-8 غير الصالح وNaN والأصفار البادئة على بيئات تشغيل حقيقية، وتشرح كيف حوّل CVE-2026-33948 الاختلاف إلى سطح هجوم، وتبيّن كيفية تعيين حَكَم واحد لكل حدّ فاصل.

Advancedقراءة نحو 6 دقيقةنُشر في 2026-11-11حُدِّث في 2026-11-11
غلاف يُظهر أداتين تصدران حكمين متضادين حول المستند نفسه بصيغة JSON

اجتياز التحقق يثبت شيئًا واحدًا فقط: النص قوبل بالقبول من ذلك المُحلِّل، وفق تلك السياسة. بدِّل المُحلِّل وقد ينقلب الحكم.

العَرَض: الأداة A تقبل والأداة B ترفض

هذه مشهدٌ واجهه الجميع. تُلصق استجابة API في مُنسِّق عبر الإنترنت فتحصل على علامة خضراء. الحمولة نفسها تصل إلى الخدمة التالية فترمي استثناء. حين تضع المُحلِّلَين جنباً إلى جنب وتقارن حرفًا بحرف، لا يكون أحد الطرفين عادةً «مخطئًا» — البيانات هبطت بالضبط على نقطة تختلف فيها التنفيذات.

هذه النقاط ليست كثيرة، لكن كل واحدة منها شائعة. يسجّل الجدول التالي السلوك الفعلي مع مدخلات عالية التكرار (اختُبرت ضد Node 22 JSON.parse ومكتبة json القياسية في بايثون 3.11 وjq 1.8 وأدوات تحقق عبر الإنترنت):

المدخل Node JSON.parse بايثون json.loads jq ملاحظات
{"a":1,"a":2} مفتاح مكرر يقبل، يبقى الأخير يقبل، يبقى الأخير يقبل، يبقى الأخير RFC 8259 يقول SHOULD فقط؛ الأربعة تسمح به
{"n":NaN} خطأ تقبل خطأ المكتبة القياسية في بايثون تقبله افتراضيًا — أكبر فخ صامت
{"n":01} صفر بادئ خطأ خطأ خطأ يُرفض في كل مكان، لكن مواضع الخطأ تختلف
"中文" محفوظة كبايتات GBK خطأ أو أحرف مشوهة يعتمد على الترميز خطأ يفرض RFC صيغة UTF-8، لكن فك الترميز من عمل طبقة الإدخال/الإخراج
{"a":1} مع BOM خطأ يقبل (utf-8-sig) خطأ مَن يزيل BOM هو مَن يقرر
تعليقات، علامات اقتباس مفردة، فواصل لاحقة خطأ خطأ خطأ محللات JSON5/JSONC فقط تقبلها

انظر إلى الصف الثاني: json.loads('{"cpu":NaN}') سليم في بايثون. تقبل المكتبة القياسية عمدًا NaN/Infinity لأجل التوافق مع الماضي، وقد عدّت كثير من خطوط المعالجة هذه الأسطر الفاسدة سجلات عادية دون ملاحظة التلوث. حجبها يتطلب وسيط parse_constant الصريح — الشيفرة أدناه.

من أين تأتي الاختلافات: فجوات المواصفة وقرارات التنفيذ

ليست RFC 8259 غامضة؛ إنها تترك ثلاثة مجالات عمدًا «للتنفيذ أن يقرر»، وكل تنفيذ يملؤها بطريقة مختلفة.

أولًا، تفرّد أسماء الكائنات. تقول المادة 4 إن الأسماء ينبغي (SHOULD) أن تكون فريدة — توصية لا قاعدة. المفتاح المكرر إذن ليس خطأ نحويًا، وتختار المُحلِّلات في كل مكان «الأخير يفوز». يرى مدقّق الأعمال حينها القيمة الناجية فقط؛ القيمة التي أرسلها المرسل أولًا اختفت دون خطأ ولا سطر سجل.

ثانيًا، الأعداد. تحدّد القواعد الشكل int frac exp فقط؛ وتُترك المقدار للتنفيذ. تجبر جافاسكريبت كل شيء عبر أعداد IEEE 754 العائمة المزدوجة، فيتحول 9007199254740993 إلى ...992. يحافظ jq على الحروف العشرية بأمانة منذ 1.8، لكن أي حساب يعود إلى المزدوجات. يمكن للمستند نفسه أن يُظهر ثلاث قيم مختلفة عند المقارنة والتخزين والنقل.

ثالثًا، UTF-8 والمحارف الخفية. تشترط المواصفة أن يكون JSON المتداول بصيغة UTF-8، لكن كيفية فتح الملف، وهل يُزال BOM، وكيفية التعامل مع البايتات غير الصالحة — قرارات لطبقة الإدخال/الإخراج. يعطي تيار البايتات نفسه أحكامًا مختلفة بحسب فتح بايثون له بـ utf-8 أو utf-8-sig.

المصدر الرابع هو اللهجات المتساهلة. يسمح JSON5 بالتعليقات وعلامات الاقتباس المفردة والفواصل اللاحقة؛ ويخفف JSONC القواعد نفسها في منظومة VS Code. إعداد يُحلَّل بمُحلِّل متساهل وواجهات برمجية تُحلَّل بمُحلِّل صارم — أكثر انحراف شائع داخل فريق واحد.

CVE-2026-33948: حين يصبح الاختلاف سطح هجوم

اختلافات المُحلِّلات عادةً إزعاج لتجربة المستخدم. بمجرد أن يعمل «التحقق» و«التحليل» على تنفيذين مختلفين، يتحولان إلى سطح هجوم. CVE-2026-33948، المُفصح عنه في 2026، حالة نموذجية: قبل الإصدار 1.8.2 من jq، كان يقبل بايتات NUL مدمجة (\0) عند قراءة JSON من الملفات، فأنتج المدخل نفسه حكمين — مرحلة التحقق تعتبر المحتوى منتهيًا هناك، بينما تستمر المعالجة الفعلية في القراءة بعده. التجاوز كامل. يؤكد الإرشاد الأمني على GitHub الإصلاح: الترقية إلى 1.8.2.

استخلص الدرس: في أي سلسلة «تحقق أولًا ثم حلّل»، إذا استخدمت الخطوتان تنفيذين أو إعدادين مختلفين، يستطيع المهاجم صياغة مدخل يرفضه المدقق ويقبله المُحلِّل، فيُهرب حمولة عبر الفحص. تتكرر البنية نفسها عند البوابة — حجة API7 لكتابة التحليل الصارم في عقد الواجهة البرمجية أن دلالات التحليل جزء من العقد، لا سلوك خاص بتنفيذ معين. حين ترفض البوابة طلبًا وفق مجموعة قواعد ويقبل الخدمة الخلفية الجسم نفسه بمُحلِّل آخر، فقد انكسر العقد أصلًا.

الفحص الذاتي يتسع في أمر واحد — تأكد أن كل مرحلة تستخدم إصدار jq نفسه، بما يشمل هذا الإصلاح:

jq --version
# jq-1.7.1  ← مصاب، يجب الترقية
# jq-1.8.2  ← مُصلح

المفاتيح المكررة: القيمة الأخيرة تبتلع الأولى بصمت

تستحق المفاتيح المكررة قسمًا خاصًا بها لأنها الحدّ الوحيد الذي تقبله كل المُحلِّلات الرئيسية بينما يفترض كل مطوّر تقريبًا أنها خطأ.

import json

text = '{"role": "guest", "role": "admin"}'
data = json.loads(text)
print(data)          # {'role': 'admin'}
print("guest" in data.values())  # False: القيمة الأولى اختفت

لو غذّى ذلك النص فحص توقيع أو قرار أذونات، لاستطاع المهاجم إلحاق حقل بالاسم نفسه ليكتب فوق الامتياز، ولم يكن يرى كود التحقق سوى القيمة النهائية. يتصرف JSON.parse في Node بالطريقة ذاتها. للكشف بدلًا من الكتابة فوق بصمت، يقبل بايثون object_pairs_hook:

from collections import Counter

def reject_dup(pairs):
    counts = Counter(k for k, _ in pairs)
    dup = [k for k, c in counts.items() if c > 1]
    if dup:
        raise ValueError(f"duplicate keys: {dup}")
    return dict(pairs)

data = json.loads('{"a":1,"a":2}', object_pairs_hook=reject_dup)
# ValueError: duplicate keys: ['a']

تقول المادة 4 من RFC 8259 بوضوح: لأغراض قابلية التشغيل البيني، ينبغي أن تكون الأسماء فريدة. ترقية SHOULD إلى قاعدة تحقق يكلّف مسحة واحدة عبر المستند، وتزيل أكثر مصادر «أداتين، حُكمان» شيوعًا.

الحل: حَكَم واحد لكل حدّ فاصل

الإصلاح ليس «الانتقال إلى مُحلِّل أكثر صرامة». إنه منح كل نقطة حدّية سياسة صريحة مكتوبة — وجعل التحقق والتنفيذ يستخدمان السياسة نفسها. يعمل الجدول التالي كقائمة مراجعة:

الحدّ السلوك الافتراضي المتساهل الحكم الموصى به إعداد تمثيلي
مفاتيح مكررة الأخيرة تفوز رفض object_pairs_hook في بايثون؛ json/v2 في غو يرفض افتراضيًا
NaN / Infinity بايثون تقبل رفض parse_constant في بايثون يرمي استثناء
أعضاء غير معروفين يُتجاهلون بصمت يُقرر وفق العقد RejectUnknownMembers(true) في json/v2 غو
UTF-8 غير صالح يختلف بحسب التنفيذ رفض تحقق صريح من تيار البايتات في طبقة فك الترميز
BOM مَن يزيله هو مَن يقرر أزِله مرة واحدة عند المدخل utf-8-sig ثابت أو إزالة قبل التحليل
التحقق والتنفيذ منفصلان كل طرف لوحده تنفيذ واحد، إعداد واحد يعيد المدققون استخدام مُحلِّل الإنتاج

في جانب بايثون، إطفاء أخطر افتراضين يتطلب استدعاءً واحدًا:

import json

def _reject(value):
    raise ValueError(f"non-standard constant: {value}")

data = json.loads(
    raw,
    parse_constant=_reject,          # حجب NaN / Infinity
    object_pairs_hook=reject_dup,    # حجب المفاتيح المكررة
)

يجعل encoding/json/v2 في غو (بالاسم المستعار jsonv2) السياسة كلها صريحة: يرفض RejectUnknownMembers(true) الحقول غير المعروفة، وتُرفض الأسماء المكررة مع UTF-8 غير الصالح افتراضيًا. صفحة ممارسات GopherForge دقيقة في الترتيب: قيّد بايتات المدخل، فك الترميز وفق سياسة صريحة، تحقق من المجال وأذِن، ثم اسمح بالآثار الجانبية فقط — ويجب أن تُمارس كل مسارات الفشل بواسطة بيانات اختبار ثابتة، لا أن تُحكم بمقارنة رسالة خطأ تغيّرت.

انقل سياسة التحليل إلى العقود والمجاميع الاختبارية

تحتاج السياسة إلى حماية من الانجراف. يكفي إجراءان.

أولًا، اكتب «ما نقبل وما نرفض» في توثيق الواجهة بجوار تعريفات الحقول. توصي API7 برمز خطأ مستقر ليتمكن العملاء من التمييز بين خطأ عقد دائم وعطل بنية تحتية عابر — المفتاح المكرر المرفوض لا يجب أن يبدو كانتهاء مهلة البوابة، وإلا دعوت إلى عاصفة محاولات إعادة. لا تصبّ جسم الطلب كاملًا في السجلات: قد تحمل الحمولات الخام بيانات اعتماد، وبعض تتابعات البايتات غير الصالحة غير آمنة للعرض.

ثانيًا، ابنِ مجموعة اختبار للالتباسات. حوّل كل صف في الجدول أعلاه إلى حالة اختبار ثابتة: مفاتيح مكررة، مفاتيح بأحرف كبيرة/صغيرة مختلفة، أعضاء غير معروفين، UTF-8 غير صالح، BOM، قيمة ثانية في النهاية، مدخل فارغ. أكّد شيئين في خط التكامل المستمر: المدخلات غير الصالحة تفشل دون إنتاج قيمة جزئية قابلة للاستخدام، والمدخلات المقبولة تعبر دورة ترميز وفك ترميز دون تغيير. عند ترقية مُحلِّل، أعد تشغيل عينات بشكل الإنتاج في بيئة محمية بوضع المقارنة، وراجع التغيير في مجموعة القبول كتغيير عقد حقيقي بدل افتراض أن حالات الاختبار القديمة تغطي كل شيء.

تكمّل هذه الإجراءات التحقق من JSON في خطوط CI: jsonlint وajv وjq التي تشرح كيف تستقر عمليات التحقق النحوي والمخطط في خط المعالجة؛ وهذه المقالة تغطي ما يسبق العقدة الأولى — المُحلِّل نفسه. مخاطر الحقن كتلوث النموذج الأولي وXSS مغطاة في قائمة فحص مخاطر أمان JSON؛ مشكلات سلسلة الثقة على مستوى المُحلِّل — المفاتيح المكررة وبايتات NUL — هي بالضبط الطبقة صفر في تلك القائمة. لتحديد أخطاء نحوية بسيطة، انظر حدود قواعد JSON من RFC 8259.

قائمة فحص قبل الإطلاق

  1. وحّد إصدارات المُحلِّلات عبر السلسلة كلها: jq، بيئات التشغيل، البوابة، المدققون دون اتصال — يجب أن تصل إصلاحات من فئة CVE-2026-33948 إلى كل مكان؛
  2. ارفض صراحةً المفاتيح المكررة وNaN: ضع object_pairs_hook وparse_constant في أغلفة مشتركة، ولا تستدعِ json.loads عارية أبدًا في شيفرة الأعمال؛
  3. قرر مصير الأعضاء غير المعروفين لكل مسار: قد يتجاهلها المستهلكون المتوافقون أماميًا، ويتعين على نقاط النهاية الأمرية ضبط RejectUnknownMembers؛
  4. مجموعة الالتباسات في خط CI: ثماني حالات على الأقل، إضافة إلى تشغيل مقارن قديم-ضد-جديد قبل أي ترقية للمُحلِّل؛
  5. أخطاء قابلة للتصنيف: رموز منفصلة لأخطاء العقد وأخطاء البنية التحتية، وأعد المحاولة للنوع الثاني فقط.

نعد إلى الجملة الافتتاحية: اجتياز التحقق يعني «قبلَه مُحلِّلٌ ما وفق سياسة ما». اجعل تلك السياسة صريحة — في العقد، وفي مجموعة الاختبار، وفي تثبيت الإصدارات — وسيختفي «JSON واحد، حُكمان مختلفان» أخيرًا.

الأسئلة الشائعة

هل المفاتيح المكررة خطأ فعلًا وفق مواصفة JSON؟

ليست خطأً نحويًا. تصاغ المادة 4 من RFC 8259 هكذا: ينبغي (SHOULD) أن تكون الأسماء فريدة — توصية لا إلزام — لذا تقبل المُحلِّلات الرئيسية التكرارات وتحتفظ بالقيمة الأخيرة افتراضيًا. توصي المواصفة مع ذلك بالتفرّد لأغراض قابلية التشغيل البيني. وترقيتها إلى خطأ تحقق قرار عقد؛ وكشفها يكلّف مسحة واحدة.

لماذا تقبل مكتبة json في بايثون NaN بينما ترمي جافاسكريبت خطأ؟

تقبل المكتبة القياسية في بايثون NaN وInfinity عمدًا لتتمكن من إعادة قراءة البيانات التي أصدَرتها تاريخيًا مع فقدان. ينفّذ JSON.parse في ECMAScript القواعد بصرامة ويرمي SyntaxError. مرّر parse_constant في بايثون لتُرفض، وسطر إعداد واحد يوائم بين بيئتي التشغيل.

ما الإصدارات المتأثرة بـ CVE-2026-33948 وكيف يُصلح؟

قبل الإصدار 1.8.2 من jq، وعند قراءة JSON من الملفات، تُقبل بايتات NUL مدمجة تُحدث اختلافًا بين مرحلة التحقق والمُحلِّل الفعلي حول المدخل نفسه، ما يتيح تجاوز التحقق. الإصلاح وفق إرشاد GitHub هو الترقية إلى 1.8.2 أو بناء يحتوي الالتزام (commit) 6374ae0. ثبّت الإصدارات في السكربتات وخط CI، وشغّل مجموعة الالتباسات قبل الترقية.

أتحقق مرة واحدة عند المدخل وأعيد استخدام النتيجة — هل ما زلت معرضًا للخطر؟

نعم، لكن الخطر يتركز عند نقطة المدخل تلك وحدها. إذا كان مُحلِّل المدخل وإعداده وإصداره مثبتين، ومجموعة الالتباسات تغطي المفاتيح المكررة وبايتات NUL وUTF-8، فلا حَكَم ثانٍ داخل السلسلة. الطوبولوجيا الخطيرة هي بوابة على تنفيذ وخدمات على تنفيذ آخر، أو تحقق على مُحلِّل وتنفيذ على آخر — حينئذٍ يُسلَّم الحكم إلى الاختلاف نفسه.

المراجع

الأدوات المطابقة

مقالات ذات صلة

التحقق من JSON في CI: خط أنابيب بـ jsonlint وajv وjq

يثبت التحقق من الصياغة أن الملف يُحلل، ويثبت التحقق من المخطط أن الحقول تتبع العقد. في CI، المهم هو رموز خروج لا لبس فيها ومواقع أخطاء ومسارات إصلاح.

متوسطقراءة نحو 10 دقيقةحُدِّث في 2026-10-31

قائمة فحص المخاطر الأمنية لمعالجة JSON

JSON.parse نفسه آمن؛ الخطر فيما يحدث بعده: الدمج العميق، والإسناد عبر المسار، والتضمين في HTML، والعمق والحجم غير المحدودين.

متوسطقراءة نحو 12 دقيقةحُدِّث في 2026-10-30

قراءة حدود صياغة JSON من RFC 8259

ترجمة إنتاجات صياغة RFC 8259 إلى لغة واضحة: أي الأحرف يجوز أن تظهر مباشرة، وأيها يجب هروبها، وأين تترك المواصفة مساحة عن قصد.

مبتدئقراءة نحو 11 دقيقةحُدِّث في 2026-10-30