التوثيق / 10

حافظ على أمانها

تعرف على مسارات Telegram وقوائم البروكسيات العامة والخدمات الخارجية الاختيارية. اعرف ما يتيحه كل سر، وما تغطيه وسائل الحماية، وما تتركه لك.

127.0.0.1عنوان اللوحة افتراضيًّا

256 بترمز لوحة عشوائي

0شبكات توزيع المحتوى (CDNs)، أو أدوات التحليل، أو الخطوط عن بُعد

Ed25519توقيع على كل سجل

المكان الذي يُحفظ فيه كل شيء

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

06 / ما يخرج من الجهازالتثبيت

جهاز الكمبيوتر أو الخادم الخاص بك

لوحة127.0.0.1:8787 · رمز الحامل

أداة التجميععميل Telegram واحد لكل مساحة عمل

دليل البيانات

السجلSQLite · متسلسل التجزئة · موقّع

وسائل الإعلامملفات مسماة وفقًا لـ SHA-256

VaultFernet · الجلسة، زوج واجهة برمجة التطبيقات (API)، مفتاح التوقيع، الوكيل

Telegramدائمًا · عبر مسارك
اتصال الحساب بـ MTProto: مباشر، أو عبر SOCKS5، أو HTTP، أو MTProxy. ينتظر وضع «إخفاء عنوان IP» وجود بروكسي فعال. يتطلب اللجوء المباشر إلى البديل وضعًا يسمح بذلك صراحةً.
نص خارج الموقعاختياري · معطّل افتراضيًا
يتم تشفير السجل والملفات ونقاط الفحص باستخدام خوارزمية AES-GCM قبل تحميلها إلى مساحة تخزين متوافقة مع S3. وتبقى المفتاح في حوزتك؛ ويتم تسمية المرفقات باستخدام التجزئات المشفرة بالمفتاح، وليس التجزئة الخاصة بمحتواها.
الإشعاراتاختياري · معطّل افتراضيًا
المشاكل وعدد التغييرات مع عناوين الدردشات. لا يتم إرسال مقتطفات الرسائل إلا إذا قمت بتفعيل هذه الميزة.
مصدر موثوق للتوقيتاختياري · معطّل افتراضيًا
يقتصر الأمر على قيمة SHA-256 لنقطة تفتيش موقعة ورقم عشوائي (nonce). لا توجد رسائل ولا أسماء مستخدمين في الدردشة.
Witnessاختياري · معطّل افتراضيًا
تستخرج نقاط التحقق الموقعة وعدادات التسجيل باستخدام رمز قراءة فقط. ولا يمكنها قراءة المحادثات أو تغيير الإعدادات.

الإعداد الافتراضي: لا يغادر هذا الجهاز سوى اتصال Telegram.

يتم تكوين الوجهات الاختيارية لكل مساحة عمل. يتم تخزين نص الرسائل والملفات الوسائطية دون تشفير في دليل البيانات: قم بحمايته باستخدام تشفير القرص وأذونات الملفات.

ما يكشفه كل سر

سري	مكان حفظها	ما يتيحه هذا الموقع	في حالة التسريب
رمز اللوحة	`panel-token.txt` في دليل البيانات؛ ويحتفظ المتصفح به لعلامة التبويب فقط	كل شيء في كل مساحة عمل: القراءة والتصدير، وتغيير النطاق، وتسجيل الدخول إلى الحسابات	أوقف TgWitness، واحذف الرمز `panel-token.txt`، ثم أعد تشغيله: يتم إنشاء رمز جديد
جلسة Telegram	خزينة مشفرة (`credentials.enc`)	حساب Telegram نفسه	أنهِ الجلسة في Telegram من خلال «الإعدادات» → «الأجهزة»
مفتاح التوقيع	خزينة مشفرة (`signing.enc`)	توقيع السجلات التي يمكن التحقق منها باستخدام بصمتك الرقمية	يُحتفظ بنقاط التحقق في مكان آخر، ويُظهر الشاهد والطوابع الزمنية ما كان موجودًا من قبل
مفتاح الخزنة	`vault.key` بجانب البيانات، أو مفتاح رئيسي خارجي لدليل بيانات جديد	فك تشفير الخزنة	اعتبر الجلسة ومفتاح التوقيع على أنهما قد تسربا أيضًا
رمز Witness	على مضيف Witness	للقراءة فقط: نقاط التحقق الموقعة وحالة السلامة	احذفها من صفحة Witness؛ وأنشئ واحدة جديدة
نص خارج الموقع	Vault؛ قم بتنزيله مرة واحدة لاستعادة البيانات	فك تشفير النسخة الخارجية	ويمكن لأي شخص يمتلك النسخ المخزنة فك تشفيرها: تعامل مع تلك النسخة على أنها مكشوفة

ما تغطيه إجراءات الحماية

تم تغطيته

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

الأمر متروك لك

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

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

تعزيز أمان التثبيت

استخدم حساب Telegram مخصصًا — ولا تستخدم حسابك الرئيسي أبدًا. يمنحك رمز اللوحة وجلسة العمل السيطرة الكاملة عليه.
احتفظ باللوحة على العنوان 127.0.0.1. ولا تصل إليها عن بُعد إلا عبر HTTPS (تكوين Caddy المدمج) أو نفق SSH.
تشفير القرص الذي يحتوي على دليل البيانات: يتم تخزين نص الرسائل والملفات الوسائطية كما وصلت.
قصر دليل البيانات على حساب الخدمة. تُمنح الدلائل الجديدة الوضع 0700 في نظام Unix؛ أما في نظام Windows، فقم بتعيين أذونات المجلد.
احتفظ بالمفتاح الرئيسي للخزينة في مكان آخر على الخوادم: قم بتعيين TGWITNESS_VAULT_KEY_FILE قبل إنشاء دليل البيانات.
احفظ بصمة مفتاح التوقيع ونقاط التحقق على نظام آخر، وأضف شاهدًا على مضيف آخر.
لا تقم أبدًا بتحميل مفاتيح data/ أو الجلسات أو panel-token.txt أو مفاتيح الخزينة إلى GitHub أو في أي محادثة.
لا تقم بتسجيل رؤوس الرسائل Authorization أو نصوص الطلبات في الوكيل العكسي.

هل يمكنني تغيير رمز اللوحة دون فقدان البيانات؟

نعم. الرمز المميز يفتح اللوحة فقط. أوقف تشغيل TgWitness، واحذف panel-token.txt من دليل البيانات، ثم أعد تشغيله؛ حيث تظل السجلات والجلسات والمفاتيح كما هي دون تغيير. عند تعيين TGWITNESS_TOKEN، يتم استخدام قيمة البيئة بدلاً من الملف.

لماذا لا يتم تشفير الرسائل أثناء تخزينها؟

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

الإبلاغ عن ثغرة أمنية

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