TgWitness / ডকুমেন্টেশন

কি পরীক্ষা করা হয়েছে →

ডকুমেন্টেশন / 02

Telegram · GitHub Actions ক্যাপচার

অস্থায়ী GitHub রানারে Takeout, সাধারণ API এক্সপোর্ট বা চ্যাট জার্নাল বেছে নিন.

পূর্ণ রেফারেন্স

টিজিউইটনেস / ডকুমেন্টেশন · স্বতন্ত্র ধারণ

স্বতন্ত্র ধারণ

main থেকে পূর্বরূপ উপলব্ধ। একটি ফর্ক পিন করা পুনর্ব্যবহারযোগ্য ওয়ার্কফ্লো চালু করে phishdestroy/TgWitness. ওয়ার্কফ্লো একটি নতুন তৈরি টেলিগ্রাম সেশন ব্যবহার করে একটি অ্যাকাউন্ট, নির্বাচিত চ্যাট বা একটি চ্যাটের ইভেন্ট জার্নাল রপ্তানি করে, প্রমাণ (ZIP বা মাল্টিপার্ট ম্যানিফেস্ট) যাচাই করে, এবং শুধুমাত্র প্রাপক-এনক্রিপ্টেড হ্যান্ডঅফগুলো আপলোড করে। সাধারণ অ্যাডমিন প্যানেল প্রকাশ করা হয় না।

বাছুন client=official_web অফিসিয়াল-ক্লায়েন্ট উইটনেস চালানোর জন্য সুরক্ষিত টেলিগ্রাম ওয়েব নিয়ন্ত্রণ এবং ভিডিও ব্যবহার করা হয়। এর জন্য আপনার নিজস্ব আপস্ট্রিম প্রক্সি প্রয়োজন এবং এটি একটি রেন্ডারকৃত চ্যাট পর্যবেক্ষণ করে। ডিফল্ট client=api নিচে বর্ণিত সম্পূর্ণ-অ্যাকাউন্ট রপ্তানি মোডগুলো ধরে রাখে।

যাচাইকারী আর্কাইভটি তার GitHub প্রত্যয়ন, অনুমোদিত ওয়ার্কফ্লো এবং কালেক্টর কমিট, এবং স্বাক্ষরিত জার্নাল ও সংযুক্তি হ্যাশগুলোর বিরুদ্ধে যাচাই করে। সংগ্রহ প্রক্রিয়ায় পিন করা আপস্ট্রিম কোড এবং নতুন স্টোরেজ ব্যবহার করা হয়। একজন পর্যালোচক সেই কোডটি পরিদর্শন করতে পারে এবং রেকর্ডকৃত রানের বিরুদ্ধে সরবরাহিত আর্কাইভটি যাচাই করতে পারে।

এই পৃষ্ঠায়

ব্যবহারকারী প্রবাহ#

সহকারী পাঁচটি ধাপ ব্যাখ্যা করে এবং আপনাকে নমুনা ডেটায় বার্তা বা সংগ্রাহক প্রতিস্থাপন চেষ্টা করতে দেয়। 'আমার ক্যাপচার শুরু করুন' উইজার্ডটি খুলে।

  1. প্রজেক্টের হোমপেজে, ওয়ার্কস্পেস লগইন স্ক্রিনে, অথবা এক্সপোর্টস → ক্যাপচার হেল্পার খুলুন থেকে GitHub Actions ক্যাপচার (প্রিভিউ) নির্বাচন করুন। আপনি একটি আধুনিক ব্রাউজারে অফিসিয়াল হেল্পার অথবা tgwitness/static/capture.html একটি বিশ্বস্ত চেকআউট থেকেও খুলতে পারেন। হেল্পার কী বা ফাইল প্রক্রিয়াকরণের জন্য কোনো নেটওয়ার্ক অনুরোধ করে না। হেল্পার সাইটের ইন্টারফেস ভাষাগুলো সমর্থন করে; অস্থায়ী সংগ্রহ প্যানেল ইংরেজি ও রাশিয়ান ভাষা সমর্থন করে এবং যখন ব্রাউজারের ভাষা এই ভাষাগুলোর একটি হয়, তখন সেটি সেই ভাষায় খোলে।
  2. একটি কী তৈরি করুন এবং sealed-key.json সংরক্ষণ করুন। এটি একমাত্র ব্যক্তিগত ডিক্রিপশন কী। পৃথক পাবলিক রিসিভার মানটি অনুলিপি করুন। ব্যক্তিগত কী হারালে সংযোগ এবং আর্কাইভ উভয়ের অ্যাক্সেস হারিয়ে যাবে। পরবর্তী ধাপ আনলক করতে নিশ্চিত করুন যে আপনি এটি সংরক্ষণ করেছেন। যদি ইতিমধ্যেই আপনার কাছে একটি ডেলিভারি ফাইল থাকে, সংরক্ষিত কী লোড করুন এবং 'আমার কাছে ইতিমধ্যেই একটি আর্কাইভ আছে' নির্বাচন করুন।
  3. Fork TgWitness করুন, ফর্কে Actions সক্ষম করুন এবং Sealed chat capture চালান। পাবলিক রিসিভার পেস্ট করুন এবং ৩০, ৬০ বা ১২০ মিনিট নির্বাচন করুন। কখনই ফোন নম্বর, লগইন কোড, টেলিগ্রাম পাসওয়ার্ড, প্রাইভেট কী বা সেশন ওয়ার্কফ্লো ইনপুট, কমিট, ইস্যু বা লগে রাখবেন না।
  4. রানের সময়, Artifacts থেকে sealed-connection ডাউনলোড করুন এবং এটি আনজিপ করুন। লোড করুন connection.tgwsealed হেল্পারে সংরক্ষিত প্রাইভেট কী ব্যবহার করুন। ফলস্বরূপ লিঙ্কের URL ফ্রেগমেন্টে একটি র‍্যান্ডম অ্যাক্সেস সিক্রেট থাকবে। এই লিঙ্কটি গোপন রাখুন। প্যানেল ফ্রেগমেন্টটি সরিয়ে সিক্রেটটিকে এই ট্যাবের সেশন স্টোরেজে রাখে; এটি HTTP অ্যাক্সেস লগে রাখা হয় না।
  5. সংযোগ লিঙ্কটি খুলুন। QR কোড অথবা আপনার ফোন নম্বর এবং লগইন কোড ব্যবহার করে সাইন ইন করুন। যদি টেলিগ্রাম দুই-ধাপ যাচাইকরণ পাসওয়ার্ড চায়, তবে তা প্রবেশ করান। স্বাভাবিক ওয়ার্কস্পেসের মতোই ডিফল্টভাবে বিল্ট-ইন API ক্রেডেনশিয়াল পুল ব্যবহার করা হয়। আপনি ঐচ্ছিক কাস্টম ক্রেডেনশিয়াল সেকশনটি প্রসারিত করে উভয়ই প্রবেশ করাতে পারেন। api_id এবং api_hash my.telegram.org/apps থেকে। বিল্ট-ইন পুল ব্যবহার করতে উভয় ক্ষেত্র ফাঁকা রাখুন; আংশিক বা ভুলভাবে ফরম্যাট করা জোড়া প্রত্যাখ্যাত হবে। সেশন ইমপোর্ট অনুমোদিত নয়। এক্সপোর্ট মোড এবং স্কোপ নির্বাচন করুন। সংযোগ লিঙ্কে একটি অ্যাক্সেস সিক্রেট রয়েছে: এটিকে ব্যক্তিগত রাখুন।
  6. টেলিগ্রাম টেকআউট, রেগুলার টেলিগ্রাম API বা চ্যাট ইভেন্ট জার্নাল নির্বাচন করুন। অ্যাকাউন্ট এক্সপোর্টের জন্য, সমস্ত অ্যাক্সেসযোগ্য চ্যাট নির্বাচন করুন অথবা লোড করে এক বা একাধিক চ্যাট নির্বাচন করুন, তারপর তারিখ, চ্যাটের ধরন, অ্যাকাউন্ট বিভাগ এবং সংযুক্তি নিয়ম নির্ধারণ করুন। সেটিংস এবং আকার পরীক্ষা করুন, ঐচ্ছিকভাবে স্বাধীন পর্যালোচকের জন্য সেটিংস JSON সংরক্ষণ করুন, তারপর 'স্টার্ট ক্যাপচার' চাপুন। একবার শুরু হলে সেটিংস স্থায়ী হয়ে যায়। রিজামে শুধুমাত্র তখনই কাজ করে যখন এই রানার চলমান থাকে; আগে শেষ করলে সংগৃহীত ডেটা সংরক্ষিত হয় এবং ফাঁকগুলো রেকর্ড করা হয়। শুরু করার পর সময়সীমা শেষ হলে স্পষ্টভাবে আংশিক আর্কাইভ তৈরি হয়; শুরু করার আগে সময়সীমা শেষ হলে বা বাতিল করলে কোনো আর্কাইভ তৈরি হয় না।
  7. সিল করা ফলাফলটি আসার জন্য অপেক্ষা করুন, ডাউনলোড করে আনজিপ করুন এবং ডিক্রিপ্ট করুন delivery.tgwsealed হেল্পারে। আপনি পান delivery.zip, যা ধারণ করে evidence.zip, attestation.jsonl, এবং নির্দেশনা। ব্রাউজার ডিক্রিপশন 256 MiB পর্যন্ত সীমাবদ্ধ; বড় প্যাকেজগুলি নীচের স্ট্রিমিং লোকাল কমান্ড ব্যবহার করে। বড় ফলাফলে এছাড়াও অন্তর্ভুক্ত থাকে delivery-NNNNNN.tgwsealed অংশ; প্রধান delivery.tgwsealed তারপর এতে রয়েছে evidence.parts.json এবং attestation। প্রতিটি অংশ ডাউনলোড করুন এবং নিচের বর্ণনা অনুযায়ী স্থানীয়ভাবে একত্রিত করুন।
  8. যদি বাতিলকরণ নিশ্চিত না করা হয় বা রানার বন্ধ হয়ে যায়, তাহলে টেলিগ্রাম সেটিংস → ডিভাইসে অস্থায়ী সেশন শেষ করুন। সাধারণ সমাপ্তি অনুরোধ লগআউট করে, এবং রান রেকর্ড করে যে বাতিলকরণ নিশ্চিত হয়েছে কিনা।

রিপোজিটরিতে প্রকাশিত পিন করা উৎস এবং পুনর্ব্যবহারযোগ্য-ওয়ার্কফ্লো কমিট থাকতে হবে। শুধুমাত্র একটি স্থানীয় ব্রাঞ্চ অন্য কোনো GitHub রিপোজিটরি দ্বারা আহ্বান করা যাবে না।

সেশন সময়ের বাজেট#

সংগ্রহের আগে সময় এবং আকার হিসাব করুন বার্তা গণনা এবং একটি সীমাবদ্ধ নমুনা থেকে নির্বাচিত ইতিহাস এবং ফাইলগুলির আনুমানিক সময় নির্ধারণ করে। ডিসপ্লেতে সাইন ইন করতে ইতিমধ্যেই ব্যয় করা সময়, আনুমানিক সংগ্রহের সময় এবং প্যাকেজিংয়ের জন্য একটি রিজার্ভ অন্তর্ভুক্ত রয়েছে। ফাইলগুলির জন্য, প্রাথমিক অনুমান 1 MiB/s এবং দ্বিগুণ সময়ের মার্জিন ব্যবহার করে; অগ্রগতি সেই অনুমানটিকে পরিমাপকৃত হারের সাথে প্রতিস্থাপন করে। ব্যবহার করুন শুধুমাত্র বার্তা অথবা অনুমান বাকি সময়ের চেয়ে বেশি হলে কম চ্যাট নির্বাচন করুন।

টেলিগ্রামের রিপোর্টকৃত টেকআউট অপেক্ষার সময় বাজেটে যোগ করা হয়েছে। সংগ্রাহক সংগ্রহ বন্ধ করে যখন অবশিষ্ট সময় প্যাকেজিংয়ের জন্য প্রয়োজন হয়, সংগৃহীত ডেটা ধরে রাখে এবং আংশিক ফলাফল চিহ্নিত করে। তাই একটি ১২০-মিনিটের সেশন আর্কাইভ প্রস্তুত করার আগে সময়সীমা পর্যন্ত অপেক্ষা না করেই তার অবশিষ্ট সংগ্রহের সময়সীমা ব্যবহার করে। ডিসপ্লে সেই নির্বাচনগুলিকে চিহ্নিত করে যেগুলির পূর্ণ আকার নমুনায় ধরা যায়নি।

এই মোড বা একটি স্থায়ী কর্মক্ষেত্র নির্বাচন করুন#

ক্যাপচার মোড সংরক্ষণযোগ্য পরিসর পার্থক্য
টেলিগ্রাম টেকআউট, ডিফল্ট সমস্ত অ্যাক্সেসযোগ্য ক্লাউড চ্যাট বা নির্বাচিত চ্যাট, তারিখ, অ্যাকাউন্ট বিভাগ, মিডিয়া নীতি এবং JSON/HTML ভিউ টেলিগ্রামের অফিসিয়াল এক্সপোর্ট মেকানিজম ব্যবহার করে; অনুমোদন বা অপেক্ষার প্রয়োজন হতে পারে। Takeout টেলিগ্রাম যেখানে অনুমতি দেয় সেখানে বাম চ্যানেল/গ্রুপ তালিকাভুক্ত করতে পারে এবং অতিরিক্ত ব্যক্তিগত তথ্য অনুরোধ করতে পারে।
সাধারণ টেলিগ্রাম API একই অ্যাকাউন্টের পরিধি এবং আউটপুট বিকল্পসমূহ, যা নিয়মিত API-এর মাধ্যমে উপলব্ধ পদ্ধতিগুলির অধীন। Takeout প্রাথমিকীকরণ করে না; বাম চ্যানেল/সুপারগ্রুপ তালিকাভুক্ত করা বা শুধুমাত্র Takeout-এর ব্যক্তিগত তথ্য আনা সম্ভব নয়। কন্ট্যাক্টস সম্পূর্ণ সংরক্ষিত ফোন যোগাযোগ তালিকা নয়, বরং টেলিগ্রাম ব্যবহারকারীদের অন্তর্ভুক্ত করে। রেট লিমিট এখনও প্রযোজ্য।
চ্যাট ইভেন্ট জার্নাল একটি নির্বাচিত চ্যাট, সংযুক্তি নীতি এবং ঐচ্ছিক অবতার এই রানের সময় পর্যবেক্ষিত ইতিহাস এবং পরিবর্তনগুলি ধারণ করে। অ্যাকাউন্ট বিভাগ, তারিখ ফিল্টার এবং ডেস্কটপ-সামঞ্জস্যপূর্ণ ভিউ প্রযোজ্য নয়।

তিনটি মোডেরই একই GitHub প্রত্যয়ন এবং এনক্রিপ্টেড ডেলিভারি রয়েছে। Takeout অধিগ্রহণ পদ্ধতি নির্বাচন করে এবং এটি কখনই নীরবে সাধারণ API অ্যাক্সেস দ্বারা প্রতিস্থাপিত হয় না। TgWitness ক্যাপচারকৃত রেকর্ড থেকে JSON/HTML ভিউ তৈরি করে এবং এক্সপোর্টে নির্বাচিত অধিগ্রহণ পদ্ধতি সংরক্ষণ করে। অফিসিয়াল Takeout API দেখুন।

ডিফল্ট হিসেবে ব্যবহার হয় টেকআউট, সমস্ত অ্যাক্সেসযোগ্য চ্যাট ধরন (আর্কাইভকৃত চ্যাটসহ), সমস্ত তারিখ, অ্যাকাউন্ট প্রোফাইল এবং যোগাযোগসমূহ, সামঞ্জস্যপূর্ণ JSON এবং HTML, এবং ফাইল ডাউনলোড। প্রাথমিক মিডিয়া বাজেট ৪ জিবি, প্রতি-ধরনের ফাইলের জন্য দৃশ্যমান সীমা সহ; বড় ফাইল বা শেষ হয়ে যাওয়া ডাউনলোড বাজেটের ক্ষেত্রে, যেখানে সম্ভব সার্ভার হ্যাশ ব্যবহার করা হয়। সংগ্রহ করার আগে এই সীমাগুলো পর্যালোচনা করুন। হ্যাশ থেকে ফাইল পুনর্গঠন করা যায় না। ঐচ্ছিক ছবি, গল্প, সেশন মেটাডেটা এবং অতিরিক্ত ব্যক্তিগত তথ্য আলাদা পছন্দ হিসেবে থাকে।

Takeout-এর জন্য একটি প্রতিষ্ঠিত টেলিগ্রাম সেশনে অনুমোদন প্রয়োজন হতে পারে। টেলিগ্রাম বিলম্ব নির্ধারণ করে; নতুন লগইন বা রানার এটিকে এড়িয়ে যায় না। সর্বোচ্চ ক্যাপচার উইন্ডো লগইন এবং অনুমোদন সহ ১২० মিনিট, তাই বড় কোনো অ্যাকাউন্ট বা দীর্ঘ অনুমোদন অপেক্ষা শেষ নাও হতে পারে। একটি স্থায়ী স্থানীয় এক্সপোর্ট একই সেশন পুনরায় শুরু করতে পারে, তবে এটি 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 ক্যাপচার (প্রিভিউ)
বিভিন্ন চ্যাট অবিরত পর্যবেক্ষণ করুন, অ্যাকাউন্ট পরিচালনা করুন, ক্রমবর্ধমান আর্কাইভ অনুসন্ধান ও পড়ুন স্থানীয় বা ডকার ওয়ার্কস্পেস

এটি একটি নতুন লগইন দিয়ে একটি পৃথক ক্যাপচার শুরু করে। এটি আপনার বিদ্যমান স্থানীয় জার্নাল আপলোড করে না, বর্তমানে খোলা ওয়ার্কস্পেস রপ্তানি করে না, বা এর টেলিগ্রাম সেশন পুনর্ব্যবহার করে না। একটি অসম্পূর্ণ ক্লাউড ক্যাপচার এর রানার ধ্বংস হয়ে গেলে পুনরায় চালানো যায় না; একটি নতুন ওয়ার্কফ্লো একটি নতুন ক্যাপচার শুরু করে।

ওয়ার্কস্পেসের এক্সপোর্টস → ওপেন ক্যাপচার হেল্পার প্যানেলের ভিতরে সম্পূর্ণ উইজার্ডটি খুলে। স্ট্যান্ডঅ্যালোন পেজটি একই উইজার্ড, কন্ট্রোল এবং থিম ব্যবহার করে। উভয়ই আপনার ব্রাউজারে কী এবং ডিক্রিপশন রাখে। গিটহাব ওয়ার্কফ্লো স্টার্টআপ এবং অস্থায়ী টেলিগ্রাম প্যানেল আলাদা ট্যাবে খোলে; উইজার্ডটি আপনাকে কখন ফিরে আসতে হবে তা জানিয়ে দেয়। ওয়ার্কস্পেস লক করলে উইজার্ডের ইন-মেমরি কী মুছে যায়। আপনার সংরক্ষিত কী ফাইল আপনার ডিভাইসেই থাকে।

কী জনসাধারণের জন্য উন্মুক্ত, আর কী ব্যক্তিগতই রাখতে হবে?

কালেকশন একটি স্ট্যান্ডার্ড গিটহাব-হোস্টেড রানারে চলে। গিটহাব, অনুমোদিত কালেক্টর এবং ডিপেন্ডেন্সি, হেল্পার পেজ, ব্রাউজার এবং HTTPS টানেল এই সেটআপের বিশ্বাসযোগ্য অংশ। অস্থায়ী হোস্ট টেলিগ্রাম সেশন এবং প্লেনটেক্সট মেসেজ প্রক্রিয়া করে; সরবরাহকৃত আর্টিফ্যাক্টগুলো প্রাপকের জন্য এনক্রিপ্ট করা হয়।

ফর্ক প্রকল্প কোড আপনার রিপোজিটরিতে অনুলিপি করে। এটি আপনার টেলিগ্রাম অ্যাকাউন্ট রপ্তানি করে না। প্রাপকের ওয়ার্কফ্লো ইনপুট একটি পাবলিক এনক্রিপশন কী। রাখুন sealed-key.json, টেলিগ্রামের ক্রেডেনশিয়াল, লগইন কোড, 2FA পাসওয়ার্ড এবং ডিক্রিপ্ট করা সংযোগ URL কমিট, ওয়ার্কফ্লো ইনপুট এবং পাবলিক লগ থেকে দূরে রাখুন।

ওয়ার্কফ্লো এনক্রিপ্ট করা সংযোগ/ফলাফল আর্টিফ্যাক্ট এক দিনের জন্য প্রকাশ করে। সময়মতো উভয়ই ডাউনলোড করুন; GitHub Actions-এর উপলব্ধতা, অ্যাকাউন্ট সীমা এবং বিলিং প্রযোজ্য। একটি পাবলিক ফর্ক সীমাহীন বিনামূল্যে কম্পিউটের প্রতিশ্রুতি নয়। কোনো অর্থপ্রদান বা GitHub অ্যাক্সেস টোকেন হেল্পারে প্রবেশ করানো হয় না।

ব্যক্তিগত ডিক্রিপশন কী আপনার ব্রাউজার/ফাইলে থাকে। টেলিগ্রাম সেশন উপাদান এবং প্লেনটেক্সট পর্যবেক্ষণগুলি অনিবার্যভাবে অস্থায়ী কালেক্টরের ভিতরে থাকে। GitHub এবং HTTPS টানেল বিশ্বস্ত অবকাঠামো হিসেবে থাকে। অ্যাটেস্টেশন আর্কাইভ ডাইজেস্ট এবং ওয়ার্কফ্লো পরিচয়কে সর্বজনীন করতে পারে; আর্কাইভের বিষয়বস্তু অ্যাটেস্টেশনে রাখা হয় না। অ্যাটেস্টেশনের টাইমস্ট্যাম্প কোনো বার্তার টাইমস্ট্যাম্প নয়।

ত্রুটি নির্ণয়#

লক্ষণ পরবর্তী ধাপ
কোনও রান ওয়ার্কফ্লো বোতাম আপনার নিজস্ব ফর্ক খুলুন, অ্যাকশনস সক্ষম করুন এবং এটিকে আপস্ট্রিমের সাথে সিঙ্ক করুন 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

ম্যানিফেস্ট হল প্রত্যয়িত বিষয় এবং এটি প্রতিটি অংশ ও একত্রিত ZIP-কে আবদ্ধ করে। ব্যবহার করুন --max-gib একটি বড় আর্কাইভের জন্য উপযুক্ত সংকুচিত-বিহীন যাচাইকরণ সীমা নির্ধারণ করতে; ডিফল্ট ৪ 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 বিশ্বস্ত ইনস্টলেশন থেকে। এটি কলার রিপোজিটরি, আপস্ট্রিম স্বাক্ষরকারীর ওয়ার্কফ্লো, অনুমোদিত স্বাক্ষরকারীর কমিট, হোস্টেড রানারের প্রয়োজনীয়তা, সম্পূর্ণ 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 ফাইল, বা স্বাক্ষরের জন্য হ্যাশ গ্রহণ করে না। এটি একটি সীমাবদ্ধ পাবলিক প্রাপক এবং সেশন সময়কাল গ্রহণ করে। অ্যাকশনসমূহ, পাইথন বেস ইমেজ এবং cloudflared অপরিবর্তনীয় ডাইজেস্ট দ্বারা পিন করা হয়; পাইথন নির্ভরতা বিদ্যমান হ্যাশ-লকড প্রয়োজনীয়তা ব্যবহার করে। ইমেজটি ক্যাশ ছাড়াই বিশ্বাসযোগ্য উৎস থেকে তৈরি করা হয়।

কলেক্টরটি একটি নন-রুট ব্যবহারকারী হিসেবে চলে, যেখানে ইমেজটি শুধুমাত্র-পঠন (read-only) মোডে থাকে, লিনাক্স ক্যাপাবিলিটিস (Linux capabilities) ড্রপ করা থাকে, রিসোর্স লিমিট (resource limits) সেট করা থাকে, এবং কোনো ডকার সকেট (Docker socket) বা গিটহাব-টোকেন (GitHub-token) পরিবেশ থাকে না। এর একমাত্র মাউন্ট করা ডিরেক্টরিগুলো হলো ফ্রেশ কনফিগারেশন (fresh configuration), ওয়ার্কস্পেস (workspace), এবং আউটপুট (output) ডিরেক্টরি। সীমাবদ্ধ FastAPI অ্যাপ্লিকেশনটি লগইন, ডায়ালগ, কনফিগারযোগ্য অ্যাকাউন্ট বা চ্যাট সংগ্রহ, স্ট্যাটাস, রিজিউম, ফিনিশ এবং বাতিলের সুবিধা প্রদান করে। এতে কোনো প্লেনটেক্সট ডাউনলোড রুট, সাধারণ প্রশাসন রুট, ইমপোর্ট রুট বা সই করার এন্ডপয়েন্ট নেই।

সুপারভাইজার attest ক্রিয়া চালানোর আগে নেটওয়ার্ক-মুখী কন্টেইনারগুলো বন্ধ করে চূড়ান্ত স্থির অংশটি পড়ে evidence.zip অথবা evidence.parts.json. প্যাকেজিং কন্টেইনারের কোনো নেটওয়ার্ক নেই। আপলোডের ধাপগুলির নাম শুধুমাত্র connection.tgwsealed এবং delivery*.tgwsealed; কোনও প্লেনটেক্সট প্রমাণ বা টেলিগ্রাম ক্রেডেনশিয়াল আর্টিফ্যাক্ট হিসেবে আপলোড করা হয় না। ক্লিনআপ ব্যক্তিগত ডিরেক্টরি এবং কন্টেইনারগুলি সরিয়ে ফেলে, এবং GitHub কাজ শেষ হওয়ার পর হোস্টেড রানার VM বাতিল করে দেয়। আর্টিফ্যাক্ট সংরক্ষণ এক দিন; মেয়াদ শেষ হওয়ার আগে ডাউনলোড করুন।

একজন ফর্ক মালিক কলকারীকে প্রতিস্থাপন করতে পারে বা একটি ভিন্ন স্বাক্ষরিত ফাইল তৈরি করতে পারে। কঠোর যাচাইকারীকে ফলস্বরূপ ভিন্ন স্বাক্ষরকারী ওয়ার্কফ্লো/ডাইজেস্ট প্রত্যাখ্যান করতে হবে। এই নির্মাণ এখনও অনুমোদিত কোডে শোষণযোগ্য বাগের অনুপস্থিতি এবং GitHub-এর রানার ও স্বাক্ষর অবকাঠামোর অখণ্ডতার উপর নির্ভর করে।

ক্রিপ্টোগ্রাফিক হস্তান্তর#

প্রতিটি প্রাপকের কী হল RSA-3072 (RSA-4096 আমদানিও গ্রহণযোগ্য), সূচক 65537। প্রতিটি এনভেলপে একটি নতুন এলোমেলো AES-256 কী এবং 96-বিট ননস থাকে। RSA-OAEP SHA-256/MGF1-SHA256 দিয়ে AES কী-কে মোড়ায়। AES-GCM একটি 128-বিট ট্যাগ ব্যবহার করে সম্পূর্ণ প্রিফিক্স এবং পেলোডকে প্রমাণীকরণ করে। পাবলিক রিসিভার base64-এ DER SPKI; প্রাইভেট কী ফাইলে base64-এ DER PKCS8 রয়েছে।

এনভেলপ বাইটগুলো হল TGWSEAL1\n, একটি বিগ-এন্ডিয়ান uint32 JSON-হেডার দৈর্ঘ্য, হেডার, সাইফারটেক্সট, এবং একটি ১৬-বাইট GCM ট্যাগ। হেডারটিতে ঠিক algorithm, key, এবং nonce; অ্যালগরিদম হল RSA-OAEP-256+A256GCM. হেডার জুড়ে সম্পূর্ণ প্রিফিক্স GCM অতিরিক্ত প্রমাণীকৃত ডেটা। হেডারের আকার 8192 বাইট পর্যন্ত সীমাবদ্ধ। CLI 8 GiB পর্যন্ত পেইলোড প্রবাহিত করে এবং অনুরোধকৃত আউটপুট ইনস্টল করার আগে প্রমাণীকরণ করে; এটি বিদ্যমান গন্তব্যকে ওভাররাইট করতে অস্বীকার করে। এটি স্ট্যান্ডার্ড ক্রিপ্টোগ্রাফিক প্রিমিটিভের চারপাশে একটি প্রকল্প-নির্দিষ্ট এনভেলপ: SHA-256 সহ RSA-OAEP এবং AES-256-GCM, যা OpenSSL এবং প্রতিটি প্রধান ক্রিপ্টোগ্রাফি লাইব্রেরিতে উপলব্ধ।

প্রমাণের বাইটগুলো এনক্রিপ্টকৃত বাইরের প্যাকেজে প্রমাণ ও প্রত্যয়ন স্থাপনের আগে যাচাই করা হয়। এটি একই আর্কাইভের হ্যাশ এবং সেই আর্কাইভের ভিতরে থাকা একটি সার্টিফিকেটের মধ্যে চক্রীয় নির্ভরতা এড়ায়। পাবলিক রিপোজিটরির জন্য প্রত্যয়ন মেটাডেটা (রিপোজিটরি, ওয়ার্কফ্লো, কমিট, আর্টিফ্যাক্টের নাম ও ডাইজেস্ট) সর্বজনীন। পাবলিক মেটাডেটায় কখনই চ্যাটের নাম রাখবেন না।

পরিসর এবং যাচাইকরণ

এই মোড স্বাক্ষরিত জার্নাল এবং অ্যাকাউন্ট-এক্সপোর্ট ইঞ্জিন ব্যবহার করে। গোপন চ্যাট, সংগ্রহের আগে মুছে ফেলা ইতিহাস এবং অ্যাকাউন্টের জন্য অ্যাক্সেসযোগ্য নয় এমন ডেটা বাদ দেওয়া হয়। নির্বাচিত হলে প্রাইভেট ক্লাউড চ্যাট যোগ্য। চ্যাট পিকার ২০,০০০ ডায়ালগে সীমাবদ্ধ; অ্যাকাউন্ট এক্সপোর্ট নিজস্ব ইনভেন্টরি আবিষ্কার করে। অনুপস্থিত ডেটা, ব্যর্থ ফাইল এবং অসম্পূর্ণ কাজগুলি রেকর্ড করা হয়। সংযুক্তি সীমা এবং রানার ডিস্ক/সময় সীমা এখনও প্রযোজ্য। বৃহৎ ডেলিভারি স্থায়ী 4 GiB ডেলিভারি কাটঅফের পরিবর্তে এনক্রিপ্ট করা অংশ ব্যবহার করে। সম্পূর্ণতা মানে হিমায়িত নির্বাচিত কাজগুলো শেষ হয়েছে, এর মানে নয় যে প্রতিটি ঐতিহাসিক টেলিগ্রাম রেকর্ড আর্কাইভে বিদ্যমান। চ্যাট জার্নাল লাইভ আপডেটও পর্যবেক্ষণ করতে পারে; কোনো মোডই পারমাণবিক স্ন্যাপশট নয়। উত্পন্ন স্ক্রিনশট এবং স্ক্রিন রেকর্ডিং এই মোডের অংশ নয়।

পরীক্ষার মধ্যে রয়েছে সিনথেটিক নতুন লগইন, স্কোপ আইসোলেশন, মিডিয়া, বাতিলকরণ, আংশিক ডেডলাইন সম্পন্নকরণ, ব্যর্থ লগআউট, নিষিদ্ধ API পথ ও ফিল্ড, প্রি-লোড করা ওয়ার্কস্পেস প্রত্যাখ্যান, ভুল-কী ও ট্যাম্পার প্রত্যাখ্যান, প্রয়োজনীয় ভেরিফায়ার ফ্ল্যাগ, এবং ব্রাউজার/পাইথন এনক্রিপশন আন্তঃকার্যক্ষমতা। ব্রাউজার গ্রহণ পরীক্ষা একটি স্পষ্টভাবে লেবেলযুক্ত মক অ্যাটেস্টেশন ব্যবহার করে; এটি কোনো প্রকৃত Sigstore পরীক্ষা নয়। বাস্তব হোস্টেড-রানার, ডকার, গিটহাব অ্যাটেস্টেশন, এবং লাইভ টেলিগ্রাম গ্রহণযোগ্যতা পরীক্ষাগুলিকে স্থানীয় সিন্থেটিক চেক থেকে আলাদাভাবে রিপোর্ট করতে হবে।

GitHub Actions-এর শর্তাবলী হোস্ট করা রানার ব্যবহারকে সফটওয়্যার প্রকল্পের জীবনচক্রের মধ্যে সীমাবদ্ধ করে। একটি ফর্ক এই সীমাবদ্ধতাগুলো দূর করে না; এই প্রিভিউটিকে অবাধ, বিনামূল্যের প্রোডাকশন হোস্টিং হিসেবে বিপণন করা যাবে না। Cloudflare Quick Tunnels-ও পরীক্ষা ও উন্নয়নের জন্যই তৈরি। হেল্পার/ওয়ার্কফ্লোগুলো এই ফিচারটি মূল্যায়নের জন্য উপযুক্ত; প্রোডাকশন সার্ভিসে যোগ্যতা অর্জনের জন্য এটি একটি পৃথক ডিপ্লয়মেন্ট শর্ত।

রক্ষণাবেক্ষণকারী রিলিজ ক্রম#

  1. সংগ্রাহক, তত্ত্বাবধায়ক এবং ধারক সংজ্ঞা ও পরীক্ষাগুলি কমিট করুন এবং পর্যালোচনা করুন।
  2. সেই কালেক্টর কমিটটিকে পিন করুন sealed-collector.yml, তারপর commit/review করুন পুনর্ব্যবহারযোগ্য ওয়ার্কফ্লো। কখনোই নীরবে কলারের SHA থেকে চেকআউট ডেরাইভ করবেন না।
  3. পুনঃব্যবহারযোগ্য ওয়ার্কফ্লো কমিটটিকে পিন করুন sealed-witness.yml এবং এর workflow/collector SHA যুগল যোগ করুন sealed_policy.json একটি বিশ্বস্ত রিলিজে যোগ করুন।
  4. সব রেফারেন্সকৃত কমিট এবং হেল্পার প্রকাশ করুন, তারপর একটি স্বাধীন ফর্ক এবং প্রকৃত GitHub সার্টিফিকেট পরীক্ষা করুন। এই পিনগুলো দ্বারা রেফারেন্সকৃত কমিটগুলো সাস্কোয়াশ করবেন না, যতক্ষণ না রেফারেন্সগুলো পুনর্নির্মাণ ও পুনরায় প্রকাশিত হয়।

কলকারী রিপোজিটরি এবং আপস্ট্রিম স্বাক্ষরকারীর মধ্যে পার্থক্য জানতে পুনর্ব্যবহারযোগ্য ওয়ার্কফ্লো এবং প্রত্যয়নগুলি দেখুন।