# Telegram · الأمن ومعالجة البيانات

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

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

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

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

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

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [التوثيق](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [النشر والاستعادة](https://phishdestroy.io/tgwitness/ar/docs/reference/deployment/)

![النشر والاستعادة](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg)

تصف هذه الصفحة الوصول والتخزين وحماية الشبكة في مساحة عمل محلية أو على الخادم. لجمع البيانات على GitHub Runner أو في آلة افتراضية سرية من Intel TDX، راجع « [أوضاع التحقق](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#verification-scope)»، التي تضيف فحوصات لبيئة الجمع. تتمتع اتصالات الحسابات والإشعارات والطوابع الزمنية والنسخ خارج الموقع والشهود بإعدادات توجيه خاصة بها.

| المجال | باختصار |
| --- | --- |
| الوصول | مفتاح المسؤول بالإضافة إلى وصول محدود إلى الحسابات/الدردشات، وسبعة أذونات وجلسات قابلة للإلغاء؛ localhost بشكل افتراضي |
| الأسرار المخزنة | يتم تشفير الجلسة، وزوج واجهة برمجة التطبيقات (API)، ومفتاح التوقيع، وإعدادات الوكيل باستخدام Fernet |
| الرسائل والملفات الوسائطية | الملفات الموجودة في مساحة العمل، محمية بتشفير القرص أو وحدة التخزين وأذونات الملفات الخاصة بالمضيف |
| النزاهة | سلسلة تجزئة SHA-256 وتوقيع Ed25519 على كل سجل |
| الوقت الخارجي | تعد إيصالات RFC3161 وOpenTimestamps، ومنشورات الشهود المؤرخة من قبل Telegram وشهادة GitHub؛ ونقاط التفتيش المحتفظ بها، وسجلات الشهود، وقياسات Intel TDX بمثابة عمليات تحقق داعمة. ويقوم المُحقق بالإبلاغ عن شروط الأدلة التي تستوفيها |

للاطلاع على تقارير الثغرات الأمنية، انظر [سياسة الأمان](https://github.com/phishdestroy/TgWitness/blob/main/.github/SECURITY.md).

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

- [نموذج الوصول](https://phishdestroy.io/tgwitness/ar/docs/reference/security/#access-model)
- [محتوى اللوحة وعمليات التصدير](https://phishdestroy.io/tgwitness/ar/docs/reference/security/#panel-content-and-exports)
- [الأسرار المخزنة](https://phishdestroy.io/tgwitness/ar/docs/reference/security/#secrets-at-rest)
- [الوكلاء ومسارات الشبكة](https://phishdestroy.io/tgwitness/ar/docs/reference/security/#proxies-and-network-routes)
- [تسجيل الدخول واستيراد جلسات العمل](https://phishdestroy.io/tgwitness/ar/docs/reference/security/#sign-in-and-session-imports)
- [السجلات والنقل](https://phishdestroy.io/tgwitness/ar/docs/reference/security/#logs-and-transport)
- [السلامة والوقت الخارجي](https://phishdestroy.io/tgwitness/ar/docs/reference/security/#integrity-and-external-time)
- [إذا كنت تشك في وجود مشكلة](https://phishdestroy.io/tgwitness/ar/docs/reference/security/#if-you-suspect-a-problem)

## نموذج الوصول

يمنح رمز اللوحة الرئيسية تحكمًا كاملاً. يمكن للأشخاص الآخرين الحصول على [وصول محدد النطاق](https://phishdestroy.io/tgwitness/ar/docs/reference/access/) خاص بهم: مساحات العمل والدردشات المختارة، والأذونات، وتاريخ انتهاء الصلاحية، وقيود عناوين IP، وحدود تسجيل الدخول، والجلسات القابلة للإلغاء. لا يمكن للوصول المحدود بالدردشة تنفيذ عمليات على مستوى مساحة العمل بأكملها حتى لو تم تحديد أذونته. لكل مساحة عمل دفترها الخاص، وخزانتها، ومفتاح التوقيع الخاص بها داخل عملية واحدة؛ ويأتي الفصل بين الأشخاص على المضيف من حسابات نظام التشغيل.

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

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

يتم تقييد معدل محاولات المصادقة الفاشلة حسب عنوان العميل. تستخدم قيود عناوين IP العنوان الذي يراه التطبيق؛ لذا يجب التحقق من سلوك الوكيل العكسي قبل الاعتماد عليه. تظل بيانات اعتماد Witness منفصلة عن بيانات اعتماد نقاط الفحص/التحقق من الحالة، وهي مخصصة للقراءة فقط.

### الوصول إلى النسخة التجريبية

`/api/demo-access` هو أداة تمهيدية غير مصدقة عن عمد من أجل عرض توضيحي اصطناعي معزول تم بدء تشغيله بشكل صريح. وهي تصدر إمكانية منفصلة تدوم طوال عمر العملية، وليس أبدًا رمز اللوحة الحقيقي أو تجاوز TGWITNESS_TOKEN. يتطلب الإصدار والاستخدام نظيرًا للارتداد (loopback) ومضيفًا، دون رؤوس معاد توجيهها، ودون طلب عبر الأصول. تؤدي مساحات العمل الإضافية أو الجلسة المصرح بها إلى تعطيل هذا المسار. لا تصدر مساحات العمل الحية هذه القدرة أبدًا. لا يمكن للعرض التوضيحي ربط الحسابات أو تغيير إعدادات التجميع.

## محتوى اللوحة وعمليات التصدير

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

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

## الأسرار المخزنة

يتم تشفير بيانات اعتماد واجهة برمجة تطبيقات Telegram، والجلسة، ومفتاح التوقيع باستخدام خوارزمية Fernet. بالنسبة للرسائل والوسائط المحلية، يتم توفير التشفير بواسطة قرص المضيف أو وحدة التخزين؛ وتخزن مساحة العمل الملفات العادية. يمكن أن تستخدم عمليات التصدير ملف ZIP محمي بكلمة مرور باستخدام خوارزمية AES-256، وتستخدم النسخ خارج الموقع خوارزمية AES-256-GCM.

يتم تعيين مفتاح الخزينة افتراضيًّا على دليل البيانات المحمية. استخدم ملف مفتاح رئيسي خارجي أدناه لتخزينه بشكل منفصل. في نظام Unix، تستخدم ملفات المفاتيح الخاصة الجديدة الوضع 0600، بينما تستخدم أدلة البيانات الجديدة الوضع 0700؛ أما في نظام Windows، فقم بتعيين قائمة التحكم في الوصول (ACL) للدليل لحساب الخدمة و المسؤولين المصرح لهم. يتم الاحتفاظ بأذونات الدليل الحالية.

### مفتاح رئيسي خارجي

بالنسبة لدليل البيانات الجديد، يمكن لـ TGWITNESS_VAULT_KEY_FILE توفير مفتاح رئيسي عشوائي خارجي. يُستمد مفتاح Fernet مختلف لكل مساحة عمل باستخدام HKDF-SHA256 وملح عشوائي منفصل. يجب الاحتفاظ بملف vault.external.json لأغراض الاستعادة. تؤدي المفاتيح الرئيسية المفقودة أو الخاطئة إلى فشل الإغلاق. لا تتم ترحيل الخزائن المحلية الموجودة بصمت. تعرض اللوحة وضع تخزين المفاتيح المحدد. يحمي تشفير القرص ملفات الرسائل والوسائط المحلية في كلا الوضعين؛ انظر [الاتصال وحماية البيانات](https://phishdestroy.io/tgwitness/ar/docs/reference/connection/) للحصول على تفاصيل الإعداد.

## الخوادم الوكيلة ومسارات الشبكة

يتم تشفير إعدادات الوكيل في الخزينة. ولا يتم إرجاع كلمات المرور وأسرار MTProxy عبر واجهة برمجة التطبيقات (API) أو تدوينها في سجلات الأدلة. تختار كل مساحة عمل مسار Telegram الخاص بها و[وضع IP](https://phishdestroy.io/tgwitness/ar/docs/reference/connection/#ip-modes).

**يؤدي إخفاء العنوان** إلى رفض الاستعانة المباشرة بـ Telegram كخيار بديل ويتطلب استخدام وكيل (بروكسي) لطلبات HTTP الخارجية. يسمح وضع الاستعانة البديلة المحدد صراحةً بالوصول المباشر إلى Telegram بعد فترة تأخير؛ بينما يسمح وضع النفق/VPN بالاتصال المباشر. لا يؤدي اختيار وضع النفق إلى تثبيت أو التحقق من VPN. لا تتحكم هذه الإعدادات في كل حركة مرور الجهاز أو المتصفحات أو مديري الحزم أو تحليل عناوين DNS لمضيف الوكيل المحلي.

تنقل MTProxy حركة مرور Telegram فقط. يمكن للطلبات الخارجية استخدام بروكسي SOCKS5/HTTP منفصل، أو مسار SOCKS5/HTTP الخاص بمساحة العمل، أو مسار مباشر مسموح به؛ كما يمكن تعطيلها. يمتلك الشاهد المستقل إعدادات النقل الخاصة به. لا يتم تشفير المصادقة العادية لـ SOCKS5/HTTP CONNECT بواسطة بروتوكولات الوكيل تلك نفسها. ولا تزال أسرار TLS المزيفة لـ MTProxy غير مدعومة.

## تسجيل الدخول واستيراد جلسات العمل

تحتوي ملفات .tgwitness-session المحولة على سر ترخيص بنص عادي حتى يتم تحميلها وتخزينها في الخزينة. تقبل واجهة سطر الأوامر (CLI) غير المتصلة بالإنترنت مخططات Telethon التي تمت مراجعتها. كما يقبل استيراد اللوحة Pyrogram SQLite، وملفات TData ZIP الحديثة ذات الحساب الواحد، ومدخلات JSON الموثقة. وهي مصادق عليها، ومحدودة بأربعة ملفات / 8 ميغابايت، وتعالج عمليات التحميل في الذاكرة دون استخراج الأرشيف أو حفظ الملفات الأصلية. يتم إرجاع بيانات الاعتماد المعيارية فقط إلى المتصفح المصادق عليه الطالب؛ ويتم حفظها في الخزينة المشفرة بعد نجاح عملية المصادقة عبر Telegram. قم بحماية الملفات الأصلية والمحولة، وتجنب قيام العملاء المتزامنين باستنساخ المصادقة.

تتحقق معالجة TData من مجموعات التحقق للحاويات، وتجزئات فك التشفير المحلية، وأطوال الهياكل. يُستخدم رمز المرور المحلي المقدم لـ Desktop بشكل مؤقت ولا يتم تخزينه. يدعم المحلل المحدود تنسيقات Desktop التي يتحقق من صحتها ويرفض التنسيقات الأخرى. يتم إنشاء صور QR محليًّا، وتحتوي على رموز تسجيل دخول Telegram قصيرة الأمد، و لا يتم إرسالها أبدًا إلى خدمة عرض خارجية. يؤدي القفل، والتبديل بين مساحات العمل، وتسجيل الدخول الجديد، وتغييرات المسار إلى إلغاء محاولات QR المعلقة. قد تؤدي إعادة تحميل/إغلاق علامة تبويب إلى ترك محاولة معلقة حتى انتهاء صلاحيتها. ولا يزال تسجيل الدخول الناجح عبر رمز الاستجابة السريعة يفرض ربط الحساب. تظل أحجام نصوص واجهة برمجة التطبيقات (API) العادية محدودة بـ 16 كيلوبايت؛ بينما يقبل مسار الاستيراد المصادق عليه ما يصل إلى 12 ميغابايت من JSON المشفر، مع فرض حد أصغر للملفات المفككة بشكل منفصل.

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

## السجلات والنقل

يتم استبدال استجابة التحقق الافتراضية لواجهة برمجة التطبيقات (API) بحيث لا تعكس قيم بيانات الاعتماد. يتم تعطيل تسجيل وصول التطبيق. لا تقم بتكوين وكيل عكسي لتسجيل رؤوس التفويض أو نصوص الطلبات. تستمع اللوحة إلى المضيف المحلي (localhost)؛ ويتم الوصول عن بُعد عبر نفق SSH المُزوَّد، أو Cloudflare Tunnel، أو Caddy HTTPS، بحيث تنتقل الرموز وأسرار تسجيل الدخول عبر SSH أو TLS.

## السلامة والوقت الخارجي

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

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

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

تسرد كل إجابة تحقق شروط الأدلة مع كيفية التحقق من كل منها، مجمعةً حسب دورها على الأقل:

| الدور | الشرط |
| --- | --- |
| مطلوب | السلامة؛ مفتاح الموقّع مثبت بـ `--fingerprint`؛ وقت خارجي يغطي السجل الأخير (تم التحقق من إيصال RFC 3161 باستخدام `--tsa-ca`، وتم تأكيد إيصال OpenTimestamps باستخدام `--check-bitcoin`، وقراءة منشور الشاهد من t.me باستخدام `--channel`، وختم بيتكوين للشاهد أو شهادة GitHub تم التحقق منها) |
| دعم، وليس جزءًا من الحد الأدنى | شاهد بمفتاحه الخاص؛ نقطة تفتيش محفوظة؛ عملية جمع مُصدَّقة |

الحد **الأدنى المطلوب كدليل** هو استيفاء الشروط الثلاثة المطلوبة بالنسبة لآخر سجل تم تصديره؛ وتضيف عملية التجميع التي تم التحقق منها والتصديق عليها `attested` الملف الشخصي. يُبيّن السطر الأخير النتيجة، وتحدد الإجابة الخيارات التي من شأنها تلبية الشروط الناقصة. وبدون `--fingerprint` يبدأ السطر الأخير بـ `EVIDENCE: minimum not met · missing: confirmed signer key`. عندما تغطي الطوابع الزمنية التي تم التحقق منها السجلات السابقة فقط، تذكر الإجابة السجل الذي يصل إليه الحد الأدنى. `--require evidence` أو `--require attested` يخرج برمز 2 عندما لا يتم الوصول إلى الملف التعريفي للتصدير بأكمله، ويتم الإبلاغ عن أي فحص مطلوب في سطر الأوامر لا يمكن تنفيذه على أنه لم يتم تنفيذه بنفس الرمز. كل تقرير يحمل نفس الشروط مع حالتها في تلك النسخة والأمر الذي يتحقق منها. تظل مستويات الضمان `--strict` متاحة؛ ويُدرج [تنسيق الأدلة](https://phishdestroy.io/tgwitness/ar/docs/reference/evidence/#verification-scope) عمليات الفحص لكل وضع تجميع.

## إذا كنت تشك في وجود مشكلة

الحفاظ على دليل البيانات الأصلي واستخدام نسخة منفصلة للتحليل. الإبلاغ عن الإصدار المتأثر والعملية والخطوات القابلة للتكرار من خلال [سياسة الأمان](https://github.com/phishdestroy/TgWitness/blob/main/.github/SECURITY.md)، مع الحفاظ على خصوصية بيانات الحساب وبيانات الاعتماد.
