التوثيق / 02
Telegram · التقاط GitHub Actions
اختر Takeout أو التصدير عبر API العادي أو سجل محادثة على مشغّل GitHub مؤقت.
المرجع الكامل
TgWitness / التوثيق · التصوير المستقل
المعاينة متاحة من الصفحة main. يقوم «الفرع» بتشغيل سير عمل مثبت وقابل لإعادة الاستخدام من
phishdestroy/TgWitness. يقوم سير العمل بتصدير حساب، أو محادثات محددة، أو
سجل أحداث محادثة واحدة باستخدام جلسة Telegram تم إنشاؤها حديثًا، ويصادق على ملف
ZIP الخاص بالأدلة أو ملف البيان متعدد الأجزاء، ويقوم بتحميل
الملفات المنقولة المشفرة من قبل المستلم فقط. ولا يتم الكشف عن لوحة الإدارة العادية.
اختر client=official_web لتشغيل الشاهد "official-client" مع عناصر تحكم Telegram Web المحمية والفيديو. يتطلب ذلك وجود وكيل اتصال خاص بك ويراقب محادثة واحدة معروضة. الإعداد الافتراضي client=api يحتفظ بأوضاع تصدير الحساب الكامل الموضحة أدناه.
يقوم المُحقق بمقارنة الأرشيف بشهادة GitHub الخاصة به، وسير العمل المعتمد وعمليات التسجيل الخاصة بالمجمع، بالإضافة إلى التجزئات الموقعة للمجلة والمرفقات. تستخدم عملية التجميع كودًا مثبتًا من المصدر الرئيسي ومساحة تخزين جديدة. ويمكن للمراجع فحص هذا الكود والتحقق من الأرشيف المُسلَّم مقارنةً بالتشغيل المسجل الخاص به.
في هذه الصفحة
مسار المستخدم#
يشرح المساعد المراحل الخمس ويتيح لك تجربة استبدال الرسائل أو المجمعات على بيانات نموذجية. يؤدي النقر على بدء التسجيل إلى فتح المعالج.
- اختر GitHub Actions capture (نسخة تجريبية) من الصفحة الرئيسية للمشروع، أو
شاشة تسجيل الدخول إلى مساحة العمل، أو من التصدير → فتح أداة المساعدة capture. يمكنك أيضًا
فتح أداة المساعدة الرسمية
أو ملف
tgwitness/static/capture.htmlمن نسخة موثوقة في متصفح حديث. لا يقوم المساعد بإجراء أي طلبات شبكية لمعالجة المفاتيح أو الملفات. يدعم المساعد لغات واجهة الموقع؛ وتدعم لوحة التجميع المؤقتة اللغتين الإنجليزية والروسية، وتفتح باللغة التي يعمل بها المتصفح إذا كانت إحدى هاتين اللغتين. - قم بإنشاء مفتاح وحفظ ملف sealed-key.json. هذا هو المفتاح الخاص الوحيد لفك التشفير. انسخ قيمة المفتاح العام الخاص بالمستلم. إن فقدان المفتاح الخاص يؤدي إلى فقدان إمكانية الوصول إلى كل من الاتصال والأرشيف. تأكد من حفظه لفتح الخطوة التالية. إذا كان لديك بالفعل ملف تسليم، فقم بتحميل المفتاح المحفوظ واختر لدي أرشيف بالفعل.
- قم بإنشاء نسخة متفرعة من TgWitness، وقم بتمكين ميزة «Actions» في النسخة المتفرعة، ثم قم بتشغيل Sealed chat capture. الصق عنوان المستلم العام واختر 30 أو 60 أو 120 دقيقة. لا تقم أبدًا بإدراج رقم هاتف أو رمز تسجيل الدخول أو كلمة مرور Telegram أو مفتاح خاص أو جلسة عمل في مدخلات سير العمل أو عمليات التسجيل أو المشكلات أو السجلات.
- أثناء التشغيل، قم بتنزيل ملف sealed-connection من «Artifacts» وقم بفك ضغطه.
قم بتحميل
connection.tgwsealedفي الأداة المساعدة، باستخدام المفتاح الخاص المحفوظ. يحتوي الرابط الناتج على سر وصول عشوائي في جزء عنوان URL الخاص به. حافظ على سرية هذا الرابط. تقوم اللوحة بإزالة الجزء وتخزين السر في مخزن جلسة العمل لهذه العلامة التبويبية؛ ولا يتم وضعه في سجلات الوصول HTTP. - افتح رابط الاتصال. قم بتسجيل الدخول باستخدام رمز QR، أو برقم هاتفك و
رمز تسجيل الدخول. أدخل كلمة مرور المصادقة الثنائية إذا طلبها Telegram. يتم
استخدام مجموعة بيانات اعتماد واجهة برمجة التطبيقات (API) المدمجة بشكل افتراضي، تمامًا مثل مساحة العمل العادية. يمكنك
توسيع قسم بيانات الاعتماد المخصصة الاختيارية وإدخال كليهما
api_idوapi_hashمن my.telegram.org/apps. اترك كلا الحقلين فارغين لاستخدام المجموعة المدمجة؛ حيث يتم رفض أي زوج غير مكتمل أو غير صحيح. لا يُسمح باستيراد الجلسات. اختر وضع التصدير ونطاقه. يحتوي رابط الاتصال على سر وصول: حافظ على سريته. - اختر Telegram Takeout أو Regular Telegram API أو Chat event journal. لتصدير الحساب، اختر جميع المحادثات المتاحة أو قم بتحميل واختيار محادثة واحدة أو أكثر، ثم حدد التواريخ وأنواع المحادثات وفئات الحساب وقواعد المرفقات. تحقق من الإعدادات والحجم، واحفظ إعدادات JSON اختياريًا لمراجع مستقل، ثم اضغط على بدء التسجيل. يتم تثبيت الإعدادات بعد البدء. لا تعمل ميزة «استئناف» إلا أثناء وجود هذا المشغل؛ ويؤدي الإنهاء المبكر إلى الحفاظ على البيانات المكتسبة وتسجيل الفجوات. يؤدي انتهاء المهلة بعد البدء إلى إنشاء أرشيف جزئي صريح؛ بينما يؤدي انتهاء المهلة قبل البدء أو الإلغاء إلى عدم إنشاء أي أرشيف.
- انتظر وصول الملف المُغلق، ثم قم بتنزيله وفك ضغطه، ثم قم بفك تشفير
delivery.tgwsealedفي الأداة المساعدة. ستحصل علىdelivery.zip، الذي يحتوي علىevidence.zip,attestation.jsonl، والتعليمات. يقتصر فك التشفير عبر المتصفح على 256 ميغابايت؛ أما الحزم الأكبر حجمًا فتستخدم الأمر المحلي للتدفق الموضح أدناه. تتضمن النتائج الكبيرة أيضًاdelivery-NNNNNN.tgwsealedأجزاء؛ ويحتوي الملفdelivery.tgwsealedيحتوي بعد ذلك علىevidence.parts.jsonوالشهادة. قم بتنزيل كل جزء وقم بتجميعها محليًا كما هو موضح أدناه. - قم بإنهاء الجلسة المؤقتة من خلال «إعدادات تيليجرام» → «الأجهزة» إذا لم يتم تأكيد الإلغاء أو تم إيقاف تشغيل التطبيق. وفي حالة الإكمال العادي، يُطلب منك تسجيل الخروج، و يسجل التطبيق ما إذا تم تأكيد الإلغاء أم لا.
يجب أن يحتوي المستودع على التزامات المصدر المثبتة المنشورة و«reusable-workflow». لا يمكن لمستودع GitHub آخر استدعاء فرع محلي بمفرده.
ميزانية وقت الجلسة#
قبل التحصيل، حساب الوقت والحجم يُقدِّر السجل والملفات المحددة بناءً على عدد الرسائل وعينة محدودة. يتضمن العرض الوقت الذي استغرقه تسجيل الدخول حتى الآن، والوقت المقدر لعملية التجميع، ووقت احتياطي للتعبئة. بالنسبة للملفات، يستخدم التقدير الأولي معدل 1 ميغابايت في الثانية وهامش زمني مضاعف؛ ويستبدل التقدم المحرز هذا الافتراض بالمعدل المقاس. استخدم الرسائل فقط أو اختر عددًا أقل من المحادثات عندما يتجاوز التقدير الوقت المتبقي.
يتم إضافة وقت الانتظار المُبلغ عنه لـ «Takeout» في Telegram إلى الميزانية. ويوقف المجمع عملية التجميع عندما يكون الوقت المتبقي ضروريًّا للتعبئة، ويحتفظ بالبيانات التي تم جمعها ويسجل نتيجة جزئية. وبالتالي، فإن الجلسة التي مدتها 120 دقيقة تستخدم نافذة التجميع المتبقية لديها بدلاً من الانتظار حتى الموعد النهائي قبل إعداد الأرشيف. ويُظهر العرض التحديدات التي تعذر أخذ عينات من حجمها الكامل.
اختر هذا الوضع أو مساحة عمل دائمة#
| وضع الالتقاط | نطاق قابل للتكوين | الفرق |
|---|---|---|
| Telegram Takeout، الخيار الافتراضي | جميع الدردشات السحابية المتاحة أو الدردشات المحددة، والتواريخ، وفئات الحسابات، وسياسات الوسائط، وطرق عرض JSON/HTML | يستخدم آلية التصدير الرسمية لـ Telegram؛ وقد يتطلب الأمر موافقة أو فترة انتظار. يمكن لـ Takeout حصر القنوات/المجموعات المتبقية حيثما يسمح Telegram بذلك، وطلب بيانات شخصية إضافية. |
| واجهة برمجة تطبيقات Telegram العادية | نفس نطاق الحساب وخيارات الإخراج، وفقًا للطرق المتاحة عبر واجهة برمجة التطبيقات (API) العادية | لا يتم تهيئة خدمة «Takeout»؛ ولا يمكن حصر القنوات/المجموعات الفائقة المتبقية أو استرداد البيانات الشخصية الخاصة بخدمة «Takeout» فقط. تشمل جهات الاتصال مستخدمي Telegram بدلاً من قائمة جهات الاتصال الهاتفية المحفوظة بالكامل. ولا تزال حدود الاستخدام سارية. |
| سجل أحداث الدردشة | محادثة واحدة مختارة، وسياسات المرفقات، والصور الرمزية الاختيارية | يسجل السجل التاريخي والتغييرات التي لوحظت خلال هذه الدورة. لا تنطبق فئات الحسابات، وفلاتر التواريخ، وطرق العرض المتوافقة مع أجهزة سطح المكتب. |
تتمتع الأوضاع الثلاثة جميعها بنفس شهادة GitHub ونفس آلية التسليم المشفرة. يختار Takeout طريقة الاستحواذ ولا يتم استبداله أبدًا بشكل خفي بالوصول العادي عبر واجهة برمجة التطبيقات (API). يقوم TgWitness بإنشاء عروض JSON/HTML من السجلات الملتقطة ويحافظ على طريقة الاستحواذ المحددة في عملية التصدير. راجع واجهة برمجة التطبيقات (API) الرسمية لـ Takeout.
يتم استخدام «Takeout» بشكل افتراضي، وتشمل جميع أنواع الدردشات التي يمكن الوصول إليها بما في ذلك الدردشات المؤرشفة، وجميع التواريخ، وملف تعريف الحساب وجهات الاتصال، وملفات JSON وHTML المتوافقة، وتنزيلات الملفات. تبلغ السعة التخزينية الأولية للوسائط 4 جيجابايت، مع حدود مرئية للملفات حسب النوع؛ أما الملفات الأكبر حجمًا أو في حالة استنفاد السعة التخزينية المخصصة للتنزيل، فيتم استخدام التجزئات (هاشات) الخادم حيثما كانت متاحة. يرجى مراجعة هذه الحدود قبل البدء في التجميع. لا يمكن إعادة تكوين الملف باستخدام التجزئات. أما الصور الاختيارية، والقصص، وبيانات تعريف الجلسات، والبيانات الشخصية الإضافية، فتظل خيارات منفصلة.
قد يتطلب الاستخراج الحصول على موافقة في جلسة Telegram قائمة. ويحدد Telegram مدة الانتظار؛ ولا يمكن تجاوزها من خلال تسجيل دخول جديد أو استخدام برنامج تشغيل جديد. وتبلغ المدة القصوى لفترة الاستخراج 120 دقيقة، بما في ذلك تسجيل الدخول والموافقة، لذا قد لا تكتمل العملية في حالة الحسابات الكبيرة أو عند طول مدة انتظار الموافقة. ويمكن لعملية التصدير المحلية المستمرة استئناف الجلسة نفسها، ولكنها لا ترث شهادة GitHub.
الموافقة على الإعدادات والتحقق منها#
بعد التحقق من الإعدادات والحجم، استخدم خيار حفظ الإعدادات للتحقق. اتفق
على النتيجة sealed-export-settings.json مع المراجع قبل عملية التجميع.
تؤدي التغييرات إلى إبطال التقييم المحفوظ. يقوم المجمع بالتوقيع على
الإعدادات السارية ورمز SHA-256 الخاص بها، وتربط إيصالات تصدير الحسابات نفس الخيارات.
يقوم المُحقق بالإبلاغ عن الوضع الفعلي، والاختيار، واكتمال العملية، ويرفض أي
تعارض بين المجلة وتصدير الحسابات المتداخلة.
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete
--expected-selection يرفض أي وسيلة نقل أو نطاق دردشة أو مرشح أو
سياسة مرفقات مختلفة. --require-complete لا تقبل سوى عمليات تصدير الحسابات وسجلات الدردشة
المسجلة على أنها مكتملة. وبدون هذه العلامات، لا يزال التحقق يتحقق من المصدر و
السلامة مع الإبلاغ عن الإعدادات المسجلة والثغرات. اتفق على
الاختيار المتوقع قبل التشغيل واحتفظ به بشكل منفصل عن الأرشيف. يحدد النطاق وفترات الاستحواذ المواد التي تم التقاطها أثناء
التشغيل؛ استخدم الملاحظات السابقة المحتفظ بها عند مقارنة الإصدارات السابقة.
| المطلوب | الوضع |
|---|---|
| تصدير بيانات الحساب التي يمكن الوصول إليها أو المحادثات المحددة خلال جلسة محدودة، وتزويد المراجع بأرشيف معتمد من جهة خارجية | التقاط GitHub Actions (نسخة تجريبية) |
| متابعة عدة محادثات بشكل مستمر، وإدارة الحسابات، والبحث في أرشيف متزايد وقراءته | مساحة عمل محلية أو مساحة عمل Docker |
يؤدي هذا إلى بدء عملية التقاط منفصلة باستخدام معلومات تسجيل دخول جديدة. ولا يقوم هذا الإجراء بتحميل اليوميات المحلية الموجودة لديك، ولا بتصدير مساحة العمل المفتوحة حاليًا، ولا بإعادة استخدام جلسة Telegram الخاصة بها. لا يمكن استئناف عملية التقاط سحابية غير مكتملة بعد إيقاف تشغيل برنامج تشغيلها؛ حيث يؤدي بدء سير عمل جديد إلى بدء عملية التقاط جديدة.
يؤدي اختيار التصدير → فتح أداة المساعدة في التسجيل في مساحة العمل إلى فتح المعالج الكامل داخل اللوحة. وتستخدم الصفحة المستقلة نفس المعالج وعناصر التحكم والسمات. وكلاهما يحتفظ بالمفاتيح وعملية فك التشفير داخل متصفحك. يتم فتح عملية بدء سير عمل GitHub و لوحة Telegram المؤقتة في علامات تبويب منفصلة؛ ويخبرك المعالج بموعد العودة. يؤدي قفل مساحة العمل إلى مسح مفتاح المعالج الموجود في الذاكرة. ويبقى ملف المفتاح المحفوظ على جهازك.
ما هو العام، وما الذي يجب أن يظل خاصاً#
تعمل عملية التجميع على برنامج تشغيل قياسي مستضاف على GitHub. ويُعتبر كل من GitHub — باعتباره أداة التجميع المعتمدة والتبعيات، والصفحة المساعدة، والمتصفح، ونفق HTTPS — أجزاءً موثوقة في هذا الإعداد. ويقوم المضيف المؤقت بمعالجة جلسة Telegram و الرسائل النصية العادية؛ ويتم تشفير المخرجات المرسلة من أجل المستلم.
تؤدي عملية «الفوركينغ» إلى نسخ كود المشروع إلى مستودعك. وهي لا تقوم بتصدير
حسابك على Telegram. مدخلات سير العمل الخاصة بالمستلم هي مفتاح تشفير عام.
احتفظ sealed-key.jsonبيانات اعتماد Telegram، ورموز تسجيل الدخول، وكلمات مرور المصادقة الثنائية (2FA)، و
عنوان URL للاتصال بعد فك التشفير بعيدًا عن عمليات الالتزام، ومدخلات سير العمل، والسجلات العامة.
ينشر سير العمل عناصر الاتصال/النتائج المشفرة لمدة يوم واحد. قم بتنزيل كليهما في الوقت المناسب؛ حيث تنطبق شروط توفر GitHub Actions وحدود الحساب والفوترة. ولا يُعد إنشاء نسخة متفرعة عامة ضمانًا للحصول على موارد حوسبة مجانية غير محدودة. ولا يتم إدخال أي دفعة أو رمز وصول GitHub في الأداة المساعدة.
يظل مفتاح فك التشفير الخاص موجودًا في متصفحك/ملفك. أما محتوى جلسة Telegram وملاحظات النص العادي فتوجد بالضرورة داخل المخزن المؤقت. يظل GitHub ونفق HTTPS بنية تحتية موثوقة. وقد يؤدي التصديق إلى إتاحة ملخص الأرشيف وهوية سير العمل للجمهور؛ أما محتويات الأرشيف فلا تُدرج في التصديق. والطابع الزمني للتصديق ليس طابعًا زمنيًا للرسالة.
استكشاف الأخطاء وإصلاحها#
| الأعراض | الخطوة التالية |
|---|---|
| زر إيقاف سير العمل | افتح نسخة فرعية خاصة بك، وقم بتمكين «الإجراءات»، وقم بمزامنتها مع المصدر الأصلي main. لا تقم بتعديل دبابيس المصدر المعتمدة لتجاوز أي عطل. |
لا sealed-connection قطعة أثرية |
تحقق مما إذا كانت المهمة قد بدأت وأكملت خطوة التشغيل/التحميل. قد تؤدي الأعطال في قائمة الانتظار أو برنامج التشغيل أو تنزيل الصورة أو النفق أو سياسة المستودع إلى منع عملية التشغيل. |
| يتعذر فتح الاتصال | قم بتحميل المفتاح المحفوظ لهذه الجولة، وقم بفك ضغط الملف الذي تم تنزيله، ثم حدد connection.tgwsealed. يجب أن يظل المشغل نشطًا. |
| تم إيقاف التاريخ مؤقتًا | تحقق من حالة اللوحة واستخدم خيار «استئناف» طالما أن الجلسة لا تزال نشطة، أو قم بإنهاء العملية بالبيانات التي تم جمعها بالفعل. قد تؤدي قيود Telegram والمحتوى الذي يتعذر الوصول إليه إلى حدوث ثغرات. |
لا sealed-result |
Cancellation or expiry before starting collection produces no archive; the run then ends with the notice No archive. A failed collection, attestation or packaging step also prevents delivery; the failed step names the supervisor's reason without private data. Inspect it without posting credentials. |
| لا يستطيع المتصفح فك تشفير أرشيف كبير الحجم | استخدم واجهة سطر الأوامر (CLI) الخاصة بالبث المباشر أدناه للحزم التي يزيد حجمها عن 256 ميبي. لن يتمكن المفتاح الخاص الخاطئ أو المفقود من فك تشفير النتيجة. |
| تم رفض الموقّع أثناء عملية التحقق | استخدم نسخة حديثة وموثوقة من برنامج TgWitness والمتصل المحدد OWNER/REPOSITORY. لا تقبل سياسة بديلة مرفقة مع الأرشيف. |
| لا يزال تطبيق Telegram يُدرج الجلسة المؤقتة | قم بإنهاء العملية من خلال «الإعدادات» → «الأجهزة». قد تفشل عملية تسجيل الخروج، وقد لا يتم تنفيذ عملية التنظيف في حالة إنهاء سير العمل قسريًّا. |
قبل الاعتماد على هذه النسخة التجريبية، جرب إجراء محادثة صغيرة تتحكم فيها: أنشئ رسالة ومرفقًا، واجمعهما، وفك تشفير النتيجة، وشغّل أداة التحقق، وتحقق من نتائج التغطية/الوسائط، وتأكد من إلغاء جلسة Telegram. تستخدم عمليات الفحص الآلية عميل Telegram اصطناعيًّا بالإضافة إلى اختبار منفصل لشهادة GitHub حقيقية؛ ولم يتم تسجيل أي تشغيل لحساب حقيقي في الإصدار الحالي.
فك التشفير والتحقق محليًّا#
استخدم أدوات من مصدر تثبيت موثوق به ومستقل، وليس الملفات القابلة للتنفيذ المقدمة من أرشيف أدلة مجهول:
python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip
# Unzip delivery.zip using your archive manager, then:
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
في حالة التسليم متعدد الأجزاء، قم بفك تشفير الحزمة الرئيسية أولاً واحتفظ بملف البيان المستخرج بجانب كل جزء مشفر، ثم قم بتشغيل:
python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip
python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
البيان هو العنصر المُثبت، وهو يُلزم كل جزء والملف المضغوط (ZIP) المُجمَّع.
استخدم --max-gib لتعيين حد أقصى مناسب للتحقق من الملف غير المضغوط لأرشيف
كبير الحجم؛ القيمة الافتراضية هي 4 جيجابايت. كما تعمل عمليات التحقق من «التحديد المتوقع» و«النطاق الكامل»
مع التسليم متعدد الأجزاء.
Python 3.11 أو أحدث، وتبعيات المشروع، وإصدار حديث من GitHub CLI يدعم
--signer-digest و --deny-self-hosted-runners . كما يتوفر مُنشئ مفاتيح CLI
أيضًا: python -m tgwitness.sealed_crypto keygen sealed-key.json.
يستخدم أداة التحقق tgwitness/sealed_policy.json من التثبيت الموثوق به.
ويقوم بالتحقق من مستودع المتصل، وسير عمل الموقّع الرئيسي، و
التزام الموقّع المعتمد، ومتطلبات المشغل المستضاف، وملخص ZIP الكامل، وسجل الأحداث الداخلي، و
سلامة المرفقات، وأصل مفتاح الحساب الجديد، والتزام المجمع المتوقع.
ويعرض السجل ونتائج الوسائط بدلاً من الإيحاء بأن جميع البيانات قد تم حفظها.
تؤدي قائمة الإصدارات المعتمدة الفارغة إلى فشل الإغلاق. يعد تحديث السياسة قرارًا صريحًا
بشأن الثقة؛ ولا تقبل أبدًا السياسة المقترحة الخاصة بالأرشيف تلقائيًّا.
للاستخدام دون اتصال بالإنترنت، قم بالحصول مسبقًا على الجذور الموثوقة من بيئة موثوقة:
gh attestation trusted-root > trusted_root.jsonl
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl
يتعلق الطابع الزمني للشهادة بالتزام الأرشيف. وهو لا يؤكد صحة الطوابع الزمنية للرسائل أو الساعة الحائطية الخاصة بالمجمع. انظر خيارات التحقق في GitHub.
كيف يتم إبقاء الشوكة خارج عملية الالتقاط#
يحتوي المُستدعي على مرجع على مستوى المهمة إلى سير العمل القابل لإعادة الاستخدام في المرحلة السابقة عند
رمز SHA الخاص بالتسجيل الكامل. ويقوم سير العمل هذا بسحب النسخة بشكل صريح مستودع المنبع
بمُجمِّع SHA ثابت. القيمة الافتراضية actions/checkout في مسار عمل قابل لإعادة الاستخدام
يقوم بالتحقق من هوية المتصل، ولا يُستخدم عن قصد.
لا يقوم سير العمل باستعادة ذاكرات التخزين المؤقت الخاصة بالمتصل، ولا يستهلك عناصر المتصل، ولا ينفذ ملفات المتصل، ولا يقبل عناوين URL للمصدر/الصورة، أو أوامر شل، أو ملفات ZIP المعدة مسبقًا، أو التجزئات المراد توقيعها. ويقبل مستلمًا عامًا محددًا ومدة جلسة محددة. يتم تثبيت الإجراءات والصورة الأساسية لـ Python و cloudflared بواسطة ملخصات غير قابلة للتغيير؛ وتستخدم تبعيات Python المتطلبات الحالية المقفلة بالتجزئة. يتم بناء الصورة من المصدر الموثوق به دون ذاكرة تخزين مؤقت.
يعمل المجمع كمستخدم غير جذر باستخدام صورة للقراءة فقط، مع إزالة إمكانيات Linux، ووضع حدود للموارد، وبدون مقبس Docker أو بيئة GitHub-token. وتقتصر عمليات التثبيت الخاصة به على دلائل التكوين ومساحة العمل والمخرجات الجديدة. يُتيح تطبيق FastAPI المقيد وظائف تسجيل الدخول، ومربعات الحوار، وجمع الحسابات أو الدردشات القابلة للتكوين، والحالة، والاستئناف، والإنهاء، والإلغاء. ولا يوجد مسار تنزيل بالنص العادي، أو مسار إدارة عام، أو مسار استيراد، أو نقطة نهاية للتوقيع.
يقوم المشرف بإيقاف الحاويات المتصلة بالشبكة قبل أن تقوم عملية التحقق
بقراءة الإصلاح النهائي evidence.zip أو evidence.parts.json. حاوية التعبئة لا تحتوي على شبكة.
تسمي خطوات التحميل فقط connection.tgwsealed و delivery*.tgwsealed؛
ولا يتم تحميل أي أدلة نصية عادية ولا بيانات اعتماد Telegram كأدلة.
تقوم عملية التنظيف بإزالة الدلائل والحاويات الخاصة، ويقوم GitHub بالتخلص من
الآلة الافتراضية للمشغل المستضافة بعد انتهاء المهمة. مدة الاحتفاظ بالأدلة هي يوم واحد؛ قم بالتنزيل قبل انتهاء الصلاحية.
يمكن لمالك «فورك» استبدال المُتصل أو إنشاء ملف مُوقَّع مختلف. ويجب على أداة التحقق الصارمة أن ترفض النتيجة مسار عمل/ملخص مختلف للموقّع. لا يزال هذا البناء يعتمد على عدم وجود ثغرات قابلة للاستغلال في الكود المعتمد وعلى سلامة برنامج التشغيل (runner) والبنية التحتية للتوقيع في GitHub.
التحويل التشفيري#
كل مفتاح مستلم هو RSA-3072 (يُقبل أيضًا استيراد RSA-4096)، والأس 65537. يحتوي كل غلاف على مفتاح AES-256 عشوائي جديد ورقم عشوائي (nonce) من 96 بت. يتم تغليف مفتاح AES باستخدام RSA-OAEP مع SHA-256/MGF1-SHA256. ويقوم AES-GCM بعلامة 128 بت بالمصادقة على البادئة والحمولة بالكامل. المفتاح العام للمستلم هو DER SPKI بتنسيق base64؛ ويحتوي ملف المفتاح الخاص على DER PKCS8 بتنسيق base64.
تتكون بايتات المغلف من TGWSEAL1\n، طول رأس JSON من نوع uint32 بتنسيق big-endian، و
الرأس، والنص المشفر، وعلامة GCM مكونة من 16 بايت. يتكون الرأس بالضبط من algorithm,
key، و nonce؛ والخوارزمية هي RSA-OAEP-256+A256GCM. البادئة الكاملة
من خلال الرأس هي بيانات مصادقة إضافية لـ GCM. حجم الرأس محدد
بـ 8192 بايت. تقوم واجهة CLI بنقل حمولات تصل إلى 8 جيجابايت وتقوم بالمصادقة قبل
تثبيت المخرجات المطلوبة؛ وترفض الكتابة فوق وجهة موجودة مسبقًا.
هذا غلاف خاص بالمشروع يحيط بالعناصر التشفيرية الأساسية القياسية:
RSA-OAEP مع SHA-256 وAES-256-GCM، متوفر في OpenSSL وفي كل
مكتبة تشفير رئيسية.
يتم التصديق على بايتات الأدلة الأصلية قبل وضع الأدلة و التصديق في الحزمة الخارجية المشفرة. وهذا يتجنب حدوث تبعية دائرية بين التجزئة الخاصة بالأرشيف والشهادة المضمنة داخل ذلك الأرشيف نفسه. بالنسبة للمستودعات العامة، تكون بيانات التعريف الخاصة بالتصديق (المستودع، سير العمل، عملية التسجيل، اسم العنصر وملخصه) عامة. لا تضع أبدًا أسماء الدردشة في بيانات التعريف العامة.
النطاق والتحقق من الصحة#
يستخدم هذا الوضع سجل المحادثات الموقّع ومحرك تصدير الحساب. يتم استبعاد المحادثات السرية، وسجل المحادثات المحذوف قبل بدء التجميع، والبيانات التي يتعذر الوصول إليها من الحساب. تكون المحادثات السحابية الخاصة مؤهلة عند تحديدها. يقتصر عدد المحادثات في أداة اختيار المحادثات على 20,000 محادثة؛ بينما يحدد محرك تصدير الحساب حجم البيانات المتوفرة لديه بنفسه. يتم تسجيل البيانات المفقودة والملفات الفاشلة والمهام غير المكتملة. ولا تزال حدود المرفقات وحدود سعة القرص/الوقت الخاصة ببرنامج التشغيل سارية. يستخدم التسليم الكبير أجزاءً مشفرة بدلاً من حد تسليم ثابت يبلغ 4 جيجابايت. يعني «الإكمال» انتهاء المهام المحددة المجمدة، وليس وجود كل سجل تاريخي لـ Telegram في الأرشيف. يمكن لمجلة المحادثة أيضًا مراقبة التحديثات المباشرة؛ ولا يُعد أي من الوضعين لقطة لحظية كاملة. لا تُعد لقطات الشاشة المُنشأة وتسجيلات الشاشة جزءًا من هذا الوضع.
تغطي الاختبارات عمليات تسجيل الدخول الاصطناعية الجديدة، وعزل النطاق، والوسائط، والإلغاء، وإكمال الموعد النهائي جزئيًا، وفشل تسجيل الخروج، ومسارات وحقول واجهة برمجة التطبيقات (API) المحظورة، ورفض مساحة العمل المُحمَّلة مسبقًا، ورفض المفاتيح الخاطئة والتلاعب، وعلامات التحقق المطلوبة، وقابلية التشغيل البيني للتشفير بين المتصفح وPython. يستخدم اختبار قبول المتصفح شهادة وهمية مُصنَّفة بوضوح؛ وهو ليس اختبار Sigstore حقيقيًّا. يجب الإبلاغ عن اختبارات القائم بالتشغيل المستضاف الحقيقي، وDocker، وشهادة GitHub، واختبار قبول Telegram المباشر بشكل منفصل عن الفحوصات الاصطناعية المحلية.
شروط GitHub Actions تقصر استخدام برامج التشغيل المستضافة على دورة حياة مشروع البرمجيات. ولا يؤدي إنشاء نسخة متفرعة إلى إزالة هذه القيود؛ ولا يجوز الترويج لهذه النسخة التجريبية على أنها استضافة إنتاجية مجانية غير مقيدة. كما أن خدمة Cloudflare Quick Tunnels مخصصة للاختبار والتطوير. وتعد أدوات المساعدة/سير العمل مناسبة لتقييم هذه الميزة؛ بينما تظل أهلية الخدمة الإنتاجية متطلبًا منفصلاً للنشر.
تسلسل إصدارات المسؤول عن الصيانة#
- قم بإدخال التغييرات ومراجعة المجمع والمشرف وتعريف الحاوية والاختبارات.
- قم بتثبيت التزام المجمع هذا في
sealed-collector.yml، ثم قم بالتسجيل/المراجعة لسير العمل القابل لإعادة الاستخدام. لا تقم أبدًا باشتقاق عملية السحب من SHA الخاص بالمستدعي بشكل صامت. - قم بتثبيت التزام سير العمل القابل لإعادة الاستخدام في
sealed-witness.ymlوأضف زوج SHA الخاص بـ workflow/collector إلىsealed_policy.jsonفي إصدار موثوق به. - انشر جميع عمليات التسجيل المشار إليها والبرنامج المساعد، ثم اختبر نسخة مستقلة وشهادة GitHub الأصلية. لا تقم بدمج عمليات التسجيل المشار إليها في هذه الإشارات ما لم يتم إعادة إنشاء الإشارات ونشرها مرة أخرى.
انظر إلى مسارات العمل القابلة لإعادة الاستخدام والشهادات للتعرف على الفرق بين مستودع المُتصل والمُوقِّع في المرحلة السابقة.