दस्तावेज़ीकरण / 02
Telegram · GitHub Actions कैप्चर
अस्थायी GitHub रनर पर Takeout, सामान्य API एक्सपोर्ट या चैट जर्नल चुनें.
पूर्ण संदर्भ
टीजीविटनेस / दस्तावेज़ीकरण · स्वतंत्र कब्ज़ा
main से पूर्वावलोकन उपलब्ध है। एक फोर्क से एक पिन किया गया पुन: प्रयोज्य वर्कफ़्लो लॉन्च होता है
phishdestroy/TgWitness. यह वर्कफ़्लो एक नए बनाए गए टेलीग्राम सत्र का उपयोग करके एक खाता, चयनित चैट या एक चैट का इवेंट जर्नल एक्सपोर्ट करता है, सबूत (ZIP या मल्टीपार्ट मैनिफेस्ट) की पुष्टि करता है, और केवल प्राप्तकर्ता-एन्क्रिप्टेड हैंडऑफ़ अपलोड करता है। सामान्य प्रशासन पैनल प्रदर्शित नहीं किया जाता है।
चुनें client=official_web आधिकारिक-क्लाइंट विटनेस को सुरक्षित टेलीग्राम वेब नियंत्रणों और वीडियो के साथ चलाने के लिए। इसके लिए आपके अपने अपस्ट्रीम प्रॉक्सी की आवश्यकता होती है और यह एक रेंडर की गई चैट को अवलोकन करता है। डिफ़ॉल्ट client=api नीचे वर्णित पूर्ण-खाता निर्यात मोड को बरकरार रखता है।
सत्यापनकर्ता आर्काइव की जाँच इसके GitHub प्रमाणीकरण, स्वीकृत वर्कफ़्लो और कलेक्टर कमिट्स, और हस्ताक्षरित जर्नल और अटैचमेंट हैश के विरुद्ध करता है। संग्रह प्रक्रिया पिन किए गए अपस्ट्रीम कोड और नई स्टोरेज का उपयोग करती है। एक समीक्षक उस कोड की जाँच कर सकता है और उसकी दर्ज की गई रन के विरुद्ध डिलीवर किए गए आर्काइव को सत्यापित कर सकता है।
इस पृष्ठ पर
उपयोगकर्ता प्रवाह#
सहायक पाँच चरणों को समझाता है और आपको नमूना डेटा पर संदेश या कलेक्टर प्रतिस्थापन आज़माने देता है। 'मेरा कैप्चर शुरू करें' विज़ार्ड खोलता है।
- प्रोजेक्ट होमपेज, वर्कस्पेस लॉगिन स्क्रीन, या एक्सपोर्ट्स → कैप्चर हेल्पर खोलें पर GitHub Actions कैप्चर (प्रीव्यू) चुनें। आप एक आधुनिक ब्राउज़र में एक विश्वसनीय चेकआउट से आधिकारिक हेल्पर या
tgwitness/static/capture.htmlभी खोल सकते हैं। हेल्पर कुंजी या फ़ाइल प्रोसेसिंग के लिए कोई नेटवर्क अनुरोध नहीं करता है। हेल्पर साइट की इंटरफ़ेस भाषाओं का समर्थन करता है; अस्थायी संग्रह पैनल अंग्रेजी और रूसी का समर्थन करता है और जब ब्राउज़र की भाषा इनमें से एक हो तो यह उसी भाषा में खुलता है। - एक कुंजी उत्पन्न करें और sealed-key.json को सहेजें। यह एकमात्र निजी डिक्रिप्शन कुंजी है। अलग सार्वजनिक प्राप्तकर्ता मान की प्रतिलिपि बनाएँ। निजी कुंजी खोने पर कनेक्शन और आर्काइव दोनों की पहुँच खो जाएगी। अगले चरण को अनलॉक करने के लिए पुष्टि करें कि आपने इसे सहेज लिया है। यदि आपके पास पहले से ही एक डिलीवरी फ़ाइल है, तो सहेजी गई कुंजी लोड करें और 'मेरे पास पहले से ही एक आर्काइव है' चुनें।
- Fork TgWitness, फोर्क में Actions सक्षम करें, और Sealed chat capture चलाएँ। सार्वजनिक प्राप्तकर्ता को पेस्ट करें और 30, 60, या 120 मिनट चुनें। कभी भी workflow इनपुट्स, कमिट्स, इश्यूज़, या लॉग्स में फ़ोन नंबर, लॉगिन कोड, टेलीग्राम पासवर्ड, प्राइवेट की, या सेशन न डालें।
- रन के दौरान, आर्टिफैक्ट्स से सील्ड-कनेक्शन डाउनलोड करें और इसे अनज़िप करें।
लोड करें
connection.tgwsealedहेल्पर में, सहेजी गई निजी कुंजी का उपयोग करके। परिणामी लिंक में उसके URL खंड में एक यादृच्छिक पहुँच रहस्य होता है। इस लिंक को निजी रखें। पैनल खंड को हटा देता है और रहस्य को इस टैब के सत्र भंडारण में रखता है; इसे HTTP पहुँच लॉग में नहीं रखा जाता। - कनेक्शन लिंक खोलें। QR कोड से, या अपने फोन नंबर और लॉगिन कोड से साइन इन करें। यदि टेलीग्राम पूछे तो अपना दो-चरणीय सत्यापन पासवर्ड दर्ज करें। सामान्य वर्कस्पेस की तरह, डिफ़ॉल्ट रूप से अंतर्निहित API क्रेडेंशियल पूल का उपयोग किया जाता है। आप वैकल्पिक कस्टम क्रेडेंशियल्स अनुभाग का विस्तार कर सकते हैं और दोनों दर्ज कर सकते हैं।
api_idऔरapi_hashmy.telegram.org/apps से। अंतर्निहित पूल का उपयोग करने के लिए दोनों फ़ील्ड को खाली छोड़ दें; एक आंशिक या गलत जोड़ी अस्वीकार कर दी जाती है। सत्र आयात की अनुमति नहीं है। निर्यात मोड और दायरा चुनें। कनेक्शन लिंक में एक एक्सेस सीक्रेट होता है: इसे निजी रखें। - टेलीग्राम टेकआउट, रेगुलर टेलीग्राम API या चैट इवेंट जर्नल चुनें। खाते के एक्सपोर्ट के लिए, सभी एक्सेसिबल चैट्स चुनें या लोड करें और एक या अधिक चैट्स चुनें, फिर तारीखें, चैट के प्रकार, खाते की श्रेणियाँ और अटैचमेंट नियम सेट करें। सेटिंग्स और आकार की जाँच करें, वैकल्पिक रूप से एक स्वतंत्र समीक्षक के लिए सेटिंग्स JSON सहेजें, फिर कैप्चर शुरू करें दबाएँ। शुरू करने के बाद सेटिंग्स स्थिर हो जाती हैं। रिज़्यूम केवल तब तक काम करता है जब तक यह रनर मौजूद रहता है; जल्दी समाप्त होने पर प्राप्त डेटा को संरक्षित करता है और रिकॉर्ड में रिक्त स्थानों को दर्ज करता है। शुरू करने के बाद समय सीमा समाप्त होने पर स्पष्ट रूप से एक आंशिक आर्काइव बनता है; शुरू करने से पहले समय सीमा समाप्त होने या रद्दीकरण पर कोई आर्काइव नहीं बनता है।
- सीलबंद परिणाम का इंतज़ार करें, उसे डाउनलोड करें और अनज़िप करें, और डिक्रिप्ट करें
delivery.tgwsealedमें helper में। आपको प्राप्त होता हैdelivery.zip, जिसमें शामिल हैंevidence.zip,attestation.jsonl, और निर्देश। ब्राउज़र डिक्रिप्शन 256 MiB तक सीमित है; बड़े पैकेज नीचे दी गई स्ट्रीमिंग स्थानीय कमांड का उपयोग करते हैं। बड़े परिणामों में भी शामिल होते हैंdelivery-NNNNNN.tgwsealedभाग; मुख्यdelivery.tgwsealedफिर में शामिल होता हैevidence.parts.jsonऔर प्रमाणीकरण। हर हिस्से को डाउनलोड करें और नीचे वर्णित अनुसार स्थानीय रूप से इकट्ठा करें। - यदि रद्दीकरण की पुष्टि नहीं हुई थी या रन समाप्त हो गया था, तो टेलीग्राम सेटिंग्स → डिवाइस में अस्थायी सत्र समाप्त करें। सामान्य पूर्णता अनुरोध लॉगआउट करते हैं, और रन यह रिकॉर्ड करता है कि रद्दीकरण की पुष्टि हुई थी या नहीं।
रिपॉजिटरी में प्रकाशित पिन किया गया स्रोत और पुन: प्रयोज्य-वर्कफ़्लो कमिट्स शामिल होने चाहिए। केवल एक स्थानीय शाखा को किसी अन्य GitHub रिपॉजिटरी द्वारा नहीं चलाया जा सकता।
सत्र समय बजट#
संग्रह से पहले समय और आकार की गणना करें संदेशों की गिनती और एक सीमित नमूने से चयनित इतिहास और फ़ाइलों का अनुमान लगाता है। डिस्प्ले में साइन इन करने में पहले से बिताया गया समय, अनुमानित संग्रह समय और पैकेजिंग के लिए एक आरक्षित समय शामिल होता है। फ़ाइलों के लिए, प्रारंभिक अनुमान 1 MiB/s और दो गुना समय मार्जिन का उपयोग करता है; प्रगति उस धारणा को मापी गई दर से बदल देती है। उपयोग केवल संदेश या जब अनुमान शेष समय से अधिक हो, तो कम चैट चुनें।
टेलीग्राम की रिपोर्ट की गई टेकआउट प्रतीक्षा को बजट में जोड़ा जाता है। कलेक्टर अधिग्रहण को तब रोकता है जब शेष समय पैकेजिंग के लिए आवश्यक हो, अधिग्रहीत डेटा को बनाए रखता है और एक आंशिक परिणाम को चिह्नित करता है। इसलिए एक 120-मिनट का सत्र, आर्काइव तैयार करने से पहले समय सीमा का इंतजार करने के बजाय अपनी शेष संग्रह विंडो का उपयोग करता है। यह डिस्प्ले उन चयनित वस्तुओं की पहचान करता है जिनके पूर्ण आकार का नमूना नहीं लिया जा सका।
इस मोड या एक स्थायी कार्यक्षेत्र चुनें#
| कैप्चर मोड | विन्यस्त करने योग्य दायरा | अंतर |
|---|---|---|
| टेलीग्राम टेकआउट, डिफ़ॉल्ट | सभी सुलभ क्लाउड चैट या चयनित चैट, तिथियाँ, खाता श्रेणियाँ, मीडिया नीतियाँ और JSON/HTML दृश्य | Telegram की आधिकारिक एक्सपोर्ट मेकेनिज्म का उपयोग करता है; अनुमोदन या प्रतीक्षा आवश्यक हो सकती है। Takeout उन बाएँ चैनलों/समूहों की सूची तैयार कर सकता है जहाँ Telegram अनुमति देता है और अतिरिक्त व्यक्तिगत डेटा का अनुरोध कर सकता है। |
| नियमित टेलीग्राम एपीआई | नियमित एपीआई के माध्यम से उपलब्ध विधियों के अधीन, वही खाता दायरा और आउटपुट विकल्प। | Takeout को इनिशियलाइज़ नहीं करता; बाएँ चैनलों/सुपरग्रुप्स को सूचीबद्ध नहीं कर सकता या केवल Takeout-केवल व्यक्तिगत डेटा प्राप्त नहीं कर सकता। संपर्क टेलीग्राम उपयोगकर्ताओं को कवर करते हैं, न कि पूरी सहेजी गई फोन संपर्क सूची को। रेट लिमिट्स अभी भी लागू हैं। |
| चैट इवेंट जर्नल | एक चयनित चैट, संलग्नक नीतियाँ और वैकल्पिक अवतार | इस रन के दौरान देखे गए इतिहास और परिवर्तनों को कैप्चर करता है। खाता श्रेणियाँ, दिनांक फ़िल्टर और डेस्कटॉप-संगत दृश्य लागू नहीं होते। |
तीनों मोड में एक ही GitHub प्रमाणीकरण और एन्क्रिप्टेड डिलीवरी होती है। Takeout अधिग्रहण विधि का चयन करता है और इसे कभी भी नियमित API एक्सेस द्वारा चुपचाप प्रतिस्थापित नहीं किया जाता है। TgWitness कैप्चर किए गए रिकॉर्ड से JSON/HTML व्यूज़ बनाता है और एक्सपोर्ट में चयनित अधिग्रहण विधि को संरक्षित रखता है। आधिकारिक Takeout API देखें।
डिफ़ॉल्ट में टेकआउट, संग्रहीत चैट सहित सभी सुलभ चैट प्रकार, सभी दिनांक, खाता प्रोफ़ाइल और संपर्क, संगत JSON और HTML, और फ़ाइल डाउनलोड का उपयोग होता है। प्रारंभिक मीडिया बजट 4 जीआईबी है, जिसमें प्रति-प्रकार फ़ाइल सीमाएँ दिखाई देती हैं; बड़ी फ़ाइलों या समाप्त हो चुके डाउनलोड बजट के लिए जहाँ उपलब्ध हो, सर्वर हैश का उपयोग किया जाता है। एकत्र करने से पहले इन सीमाओं की समीक्षा करें। हैश किसी फ़ाइल का पुनर्निर्माण नहीं कर सकते। वैकल्पिक फ़ोटो, कहानियाँ, सत्र मेटाडेटा और अतिरिक्त व्यक्तिगत डेटा अलग-अलग विकल्प बने रहते हैं।
एक स्थापित टेलीग्राम सत्र में टेकआउट के लिए अनुमोदन की आवश्यकता हो सकती है। टेलीग्राम विलंब निर्धारित करता है; एक नया लॉगिन या रनर इसे बायपास नहीं करता है। अधिकतम कैप्चर विंडो लॉगिन और अनुमोदन सहित 120 मिनट है, इसलिए एक बड़ा खाता या लंबा अनुमोदन इंतजार समाप्त नहीं हो सकता है। एक स्थायी स्थानीय एक्सपोर्ट उसी सत्र को फिर से शुरू कर सकता है, लेकिन यह गिटहब प्रमाणीकरण प्राप्त नहीं करता है।
सेटिंग्स से सहमत हों और सत्यापित करें#
सेटिंग्स और आकार की जाँच करने के बाद, सत्यापन के लिए सेटिंग्स सहेजें का उपयोग करें। सहमत
परिणामी 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 कैप्चर (पूर्वावलोकन) |
| कई चैट को लगातार देखें, खातों का प्रबंधन करें, बढ़ते आर्काइव को खोजें और पढ़ें | स्थानीय या डॉकर वर्कस्पेस |
यह एक नए लॉगिन के साथ एक अलग कैप्चर शुरू करता है। यह आपके मौजूदा स्थानीय जर्नल को अपलोड नहीं करता, वर्तमान में खुले वर्कस्पेस को एक्सपोर्ट नहीं करता, या उसके टेलीग्राम सत्र का पुन: उपयोग नहीं करता है। एक अधूरा क्लाउड कैप्चर उसके रनर के नष्ट हो जाने के बाद फिर से शुरू नहीं किया जा सकता; एक नया वर्कफ़्लो एक नया कैप्चर शुरू करता है।
वर्कस्पेस का एक्सपोर्ट्स → ओपन कैप्चर हेल्पर पैनल के अंदर पूरा विज़ार्ड खोलता है। स्टैंडअलोन पेज भी वही विज़ार्ड, कंट्रोल और थीम का उपयोग करता है। दोनों ही कीज़ और डिक्रिप्शन को आपके ब्राउज़र में ही रखते हैं। गिटहब वर्कफ़्लो स्टार्टअप और अस्थायी टेलीग्राम पैनल अलग-अलग टैब में खुलते हैं; विज़ार्ड आपको बताता है कि कब वापस आना है। वर्कस्पेस को लॉक करने से विज़ार्ड की इन-मेमोरी की साफ़ हो जाती है। आपकी सेव की हुई की फ़ाइल आपके डिवाइस पर ही रहती है।
सार्वजनिक क्या है, और क्या निजी रहना चाहिए?
कलेक्शन एक मानक GitHub-होस्टेड रनर पर चलता है। GitHub, स्वीकृत कलेक्टर और डिपेंडेंसी, हेल्पर पेज, ब्राउज़र और HTTPS टनल इस सेटअप के विश्वसनीय हिस्से हैं। अस्थायी होस्ट टेलीग्राम सत्र और प्लेनटेक्स्ट संदेशों को संसाधित करता है; वितरित किए गए आर्टिफैक्ट प्राप्तकर्ता के लिए एन्क्रिप्ट किए जाते हैं।
फ़ॉर्किंग प्रोजेक्ट कोड की आपकी रिपॉज़िटरी में कॉपी करता है। यह आपके टेलीग्राम खाते को एक्सपोर्ट नहीं करता है। प्राप्तकर्ता वर्कफ़्लो इनपुट एक सार्वजनिक एन्क्रिप्शन कुंजी है। रखें sealed-key.json, टेलीग्राम क्रेडेंशियल, लॉगिन कोड, 2FA पासवर्ड और डिक्रिप्ट किए गए कनेक्शन URL को कमिट्स, वर्कफ़्लो इनपुट और सार्वजनिक लॉग से दूर रखें।
वर्कफ़्लो एक दिन के लिए एन्क्रिप्टेड कनेक्शन/परिणाम आर्टिफैक्ट प्रकाशित करता है। समय पर दोनों डाउनलोड करें; GitHub Actions की उपलब्धता, खाते की सीमाएँ और बिलिंग लागू होती हैं। एक पब्लिक फोर्क असीमित मुफ़्त कंप्यूट की गारंटी नहीं है। कोई भुगतान या GitHub एक्सेस टोकन हेल्पर में नहीं डाला जाता है।
निजी डिक्रिप्शन कुंजी आपके ब्राउज़र/फ़ाइल में रहती है। टेलीग्राम सत्र सामग्री और प्लेनटेक्स्ट अवलोकन अनिवार्य रूप से अस्थायी कलेक्टर के अंदर मौजूद होते हैं। GitHub और HTTPS टनल विश्वसनीय बुनियादी ढांचे बने रहते हैं। अटेस्टेशन आर्काइव डाइजेस्ट और वर्कफ़्लो पहचान को सार्वजनिक कर सकता है; आर्काइव की सामग्री अटेस्टेशन में नहीं रखी जाती है। अटेस्टेशन टाइमस्टैम्प एक संदेश टाइमस्टैम्प नहीं है।
समस्या निवारण
| लक्षण | अगला कदम |
|---|---|
| नो रन वर्कफ़्लो बटन | अपना खुद का फोर्क खोलें, Actions सक्षम करें, और इसे अपस्ट्रीम के साथ सिंक करें main. विफलता को बायपास करने के लिए अनुमोदित अपस्ट्रीम पिनों को संपादित न करें। |
नहीं sealed-connection पुरातात्विक अवशेष |
जाँचें कि क्या जॉब ने अपना स्टार्टअप/अपलोड चरण शुरू किया और पूरा किया है। क्यू, रनर, इमेज डाउनलोड, टनल या रिपॉजिटरी नीति की विफलताएँ स्टार्टअप को रोक सकती हैं। |
| कनेक्शन नहीं खुल पा रहा है | इस रन के लिए सहेजी गई कुंजी लोड करें, डाउनलोड किए गए आर्टिफैक्ट को अनज़िप करें और चुनें connection.tgwsealed. रनर अभी भी सक्रिय होना चाहिए। |
| इतिहास रुका हुआ है | पैनल की स्थिति जांचें और जब तक सत्र सक्रिय है, Resume का उपयोग करें, या पहले से एकत्र किए गए डेटा के साथ समाप्त करें। टेलीग्राम की सीमाएँ और पहुँच से बाहर सामग्री अंतराल छोड़ सकती हैं। |
नहीं sealed-result |
संग्रह शुरू करने से पहले रद्दीकरण या समाप्ति होने पर कोई आर्काइव नहीं बनता; तब रन 'कोई आर्काइव नहीं' सूचना के साथ समाप्त हो जाता है। एक असफल संग्रह, प्रमाणीकरण या पैकेजिंग चरण भी डिलीवरी को रोकता है; असफल चरण निजी डेटा के बिना पर्यवेक्षक के कारण का उल्लेख करता है। क्रेडेंशियल पोस्ट किए बिना इसकी जांच करें। |
| ब्राउज़र एक बड़े आर्काइव को डिक्रिप्ट नहीं कर सकता। | 256 MiB से बड़े पैकेजों के लिए नीचे दी गई स्ट्रीमिंग CLI का उपयोग करें। गलत या खोई हुई निजी कुंजी परिणाम को डिक्रिप्ट नहीं कर सकती। |
| सत्यापन हस्ताक्षरकर्ता को अस्वीकार करता है | एक विश्वसनीय वर्तमान TgWitness इंस्टॉलेशन और सटीक कॉलर का उपयोग करें OWNER/REPOSITORY. आर्काइव के साथ प्रदान की गई प्रतिस्थापन नीति को स्वीकार न करें। |
| टेलीग्राम अभी भी अस्थायी सत्र को सूचीबद्ध करता है। | इसे सेटिंग्स → डिवाइस में समाप्त करें। लॉगआउट विफल हो सकता है और जबरदस्ती समाप्त किया गया वर्कफ़्लो सफ़ाई नहीं चला सकता। |
इस पूर्वावलोकन पर भरोसा करने से पहले, एक छोटी सी बातचीत आज़माएँ जिसे आप नियंत्रित करते हैं: एक संदेश और अटैचमेंट बनाएँ, उन्हें एकत्र करें, परिणाम को डिक्रिप्ट करें, वेरिफ़ायर चलाएँ, कवरेज/मीडिया परिणामों की जाँच करें और टेलीग्राम सत्र रद्दीकरण की पुष्टि करें। स्वचालित जाँचों में एक सिंथेटिक टेलीग्राम क्लाइंट और साथ ही एक अलग वास्तविक गिटहब प्रमाणपत्र परीक्षण का उपयोग होता है; वर्तमान संशोधन पर किसी भी लाइव-खाते के चलने का कोई रिकॉर्ड नहीं है।
स्थानीय डिक्रिप्शन और सत्यापन
स्वतंत्र रूप से विश्वसनीय इंस्टॉलेशन से टूल का उपयोग करें, न कि किसी अज्ञात स्रोत से मिली निष्पादन योग्य फ़ाइलों का:
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
मैनिफेस्ट प्रमाणित विषय है और यह प्रत्येक भाग और संकलित ज़िप को बाँधता है।
उपयोग करें --max-gib किसी बड़े आर्काइव के लिए एक उपयुक्त बिना-संपीडित सत्यापन सीमा निर्धारित करने के लिए; डिफ़ॉल्ट 4 GiB है। अपेक्षित-चयन और पूर्ण-दायरा जाँचें भी बहु-भाग वितरण के साथ काम करती हैं।
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 विश्वसनीय इंस्टॉलेशन से। यह कॉलर रिपॉजिटरी, अपस्ट्रीम साइनर वर्कफ़्लो, स्वीकृत साइनर कमिट, होस्टेड रनर आवश्यकता, पूर्ण ज़िप डाइजेस्ट, आंतरिक जर्नल और अटैचमेंट की अखंडता, ताज़ा अकाउंट-की उत्पत्ति, और अपेक्षित कलेक्टर कमिट की जाँच करता है। यह यह संकेत देने के बजाय कि सभी डेटा सहेजा गया था, इतिहास और मीडिया परिणाम प्रदर्शित करता है।
एक खाली स्वीकृत-रिलीज़ सूची विफल बंद हो जाती है। नीति को अपडेट करना एक स्पष्ट विश्वास निर्णय है; कभी भी किसी आर्काइव की अपनी प्रस्तावित नीति को स्वचालित रूप से स्वीकार न करें।
ऑफ़लाइन उपयोग के लिए, विश्वसनीय रूट पहले से एक विश्वसनीय वातावरण से प्राप्त करें:
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 फ़ाइलें, या हैश स्वीकार नहीं करता है। यह एक सीमित सार्वजनिक प्राप्तकर्ता और सत्र की अवधि स्वीकार करता है। एक्शन्स, पाइथन बेस इमेज, और क्लाउडफ्लेयर्ड को अपरिवर्तनीय डाइजेस्ट द्वारा पिन किया गया है; पाइथन डिपेंडेंसी मौजूदा हैश-लॉक्ड आवश्यकताओं का उपयोग करती हैं। इमेज को कैश के बिना विश्वसनीय स्रोत से बनाया जाता है।
कलेक्टर एक नॉन-रूट उपयोगकर्ता के रूप में, रीड-ओनली इमेज, ड्रॉप्ड लिनक्स कैपेबिलिटीज़, रिसोर्स लिमिट्स, और बिना डॉकर सॉकेट या गिटहब-टोकन एनवायरनमेंट के चलता है। इसके केवल माउंट्स ताज़ा कॉन्फ़िगरेशन, वर्कस्पेस, और आउटपुट डायरेक्टरीज़ हैं। प्रतिबंधित FastAPI एप्लिकेशन लॉगिन, डायलॉग, कॉन्फ़िगर करने योग्य खाता या चैट संग्रह, स्थिति, फिर से शुरू, समाप्त, और रद्दीकरण को एक्सपोज़ करता है। इसमें कोई प्लेनटेक्स्ट डाउनलोड रूट, सामान्य प्रशासन रूट, आयात रूट, या साइनिंग एंडपॉइंट नहीं है।
सुपरवाइज़र अटेस्ट क्रिया से पहले नेटवर्क-सामना करने वाले कंटेनरों को रोकता है
अंतिम निश्चित को पढ़ता है evidence.zip या evidence.parts.json. पैकेजिंग कंटेनर का कोई नेटवर्क नहीं है। अपलोड चरण केवल नाम का है connection.tgwsealed और delivery*.tgwsealed; न तो प्लेनटेक्स्ट सबूत और न ही टेलीग्राम क्रेडेंशियल आर्टिफैक्ट के रूप में अपलोड किए जाते हैं।
क्लीनअप निजी डायरेक्टरी और कंटेनर को हटा देता है, और GitHub जॉब के बाद होस्टेड रनर VM को हटा देता है।
आर्टिफैक्ट प्रतिधारण एक दिन है; समाप्ति से पहले डाउनलोड करें।
एक फोर्क मालिक कॉलर को बदल सकता है या एक अलग साइन की हुई फ़ाइल बना सकता है। सख्त वेरिफ़ायर को परिणामी अलग साइनर वर्कफ़्लो/डाइजेस्ट को अस्वीकार करना चाहिए। यह निर्माण अभी भी अनुमोदित कोड में शोषित किए जा सकने वाले बग्स की अनुपस्थिति और GitHub के रनर और साइनिंग इंफ्रास्ट्रक्चर की अखंडता पर निर्भर करता है।
क्रिप्टोग्राफ़िक हैंडऑफ़#
प्रत्येक प्राप्तकर्ता कुंजी RSA-3072 है (RSA-4096 आयात भी स्वीकार किए जाते हैं), घातांक 65537। प्रत्येक लिफाफे में एक नई यादृच्छिक AES-256 कुंजी और 96-बिट नॉन्स होता है। SHA-256/MGF1-SHA256 के साथ RSA-OAEP, AES कुंजी को लपेटता है। 128-बिट टैग वाला AES-GCM पूरे प्रीफ़िक्स और पेलोड को प्रमाणित करता है। सार्वजनिक प्राप्तकर्ता base64 में DER SPKI है; निजी कुंजी फ़ाइल में base64 में DER PKCS8 है।
एन्वेलप बाइट्स हैं TGWSEAL1\n, एक बिग-एंडियन uint32 JSON-हेडर लंबाई, हेडर, साइफरटेक्स्ट, और एक 16-बाइट GCM टैग। हेडर में ठीक algorithm,
key, और nonce; एल्गोरिदम है RSA-OAEP-256+A256GCM. हेडर के माध्यम से पूरा प्रीफ़िक्स GCM अतिरिक्त प्रमाणीकृत डेटा है। हेडर का आकार 8192 बाइट्स तक सीमित है। CLI 8 GiB तक के पेलोड को स्ट्रीम करता है और अनुरोधित आउटपुट को इंस्टॉल करने से पहले प्रमाणीकरण करता है; यह किसी मौजूदा गंतव्य को ओवरराइट करने से इनकार करता है।
यह मानक क्रिप्टोग्राफिक प्रिमिटिव्स के चारों ओर एक प्रोजेक्ट-विशिष्ट लिफाफा है: SHA-256 के साथ RSA-OAEP और AES-256-GCM, जो OpenSSL और हर प्रमुख क्रिप्टोग्राफी लाइब्रेरी में उपलब्ध है।
मूल प्रमाण बाइट्स को, प्रमाण और प्रमाणीकरण को एन्क्रिप्टेड बाहरी पैकेज में रखने से पहले प्रमाणीकृत किया जाता है। यह आर्काइव के हैश और उसी आर्काइव के अंदर शामिल एक प्रमाण पत्र के बीच चक्रीय निर्भरता से बचाता है। सार्वजनिक रिपॉजिटरी के लिए, प्रमाणीकरण मेटाडेटा (रिपॉजिटरी, वर्कफ़्लो, कमिट, आर्टिफैक्ट का नाम और डाइजेस्ट) सार्वजनिक होता है। सार्वजनिक मेटाडेटा में कभी भी चैट नाम न डालें।
दायरा और प्रमाणीकरण
यह मोड साइन्ड जर्नल और अकाउंट-एक्सपोर्ट इंजन का उपयोग करता है। गुप्त चैट, संग्रह से पहले की हटाई गई हिस्ट्री और खाते के लिए पहुंच से बाहर का डेटा बाहर रखा जाता है। चयनित होने पर निजी क्लाउड चैट पात्र हैं। चैट पिकर 20,000 डायलॉग तक सीमित है; अकाउंट एक्सपोर्ट अपनी खुद की इन्वेंट्री का पता लगाता है। अनुपस्थित डेटा, असफल फ़ाइलें और अधूरे कार्य दर्ज किए जाते हैं। अटैचमेंट सीमाएं और रनर डिस्क/समय सीमाएं अभी भी लागू होती हैं। बड़ी डिलीवरी, एक निश्चित 4 GiB डिलीवरी कटऑफ़ के बजाय एन्क्रिप्टेड हिस्सों का उपयोग करती है। पूर्णता का मतलब है कि चयनित फ़्रोज़न कार्य समाप्त हो गए हैं, न कि हर ऐतिहासिक टेलीग्राम रिकॉर्ड का आर्काइव में मौजूद होना। चैट जर्नल लाइव अपडेट्स को भी देख सकता है; कोई भी मोड एक एटॉमिक स्नैपशॉट नहीं है। जेनरेट किए गए स्क्रीनशॉट और स्क्रीन रिकॉर्डिंग इस मोड का हिस्सा नहीं हैं।
परीक्षणों में सिंथेटिक फ्रेश लॉगिन, स्कोप आइसोलेशन, मीडिया, रद्दीकरण, आंशिक डेडलाइन पूरा होना, असफल लॉगआउट, निषिद्ध एपीआई पथ और फ़ील्ड, प्रीलोडेड वर्कस्पेस अस्वीकृति, गलत-कुंजी और छेड़छाड़ अस्वीकृति, आवश्यक वेरिफ़ायर फ़्लैग, और ब्राउज़र/पाइथन एन्क्रिप्शन अंतर-संचालनीयता शामिल हैं। ब्राउज़र स्वीकृति परीक्षण एक साधारण लेबल वाले मॉक अटेस्टेशन का उपयोग करता है; यह एक वास्तविक सिगस्टोर परीक्षण नहीं है। वास्तविक होस्टेड-रनर, डॉकर, गिटहब प्रमाणीकरण, और लाइव टेलीग्राम स्वीकृति की रिपोर्ट स्थानीय सिंथेटिक जाँचों से अलग से की जानी चाहिए।
GitHub Actions की शर्तें होस्टेड रनर्स के उपयोग को सॉफ़्टवेयर प्रोजेक्ट के जीवनचक्र तक सीमित करती हैं। एक फ़ोर्क इन प्रतिबंधों को नहीं हटाता है; इस पूर्वावलोकन को बिना किसी प्रतिबंध वाली मुफ़्त प्रोडक्शन होस्टिंग के रूप में विपणन नहीं किया जाना चाहिए। Cloudflare Quick Tunnels का उद्देश्य भी परीक्षण और विकास के लिए है। हेल्पर/वर्कफ़्लोज़ इस फ़ीचर का मूल्यांकन करने के लिए उपयुक्त हैं; प्रोडक्शन सेवा के लिए पात्रता एक अलग डिप्लॉयमेंट आवश्यकता बनी हुई है।
रखरखावकर्ता रिलीज़ अनुक्रम#
- कलेक्टर, सुपरवाइजर, कंटेनर की परिभाषा और परीक्षणों को प्रतिबद्ध करें और समीक्षा करें।
- उस कलेक्टर कमिट को में पिन करें
sealed-collector.yml, फिर रिवाइज़ेबल वर्कफ़्लो को कमिट/रिव्यू करें। कभी भी कॉलर SHA से चुपचाप चेकआउट न निकालें। - पुन: प्रयोज्य वर्कफ़्लो कमिट को में पिन करें
sealed-witness.ymlऔर इसके workflow/collector SHA जोड़े कोsealed_policy.jsonएक विश्वसनीय रिलीज़ में। - सभी संदर्भित कमिट्स और हेल्पर को पब्लिश करें, फिर एक स्वतंत्र फोर्क और असली GitHub सर्टिफिकेट का परीक्षण करें। इन पिनों द्वारा संदर्भित कमिट्स को तब तक स्क्वैश न करें, जब तक कि संदर्भ फिर से जेनरेट और पब्लिश न हो जाएं।
कॉलर रिपॉजिटरी और अपस्ट्रीम साइनर के बीच अंतर के लिए पुन: प्रयोज्य वर्कफ़्लो और प्रमाणीकरण देखें।