TgWitness / التوثيق

ما تم اختباره ←

التوثيق / 14

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). لا توجد رسائل ولا أسماء مستخدمين في الدردشة.

  • الشاهداختياري · معطّل افتراضيًا

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

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

يتم تكوين الوجهات الاختيارية لكل مساحة عمل.

ما يكشفه كل سر

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

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

تم تغطيته

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

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

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

شارك الوصول إلى قضية مع صلاحيات وانتهاء صلاحية وحدود للجلسات.

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

  1. استخدم حساب Telegram مخصصًا، ولا تستخدم حسابك الرئيسي أبدًا.
  2. أبقِ اللوحة على 127.0.0.1. الوصول عن بُعد فقط عبر HTTPS (Caddy المرفق) أو نفق SSH.
  3. شفّر القرص الذي يضم دليل البيانات.
  4. قيّد دليل البيانات بحساب الخدمة (0700 على Unix، وصلاحيات المجلد على Windows).
  5. احفظ مفتاح الخزنة في مكان آخر على الخوادم: عيّن TGWITNESS_VAULT_KEY_FILE قبل التشغيل الأول.
  6. احفظ البصمة ونقاط التحقق على نظام آخر، وشغّل الشاهد على مضيف آخر.
  7. لا تقم أبدًا بتحميل مفاتيح data/ أو الجلسات أو panel-token.txt أو مفاتيح الخزينة إلى GitHub أو في أي محادثة.
  8. لا تقم بتسجيل رؤوس الرسائل Authorization أو نصوص الطلبات في الوكيل العكسي.
هل يمكنني تغيير رمز اللوحة دون فقدان البيانات؟

نعم، فهو لا يفتح سوى اللوحة. أوقف TgWitness، واحذف panel-token.txt، وشغّله من جديد. يبقى السجل والجلسات والمفاتيح. إذا كان TGWITNESS_TOKEN معيّنًا، فقيمته تتقدم على الملف.

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

Security → Report a vulnerability على GitHub. الإصدار، والأثر، ومثال إعادة إنتاج مصغّر ببيانات وهمية. لا ترسل أبدًا بيانات اعتماد أو مجلدات حسابات أو أدلة حقيقية. إذا كان الإبلاغ الخاص معطّلاً، فافتح issue تطلب فيه قناة خاصة، دون تفاصيل الاستغلال.