# Telegram · تنسيق الأدلة

Canonical page: https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/

محتويات ملف ZIP الموقّع، وأنواع السجلات، وإيصالات المعالجة، وملفات تعريف الأشخاص، والنسخ خارج الموقع، والتحقق دون اتصال بالإنترنت.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/ar/llms.txt)

Translation coverage: this edition includes material from the English original.

محتويات ملف ZIP الموقّع، وأنواع السجلات، وإيصالات المعالجة، وملفات تعريف الأشخاص، والنسخ خارج الموقع، والتحقق دون اتصال بالإنترنت.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [التوثيق](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![الأدلة والتحقق](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg)

يحتفظ TgWitness بملاحظات Telegram المرئية للحساب في سجل موقّع. يمكن للمستلمين التحقق من السجلات والمرفقات والتقارير المحفوظة بمقارنتها بمفتاح جامع موثوق به، والتحقق من الوقت الخارجي من طرف ثالث بالنسبة للسجل الأخير، ومقارنة السجل بنقطة تفتيش احتفظوا بها سابقًا. تصف هذه الصفحة التنسيقات، وعمليات الفحص، والمواد التي يجب الاحتفاظ بها من أجل التسليم.

يمكن للمستلمين البدء بـ **VERIFY.cmd** على نظام Windows: حيث يطلب الملف الأصلي بصيغة ZIP وبصمة المفتاح التي تم الحصول عليها بشكل مستقل، ويعرض نتيجة مفسرة، ويحفظ نسخة منفصلة من محضر التحقق. انظر مشغلات التحقق [و بيئة التشغيل المحمولة](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md) لمعرفة الإعدادات وحدود الثقة.

**في هذه الصفحة**

- [ما الذي تم توقيعه؟](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#what-is-signed)
- [مقارنة ملفات تصدير الدردشات](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#comparing-chat-exports)
- [تسليم التحقيق](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#investigation-handoff)
- [مقتطف من عملية التسليم](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#handover-extract)
- [تقارير سهلة القراءة](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#readable-reports)
- [توحيد الأحداث](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#event-canonicalization)
- [دلالات الفاعل](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#actor-semantics)
- [التغطية: الاستمرارية، والثغرات، والمعرفات غير الملاحظة](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)
- [المنتج](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#producer)
- [ملفات تعريف الأشخاص](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#people-profiles)
- [شاهد مستقل](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#independent-witness)
- [البيان ونقاط الفحص](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#manifest-and-checkpoints)
- [نطاق التحقق](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#verification-scope)
- [المرفقات](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#attachments)
- [جمع وإيصالات المعالجة الدائمة (0.2)](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#durable-collection-and-process-receipts-02)
- [RFC التحضير لـ 3161 والتحقق من الاستجابة (0.2)](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)
- [السجلات الاختيارية في وضع الأدلة: drand وأجهزة Telegram](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)

## ما هو «الموقع»؟

| المواد | الحماية | ما يجب الاحتفاظ به |
| --- | --- | --- |
| كل ملاحظة في السجل، بما في ذلك الأحداث التشغيلية | سلسلة SHA-256 وتوقيع Ed25519 لكل حدث | `events.jsonl` الأصلي، بصمة المفتاح الموثوق بها، ونقطة تفتيش محفوظة |
| محتويات ملف ZIP الخاص بالأدلة | يقوم `manifest.sig` بتوقيع البيان القياسي، الذي يسرد التجزئات (هاشات) لملفات المحتوى | ملف ZIP الكامل، بما في ذلك قائمة المحتويات والتوقيع |
| المرفقات المحفوظة | SHA-256 وعدد البايتات في حدث `media.saved` موقّع؛ تجزئة الملف في قائمة محتويات ملف ZIP الموقّعة | البايتات الأصلية الموجودة داخل ملف ZIP الذي تم التحقق منه |
| نقطة التحقق | توقيع Ed25519 على طول السجل، وتجزئة الرأس، والمفتاح العام، ووقت الإنشاء | نسخة مستقلة يتم الاحتفاظ بها قبل إجراء أي تغيير مثير للجدل |
| إيصال التشغيل | سجل موقّع لإصدار أداة التجميع، وتجزئات الملفات المصدرية، وإعدادات البدء، وهو مدرج أيضًا في `process.started` | الإيصال، والسجل المرتبط به، والأدلة البيئية الخاصة بوضع التحقق المحدد |
| تقارير سهلة القراءة: `report.html` وأجزاؤها، `report.json`، `report.pdf`، `chat.pdf` | ختم Ed25519 لكل ملف على محتواه؛ كما يحمل PDF توقيعًا قياسيًا PDF (انظر [التقارير القابلة للقراءة](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#readable-reports)) | الملف كما تم استلامه وبصمة المفتاح الموثوق به؛ ملف ZIP الموصوف فيه |
| CSV المستقل | لا توجد توقيعات تشفيرية مستقلة؛ فالتجزئات الخاصة بالأحداث وحدها غير كافية | استخدم النص المطابق الموجود داخل ملف ZIP الذي تم التحقق من صحته للتأكد من سلامة البيانات |
| لقطات شاشة، أو مطبوعات، أو ملفات PDF تم إنشاؤها بواسطة متصفح | لا يوجد توقيع TgWitness على النسخة المشتقة | احتفظ بالحزمة الأصلية التي تم التحقق منها ووثق كيفية إنشاء النسخة المشتقة منها |

يقوم المجمع بالتحقق من توقيعات السجل قبل إنشاء كل تنسيق تصدير. تحمل التقارير القابلة للقراءة بتنسيقي HTML وPDF أختامها الخاصة؛ ويتم فحص ملف CSV المستقل كجزء من ملف ZIP موقّع. احتفظ بملف ZIP للحفاظ على بايتات المرفقات وقائمة المحتويات، ونقطة فحص منفصلة لمقارنة السجل بحدود سابقة.

## التنسيقات ومسارات التحقق

يستجيب وضع الاستحواذ وتنسيق الإخراج لأسئلة مختلفة. يوفر الوضع أدلة التجميع والبيئة؛ ويحافظ كل تنسيق على جزء من ذلك السجل أو يعرضه مع الفحوصات الواردة أدناه.

| المخرجات | التحقق والاستخدام |
| --- | --- |
| الأدلة ZIP | الأحداث القياسية، والبيان الموقّع، والتغطية، وإدخالات الحفظ، والمرفقات، والإيصالات الخارجية المتاحة؛ تحقق من الأرشيف ووضع الاستحواذ المحدد له. |
| حاوية ASiC-E | ملف ZIP الخاص بالأدلة كحاوية ETSI ASiC-E (EN 319 162-1) مع إدخال نوع الميمتيب (`mimetype`) وملف `META-INF/ASiCManifest.xml`، موقّعًا باستخدام CAdES بشهادة مساحة العمل الخاصة بها على المستوى B-B، أو B-T عند تفعيل الختم الزمني. تقوم أدوات التحقق مثل EU DSS بفحص التنسيق والسلامة، وبما أن الشهادة صادرة ذاتيًا، فإنها تبلغ عن عدم وجود مرساة ثقة. يرفض EU DSS 6.3 بالإعدادات الافتراضية أي حاوية تحتوي على أكثر من 1000 ملف («تم الكشف عن عدد كبير جدًا من الملفات»). يقوم `verify.py` بالتحقق من ملف البيان Ed25519 وكل ملف مدرج، وقيم SHA-256 في ملف `META-INF/ASiCManifest.xml` وفي ملف `ASiCManifestNNN.xml` أو `ASiCEvidenceRecordManifest.xml` المضاف، ويفشل في حالة وجود إدخال في `META-INF/` لا يغطيه أي منها. ولا يتحقق من توقيعات CAdES ويشير إلى ذلك صراحةً. |
| تقارير HTML و JSON | طرق عرض مختومة بشكل فردي مع مراجع المصدر، مدرجة أيضًا في قائمة ملف ZIP. تلخص أعدادها المسجلة أنواع أحداث السجل. |
| تقارير PDF | ختم Ed25519 بالإضافة إلى توقيع PDF أساسي من نوع PAdES على نطاق البايتات: B-B، أو B-T مع طابع زمني للتوقيع عند تفعيل ميزة الطابع الزمني. يستخدم أداة التحقق TgWitness مفتاح Ed25519 الموثوق به؛ أما عرض ثقة الشهادة في العارض فهو فحص منفصل. |
| CSV | عرض جدول بيانات مشمول ببيان ZIP. يحمي تهرب الصيغ استخدام جدول البيانات؛ ويبقى النص الأصلي الموقع في السجل. |
| JSONL | سجلات الأحداث الموقعة، بما في ذلك مراجع المرفقات. كما يحتوي ملف ZIP الخاص بالأدلة على بايتات المرفقات المحفوظة. |
| تصدير الدردشات وطرق العرض المتوافقة مع سطح المكتب | الحصول على السجل التاريخي وسجلات سجلات الإدارة المتاحة، مع العرض المطلوب والأرشيف الموقّع. تعد الإصدارات المحفوظة للمراقبة المباشرة مسارًا منفصلاً للحصول على البيانات. |
| الوسائط والسجلات التي تحتوي على التجزئة فقط | يتم فحص البايتات المحفوظة بمقارنتها بـ SHA-256 ومرجع الرسالة. يحافظ الاستحواذ على التجزئة فقط على بيانات التجزئة الوصفية المتاحة للمقارنة لاحقًا مع بايتات الملف. |
| STIX/MISP وملفات تعريف الأشخاص | الملاحظات المستخرجة المرتبطة بالمصدر، ومعرفات الحسابات، والمطابقات التحليلية. يمكن التحقق من توقيعات الملفات الشخصية وتجزئات السجلات بمقارنتها بالأدلة الأصلية؛ ويتم تمييز مصدر ذاكرة التخزين المؤقتة للصورة الرمزية بشكل منفصل. |
| مقتطف من تسليم المهام | قواعد الإفصاح الموقعة، والسجلات التي لم تتغير، والسجلات المصغرة المُعلَّمة التي تحتفظ بالتجزئات/التوقيعات الأصلية. استخدم النسخة الأصلية المحتفظ بها للمقارنة التي تتطلب حقولًا محجوبة. |
| الشاهد وإيصالات الوقت | حدود السجل السابقة، والاستمرارية، وادعاءات الوقت الفردية التي تم التحقق منها. وهي تصاحب عمليات التحقق من الاستحواذ والأرشفة. |
| التسليم المحمي بكلمة مرور | يحمي الحزمة المرفقة أثناء النقل. يستخدم `.tgwpw` تشفيرًا مصدقًا عليه باستخدام AES-GCM، بما في ذلك سجل نهائي مصدق عليه؛ ويحتفظ السجل المرفق بتوقيعاته وإيصالات الاستلام. |

تعد النسخة المطبوعة أو لقطة الشاشة عرضًا للمواد الموقعة. ويساعد معرّف التقرير وبصمة المفتاح ومرجع QR في تحديد موقع الملف الأصلي للتحقق منه. تسجل إقرارات الحفظ معلومات الفاحص المقدم ومعلومات النقل؛ ويتم الاحتفاظ بنتائج التحقق وإيصالات الاستلام كأدلة منفصلة.

### التوقيعات الخارجية

ويمكن أن يأتي التوقيع أيضًا من مفتاح لا تحتفظ به TgWitness أبدًا، مثل التوقيع الإلكتروني المؤهل للمحقق أو ختم المؤسسة. وفيما يتعلق **بعمليات التصدير**، فإن **التوقيع الخارجي** على ملف تصدير جاهز بدون كلمة مرور يزود النظام بالبايتات المطلوبة للتوقيع: قائمة جديدة `META-INF/ASiCManifestNNN.xml` تضم كل ملف مع قيمة SHA-256 الخاصة به لحاوية ASiC-E ، أو `manifest.json` في حالة ملف ZIP. يقوم الموقّع بإرجاع ملف CMS (CAdES) `.p7s`، منفصلاً أو مع المحتوى مضمنًا.

يقوم TgWitness بالتحقق من أن التوقيع يغطي تلك البايتات بالضبط، كما يتحقق من صحة شهادة المُوقِّع (RSA PKCS#1 v1.5، RSASSA-PSS، ECDSA، Ed25519، Ed448). يتم فحص السلسلة فقط مقابل الشهادات الجذرية التي يوفرها المشغل؛ ولا يتم فحص الإلغاء، والقوائم الموثوقة، والحالة المؤهلة. تعرض اللوحة حالة واحدة لكل توقيع: في انتظار التوقيع، مرفق ولم يتم فحصه، تم التحقق منه، الخوارزمية غير مدعومة، التوقيع غير صالح، البايتات الموقعة غير متطابقة، أو الشهادة غير مرتبطة بشهادة جذرية مقدمة. يؤدي تغيير التصدير بعد توزيع البايتات إلى تعيين جميع توقيعاته إلى «البايتات الموقعة غير متطابقة».

يؤدي **التنزيل مع التوقيعات** إلى إضافة التوقيعات وقوائم بياناتها ضمن `META-INF` في حاوية ASiC-E. أما بالنسبة لملف ZIP، فيضع ملف ZIP الذي لم يتغير، وملفات `.p7s` الملفات و `SIGNATURES.txt` في ملف ZIP خارجي. يتم استبعاد التوقيعات غير الصالحة والتوقيعات الموجودة فوق بايتات أخرى . يتم تضمين التوقيع الذي لا يمكن لـ TgWitness التحقق منه؛ وتُظهر اللوحة حالته، كما هو الحال `SIGNATURES.txt` في حالة ملف ZIP.

### صور الدردشة الموقعة

يؤدي **تنزيل ملف ZIP الموقّع** الموجود في معاينة الصورة إلى حفظ الصفحات بتنسيق PNG، `pages.sig.json` و `README.txt`. تنتهي كل صفحة بأرقام سجلات اليومية التي تعرضها، والمحادثة، و وقت العرض، وبصمة مفتاح مساحة العمل، والأمر الذي يتحقق منها. لا ترسل اللوحة سوى أرقام SHA-256 وأرقام السجلات الخاصة بكل صفحة؛ ويؤكد الخادم أن السجلات تنتمي إلى المحادثة، ويوقع على البيان (`tgwitness-image-attestation-v1`) باستخدام مفتاح مساحة العمل وتسجل عملية التوقيع على النحو التالي `export.image_attested`.

```
python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip
```

يقوم المُحقق بالتحقق من التوقيع، ومطابقة كل ملف PNG بصفحة موقعة، والإبلاغ عن بصمة المفتاح. `--fingerprint` يقارن الموقّع ببصمة تم الحصول عليها من المرسل بشكل مستقل. `--evidence` يقرأ ملف ZIP للأدلة الموقعة من نفس مساحة العمل و يشترط أن يكون كل سجل من الصور موجودًا بنفس التجزئة. أي بكسل تم تغييره، أو بيان تم تغييره، أو مفتاح آخر يؤدي إلى فشل الفحص. تُظهر الصور السجلات المحفوظة في التنسيق الخاص بـ TgWitness؛ ولا تُظهر ما عرضه Telegram لأي شخص.

## مقارنة ملفات تصدير الدردشات

التحقق من ملفين ZIP موقّعين لبيانات الدردشة المُصدَّرة ومقارنتهما مع بصمات الموقّعين المحتفظ بها بشكل مستقل:

```
python -m tgwitness.verify first.zip --compare second.zip \
  --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256
```

يتم رفض استخدام الخيارين `--require` و`--require-tier` مع الخيار `--compare`؛ تحقق من الملف التعريفي المطلوب لكل أرشيف من خلال عملية التحقق الخاصة به.

عندما يسجل كلا الأرشيفين نفس معرّف الحساب الرقمي ومعرّف الدردشة، يتم إقران السجلات بناءً على معرّف الرسالة. **Unchanged** تعني تطابق السجل JSON الكامل المحفوظ: النص الكامل، والمؤلف، والتواريخ، وهدف الرد، والبيانات الوصفية المتداخلة، والحقول المجهولة كلها مضمنة. لا يهم ترتيب مفاتيح كائن JSON؛ أما الحقول الغائبة والقيم الفارغة وأنواع القيم وترتيب المصفوفات فهي مهمة. المعاينة المكونة من حرفين (300) هي للعرض فقط. تحدد الإدخالات التي تم تغييرها `changed_fields` المستوى الأعلى المختلفة، بما في ذلك التغييرات غير المرئية في تلك المعاينة. يتم رفض معرّفات الرسائل المكررة بدلاً من الكتابة فوق بعضها البعض أثناء المطابقة.

قد يكون الاختلاف عبارة عن اسم عرض تم تغييره، أو عدد المشاهدات، أو تعليق على المجموعة، أو بيانات وصفية أخرى للملاحظة. تظهر تعديلات Telegram كأحداث تعديل مستقلة، ويُظهر التحقق من كل أرشيف ما إذا كان هذا الأرشيف سليمًا أم لا. تظل السجلات غير المُحللة في المقارنة ويتم مقارنتها بناءً على تمثيلها المحفوظ.

بالنسبة لهويات الحسابات/الدردشات المختلفة أو المفقودة، تبحث الأداة عن التطابقات المحتملة باستخدام المرسل، والنص الكامل، وتجزئة الملف، ونوع الوسائط، وهامش زمني مدته خمس ثوانٍ، وتبلغ عنها على أنها **متطابقة** بدلاً من **لم تتغير**. تظل السجلات غير المُحللة غير متطابقة. يتم سرد الاختلافات في السجلات المقترنة في `changed`، بما في ذلك في وضع المحتوى. باستخدام `--json`، يقوم `matched` بحساب الأزواج المرشحة و `unchanged` بحساب الأزواج التي تتطابق سجلاتها الكاملة المحفوظة. يظل الإخراج الحالي `changed_fields` والقيمة الصحيحة `unchanged` متوافقين مع نتائج المقارنة السابقة. لم يتغير تنسيق الأرشيف والتحقق من التوقيع.

## تسليم التحقيق

1. سجل رقم مرجع القضية، والمشغل، والمعرف الرقمي لحساب Telegram، والمصادر المحددة ، وسياسة التجميع، وفترة التجميع في ملاحظات القضية الخاصة بك. يحافظ TgWitness على الملاحظات ويدعم الملاحظات المرتبطة بالمصادر وعمليات التجميع في [لوحة القضية (Case Board](https://phishdestroy.io/tgwitness/ar/docs/reference/case-board/)). احتفظ بسجلات النقل والحفظ مع مواد القضية الخاصة بك. تحقق من إعدادات التجميع المقصودة من خلال [إجراء القبول المباشر](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md).
2. احتفظ ببصمة المفتاح العام لمساحة العمل بشكل مستقل قبل الاعتماد على مخرجاتها. حافظ على تشغيل «وضع الأدلة» (الإعداد الافتراضي) بحيث تتلقى نقاط الفحص إيصالات RFC 3161 و OpenTimestamps. احفظ نقاط الفحص الموقعة خارج جهاز التجميع أثناء عملية التجميع. سجل حالات المقاطعة وحدود رؤية الحساب.
3. قم بتصدير ملف **ZIP موقّع** واحتفظ بإيصال التشغيل الموقّع. استخدم نقطة تفتيش عند أو قبل حدود السجل المُصدَّر. قد تؤدي نقطة تفتيش لاحقة إلى رفض التصدير السابق بشكل صحيح باعتباره قصيرًا جدًّا. تتضمن عمليات التصدير سجل مساحة العمل بالكامل، بغض النظر عن مرشحات اللوحة؛ راجع المواد قبل مشاركتها.
4. اطلب من المستلم التحقق من ملف ZIP باستخدام نسخة موثوقة من أداة التحقق، و البصمة المقدمة بشكل مستقل، وشهادة الجذر الخاصة بسلطة الطابع الزمني التي تم الحصول عليها بشكل منفصل. من بيئة Python موثوقة مع تفعيل بيئة Python:

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence
   ```

   تستوفي البصمة والطابع الزمني الذي تم التحقق منه للسجل الأخير الحد الأدنى المطلوب للدليل؛ وإلا فإن `--require evidence` تنتهي برمز 2. نقطة الفحص هي فحص داعم، لأنها موقعة بمفتاح المجمع. يُبلغ الإخراج الناجح `key_pinned: true` و`checkpoint_checked: true` عندما يتم توفير المدخلتين وقبولهما. حافظ على نتيجة التحقق.

   ```
   For a handover requiring the final exported record to be witnessed, use
   `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`.
   This refuses an export with an unwitnessed tail. Add
   `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the
   witness posts as external time. See the
   [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).
   ```

   1. سجل قيمة SHA-256 للأرشيف، وحدود التصدير، وتاريخ النقل، والمرسل، و المستلم في سجل الحفظ الخاص بك. احتفظ بالحزمة الأصلية سليمة واعمل من النسخ. شارك ملفات الأدلة بدلاً من دليل البيانات الخاصة للتطبيق ، الذي يحتوي أيضًا على جلسات الحساب وأسرار التوقيع. للنقل، اختر ملف ZIP محمي بكلمة مرور باستخدام تشفير AES-256 أو الحاوية الأقوى `.tgwpw` . يستخدم ZIP طريقة اشتقاق كلمة المرور منخفضة التكلفة الخاصة بـ WinZip؛ استخدم عبارة مرور عشوائية طويلة. يستخدم `.tgwpw` scrypt و AES-256-GCM ويُفتح باستخدام الأمر `unseal-password` الخاص بأداة التحقق المستقلة. لا يتم تخزين كلمة المرور وهي تحمي السرية فقط؛ يقوم المستلم بفك تشفير الأرشيف والتحقق من التصدير الموقع بداخله، والذي لم يتغير.
   2. لوضع طابع زمني على نقطة تفتيش خارج وضع الأدلة، اتبع [إجراء RFC 3161](https://phishdestroy.io/tgwitness/ar/docs/reference/timestamp/) واحتفظ بالطلب ونقطة التفتيش ومعلومات السلطة المصدقة الموثوقة واستجابة السلطة التي تم التحقق منها. إن إعداد الطلب وحده لا يؤدي إلى الحصول على طابع زمني.

بالنسبة لـ `.tgwpw`، استخدم أداة تحقق تم الحصول عليها بشكل مستقل واختر ملف إخراج جديد بالامتداد الأصلي: `python verify.py unseal-password export.tgwpw --out evidence.zip`. يطلب الأمر إدخال كلمة المرور؛ ويقوم `--password-stdin` بقراءة سطر واحد من أجل الأتمتة. لا يقوم أبدًا بالكتابة فوق ملف موجود ولا ينشر النص العادي إلا بعد مصادقة جميع السجلات. قم بعد ذلك بتشغيل التحقق العادي من التوقيع على الملف الذي تم فك تشفيره. يستخدم الحاوية خوارزمية scrypt (`N=131072`، `r=8`، `p=1`، ملح بحجم 16 بايت؛ حوالي 128 ميغابايت من ذاكرة الوصول العشوائي) وAES-256-GCM مع سجلات بحجم 1 ميغابايت وسجل نهائي تم التحقق من صحته. ويخزن سجل البيانات الوصفية المشفر اسم الملف الداخلي، بحيث يمكن إعادة تسمية الحاويات التي تم تنزيلها.

يؤكد التحقق الناجح سلامة البيانات بالنسبة لمفتاح المجمع الموثوق به والحدود المحتفظ بها. انظر [نطاق التحقق](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#verification-scope) للاطلاع على افتراضات الثقة [ونتائج](https://phishdestroy.io/tgwitness/ar/docs/reference/verification/) [التحقق](https://phishdestroy.io/tgwitness/ar/docs/reference/verification/) الخاصة بالفحوصات التي تم إجراؤها.

## مقتطف من تسليم المهام

يحتوي ملف ZIP الموقّع على سجل مساحة العمل بالكامل. عندما تحتاج المحكمة أو المحامي أو مكتب مكافحة الإساءة إلى بعض المحادثات فقط، أو فترة زمنية معينة، أو أشخاص معينين، فإن **«التصدير → استخراج التسليم»** يُعد نسخة مصغرة (`tgwitness-handover-v1`) وفقًا لقواعد الكشف المحددة. يحدد المشغل الغرض ويختار المحادثات، وفترة اختيارية (UTC)، والأشخاص الذين يتعلق بهم المقتطف، وما يحدث للآخرين (يتم عرضهم، أو استبدالهم بأسماء مستعارة P01، P02… أو يتم استبعادهم)، ونصوص الرسائل التي سيتم الاحتفاظ بها، والمرفقات وصور الملف الشخصي التي سيتم تضمينها، وما إذا كان سيتم إخفاء أرقام الهواتف وعناوين البريد الإلكتروني الواردة في النصوص. يُدرج الغرض وهذه القواعد في البيان الموقّع وفي التقرير؛ وتسجل السجلات «`handover.exported`» مع حق الوصول الذي أعدّها ورمز SHA-256 للملف، وليس المحتويات.

يقوم برنامج `verify.py` بالتحقق من المقتطف بطريقتين. يتم التحقق من السجل الذي يظهر دون تغيير بالكامل: حيث يتم مقارنة محتواه بقيمته التجزئية، وتوقيعه Ed25519، ورابطه إلى السجل السابق المضمن. أما السجل المُختصر فيحتفظ بالهاش والتوقيع الأصليين، لذا يظل التوقيع صالحًا للتحقق، لكن الحقول المحجوبة لا يمكن إعادة حسابها منه؛ ويحدد السجل ما تم حجبه ويقوم التقرير بتمييزه. أما سجلات الخدمة على مستوى الحساب (عمليات البدء والإيقاف، وفجوات التغطية، وإشعارات الاتصال والشبكة والتخزين، وتغييرات النطاق والإعدادات) فتحتفظ فقط بالحقول المدرجة لنوعها: يتم اقتطاع قوائم الدردشة الواردة فيها لتقتصر على وإعادة حساب إجمالياتها، وتؤدي فجوة «الفحص المباشر» في محادثة خارج نطاق الاختيار إلى فقدان تلك المحادثة وعدد رسائلها وحساب الشاهد؛ وفي محادثة «الفحص» المختارة، يتم استبدال حساب الشاهد باسمه المستعار ما لم يتم عرض الجميع أو يكون أحد الأشخاص المختارين. يحدد البيان طول السجل ورأسه مع توقيع المجمع فوق ذلك الرأس، ويحسب السجلات التي تم استبعادها؛ ويصف ملف `coverage.json` المحادثات المختارة. كما تحتوي المقتطفات الجديدة على ملف `proofs.jsonl`: لكل سجل مدرج ولرأس السجل، مسار ميركل من التجزئة الأصلية للسجل إلى جذر السجل المسمى في البيان الموقع. يقوم `verify.py` بالتحقق من كل مسار، بحيث يتبين أن كل سجل ينتمي إلى نفس السجل الذي له ذلك الطول والعنوان، دون الحاجة إلى السجل الكامل؛ ويقوم مقتطف مكون من 100 رسالة بالتحقق في حوالي ثانية واحدة بغض النظر عن حجم السجل. `--range=CHAT:FROM-TO` يؤكد بالإضافة إلى ذلك أن الرسائل من «FROM» إلى «TO» في المحادثة موجودة في المقتطف ويبلغ عن عدد السجلات التي تم فحصها بحثًا عنها. لا يتم الكشف عن الأسماء الموجودة داخل أسماء الملفات. راجع الملفات النهائية قبل مشاركتها: النص الحر وأسماء الملفات والمرفقات المختارة لا تزال قادرة على تحديد هوية الأشخاص. احتفظ بملف ZIP الكامل الموقع: المقتطف هو إفصاح، وليس بديلاً.

## تقارير سهلة القراءة

تحتوي ملفات ZIP الخاصة بالأدلة الموقعة وعمليات التسليم والدردشات على تقارير قابلة للقراءة بتنسيقات HTML و JSON، بالإضافة إلى ملفات PDF عند توفر الخطوط المطلوبة، باللغة المحددة للتقرير. يتم تشفير كل تقرير بمفتاح Ed25519 الخاص بمساحة العمل ويمكن التحقق منه بشكل منفصل: `python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]`.

- `report.html` / `chat.html`: بيان الختم (`tgwitness-report-seal-v1`) يغلق الملف و يوقع على SHA-256 لكل بايت يسبقه. يتم تقسيم السجلات والمحادثات الطويلة إلى أجزاء ذات حجم قابل للتكوين (إعدادات التقرير، من 500 إلى 100,000 سجل؛ 5,000 بشكل افتراضي): `records/records-0001.html` أو `messages/messages-0001.html`، كل منها مختوم برقمه ونطاقه والمجموع، ومدرج مع SHA-256 الخاص به في قائمة البيانات الموقعة. تظهر سلاسل نبضات المجمع في سطر واحد ما لم تدرجها «إعدادات التقرير» واحدة تلو الأخرى.
- `report.json` (`tgwitness-report-json-v1`، المفاتيح `format`، `report`، `seal`): الختم يوقع على SHA-256 الخاص بـ JSON القياسي لـ `report`، بحيث يمكن قراءة الحقائق بواسطة أنظمة معالجة القضايا والبرامج النصية ويمكن إجراء اختيار لحماية البيانات منها بينما يظل الملف الموقّع سليمًا.
- `report.pdf` / `chat.pdf`: وثيقة رسمية مخصصة للطباعة والحفظ، موقعة مرتين على نفس البايتات، أي الملف بأكمله باستثناء قيمة التوقيع (`/ByteRange`). التوقيع القياسي لملفات PDF هو PAdES baseline (ETSI EN 319 142-1، `/SubFilter /ETSI.CAdES.detached`: CMS مع SHA-256 و ECDSA P-256، شهادة التوقيع v2، بدون وقت توقيع CMS؛ الوقت المُعلن هو `/M`) عند المستوى B-B، أو B-T مع طابع زمني للتوقيع وفقًا لـ RFC 3161 في CMS عندما يكون الطابع الزمني قيد التشغيل وتقوم سلطة الطابع الزمني بالرد عبر المسار للطلبات خارج Telegram. ويستخدم شهادة توقيع مستندات صادرة ذاتيًا محفوظة في خزينة مساحة العمل؛ ورقمها التسلسلي هو بصمة مفتاح Ed25519. ينتقل ختم Ed25519 داخل نظام إدارة المحتوى (CMS) باعتباره السمة غير الموقعة `2.25.240684792623320047764573196045913242332` ويحدد SHA-256 الخاص بالشهادة بـ `"content": "pdf-byte-range"`، وبذلك يضمن مفتاح Ed25519 صحة الشهادة. الشهادة غير مؤهلة: يعرض قارئ ملفات PDF التوقيع على أنه صالح و الموقّع على أنه مجهول أو غير موثوق به حتى يتم الوثوق بالشهادة؛ قارن بصمة Ed25519 بدلاً من ذلك. تحتاج ملفات PDF باللغات الصينية واليابانية والكورية إلى خط على الخادم (أو في `TGWITNESS_FONT_DIR`)؛ وبدون وجوده، لا يحمل ملف ZIP سوى تقارير HTML و JSON فقط.
- `report.en.html`، `report.en.pdf` / `chat.en.html`، `chat.en.pdf`: النسخة الأصلية بالإنجليزية من التقرير نفسه عندما لا تكون لغة التقرير الإنجليزية، مختومة وموقعة بالطريقة نفسها ومذكورة تحت `report.original` في البيان الموقّع. ويبدأ التقرير باللغة المختارة بتوصية بتقديم الأصل الإنجليزي مع ترجمة معتمدة أو محلفة؛ راجع [ترجمة التقارير للمحكمة](https://phishdestroy.io/tgwitness/ar/docs/reference/translation/).

في قناة أو مجموعة فرعية، يقوم Telegram بترقيم الرسائل 1، 2، 3... بالترتيب. يسرد تصدير الدردشة الرقم الأول والأخير، وعدد الرسائل الموجودة، وكل سلسلة من الأرقام الغائبة في `message-ids.json` ، وقائمة البيانات، ورأس `chat.json` ، ويحدد كل فجوة في المكان الذي تقع فيه في النص الكامل. `verify.py` يعيد ترقيمها بدءًا من `chat.json` . الرقم الغائب هو رسالة لم ترجعها Telegram (تم حذفها قبل التصدير، أو غير مرئية للحساب)؛ في الدردشات الخاصة و المجموعات الأساسية، يتم مشاركة الأرقام بين جميع دردشات الحساب ولا يتم احتساب الفجوات.

بعد قراءة السجل، يطلب التصدير من Telegram كل رقم غائب مرة أخرى، حسب الرقم (`channels.getMessages`، بحد أقصى 10,000 رقم بما في ذلك الـ 1,000 رقم الموجود أسفل الرسالة الأولى، موزعة بالتساوي على جميع الفجوات عند وجود المزيد منها). تظهر النتيجة في `message-ids.json` والتقرير. وتسجل الإجابة الفارغة أن الرقم غير متاح لهذا الحساب في وقت إعادة الفحص؛ دون تحديد السبب. وتُضاف أي رسالة يتم إرجاعها عند إعادة الفحص إلى التصدير ويتم تمييزها `found_on_recheck`.

عندما تلاحظ مساحة العمل المراقبة أن رسائل الدردشة قد حُذفت، أو كانت مفقودة عند إعادة الفحص، أو تم تعديلها، فإن عملية تصدير الدردشة تضيف `journal-changes.jsonl`: سجلات اليومية تلك، وكل نسخة محفوظة والإشعار، مع تضمين كل منها التجزئة وتوقيع Ed25519 الذي تلقته في اليومية. `verify.py` تُعيد حساب التجزئة لكل سجل، وتتحقق من توقيعه مقابل مفتاح التصدير، وتقارن العدد مع قائمة البيانات الموقعة؛ ويحتوي تصدير الأدلة على سلسلة التجزئة الكاملة. يسرد التقرير هذه الرسائل تحت **«الحذف» و«الإصدارات السابقة**».

يبدأ كل تقرير بقسم **باختصار**: فقرة واحدة، ثم ما تُظهره المادة وما يتضمنه السجل. يتحول لون ختم الصفحة نفسه إلى الكهرماني عندما يتحقق المتصفح من توقيع الختم، وليس من الصفحة: فالمتصفح لا يمنح الصفحة بايتاتها الخاصة. يتحول إلى اللون الأخضر فقط عندما يقوم القارئ بسحب الملف إلى منطقة الفحص في نهاية الصفحة وتتطابق كل بايت، وفقط إذا كانت الصفحة المعروضة هي ذلك الملف؛ وإلا فإنه يتحول إلى اللون الأحمر.

يحدد كل تقرير اسم البرنامج بدقة: الالتزام (git commit) عند تشغيل أداة التجميع من نسخة مستخرجة أو عندما يقوم المثبت بتعيين `TGWITNESS_COMMIT`، وSHA-256 لملفات المصدر الخاصة به (`source_tree_sha256`، JSON القياسي للمسار → SHA-256 لكل ملف من ملفات `.py` و`.js` و`.css` و`.html` و`.svg` في الحزمة)، والتي تعيد إنتاجها نسخة مستخرجة من ذلك الالتزام ما لم يتم تغيير الملفات. يُسمى عميل Telegram باسم مكتبته وطبقة واجهة برمجة التطبيقات (API) ومركز البيانات الخاص به. عند بدء المراقبة وعندما يبدأ تصدير الدردشة وينتهي، يطلب المجمع من Telegram وقته (`updates.getState`، بالثواني الكاملة) ويسجل وقت Telegram مطروحًا منه توقيت ساعة المجمع، مع أخذ عدم اليقين الناتج عن رحلة الذهاب والإياب في الاعتبار؛ وتُظهر التقارير هذه القياسات تحت بند «سلسلة الحراسة». كما يسجل تصدير الدردشة الوقت الذي تمت فيه قراءة السجل، بالإضافة إلى تواريخ الرسائل.

### دليل عارض التقارير والأرشيف في وضع عدم الاتصال

قم باستخراج ملف ZIP بالكامل قبل فتح `chat.html` أو `report.html`. يوفر العارض ميزات البحث، والمرشحات، والمشاركين، والمؤشرات، وتفاصيل السجل، واختيارات JSON/CSV دون الحاجة إلى خادم. احتفظ بـ `viewer/` و `media/` بجانب التقرير. الاختيارات هي مشتقات: استخدم `verify.py SELECTION.json
--evidence ARCHIVE.zip` لمقارنتها بالأرشيف الموقّع. يقوم أداة التحقق بفحص معرّف التقرير، ومفتاح التوقيع، وحدود الأرشيف، وكل عنصر محدد؛ حيث تُرفض العناصر التي تم تعديلها، أو المفقودة، أو المكررة. تظل ملاحظات التحديد ووقت الإنشاء بيانات وصفية غير موقعة.

لا تظهر فجوات أرقام الرسائل إلا في موجز الدردشة الكامل غير المُصفى والمرتب ترتيبًا تصاعديًا. ولا يجب أن يؤدي إخفاء فئة ما أو الفشل في تحميل جزء من البيانات إلى تحويل الصف المُهمل إلى دليل على وجود رسالة مفقودة. تعمل ميزات تمييز النتائج على النص العادي قبل عملية التحويل إلى HTML، مع الحفاظ على العلامات الحرفية.

يقوم المتصفح بالتحقق من توقيعات ملفات البيان، ومعرف التقرير والمفتاح، وجميع تجزئات الملفات المدرجة. كما يرفض هياكل ملفات ZIP الغامضة أو غير الصحيحة، والأسماء المكررة والمسارات غير الآمنة، ويحدد سعة الملفات بحد أقصى 256 ميغابايت (MiB) والمحتوى الإجمالي المعلن بـ 4 غيغابايت (GiB). استخدم أداة التحقق المستقلة للأرشيفات الأكبر حجمًا. تكمل عملية الفحص هذه التي يقوم بها المتصفح عمليات الفحص التي يجريها أداة التحقق لسلاسل السجلات ودلالات البيانات.

يحتوي `README.txt` على دليل البدء، وقائمة ملفات متوافقة، وتعليمات التحقق، وملاحظات بشأن تنسيق البيانات بلغة التقرير، يليها دليل كامل باللغة الإنجليزية. يغطي ملف `SHA256SUMS` الملفات المدرجة فيه، باستثناء الملف نفسه و`manifest.json` و`manifest.sig`؛ كما يغطي البيان الموقّع ملف `SHA256SUMS` أيضًا. حافظ على ملف ZIP الأصلي دون تغيير واحفظ ملفات العمل خارج المجلد المستخرج. تتضمن تقارير PDF إشارات مرجعية للأقسام وتعريف الحالة/التقرير في الصفحات اللاحقة.

### الدردشة في وقت التصدير

يسجل تصدير الدردشة ما قاله Telegram عن الدردشة عند بدء التصدير: التسميات الخاصة بـ Telegram (`scam`، `fake`، `restricted` مع أسبابها، `verified`)، أسماء المستخدمين، الوصف، عدد الأعضاء والمسؤولين، المناقشة المرتبطة، حماية المحتوى، ما إذا كان الأعضاء الجدد يرون الرسائل السابقة ومن أي رسالة يبدأ هذا الحساب في عرض السجل (`available_min_id`)، تاريخ الرسالة 1 عندما يكون ذلك هو تاريخ إنشاء الدردشة، وSHA-256 لصورة الدردشة (المحفوظة في `media/`). ويسجل مكان الحساب المصدر في الدردشة: الدور، وتاريخ الانضمام، ومن قام بدعوته، وبالنسبة للمسؤول، حقوقه. ويتم بدلاً من ذلك تسمية الطلب الذي يرفضه Telegram.

عندما يكون الحساب المُصدِّر حسابًا إداريًا، يقوم التصدير بقراءة سجل الإدارة الخاص بالدردشة (يحتفظ Telegram به لمدة 48 ساعة تقريبًا) في ملف `admin-log.json`: عمليات الحذف والتعديلات مع المحتوى المُقدَّم، والحساب الفاعل وتاريخ الإجراء المصدر. تُكمِّل هذه الإدخالات الإصدارات الملتقطة من السجل المباشر وسجلات استلام عمليات الحذف.

### المؤشرات

قائمة التقارير، والأرشيف يحمل الرموز `indicators.csv` و`indicators.stix.json` (STIX 2.1 ) و`indicators.misp.json` (حدث MISP )، وهي ما يمكن لمكتب مكافحة إساءة الاستخدام اتخاذ إجراءات بشأنه في الرسائل المسجلة: الروابط والنطاقات (حتى تلك المخفية خلف النص، وفي الأزرار، وفي معاينات الروابط)، وعناوين العملات المشفرة، وأسماء المستخدمين وروابط الدعوة Telegram ، وأرقام الهواتف، وعناوين البريد الإلكتروني، والصور المحفوظة. يتم إدراج عناوين Bitcoin وLitecoin وDogecoin وTRON فقط عندما يكون مجموعها الاختباري base58 صحيحًا، وعناوين segwit عندما يكون مجموعها الاختباري bech32 أو bech32m صحيحًا، وعناوين TON عندما يكون مجموعها الاختباري CRC صحيحًا؛ أما عناوين EVM وSolana فيتم وضع علامة عليها على أنها غير تم فحصها. تحتوي الصور على SHA-256 وهاش إدراكي (dHash، 64 بت) الذي تظل النسخ المعاد ضغطها أو تغيير حجمها منه دون تغيير تقريبًا. تكتب التقارير المؤشرات بحيث لا تفتح عن طريق الخطأ (`hxxps[://]example[.]com` )؛ وتحتفظ الملفات بالقيم كما هي. يتم وضع علامة «مجهول» على كل مؤشر، ولا يخضع للكشف التلقائي (STIX ، `indicator_types: unknown` ، MISP ، `to_ids: false` ، التوزيع على المنظمة نفسها): وجوده في القائمة يعني أن رسالة ما احتوت عليه، لا أنه ضار. يتم وضع علامة في التقرير على الرابط الذي يظهر نصه عنوانًا مختلفًا عن العنوان الذي يفتح عليه.

تنتهي تقارير PDF بإقرار من الفاحص للتوقيع بخط اليد، وقائمة مراجعة للموثق أو خبير المحكمة، ورمز QR (موجود أيضًا في الصفحة الأولى) يتضمن معرّف التقرير، وبصمة المفتاح، و SHA-256 للبيانات الموثوقة، بحيث يمكن إرجاع النسخة المطبوعة إلى أرشيفها.

## توحيد الأحداث

يتكون إدخال التجزئة من الحقول التالية بالضبط:

```
seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash
```

تسلسل البيانات باستخدام JSON المتوافق مع Python بترميز UTF-8، ومفاتيح كائنات مرتبة، وبدون رموز ASCII الهروب، وبدون مسافات بيضاء غير ذات أهمية، وبدون قيم NaN أو اللانهاية:

```
json.dumps(value, ensure_ascii=False, sort_keys=True,
           separators=(",", ":"), allow_nan=False).encode("utf-8")
```

يصبح SHA-256 لتلك البايتات هو تجزئة الحدث. التوقيع هو Ed25519 على 32 بايت تجزئة خام، ثم يتم ترميزها بـ base64. أول previous_hash هو 64 صفرًا. تبدأ أرقام التسلسل من 1 وتزداد بمقدار 1. جميع الأحداث، بما في ذلك الأحداث التشغيلية ، تشترك في سلسلة واحدة. لا يوجد منع للتسليم المكرر: الملاحظات المتكررة هي إيصالات مميزة، وليست ادعاءً بوجود إجراءات Telegram منفصلة.

تُعد بيانات Telegram الأولية سلاسل نصية وفقًا لمعيار ISO؛ أما الحقول الثنائية فتتحول إلى كائنات تحتوي على bytes_base64. ويتم الاحتفاظ بنص الرسالة، والكيانات، ووصفات الوسائط، وبيانات الوصف الخاصة بالردود، وردود الفعل، وإجراءات الخدمة في بيانات الوصف الأولية للرسالة عند توفرها. كما تحتفظ الرسالة المباشرة بالتحديث الخاص بـ Telegram الذي قام بتسليمها `transport_update`؛ وعندما يحمل هذا التحديث نفس الرسالة `raw`، فإن `message` يكون `{"same_as": "raw"}` بدلاً من نسخة ثانية.

`observed_at` هو التوقيت العالمي المنسق (UTC) الذي كتب فيه المُجمِّع السجل؛ `source_at` هو التاريخ المقدم من حدث Telegram المذكور. السجلات التي تُكتب أثناء معالجة تحديث مباشر تُضاف إليها `payload.received_at`، وتوقيت UTC الذي وصل فيه التحديث إلى المجمع، و `payload.processing_delay_ms`. تحتفظ عمليات التحرير المباشرة بتاريخ التحرير المقدم، بينما تحتفظ لقطات السجل بتاريخ الرسالة مع وقت الملاحظة الحالي، ويقوم إشعار الحذف العادي بتسجيل وقت الاستلام مع تاريخ مصدر فارغ. تحتفظ إدخالات سجل الإدارة بتاريخ الإجراء المقدم بشكل منفصل. يعد ترتيب الاستلام وترتيب الأحداث المصدر خطين زمنيين متميزين، مع توفر ملاحظات الساعة وإيصالات الاستلام الخارجية للمقارنة.

## دلالات الفاعل

تتبع الإسناد مصدر الحدث. يحتفظ `message.new.actor_id` و `message.edited.payload.sender_id` بمرسل الرسالة. أما الإشعارات العادية `message.deleted` فتحمل معرّفات الرسائل وتحتوي على حقل actor فارغ؛ أما إدخالات سجل الإدارة المتاحة فتحمل الإجراء المحدد والفاعل والتاريخ. تحتفظ رسائل خدمة العضوية بالمرسل ونوع الإجراء، بينما تحتفظ تحديثات المشاركين الأولية بـ `actor_id` المحدد، وتحافظ لقطات ردود الفعل على الأعداد والهويات المرئية المحددة. اقرأ هذه السجلات جنبًا إلى جنب مع الإصدارات الملتقطة [وإيصالات تفاعل اللوحة](https://phishdestroy.io/tgwitness/ar/docs/reference/collection/#own-actions).

تحتوي إشعارات الحذف الخاصة بالمحادثات الخاصة والمجموعات العادية على معرّفات الرسائل فقط. تشترك تلك المحادثات في تسلسل معرّفات واحد على مستوى الحساب، لذا فإن المعرّف يحدد رسالة واحدة من هذا الحساب. عندما تم حفظ رسالة تحمل هذا المعرّف مسبقًا في هذه السجل، يتم تسجيل الحذف في تلك المحادثة على أنه message.deleted مع payload.chat_resolution لتسمية الطريقة. يتم الاحتفاظ بالمعرّفات التي لم يتم حفظها مطلقًا على أنها `deletion.unscoped`: وهو إشعار حذف فعلي لم يتم ربط محادثته بعد. وهذا يختلف عن `message.missing_on_recheck`، الذي يسجل نتيجة استعلام غير متوفرة، و عن وجود فجوة في معرّفات الرسائل المحفوظة. تقوم القنوات والمجموعات الفائقة بترقيم الرسائل لكل محادثة ولا تتم مطابقتها بهذه الطريقة أبدًا. عندما يتم إرسال الرسالة المحذوفة بواسطة الحساب الذي تمت ملاحظته، تكون قيمة payload.deleted_message_was_outgoing صحيحة؛ ولا يزال المُحذف غير محدد.

يحتفظ الإشعار غير المحدد النطاق بتسميته الخاصة لأن الدردشة المطابقة قد تكون خارج نطاق الملاحظة الحالية أو قد لا يكون لها تطابق فريد. ويظل إعادة التحقق من الغياب ملاحظة منفصلة عن إشعار الحذف في إحصاءات التقارير، والمرشحات، و التسميات. ويؤدي الاسترداد اللاحق إلى مسح حالة الفقدان الحالية مع الحفاظ على التحقق السابق غير الناجح في السجل الموقّع؛ وتظل إشعارات الحذف نوعًا منفصلاً من الأحداث.

يتم تجميع معرّفات الرسائل المتعددة التي تم ربطها بنفس المحادثة من إشعار واحد تحت اسم `deletion.batch`، بغض النظر عن عددها، مع الاحتفاظ بمعرّفات الرسائل تمامًا كما أرسلها Telegram وكذلك عدد الرسائل التي أرسلها هذا الحساب. وتدرج قائمة إشعارات Telegram الرسائل؛ بينما يذكر سجل إدارة المحادثة اسم المسؤول الفعلي حيث يمكن للحساب قراءته. يتم إنشاء الرابط (`message.deletion_attributed`) أيهما يصل أولاً: يتم مطابقة الاستطلاع الذي شهد إدخال سجل المسؤول قبل إشعار الحذف عند تسجيل الإشعار.

## التغطية: الاستمرارية، والثغرات، والمعرفات غير الملحوظة

يحتوي كل ملف ZIP موقّع على `coverage.json`، ويبدأ التقرير HTML بنفس الملخص، ويقوم `verify.py` بإعادة حسابه من `events.jsonl` بدلاً من الوثوق بالملف:

- **يتم المراقبة بشكل مستمر من X إلى Y.** تبدأ الفترة بـ `observation.started` وتنتهي عند حدوث توقف مؤقت، أو توقف نهائي، أو انقطاع اتصال Telegram، أو تسجيل الخروج، أو بدء عملية دون توقف منظم، أو مرور أكثر من ثلاث دقائق دون أي تسجيل أثناء المراقبة (يتم كتابة نبضات القلب كل دقيقة، لذا فإن الصمت يعني أن العملية توقفت، أو تجمدت، أو أن الكمبيوتر دخل في وضع السكون). عند تغيير الفاصل الزمني لنبضات القلب في **المزيد من الأدوات → المعلمات،** تقوم كل نبضة بتسجيل ذلك ويصبح الصمت المسموح به ثلاث فترات، ولا يقل أبدًا عن ثلاث دقائق.
- تُدرج **الفجوات** الفترة الزمنية الفاصلة بين الفترات مع ذكر السبب. ويُشار إلى الفجوة التي لا تزال مفتوحة عند آخر سجل بالرمز `not_resumed_by_last_record`.
- **لم يتم رصد معرّفات الرسائل.** بالنسبة للقنوات والمجموعات الفائقة، التي يتم فيها ترقيم الرسائل لكل محادثة، يتم سرد المعرّفات المفقودة بين المعرّفات التي تم رصدها على شكل نطاقات. ويتم الإبلاغ عنها على أنها لم*يتم رصدها* — محذوفة، أو لم يتم تسليمها أبدًا، أو خارج السجل المحفوظ — ولا يتم الإبلاغ عنها أبدًا على أنها محذوفة. تشترك المحادثات الخاصة والمجموعات العادية في تسلسل على مستوى الحساب بأكمله، لذا فإن الفجوات داخل إحدى هذه المحادثات لا تعني شيئًا ولا يتم إدراجها هناك.
- يتم احتساب إشعارات الفجوات على مستوى الدردشة (على سبيل المثال، طلب Telegram استعادة الفرق في إحدى القنوات) كملاحظات؛ ولا تقطع التغطية الشاملة.
- **سجلات الجلسات.** يتم إدراج الجلسات التي زاد فيها عداد التحديثات في Telegram دون أن يصل أي تحديث إلى هذه الجلسة (`updates_diverted`)، أو التي خرجت فيها هذه الجلسة من قائمة جلسات Telegram بينما ظل اتصالها يعمل (`session_revoked_externally`)، أو التي وصلت فيها إجابة استقصاء الشاهد من السجل فقط (`probe_ack_missed_live`) بشكل منفصل. كما يُبلغ المُحقق عن مصدر مفتاح جلسة Telegram، والجلسات الأخرى التي كانت مسجلة الدخول عند بدء المراقبة، والجلسات المضافة أثناء المراقبة، وإشعارات أمان Telegram (777000)، والجلسات الأخرى التي انتهت من مساحة العمل، وفترات «الجلسة فقط»، وعدد استقصاءات الشهود، وتحديثات المكالمات الهاتفية. انظر [الحسابات](https://phishdestroy.io/tgwitness/ar/docs/reference/accounts/#witness-probe). أثناء تفعيل [المحادثات المختارة الصارمة](https://phishdestroy.io/tgwitness/ar/docs/reference/collection/#strict-chosen-chats) (`scope.strict` في `observation.started`)، لا يتم جمع قائمة الجلسات (باستثناء الحالات التي تكون فيها هذه هي الجلسة الوحيدة، أو عندما تكون **أجهزة Telegram** قيد التشغيل)، ولا يتم جمع إشعارات الأمان و تحديثات المكالمات الهاتفية، لذا فإن غيابها لا يعني شيئًا، ولا تتم مطابقة الحذف مع جلسة فقط إذا كانت هناك جلسة قد جرت خلال الـ 10 دقائق التي سبقتها.

### تسلسل التحديث (`pts`)

تقوم Telegram بتحديثات متعلقة بالرسائل باستخدام `pts`: تسلسل واحد للحساب (المحادثات الخاصة والمجموعات الأساسية معًا) وتسلسل واحد لكل قناة أو مجموعة فائقة. يقوم المجمع بتسجيل كل سلسلة يتلقاها دون انقطاع كسجل `coverage.sequence` سجل: الأول والأخير `pts`، وعدد التحديثات من كل نوع، وما إذا كانت قد تم إرسالها مباشرةً أو تم استردادها بواسطة `getDifference` أو `getChannelDifference`. ويُعتبر الفاصل `coverage.gap` سجل، و `coverage.gap_closed` يحدد `pts` التي يصبح التسلسل كاملًا مرة أخرى.

يُظهر التسلسل المتواصل أن كل تحديث لـ «تيليجرام» تم ترقيمه في تلك السلسلة بين أول وأخير `pts` قد وصل إلى عميل Telegram الخاص بهذا الجامع. ولا يذكر شيئًا عن المحتوى الذي لم يرسله Telegram أبدًا إلى هذا الحساب، أو عن الفترة الزمنية التي سبقت أول تسجيل `pts`، أو عن الفترات التي لم يسجلها المجمع. ويُظهر `pts` يُظهر التقدم الذي لا يغطيه أي تسلسل أو فرق مسجل على أنه فجوة.

`GET /api/continuity` الإجابات الخاصة بفترة زمنية (`since`, `until`, `chat_id`) ما إذا كان كل متتابعة غير منقطعة، وتسرد حالات الانقطاع مع أسبابها. `verify.py` تطبع نفس المعلومات من سجلات أرشيف تحت عنوان **«استمرارية المتتابعات**».

### أرقام الرسائل المفقودة (`gap_summary`)

For a reader's guide to this section and to observation periods and gaps, see [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md).

**معاينة.** `coverage.json` → `gap_summary` يقيس الأرقام التي خصصها Telegram والتي لم يرها هذا المجمع مطلقًا. يقوم Telegram بترقيم الرسائل مرة واحدة لكل قناة أو مجموعة فائقة، ومرة واحدة لكل حساب عبر الدردشات الخاصة والروبوتات والمجموعات العادية. أي رقم يقع بين رسالتين تم رصدهما إما أنه تم رصده أو أنه مفقود؛ ويُعد النطاق المتواصل دلالة إيجابية على أن كل رسالة مرقمة فيه قد تم رصدها. أما الفجوة فلا تشير إلى أي طرف ولا سبب.

| المجال | المعنى |
| --- | --- |
| `status` | `on`، أو `off` عند إيقاف التشغيل في **المزيد من الأدوات → المعلمات → تحليل الفجوات** |
| `parameters` | المعلمات التي أدت إلى الحصول على النتيجة، بحيث يمكن تكرارها |
| `chats[]` | إدخال واحد لكل قناة أو مجموعة فائقة، كل منها مرقّم على حدة |
| `account` | تسلسل المحادثات الخاصة والروبوتات والمجموعات العادية على مستوى الحساب بأكمله |
| `status` (لكل تسلسل) | `applicable`، أو `not_applicable` مع `reason` |
| `observed_from`, `observed_to`, `span` | أول رقم تم رصده وآخر رقم تم رصده وحجم النطاق |
| `observed`, `observed_without_content` | الأرقام التي تمت ملاحظتها؛ تلك التي لا تُعرف إلا من سجل الحذف أو إعادة الفحص |
| `missing`, `density`, `gap_ranges`, `largest_gap` | الأرقام التي لم تُلاحظ قط، ونسبتها من النطاق، وعدد مرات التشغيل، وأطول مدة تشغيل |
| `clusters[]` | الثغرات المذكورة: `low`, `high`, `missing`، والأرقام المجاورة التي تمت ملاحظتها `after` / `before` مع أوقات رصدها |
| `service_estimate` | فقط عند التفعيل: عدد الأرقام المفقودة التي قد تكون رسائل خدمة وفقًا لنسبتها الملاحظة. لا تُطرح أبدًا من `missing` |

يُستمد الصحة من السجل، ولا يُفترض أبدًا:

- يتم قياس **القنوات والمجموعات الفائقة** لكل محادثة، وكذلك في تصدير المحادثات المختارة. السجلات التي يختارها المرسل هي التي تُستخدم في القياس `not_applicable`.
- يتم قياس **التسلسل على مستوى الحساب** فقط من أول رسالة إلى آخر رسالة وصلت أثناء تشغيل ميزة جمع البيانات للحساب بأكمله، مع الاحتفاظ بالمحادثات الخاصة والروبوتات والمجموعات العادية ورسائل الحساب نفسه، دون استبعاد أي محادثة من هذا القبيل (`scope.changed`). الأرقام المحددة بـ `deletion.unscoped` تُعتبر ملاحظةً بدون محتوى. ولا يمكن قياس ذلك عن طريق تصدير أو نقل الدردشات المختارة. إذا تم إيقاف تشغيل جمع البيانات من الحساب بأكمله ثم إعادة تشغيله، تظهر ملاحظة تفيد بأن الأرقام المستخدمة في تلك الفترة تظهر على شكل فجوات.
- رسائل الخدمة هي سجلات في السجل لها أرقامها الخاصة، لذا فهي تسد الفجوات بمفردها؛ أما التقدير الاختياري فهو مجرد سياق.

`verify.py` إعادة الحساب `gap_summary` من `events.jsonl` مع المعلمات الموجودة في العضو الموقّع `coverage.json` (القيم الافتراضية للأرشيفات الأقدم) و يطبع السطر الخاص بالحساب بأكمله في ملخص التغطية الخاص به. يعيد `get_capture_status`(MCP وخط الأوامر) يعيد نفس القياس للدردشات التي قد يقرأها المستخدم؛ أما التسلسل على مستوى الحساب فيقتصر على الوصول الذي يغطي مساحة العمل بأكملها.

يُحسب تكرار الملاحظات لرسالة خدمة واحدة مرة واحدة، ويستخدم تقدير خدمة الحساب الأرقام الموجودة داخل النطاق المقاس فقط. يجب أن يحافظ النطاق المطبق صراحةً على رسائل الحساب الخاصة قبل تمكين القياس على مستوى الحساب؛ ويبدأ القياس من السجلات التي تحمل تلك المعلومات. يغطي النطاق المقاس الملاحظة الجارية، ويتم تسجيل استئنافها. يحتوي استعلام الأرشيف المباشر على ميزانية زمنية، بما في ذلك مسح قاعدة البيانات، ويصنف القياس غير المكتمل على أنه جزئي.

يقوم Telegram بتوثيق [تسلسلات معرّفات الرسائل المنفصلة](https://core.telegram.org/api/updates#message-id-sequences). تصف هذه الأرقام الملاحظات؛ وإشعارات الحذف، وعمليات إعادة الفحص، وسجل إدارة النظام السبب وراء غياب رقم ما في المكان الذي يذكره Telegram.

عندما يتوقف الرمز Telegram عن قبول الحساب، فإن السجل `coverage.gap` الذي ينهي عملية المراقبة يحمل الرمز `cause` (`account_banned`، `account_frozen`، `account_deleted`، `session_duplicated`، `session_revoked`، `session_expired`، `session_ended` أو `not_authorized`) والخطأ Telegram ؛ ويحدد الرمز `verify.py` سبب انتهاء الفترة.

تجمع التغطية بين فترات المراقبة المسجلة، والانقطاعات، ونتائج الرسائل. قم بتقييمها جنبًا إلى جنب مع الدردشات المحددة، والفترة الزمنية، وسياسة المرفقات؛ وأعد التحقق من النتائج، حيث تُظهر الفجوات المسجلة مدى اكتمال مراقبة تحديثات الحساب.

## المنتج

تحتوي قائمة الأدلة الموقعة (ملفات ZIP)، وصادرات الدردشة، وسجلات الشهود، وبيان ملفات ملفات تعريف الأشخاص على `producer`: البرنامج، والإصدار، والمشروع (PhishDestroy)، والصفحة الرئيسية، ومستودع المصدر. يعرض التقرير بتنسيق HTML وأداة التحقق سجل المنتج الموقّع هذا. تحدد تجزئات ملفات المصدر شجرة المصدر المسجلة للمقارنة مع نسخة موثوقة. يتم التحقق من مصدر التنفيذ بشكل منفصل من خلال [شهادة الاستحواذ من GitHub](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) أو [قياسات Intel TDX،](https://phishdestroy.io/tgwitness/ar/docs/reference/high-assurance/) حيثما كان ذلك ممكّنًا. تظل الأرشيفات التي تم إنشاؤها قبل وجود حقل المنتج مدعومة ويتم تحديدها على أنها سجلات قديمة.

يحدد كل سجل `observation.started` أيضًا اسم عميل Telegram الذي تمت مراقبته: رقم `api_id` الخاص به (وليس التجزئة أبدًا)، سواء كان ذلك زوجًا عامًا مدمجًا أو تطبيقًا خاصًا بالمشغل، ووصف العميل المرسل في طلب الاتصال الخاص بـ Telegram، ونوع مسار الاتصال مع وضع IP (بدون عنوان وكيل أو سر). يُدرج التقرير و`custody.json` كل عميل ومسار مميز مع وقت تسجيلهما، والأوقات التي لم يرد فيها أي وكيل مدرج ورأى Telegram عنوان الخادم. وتشير السجلات التي تم تسجيلها قبل ذلك إلى ذلك.

## ملفات تعريف الأشخاص

يتم إنشاء ملف الملف الشخصي (`tgwitness-dossier-v1`، JSON) عند الطلب من السجلات الموجودة بالفعل في السجل الخاص بمحادثة واحدة؛ ولا يتم استرداد أي شيء من Telegram ولا يتم أبدًا كتابة محتويات الملف الشخصي في السجل (يتم تسجيل تشغيل الملفات الشخصية وإيقافها على أنها `dossier.changed`). بالنسبة لكل شخص لديه رسالة محفوظة، يُدرج السجل الاسم وسجل اسم المستخدم، وعلامات Telegram (روبوت، احتيال، مزيف، مميز، مُثبت، مقيد، محذوف) كما تظهر وقت الحفظ، معرفات الصور الشخصية، و SHA-256 والتجزئة الإدراكية (pHash، متوافقة مع `imagehash.phash`) لـ الصورة الرمزية من ذاكرة التخزين المؤقتة المحلية للصور الرمزية مع الصور الرمزية المماثلة، والنشاط (الرسالة الأولى والأخيرة، أعداد المشاركات، والمشاركات التي تم تعديلها وحذفها، والرسائل حسب الساعة بالتوقيت العالمي المنسق)، ومن يرد على من، والمحادثات الأخرى في هذا السجل التي كتب فيها الشخص، والمحافظ المذكورة (BTC، EVM، TRON، TON، LTC، DOGE، XMR، SOL؛ عناوين Base58Check يتم التحقق من صحتها باستخدام المجموع الاختباري)، وأرقام الهواتف، وأسماء المستخدمين و الروابط، بما في ذلك الروابط المخفية خلف النص.

تُدرج كل حقيقة سجلات السجل (`seq`) التي استُمدت منها، ويحتوي `record_hashes` على التجزئة لكل سجل مشار إليه. يتم توقيع البيان بمفتاح مساحة العمل:

```
python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip
```

يتحقق من التوقيع، ويتأكد من صحة عملية تصدير الأدلة نفسها (التوقيع، وسلسلة التجزئة، والملفات) ومن أن كل سجل مشار إليه موجود دون تغيير في عملية التصدير تلك من نفس مساحة العمل. يتم تصنيف تجزئات الصور الرمزية على أنها قادمة من ذاكرة التخزين المؤقتة المحلية (وليس من سجلات السجل). الإشارات هي مطابقات أنماط وأدلة يجب التحقق منها. يتم تشغيل الملفات الشخصية لكل محادثة على حدة، ويمكن تصديرها كملف ZIP مشفر بـ AES-256 مع كلمة مرور، و يتم حذفها عند إيقاف تشغيلها أو عند إزالة المحادثة من المصادر.

## شاهد مستقل

يتم فحص سجل الشاهد (`tgwitness-witness-v1`) ومنشورات قناته مقابل تصدير الأدلة باستخدام `verify.py --witness … --channel …`؛ انظر [الشاهد المستقل](https://phishdestroy.io/tgwitness/ar/docs/reference/witness/). باستخدام عنوان عام `https://t.me/s/…` أو `https://telegram.me/s/…`، يقرأ المدقق تاريخ كل منشور من Telegram، ويُعتبر أقدم تاريخ لمنشور في رأس التصدير هو الوقت الخارجي للسجل الأخير. أما التواريخ الواردة من أي مصدر آخر فهي بيانات وصفية مقدمة.

## البيان ونقاط التفتيش

يتضمن ملف manifest.json التنسيق، ووقت التصدير، والمفتاح العام، والبصمة، وطول السجل، وتجزئة الرأس، والنطاق، والمنتج، والقيود، و SHA-256 لكل عنصر محتوى بخلاف `manifest.json` و `manifest.sig` أنفسهما. manifest.sig هو توقيع base64 Ed25519 على ملف JSON الأساسي للبيان. يرفض المدقق العناصر غير المتوقعة/المفقودة، والأسماء المكررة، والملفات التالفة، والتسلسل/السلسلة المكسورة، والتوقيعات غير الصالحة، وعدم التطابق مع نقطة فحص مقدمة. ولا يقوم أبدًا باستخراج مسارات الأرشيف. ويحدد الحجم الإجمالي المعلن غير المضغوط بـ 4 جيجابايت؛ `--max-gib N` يسمح بأرشيفات أكبر حجمًا تم إنشاؤها باستخدام حد أعلى في **المزيد من الأدوات → المعلمات**.

يتم فحص الأرشيف الكبير بواسطة عدة عمليات في آن واحد: يتم إجراء التجزئة (هاش) للعناصر بشكل متوازٍ، وبعد أول 5,000 سجل، يتم فحص تجزئة المحتوى والتوقيع لكل سجل بواسطة عمليات عاملة، بينما تتبع العملية الرئيسية السلسلة والتغطية والروابط بالترتيب. `--jobs N` يحدد عدد العمليات؛ ويستخدم الإعداد الافتراضي `auto` يستخدم عملية واحدة لكل وحدة معالجة مركزية (CPU)، بحد أقصى 16، و `--jobs 1` يحتفظ بكل شيء في عملية واحدة. تكون النتيجة هي نفسها في كلتا الحالتين، ويتم رفض التغيير بنفس الرسالة. يتم الاحتفاظ بالتجزئات في المواضع المحددة بواسطة نقاط الفحص المحتفظ بها ومراسي الطوابع الزمنية خلال تلك المرة الواحدة، بحيث تتم مقارنة كل مرسى دون قراءة السجل مرة أخرى. على جهاز كمبيوتر ذي 32 خيطًا، استغرق أرشيف بحجم 10.8 جيجابايت يحتوي على 400,000 سجل 58.9 ثانية في عملية واحدة، و15.2 ثانية مع 4 عمليات، و8.4 ثانية مع 16 عملية؛ ثم تحدد مرور واحد على السجلات بالترتيب الحد الأقصى.

قم بإجراء التحقق من إصدار TgWitness المثبت لديك أو من نسخة تم مراجعتها. النسخة المضمنة في الأرشيف تدعم الاستخدام المحمول؛ قارن تلك النسخة مع التثبيت الموثوق لديك قبل تنفيذها.

توقع نقطة التحقق على بيان يحتوي على المفتاح العام، وطول السجل، وهاش الرأس، ووقت الإنشاء. كما أنها تحمل أحدث جولة drand التي جلبتها مساحة العمل (`drand_anchor` ): يطلب المجمع ترحيل drand عبر المسار الخارجي لمساحة العمل قبل كل نقطة تحقق دورية، لذا يتم تطبيق إخفاء عنوان IP، والبروكسيات، والمسار الخارجي المُوقف، مما يجعل نقطة التحقق نفسها لا تتصل أبدًا بالخارج. يمكن للمُحقق التحقق من أن أرشيفًا لاحقًا يحتوي على نفس البادئة. باستخدام `--checkpoint` و`--check-drand` ، يتأكد المُحقق من تلك الجولة مع مرحلات drand ويُبلغ بأن نقطة الفحص تم توقيعها في وقت لا يسبق وقت الجولة؛ ولا تغير الجولة مستوى الضمان. الاحتفاظ بنقطة الفحص خارج المجمع، بحيث يقارن التحقق اللاحق الأرشيف بـ مرجع محفوظ بشكل منفصل عنه. ويقوم مفتاح المجمع بتوقيعه، وبالتالي فإنه يربط السجلات به فقط إذا حصل المستلم عليه قبل الأرشيف، عبر قناة أخرى؛ وبحد ذاته لا يفي بالحد الأدنى المطلوب كدليل.

## قراءة نتيجة التحقق

يقدم برنامج التحقق تقارير عن سلامة الأرشيف، وتثبيت الموقّع، وفحوصات الضمان بشكل منفصل. ويُشير التوقيع الصحيح إلى أن البايتات لم تتغير منذ أن تم توقيعها. ويقوم المشغل بإرسال بصمة المفتاح إلى المستلم عبر قناة منفصلة. وبدون `--fingerprint`، يجتاز الأرشيف السليم فحوصات التوقيع والتنسيق بنجاح `signer_pinned: false`، ويبدأ السطر الأخير بـ `EVIDENCE: minimum not met · missing: confirmed signer key`.

بالنسبة لسياسة الأرشفة المحلية الآلية التي تتطلب مُوقِّعًا مثبتًا والحد الأدنى من الأدلة:

```
python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence
```

استخدم بصمة محفوظة عبر القناة الموثوقة للمستلم. يمكن للشاهد الموثوق أيضًا تثبيت المجمع من خلال سجل مشهود عليه متسق؛ قم بتوفير `--witness` و`--witness-fingerprint` و`--require-witness`. ينتهي `--strict` بالحالة 2 في حالة وجود مُوقّع غير مثبت؛ كما ينتهي أيضًا بالحالة 2 في حالة عدم استيفاء `--require-tier` أو `--require evidence`. يتطلب `--require evidence` وجود `--fingerprint` ووقت خارجي من طرف ثالث يغطي السجل الأخير. اقرأ `signer_pinned` و`requirements_met` ونتائج الضمان، وليس رمز الخروج فقط. بدلاً من ذلك، يستخدم [الاستحواذ المختوم](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md#sealed-evidence) أداة التحقق من التصديق والسياسة المعتمدة لمصادقة ملخص الاستحواذ.

## نطاق التحقق

يقوم التحقق بفحص الأرشيف ووضع التجميع المستخدم في إنشائه. اختر الوضع الذي تتطابق حدود الثقة فيه مع الحالة، ثم احتفظ بمدخلات التحقق الخاصة به.

| وضع التجميع | ما الذي يتحقق منه المدقق | مدخلات التحقق وحدود الثقة |
| --- | --- | --- |
| مساحة العمل المحلية | تسجيل التوقيعات وسلسلة التجزئة وبيانات البيان والمرفقات | يحتفظ المستلم ببصمة المجمع والوقت الخارجي من طرف ثالث: إيصالات RFC3161 أو OpenTimestamps التي تم التحقق منها، أو منشورات الشاهد التي تُقرأ من t.me. وتُعد نقاط التفتيش وسجلات الشاهد المحتفظ بها بمثابة عمليات تحقق داعمة |
| مساحة عمل محلية مع شاهد مستقل | التحقق من الأرشيف والتأكد من مطابقته لبادئة السجل السابقة التي احتفظ بها الشاهد | بصمة الشاهد وسجلاته؛ يُظهر سجل التحكم في المفتاح لدى الأمين من يحوز مفتاح الشاهد. مع `--channel https://t.me/s/…`، تمنح التواريخ التي وضعها Telegram على المنشورات وقتًا خارجيًا |
| [التقاط إجراءات GitHub](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | شهادة GitHub الخاصة بموجز الأرشيف، وسير العمل المعتمد، والتزامات المجمع، والمشغل المستضاف، وأصل الجلسة/المفتاح الجديد، وسلامة الأرشيف الداخلية | سياسة المُحقق الموثوق به، ومستودع المتصلين، وحزمة شهادات GitHub؛ يتم تنفيذ عملية التجميع ضمن سير العمل المثبت |
| [النشر على السحابة](https://phishdestroy.io/tgwitness/ar/docs/reference/high-assurance/) | سجلات دورة حياة المزود وسجلات الوصول، وحالة جدار الحماية وCloudflare، بالإضافة إلى سجل التشغيل الموقع من قبل المجمع | استعلامات للقراءة فقط موجهة إلى المزود وCloudflare؛ ويتوقف توفر الفحوصات الفردية على المزود |
| [آلة افتراضية سرية Intel TDX](https://phishdestroy.io/tgwitness/ar/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) | اقتباس التوقيع وحالة المنصة، والربط ببيان المجمع، والتكوين، وقياسات نظام التشغيل | سلسلة الثقة الخاصة بـ Intel ومقاييس النشر المتوقعة؛ مع الاحتفاظ بنتائج كل فحص TDX مطلوب |

في عملية الاستحواذ المختومة، يتلقى المجمع المعتمد البيانات عبر اتصال Telegram مصدق داخل البيئة التي تم التحقق منها. يربط التصديق الأرشيف بتلك العملية، لذا يشمل التحقق عملية الاستحواذ بالإضافة إلى سلامة الملف لاحقًا. يعتمد هذا على الكود المعتمد وسلسلة الثقة الخاصة بالمنصة المذكورة أعلاه. يتطلب التحقق من عمليات التقاط GitHub إنشاء جلسة داخل عملية التشغيل ويرفض عمليات التقاط الجلسات المستوردة.

يسجل إيصال التشغيل إصدار أداة التجميع، وتجزئات الملفات، وإعدادات بدء التشغيل. توفر قياسات المنشأ وTDX على GitHub فحوصات البيئة؛ ويحدد سجل التحقق  التكوينات التي تم اختبارها.

### من أين تأتي الرسائل

يقوم Telegram بتسليم الرسائل إلى كل عميل، بما في ذلك التطبيقات الرسمية، ضمن جلسة MTProto. يتم التفاوض على مفتاح التفويض الخاص بالجلسة مقابل مفتاح الخادم الثابت الخاص بـ Telegram، وتصل كل تحديثات مشفرة ويتم التحقق من سلامتها باستخدام ذلك المفتاح. يتلقى المجمع الرسائل من خلال الجلسة المصادق عليها للحساب، ويقوم بتوقيع كل ملاحظة في السجل فور وصولها، مع معرّفات الدردشة والرسالة والمرسل والتاريخ الذي يحدده Telegram لكل رسالة. في GitHub Actions ونشر Intel TDX، يربط التصديق أيضًا تلك الجلسة و مفتاح التوقيع بتنفيذ المجمع المعتمد.

يسجل السجل مصدر مفتاح التفويض. يؤدي تسجيل الدخول عبر الهاتف أو رمز الاستجابة السريعة (QR)، أو تسجيل الدخول المستقل من ملف جلسة، إلى كتابة `account.authorized` مع `key_origin: "created"`؛ ويؤدي التجميع على مفتاح `.session` مستورد، أو مفتاح TData أو JSON، إلى كتابة `imported`. كما يوجد المفتاح المستورد أينما كان مصدره. وترفض عمليات النشر المُصدّق عليها المفاتيح المستوردة.

يعتمد أصل السجل في Telegram على الاتصال المصادق عليه للحساب، و سجلات الاتصال والتسجيل في السجل اليومي، وإطارات MTProto المسجلة المطابقة لمدخلات السجل اليومي ([`tgwitness/forensics/`](https://github.com/phishdestroy/TgWitness/tree/main/tgwitness/forensics))، وتاريخ Telegram لكل رسالة، وفي حالة التسجيل المُثبت، بيئة التنفيذ التي تم التحقق منها. تحافظ توقيعات الأرشيف على هذا السجل للتحقق منه لاحقًا. تحدد نقاط الفحص المحتفظ بها حدود السجل السابقة، وتُظهر سجلات التغطية نتائج التجميع، وتحدد الطوابع الزمنية الخارجية التي تم التحقق منها الموضع الزمني للبايتات التي تم تسجيلها.

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

## المرفقات

يتم التعامل مع الملفات باستخدام خوارزمية SHA-256 ضمن مجلد media/. ويربط حدث media.saved التجزئة و طول البايت بحدث رسالة محدد. أسماء الملفات الأولية هي بيانات وصفية، وليست أبدًا مسارات محلية. يتم تنزيل بايتات الوسائط بشكل غير متزامن، لذا قد يؤدي الحذف الفوري إلى منع التسجيل. تظهر النتائج على شكل عمليات جمع معطلة، وملفات كبيرة الحجم/ذات حجم غير معروف، وفشل في التنزيل، وعمليات تنزيل متوقفة. قد يؤدي تعطل العملية إلى ترك ملفات جزئية غير مرجعية؛ ولا يتم تضمينها في عمليات التصدير.

يقوم مُصدِّر ملفات ZIP بالتحقق من الوسائط المخزنة مقارنةً بأسمائها. أما عمليات التصدير بتنسيقات JSONL و CSV و HTML فتتحقق من توقيعات الأحداث ولكنها لا تنقل بايتات الوسائط. التقارير المشتقة هي أدوات تيسيرية؛ أما ملف events.jsonl فهو التمثيل الموثوق للأحداث.

يؤدي التصدير الكامل للمحادثة إلى حفظ المرفقات ضمن إعدادات المرفقات في مساحة العمل في مجلد media/، وتسمى بـ SHA-256. يحدد كل سجل رسالة في chat.json اسم ملفه (`file`، `file_sha256`) أو سبب غيابه (`file_status`)، إلى جانب ما رآه القارئ حول النص: الروابط الموجودة خلف النص، مصدر إعادة التوجيه، أزرار الروبوت، التوقيع، عدد المشاهدات و مؤقت الحذف التلقائي. يتحقق `verify.py` من أن كل ملف مسمى موجود في قائمة البيانات الموقعة تحت ذلك التجزئة.

## جمع مستدام وإيصالات المعالجة (0.2)

مهمة وسائط وتسجيل حدث الرسالة في معاملة واحدة. تخزن المهمة وصف الرسالة الأصلية على Telegram؛ وتربط الملاحظة الموقعة بـ SHA-256، والحساب، وسياسة الحجم. يتحقق نظام الاسترداد من صحة هذا الربط قبل التنزيل. ولا يقوم أبدًا بجلب الرسالة الحالية، بل يستبدل المرفق الأحدث بصمت. يتم إعادة محاولة المهام المتوقفة، بينما يظل الفشل الدائم نتيجة صريحة.

لكل مساحة عمل دفتر يوميات خاص بها وهوية توقيع خاصة بها. يتضمن حدث process.started معرّف التشغيل، والساعات المحلية، وإصدارات التبعيات، وتجزئات ملفات المصدر، والحساب/النطاق الأولي، وإعدادات الالتقاط. تتضمن نبضات التشغيل معرّف التشغيل، والوقت الأحادي، وحالة قائمة الانتظار. يمكن أيضًا تنزيل إيصال التشغيل كبيان موقّع بشكل منفصل. للتحقق من بيئة التنفيذ، قم بإقرانه بشهادة GitHub أو فحوصات TDX الموضحة في [نطاق التحقق](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#verification-scope).

يتم الاحتفاظ بنقاط التفتيش التلقائية محليًّا عند بدء التشغيل، وكل خمس دقائق أثناء المراقبة (**المزيد من الأدوات → المعلمات → نقطة تفتيش موقعة كل**)، وعند الإيقاف المنظم. يقارن التحقق عند بدء التشغيل والتصدير السجل بأحدث نقطة تفتيش محلية محفوظة. ويمكن أن يكشف ذلك عن تراجع قاعدة البيانات عندما تبقى نقطة التفتيش سليمة. ويحافظ الاحتفاظ المستقل على توفر تلك المرجعية خارج مساحة العمل؛ كما أن الطابع الزمني الخارجي الذي تم التحقق منه يثبتها زمنيًّا بشكل إضافي.

بعد إعادة التشغيل، يتم استئناف موضع تحديث Telegram المحفوظ (`catch_up_from` في `observation.started`) ويتم طلب التحديثات الفائتة. لا يغطي الموضع المحفوظ سوى التحديثات التي اكتملت معالجتها، لذا يتم طلب التحديثات التي كانت لا تزال قيد الانتظار عند إغلاق الاتصال أو توقف العملية مرة أخرى. تسجل عملية إعادة الفحص الدورية `message.recovered` الرسائل الفائتة و `message.missing_on_recheck` عندما يتوقف Telegram عن إرجاع رسالة محفوظة؛ وهذا الأخير ليس إشعارًا بالحذف ولا يحدد من قام بالحذف أو الوقت.

### النسخ والاستعادة خارج الموقع (S3)

تقوم النسخة الخارجية (**الإعدادات → الإشعارات والنسخة الخارجية → النسخة الخارجية،** أو **المزيد من الأدوات → إضافات → الأدلة والنسخ الاحتياطية**؛ معطلة افتراضيًا) بتحميل أجزاء السجل والملفات المحفوظة ونقاط الفحص مع طوابعها الزمنية وعمليات تصدير الدردشات المكتملة إلى تخزين متوافق مع S3، مشفرة باستخدام AES-256-GCM قبل التحميل بمفتاح محفوظ في خزينة مساحة العمل؛ ويُطبق الاحتفاظ بقفل الكائن عندما يدعمه الحاوية. لا يمكن قراءة النسخة بدون المفتاح الذي تم تنزيله. قم بالاستعادة والتحقق باستخدام `python -m tgwitness.replica restore --key-file KEY.json --out DIR`.

تتطلب عملية الاستعادة وجود دليل عادي فارغ. تظل التنزيلات والكائنات التي تم فك تشفيرها في مساحة تخزين مؤقتة خاصة حتى يتم التحقق من السجل بأكمله وكل نقطة تفتيش محفوظة. يتم رفض مسارات الكائنات غير الآمنة ونطاقات المقاطع غير المتسقة والسجلات الأقصر من نقطة تفتيش؛ وفي حالة فشل التحقق، لا يتم نشر أي ملفات مستعادة. تقارن فحوصات الاحتفاظ وضع قفل الكائن المُرجع وتاريخه مع الموعد النهائي المرسل عند التحميل (بتفاوت تقريب يبلغ ثانية واحدة). لا يُعتبر الموعد النهائي منتهي الصلاحية أو غير صالح أو المختصر مُثبتًا. تُبلغ الحالة عن الكائن الذي تم أخذ عينة منه والذي تمت قراءة احتفاظه لتلك عملية التحميل.

يتم الإبلاغ عن الوسائط المحلية المفقودة أو التالفة كخطأ في الدورة، ويبقى مؤشر الوسائط قبلها، بحيث تتم إعادة محاولة تحميل الملف في الدورة التالية؛ بينما تظل الملفات ونقاط الفحص وعمليات التصدير التي تليها تُنسخ. تقوم عملية الاستعادة بمقارنة جميع مراجع الوسائط المحفوظة مع التجزئات المفككة والأحجام المسجلة. يتم إزالة التكرار من أجزاء السجل المتطابقة المتداخلة الناتجة عن عمليات التحميل المتوقفة؛ ويتم رفض التداخلات المتعارضة. يتم تأجيل نقاط التحقق التي تم إنشاؤها أثناء التحميل حتى يتم نسخ سجلات السجل التي تغطيها، بحيث لا تنشر الجولة المكتملة نقطة تحقق قبل سجلها.

### لقطات تصدير البث المباشر

تستخدم عمليات التصدير المتدفقة لقطة قراءة مستقرة من SQLite. قد يكون رأسها أقدم من السجل المباشر الحالي عند اكتمال التنزيل. يمكن لنقطة فحص تم إنشاؤها بعد تلك اللقطة أن تشير بشكل صحيح إلى أن الأرشيف أقصر؛ قارن ذلك بنقطة فحص عند البادئة المصدرة أو قبلها، وليس بنقطة فحص لاحقة عشوائية.

## التحضير لمعيار RFC 3161 والتحقق من الاستجابة (0.2)

يرسل «وضع الأدلة» فقط قيمة SHA-256 لكل نقطة تفتيش موقعة إلى السلطات المدرجة في RFC 3161 وتقويمات OpenTimestamps، عبر مسار مساحة العمل ولا يمر أبدًا عبر MTProxy. يتم تشغيل الطوابع الزمنية افتراضيًّا في كل هدف إعداد؛ كما تسجل **الأدلة الخاصة بحالة ما** قيمة drand. يتم الاحتفاظ بالإجابات في `checkpoints/anchors/`، ويتم تصديرها بصيغة `.tsr` و `.ots` تحت `anchors/`، ويتم التحقق منها بواسطة `verify.py` (`--tsa-ca` يتحقق من توقيع TSA؛ ويؤكد إثباتات OpenTimestamps باستخدام `ots upgrade` و `ots verify`).

السلطة التي تعمل وفقًا لمعيار RFC 3161 والتي تفشل مرتين على التوالي تنتظر قبل المحاولة التالية: فترة واحدة، ثم فترتين، وأربع فترات، وهكذا دواليك حتى ست ساعات، أو طالما تطلب ذلك الخاصية `Retry-After`، بحد أقصى يوم واحد. أما عملية الفحص التي تجد سلطات في حالة انتظار فقط فلا تسجل أي سجل؛ وإلا فإن `anchor.completed` يسردها تحت `deferred` مع `retry_at`. إلى أن ترد مرة أخرى، تعرض اللوحة الطوابع الزمنية على **أنها متدهورة (Degraded)**.

تقوم اللوحة بإعداد أرشيف طلبات يحتوي على بايتات ملف checkpoint.json القياسية، وبصمة رسالة SHA-256 ورقم عشوائي (nonce) في ملف timestamp.tsq، ومجموعات التحقق، والتعليمات. لا يتم إرسال أي طلب شبكة؛ الرمز الذي تعيده السلطة لهذا الطلب هو الطابع الزمني.

يتحقق `python -m tgwitness.anchor verify` من الرد مقابل بايتات نقطة التحقق والطلب الأصلي دون OpenSSL. يجب تحديد ملف CA موثوق صراحةً؛ ولا تُعدّ الشهادات المضمّنة موثوقة تلقائيًا. التحقق من الطلب اختياري في واجهة سطر الأوامر، لذا احتفظ بالطلب ومرّر --request للتحقق من nonce. تبيّن النتيجة ما إذا تم التحقق منه. ويجب التحقق من توقيع نقطة التحقق الخاصة بالمجمّع ومن السجل بشكل منفصل باستخدام البصمة الموثوقة للمجمّع.

يقوم التحقق بفحص توقيع الاستجابة، وبايتات نقطة الفحص، وعند توفرها، الطلب الأصلي في إطار الثقة المحددة للسلطة المصدقة (CA). بالنسبة للطوابع الزمنية التي تم الحصول عليها في وضع الأدلة، يفحص `verify.py` أيضًا أدلة OCSP أو CRL المخزنة ([إلغاء شهادة التوقيع](https://phishdestroy.io/tgwitness/ar/docs/reference/timestamp/#signing-certificate-revocation)). انظر [الإجراء](https://phishdestroy.io/tgwitness/ar/docs/reference/timestamp/) [ونتائج التحقق](https://phishdestroy.io/tgwitness/ar/docs/reference/verification/).

## السجلات الاختيارية في وضع الأدلة: أجهزة drand وTelegram

يمكن تشغيل سجلين إضافيين في نفس المراحل التي يتم فيها تشغيل الطوابع الزمنية. ولا يسري مفعول كلاهما إلا أثناء تشغيل «وضع الأدلة». يؤدي وجود **أدلة لقضية ما** إلى تشغيل «drand»؛ وإلا فإن كلاهما يبدأان في العمل. قم بالتبديل بينهما من خلال «المزيد من الأدوات» → «إضافات» → «الأدلة والنسخ الاحتياطية» → **المزيد من الشهود · اختياري**، أو `"drand": true` و `"devices": true` في `POST /api/evidence`. لا يؤدي فشل أحدهما إلى إيقاف الآخر أو الطوابع الزمنية؛ حيث تعرض اللوحة أحدث نتيجة لكل منهما أسفل النموذج.

**drand** (`beacon.drand` ). في كل دورة، يتم كتابة أحدث جولة من شبكة drand quicknet، وهي العشوائية العامة لـ «League of Entropy» (جولة كل 3 ثوانٍ)، في السجل: `chain` ، `round` ، `randomness` ، `signature` ، `round_time` ، و`relay` الذي استجاب. توفر الجولة المُثبتة وغير المتوقعة مرجعًا زمنيًا أدنى للمواد اللاحقة المرتبطة بالتجزئة. ويوفر الطابع الزمني الذي تم التحقق منه عند نقطة تفتيش لاحقة مرجعًا زمنيًا أعلى. تحدد هذه الفحوصات حدود المواد المرتبطة. يطلب المجمع من `drand.cloudflare.com` أولاً، ثم من مرحلات Protocol Labs، عبر مسار مساحة العمل، بطلب واحد لكل تمريرة.

يتحقق `verify.py` من أن كل قيمة عشوائية هي SHA-256 لتوقيعها وأن وقت الجولة صحيح، ويبلغ عن الجولات، وأطول فترة بدون جولة، ومدى تأخر ساعة المجمع عن drand. يقوم `--check-drand` بمقارنة الجولات مع مرحل Cloudflare ومرحل Protocol Labs، سواء جميعها أو عينة عشوائية مكونة من 100 جولة في سجل طويل؛ وأي جولة تختلف عن ذلك تفشل في عملية التحقق.

أجهزة **وTelegram و** و`account.devices`. في كل دورة، يتم قراءة جلسات الحساب باستخدام `account.getAuthorizations`، والقائمة Telegram التي تظهر في «الإعدادات» → «الأجهزة»، وتسجيلها: بالكامل عند حدوث تغيير منذ الجولة السابقة، مع تجزئات الجلسات `added` و`removed`، وإلا يُسجل فقط عددها وSHA-256. يتم الاحتفاظ بطراز الجهاز، والمنصة، والتطبيق والإصدار، وتاريخ الإنشاء وآخر نشاط، والبلد والمنطقة؛ أما عناوين IP فلا يتم الاحتفاظ بها، لأن تصدير الأدلة يخرج عن سيطرتك. تظل جلسة عمل المجمع نفسه نشطة طوال الوقت، لذا لا يُعتبر سوى نشاط الجلسات الأخرى تغييرًا. يُبلغ `verify.py` عن عدد المرات التي تم فيها تسجيل القائمة وعن كل جلسة جديدة ومنتهية. ولا يقرأ القائمة إلا أثناء تشغيل عملية المراقبة.

ما تعرضه: يقوم drand بترتيب السجلات وفقًا للوقت العام، وقائمة الأجهزة هي بيان Telegram عبر المجمع، موقّع من قبل المجمع مثل أي سجل آخر.

**سجل بوابة Cloudflare** (`cloudflare.gateway_dns`). بالنسبة للخادم الذي يتم تحليله عبر بوابة Cloudflare ([بوابة DNS](https://phishdestroy.io/tgwitness/ar/docs/reference/high-assurance/#cloudflare-as-an-outside-witness))، يقوم كل مرور بنسخ ما سجلته البوابة منذ النسخة السابقة: سجل واحد لكل نافذة مدتها ثلاث ساعات كحد أقصى مع `from`، و`until`، و`location_id`، و`address` الخاص بالخادم عند تعيينه، و `queries` كـ `[at, name, type, rcode, decision, colo]`، حتى في حالة عدم وجود أي منها. قم بتعيينه تحت **سجل بوابة Cloudflare**: الحساب، والموقع، والعنوان الاختياري، ورمز مميز للقراءة فقط (قراءة تحليلات الحساب Analytics للقراءة؛ وقراءة Zero Trust PII للاحتفاظ بعنوان واحد لموقع مشترك). تقوم اللوحة بالتحقق منها بطلب واحد قبل الحفظ؛ ويبقى الرمز مشفرًا ولا يدخل السجل أبدًا. يسرد `verify.py` النوافذ، والأسماء الأكثر بحثًا، وأي وقت لا تغطيه أي نسخة؛ ويفشل السجل الذي لا يتطابق عدده مع استفساراته. النافذة التي تحتوي على أكثر من صفحة واحدة من الاستعلامات في ثانية واحدة تحتفظ بتلك الصفحة وتشير إلى أن الباقي مفقود. النسخة هي رد Cloudflare عبر المجمع، موقعة من قبل المجمع؛ وفي غضون 24 ساعة، يمكن لأي شخص لديه رمز مميز للقراءة فقط مقارنتها مع Cloudflare.
