TgWitness / เอกสาร

สิ่งที่ได้รับการทดสอบแล้ว →

เอกสาร / 02

Telegram · การบันทึกด้วย GitHub Actions

เลือก Takeout การส่งออกผ่าน API ปกติ หรือบันทึกแชตบนตัวรัน GitHub ชั่วคราว.

อ้างอิงเต็ม

TgWitness / เอกสารประกอบ · การจับภาพแบบอิสระ

การจับภาพแบบอิสระ

สามารถดูตัวอย่างได้จาก main การ fork จะเปิด workflow ที่ถูกตรึงไว้และสามารถใช้ซ้ำได้จาก phishdestroy/TgWitness. Workflow ดังกล่าวจะส่งออกบัญชี, การสนทนาที่เลือกไว้ หรือ บันทึกเหตุการณ์ของการสนทนาหนึ่งครั้ง โดยใช้เซสชัน Telegram ที่สร้างขึ้นใหม่, รับรองความถูกต้องของ ไฟล์ ZIP หรือ manifest แบบ multipart, และอัปโหลดเฉพาะ ข้อมูลที่เข้ารหัสโดยผู้รับเท่านั้น แผงควบคุมการบริหารจัดการปกติจะไม่ถูกเปิดเผย

เลือก client=official_web เพื่อดำเนินการ พยานจากฝ่ายลูกค้าอย่างเป็นทางการ พร้อมด้วยระบบควบคุม Telegram Web และวิดีโอที่ได้รับการป้องกัน ต้องใช้พร็อกซีต้นทางของคุณเอง และติดตามการสนทนาที่แสดงผลหนึ่งครั้ง ค่าเริ่มต้น client=api ยังคงรักษาโหมดการส่งออกข้อมูลบัญชีแบบเต็มตามที่อธิบายไว้ด้านล่าง

ผู้ตรวจสอบจะตรวจสอบไฟล์เก็บถาวรโดยเปรียบเทียบกับเอกสารรับรองจาก GitHub, ขั้นตอนการทำงานที่ได้รับการอนุมัติ และการส่งโค้ดของผู้รวบรวม รวมถึงค่าแฮชของบันทึกและไฟล์แนบที่ลงนามแล้ว กระบวนการรวบรวมใช้โค้ดจากต้นทางที่ถูกตรึงไว้และพื้นที่จัดเก็บข้อมูลใหม่ ผู้ตรวจสอบ สามารถตรวจสอบโค้ดดังกล่าวและยืนยันความถูกต้องของไฟล์เก็บถาวรที่ส่งมาโดยเปรียบเทียบกับข้อมูลการรันที่บันทึกไว้

บนหน้านี้

กระบวนการใช้งาน#

ผู้ช่วยจะอธิบายขั้นตอนทั้งห้าและให้คุณลองใช้การแทนที่ข้อความหรือตัวเก็บข้อมูล บนข้อมูลตัวอย่าง การคลิก เริ่มการจับข้อมูล จะเปิดตัวช่วยสร้าง

  1. เลือก GitHub Actions capture (preview) บนหน้าหลักของโครงการ, หน้าจอเข้าสู่ระบบพื้นที่ทำงาน หรือ Exports → Open capture helper คุณยังสามารถ เปิด helper อย่างเป็นทางการ หรือ tgwitness/static/capture.html จาก checkout ที่เชื่อถือได้ในเบราว์เซอร์รุ่นใหม่ เครื่องมือนี้ไม่ส่งคำขอเครือข่ายสำหรับการประมวลผลคีย์หรือ ไฟล์ เครื่องมือนี้รองรับภาษาของอินเทอร์เฟซเว็บไซต์; แผงเก็บรวบรวมชั่วคราวรองรับภาษาอังกฤษและภาษารัสเซีย และจะเปิดใน ภาษาของเบราว์เซอร์เมื่อภาษาดังกล่าวเป็นหนึ่งในภาษาที่รองรับ
  2. สร้างกุญแจและบันทึก sealed-key.json. นี่คือกุญแจถอดรหัสส่วนตัว เพียงตัวเดียวเท่านั้น คัดลอกกุญแจสาธารณะที่แยกไว้ ผู้รับ ค่า. การสูญเสีย กุญแจส่วนตัวจะทำให้ไม่สามารถเข้าถึงทั้งการเชื่อมต่อและไฟล์เก็บถาวรได้ ยืนยันว่าคุณได้บันทึกกุญแจแล้วเพื่อปลดล็อกขั้นตอนต่อไป หากคุณมี ไฟล์ส่งมอบอยู่แล้ว ให้โหลดกุญแจที่บันทึกไว้และเลือก ผมมีไฟล์เก็บไว้แล้ว.
  3. สร้าง fork ของ TgWitness, เปิดใช้งาน Actions ใน fork นั้น และรัน Sealed chat capture วางที่อยู่ผู้รับสาธารณะและเลือกระยะเวลา 30, 60 หรือ 120 นาที อย่าใส่ หมายเลขโทรศัพท์, รหัสเข้าสู่ระบบ, รหัสผ่าน Telegram, กุญแจส่วนตัว หรือเซสชัน ลงในข้อมูลนำเข้าของ workflow, commit, issue หรือ log
  4. ระหว่างการรัน โปรดดาวน์โหลด sealed-connection จาก Artifacts และแตกไฟล์ออก โหลด connection.tgwsealed ใน helper โดยใช้กุญแจส่วนตัวที่เก็บไว้ ลิงก์ที่สร้างขึ้นจะมีรหัสลับการเข้าถึงแบบสุ่มอยู่ในส่วน URL fragment เก็บลิงก์นี้ไว้เป็นความลับ แผงควบคุมจะลบส่วน fragment ออกและเก็บรหัสลับ ไว้ในพื้นที่เก็บข้อมูลเซสชันของแท็บนี้; รหัสลับนี้จะไม่ถูกบันทึกไว้ในบันทึกการเข้าถึง HTTP
  5. เปิดลิงก์การเชื่อมต่อ ลงชื่อเข้าใช้ด้วยรหัส QR หรือด้วยหมายเลขโทรศัพท์และ รหัสลงชื่อเข้าใช้ ป้อนรหัสยืนยันสองขั้นตอนหาก Telegram ขอให้ป้อน รหัส ข้อมูลรับรอง API ที่ติดตั้งไว้จะถูกใช้เป็นค่าเริ่มต้น เช่นเดียวกับพื้นที่ทำงานปกติ คุณสามารถ ขยายส่วนข้อมูลรับรองที่กำหนดเอง (ไม่บังคับ) และป้อนทั้ง api_id และ api_hash จาก my.telegram.org/apps. ทิ้ง ทั้งสองช่องว่างไว้เพื่อใช้กลุ่มข้อมูลรับรองในตัว; คู่ข้อมูลรับรองที่ไม่ครบถ้วนหรือผิดรูปแบบจะถูกปฏิเสธ ไม่ได้รับอนุญาตให้นำเข้าเซสชัน เลือกโหมดการส่งออกและขอบเขต ลิงก์การเชื่อมต่อ มีรหัสลับการเข้าถึง: รักษาความลับของรหัสนี้
  6. เลือก Telegram Takeout, API Telegram แบบปกติ หรือ บันทึกกิจกรรมแชท. เพื่อส่งออกข้อมูลบัญชี ให้เลือกทุกการสนทนาที่เข้าถึงได้ หรือโหลดและเลือกหนึ่งหรือหลาย การสนทนา จากนั้นกำหนดวันที่ ประเภทการสนทนา หมวดหมู่บัญชี และกฎการแนบไฟล์ ตรวจสอบการตั้งค่าและขนาด และสามารถบันทึกไฟล์ JSON ของการตั้งค่าไว้เพื่อ ให้ผู้ตรวจสอบอิสระตรวจสอบได้ จากนั้นกด เริ่มบันทึก. การตั้งค่าจะถูกกำหนดไว้อย่างถาวรหลังจากเริ่มทำงาน ฟังก์ชัน "Resume" จะทำงานได้เฉพาะเมื่อตัวรันเนอร์นี้ยังอยู่; การหยุดทำงานก่อนกำหนดจะเก็บรักษา ข้อมูลที่เก็บรวบรวมได้และบันทึกช่องว่างไว้ การหมดอายุของกำหนดเวลาหลังจากเริ่มทำงานจะสร้าง ไฟล์เก็บถาวรแบบไม่สมบูรณ์อย่างชัดเจน; การหมดอายุก่อนเริ่มทำงานหรือการยกเลิกจะไม่สร้างไฟล์เก็บถาวรใดๆ
  7. รอจนกว่าไฟล์ sealed-result จะถูกส่งมา ดาวน์โหลดและแตกไฟล์ จากนั้นถอดรหัส delivery.tgwsealed ใน helper คุณจะได้รับ delivery.zip, ซึ่งประกอบด้วย evidence.zip, attestation.jsonl, และคำแนะนำ การถอดรหัสผ่านเบราว์เซอร์ จำกัดอยู่ที่ 256 MiB; แพ็กเกจที่ใหญ่กว่าให้ใช้คำสั่ง streaming local ด้านล่าง ผลลัพธ์ขนาดใหญ่ยังรวมถึง delivery-NNNNNN.tgwsealed ส่วนย่อย; ส่วนหลัก delivery.tgwsealed จะประกอบด้วย, ซึ่งประกอบด้วย, และคำแนะนำ การถอดรหัสผ่านเบราว์เซอร์ ถูกจำกัดไว้ที่ 256 MiB evidence.parts.json และใบรับรอง ดาวน์โหลดทุกส่วนและประกอบในเครื่องท้องถิ่นตามคำอธิบายด้านล่าง
  8. ปิดเซสชันชั่วคราวใน Telegram ที่ส่วนตั้งค่า → อุปกรณ์ หากการยกเลิกสิทธิ์ ยังไม่ได้รับการยืนยัน หรือโปรแกรมรันเนอร์ถูกปิดลง การเสร็จสิ้นตามปกติจะขอให้ออกจากระบบ และ บันทึกการรันจะบันทึกว่าการยกเลิกสิทธิ์ได้รับการยืนยันหรือไม่

รีโพสิตอรีดังกล่าวต้องประกอบด้วยแหล่งที่มาที่ได้รับการเผยแพร่และถูกตรึงไว้ รวมถึงการ commit ของ workflow ที่สามารถใช้ซ้ำได้ สาขาท้องถิ่นเพียงอย่างเดียวไม่สามารถถูกเรียกใช้โดยรีโพสิตอรี GitHub อื่นได้

งบประมาณเวลาเซสชัน#

ก่อนการเก็บข้อมูล ให้คำนวณการประมาณเวลาและขนาดของประวัติและไฟล์ที่เลือก จากจำนวนข้อความและตัวอย่างที่มีขอบเขต การแสดงผลจะรวมถึงเวลาที่ใช้ไปแล้วในการลงชื่อเข้าใช้ เวลาการเก็บข้อมูลที่ประมาณการ และเวลาสำรองสำหรับการจัดแพ็กเกจ สำหรับไฟล์ การประมาณการเบื้องต้น ใช้อัตรา 1 MiB/s และเวลาสำรองสองเท่า; เมื่อการดำเนินการดำเนินไป การประมาณการดังกล่าวจะถูกแทนที่ด้วย อัตราที่วัดได้จริง ให้ใช้เฉพาะข้อความ หรือเลือกจำนวนแชทที่น้อยลง เมื่อการประมาณการเกินเวลาที่เหลืออยู่

เวลารอ Takeout ของ Telegram ที่รายงานมาจะถูกเพิ่มเข้าไปในงบประมาณ ผู้รวบรวมข้อมูลจะหยุดการรวบรวม เมื่อเวลาที่เหลือเพียงพอสำหรับการจัดแพ็กเกจ เก็บข้อมูลที่รวบรวมได้ไว้ และทำเครื่องหมายว่าเป็น ผลลัพธ์บางส่วน ดังนั้น เซสชัน 120 นาทีจะใช้ช่วงเวลาการรวบรวมที่เหลืออยู่ แทนที่จะ รอจนถึงกำหนดเวลาสิ้นสุดก่อนที่จะเตรียมไฟล์เก็บถาวร การแสดงผลจะระบุรายการ ที่ขนาดเต็มไม่สามารถถูกสุ่มตัวอย่างได้

เลือกโหมดนี้หรือพื้นที่ทำงานแบบถาวร#

โหมดถ่ายภาพ ขอบเขตที่สามารถปรับแต่งได้ ความแตกต่าง
Telegram Takeout, ตัวเลือกเริ่มต้น ทุกการสนทนาบนคลาวด์ที่เข้าถึงได้ หรือการสนทนาที่เลือกไว้ วันที่ หมวดหมู่บัญชี นโยบายสื่อ และมุมมอง JSON/HTML ใช้กลไกการส่งออกอย่างเป็นทางการของ Telegram; อาจต้องได้รับการอนุมัติหรือรอการดำเนินการ Takeout สามารถระบุช่อง/กลุ่มที่ยังเหลืออยู่ ซึ่ง Telegram อนุญาต และขอข้อมูลส่วนตัวเพิ่มเติม
API Telegram แบบปกติ ขอบเขตบัญชีและตัวเลือกผลลัพธ์ยังคงเหมือนเดิม โดยขึ้นอยู่กับวิธีการที่มีให้ใช้งานผ่าน API ปกติ ไม่ทำการเริ่มต้น Takeout; ไม่สามารถระบุช่องซ้าย/กลุ่มหลัก หรือดึงข้อมูลส่วนตัวที่มีเฉพาะใน Takeout ได้ รายชื่อผู้ติดต่อครอบคลุมผู้ใช้ Telegram เท่านั้น ไม่ใช่รายชื่อผู้ติดต่อในโทรศัพท์ที่บันทึกไว้ทั้งหมด ข้อจำกัดด้านอัตราการใช้งานยังคงมีผลบังคับใช้
บันทึกกิจกรรมแชท การเลือกแชทหนึ่งรายการ นโยบายไฟล์แนบ และรูปโปรไฟล์ (ตามความประสงค์) บันทึกประวัติและเปลี่ยนแปลงที่สังเกตได้ระหว่างการรันครั้งนี้ โดยไม่รวมถึงหมวดหมู่บัญชี ตัวกรองวันที่ และมุมมองที่รองรับบนเดสก์ท็อป

ทั้งสามโหมดมีใบรับรอง GitHub และระบบส่งข้อมูลที่เข้ารหัสเหมือนกัน Takeout เลือกวิธีการเก็บข้อมูล และจะไม่ถูกแทนที่โดยอัตโนมัติด้วยการเข้าถึง API ปกติ TgWitness สร้างมุมมอง JSON/HTML จากข้อมูลที่บันทึกไว้ และรักษา วิธีการเก็บข้อมูลที่เลือกไว้ในการส่งออก ดู API Takeout อย่างเป็นทางการ

ค่าเริ่มต้นจะใช้ Takeout ซึ่งรวมถึงทุกประเภทการสนทนาที่สามารถเข้าถึงได้ เช่น การสนทนาที่ถูกเก็บถาวร ทุก วันที่ โปรไฟล์บัญชี และรายชื่อผู้ติดต่อ JSON และ HTML ที่เข้ากันได้ รวมถึงการดาวน์โหลดไฟล์ งบประมาณสื่อเริ่มต้นคือ 4 GiB พร้อมด้วยขีดจำกัดไฟล์ที่แสดงตามประเภท; สำหรับไฟล์ที่มีขนาดใหญ่กว่า หรืองบประมาณการดาวน์โหลดที่หมดลง จะใช้ค่าแฮชจากเซิร์ฟเวอร์หากมีอยู่ โปรดตรวจสอบ ขีดจำกัดเหล่านี้ก่อนการเก็บข้อมูล ค่าแฮชไม่สามารถสร้างไฟล์ขึ้นมาใหม่ได้ ส่วนรูปภาพที่เลือกได้ สตอรี เมตาดาต้าของเซสชัน และข้อมูลส่วนตัวเพิ่มเติม ยังคงเป็นตัวเลือกที่แยกต่างหาก

การนำข้อมูลออกอาจต้องได้รับการอนุมัติในเซสชัน 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 capture (เวอร์ชันทดลอง)
ติดตามการสนทนาหลายห้องอย่างต่อเนื่อง จัดการบัญชี ค้นหาและอ่านคลังข้อมูลที่เพิ่มขึ้นเรื่อยๆ พื้นที่ทำงานแบบท้องถิ่นหรือ Docker

การนี้จะเริ่มการบันทึกข้อมูลใหม่ด้วยบัญชีผู้ใช้ใหม่ โดยไม่ส่ง บันทึกท้องถิ่นที่มีอยู่ของคุณ ไม่ส่งออกพื้นที่ทำงานที่เปิดอยู่ และไม่ใช้เซสชัน Telegram เดิม การบันทึกข้อมูลบนคลาวด์ที่ยังไม่เสร็จสิ้นจะไม่สามารถดำเนินการต่อได้หลังจากที่ตัวรันเนอร์ถูกทำลาย; กระบวนการทำงานใหม่ จะเริ่มการบันทึกข้อมูลใหม่

เมื่อคลิกที่ Exports → Open capture helper ในพื้นที่ทำงาน จะเปิดวิซาร์ดแบบเต็มรูปแบบ ภายในแผงควบคุม หน้าเว็บแบบสแตนด์อโลนใช้วิซาร์ด องค์ประกอบควบคุม และธีมเดียวกัน ทั้งสองแบบเก็บกุญแจและข้อมูลการถอดรหัสไว้ในเบราว์เซอร์ของคุณ การเริ่มต้น workflow ของ GitHub และ แผงควบคุม Telegram ชั่วคราวจะเปิดในแท็บแยกกัน; วิซาร์ดจะแจ้งให้คุณทราบเมื่อถึงเวลา ที่จะกลับไปยังพื้นที่ทำงาน การล็อกพื้นที่ทำงานจะลบกุญแจในหน่วยความจำของวิซาร์ด ไฟล์กุญแจ ที่คุณบันทึกไว้จะยังคงอยู่บนอุปกรณ์ของคุณ

อะไรคือเรื่องสาธารณะ และอะไรต้องเป็นเรื่องส่วนตัว#

ระบบการรวบรวมทำงานบนตัวรันเนอร์มาตรฐานที่โฮสต์โดย GitHub GitHub ซึ่งเป็นผู้รวบรวมที่ได้รับการอนุมัติ รวมถึงส่วนประกอบที่จำเป็น หน้าช่วยใช้งาน เบราว์เซอร์ และอุโมงค์ HTTPS ล้วนเป็นส่วนที่เชื่อถือได้ ในระบบนี้ เซิร์ฟเวอร์ชั่วคราวจะประมวลผลเซสชัน Telegram และ ข้อความแบบข้อความธรรมดา ส่วนผลลัพธ์ที่ส่งไปจะถูกเข้ารหัสสำหรับผู้รับ

การคัดลอกโค้ดโครงการไปยังรีโพสิตอรีของคุณ มันจะ ไม่ ส่งออก บัญชี Telegram ของคุณ ข้อมูลป้อนเข้าในขั้นตอนการทำงานของผู้รับคือกุญแจการเข้ารหัสสาธารณะ เก็บไว้ sealed-key.json, ข้อมูลการเข้าสู่ระบบ Telegram, รหัสเข้าสู่ระบบ, รหัสผ่าน 2FA และ URL การเชื่อมต่อที่ถอดรหัสแล้ว จาก commit, ข้อมูลป้อนเข้าของ workflow และบันทึกสาธารณะ

กระบวนการทำงานนี้จะเผยแพร่ไฟล์เชื่อมต่อ/ผลลัพธ์ที่เข้ารหัสไว้เป็นระยะเวลาหนึ่งวัน โปรดดาวน์โหลดทั้งสองไฟล์ให้ทันเวลา; ข้อกำหนดเกี่ยวกับความพร้อมใช้งานของ GitHub Actions, ข้อจำกัดของบัญชี และระบบการเรียกเก็บเงิน มีผลบังคับใช้ การสร้าง fork สาธารณะไม่รับประกันว่าจะได้รับทรัพยากรการประมวลผลฟรีอย่างไม่จำกัด ไม่มีการชำระเงินหรือ โทเค็นการเข้าถึง GitHub ที่ถูกป้อนเข้าสู่ตัวช่วย

กุญแจถอดรหัสส่วนตัวจะเก็บไว้ในเบราว์เซอร์/ไฟล์ของคุณ ข้อมูลเซสชัน Telegram และข้อมูลข้อความธรรมดาจะต้องมีอยู่ในตัวเก็บข้อมูลชั่วคราว GitHub และอุโมงค์ HTTPS ยังคงเป็นโครงสร้างพื้นฐานที่เชื่อถือได้ การรับรองอาจทำให้ ค่าแฮชของไฟล์เก็บถาวรและข้อมูลระบุตัวตนของกระบวนการทำงานถูกเปิดเผยต่อสาธารณะ; ส่วนเนื้อหาของไฟล์เก็บถาวรนั้น ไม่ถูกใส่ไว้ในเอกสารรับรอง เวลาประทับของเอกสารรับรองไม่ใช่เวลาประทับของข้อความ

การแก้ไขปัญหา#

อาการ ขั้นตอนต่อไป
ปุ่ม "No Run" ในเวิร์กโฟลว์ สร้าง fork ของคุณเอง เปิดใช้งาน Actions และซิงค์กับ upstream main. อย่าแก้ไขพินต้นทางที่ได้รับการอนุมัติเพื่อหลีกเลี่ยงความล้มเหลว
ไม่ sealed-connection สิ่งประดิษฐ์ ตรวจสอบว่างานได้เริ่มขึ้นและเสร็จสิ้นขั้นตอนการเริ่มต้น/การอัปโหลดแล้วหรือไม่ ความผิดพลาดในคิว, รันเนอร์, การดาวน์โหลดภาพ, การสร้างอุโมงค์ หรือนโยบายของรีโพสิตอรี อาจทำให้การเริ่มต้นไม่สำเร็จ
ไม่สามารถเปิดการเชื่อมต่อได้ โหลดกุญแจที่บันทึกไว้สำหรับรอบนี้ แตกไฟล์อาร์ติแฟกต์ที่ดาวน์โหลดมา และเลือก connection.tgwsealed. โปรแกรมรันเนอร์ต้องยังคงทำงานอยู่
ประวัติศาสตร์ถูกหยุดชั่วคราว ตรวจสอบสถานะของแผงควบคุมและใช้ตัวเลือก "Resume" ขณะที่เซสชันยังเปิดอยู่ หรือเสร็จสิ้นด้วยข้อมูลที่เก็บรวบรวมไว้แล้ว ข้อจำกัดของ Telegram และเนื้อหาที่เข้าถึงไม่ได้อาจทำให้มีข้อมูลขาดหาย
ไม่ sealed-result การยกเลิกหรือหมดอายุก่อนเริ่มการเก็บข้อมูลจะไม่สร้างไฟล์เก็บถาวร; กระบวนการจะสิ้นสุดลงพร้อมข้อความแจ้งว่า ไม่มีไฟล์เก็บถาวร การเก็บข้อมูล การรับรอง หรือขั้นตอนการบรรจุที่ล้มเหลวก็จะทำให้การส่งข้อมูลไม่สำเร็จ; ขั้นตอนที่ล้มเหลวจะระบุเหตุผลของผู้กำกับดูแลโดยไม่เปิดเผยข้อมูลส่วนตัว ตรวจสอบได้โดยไม่ต้องป้อนข้อมูลรับรอง
เบราว์เซอร์ไม่สามารถถอดรหัสไฟล์เก็บถาวรขนาดใหญ่ได้ ใช้ CLI ของ streaming ด้านล่างนี้สำหรับแพ็กเกจที่มีขนาดมากกว่า 256 MiB หากกุญแจส่วนตัวผิดหรือสูญหาย จะไม่สามารถถอดรหัสผลลัพธ์ได้
ระบบการตรวจสอบปฏิเสธผู้ลงนาม ใช้การติดตั้ง 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

สำหรับการส่งข้อมูลแบบหลายส่วน ให้ถอดรหัสแพ็กเกจหลักก่อน และเก็บไฟล์ manifest ที่ถูกแยกออกมาไว้ข้างๆ ทุกส่วนที่ถูกเข้ารหัส แล้วรันคำสั่งต่อไปนี้:

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

ไฟล์ manifest คือไฟล์ที่ได้รับการยืนยันและทำหน้าที่ผูกมัดทุกส่วนรวมถึงไฟล์ ZIP ที่ถูกรวมไว้ ใช้ --max-gib เพื่อกำหนดขีดจำกัดการตรวจสอบไฟล์ที่ยังไม่ถูกบีบอัดให้เหมาะสมสำหรับ ไฟล์เก็บข้อมูลขนาดใหญ่; ค่าเริ่มต้นคือ 4 GiB การตรวจสอบ Expected-selection และ complete-scope ยังทำงานได้กับการส่งข้อมูลแบบหลายส่วน (multipart delivery)

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 จากระบบติดตั้งที่เชื่อถือได้ มันตรวจสอบคลังข้อมูลของผู้เรียกใช้, กระบวนการลงนามของผู้ลงนามต้นทาง, การ commit ของผู้ลงนามที่ได้รับการอนุมัติ ข้อกำหนดของตัวรันเนอร์ที่โฮสต์, ดิจิสต์ ZIP ที่สมบูรณ์, บันทึกภายใน และ ความสมบูรณ์ของไฟล์แนบ, ที่มาของคีย์บัญชีที่ใหม่ล่าสุด, และการ commit ของผู้รวบรวมที่คาดไว้ มันแสดงประวัติและผลลัพธ์ของสื่อแทนที่จะบอกเป็นนัยว่าข้อมูลทั้งหมดได้รับการบันทึกไว้แล้ว รายการ approved-release ที่ว่างจะส่งผลให้ปิดไม่สำเร็จ การอัปเดตนโยบายเป็นการตัดสินใจ เรื่องความเชื่อถืออย่างชัดเจน; ไม่ควรรับนโยบายที่เสนอโดยอาร์ไคฟ์เองโดยอัตโนมัติ

เพื่อใช้งานแบบออฟไลน์ ให้ดาวน์โหลดรากที่เชื่อถือได้ไว้ล่วงหน้าจากสภาพแวดล้อมที่เชื่อถือได้:

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

วิธีที่ fork ถูกเก็บไว้ภายนอกกระบวนการจับ#

ผู้เรียกมีอ้างอิงระดับงานไปยังเวิร์กโฟลว์ที่สามารถใช้ซ้ำได้จากต้นทาง ที่ SHA ของการคอมมิตแบบเต็ม เวิร์กโฟลว์นั้นจะทำการเช็คเอาต์จากรีโพสิตอรีต้นทาง ที่ SHA ของคอลเลกเตอร์ที่กำหนดไว้ล่วงหน้า เวิร์กโฟลว์เริ่มต้น actions/checkout ในเวิร์กโฟลว์ที่นำกลับมาใช้ใหม่ได้ จะทำการเช็คเอาต์ผู้เรียก และถูกออกแบบให้ไม่ใช้โดยเจตนา

กระบวนการนี้ไม่คืนค่าแคชของผู้เรียก ไม่ใช้ทรัพยากรของผู้เรียก ไม่ดำเนินการ ไฟล์ของผู้เรียก และไม่รับ URL ของแหล่งที่มา/ภาพ คำสั่งเชลล์ ไฟล์ ZIP ที่เตรียมไว้ หรือค่าแฮชเพื่อลงนาม มันรับผู้รับสาธารณะที่มีขอบเขตจำกัดและระยะเวลาเซสชัน การดำเนินการ, ภาพฐาน Python, และ cloudflared ถูกตรึงด้วย digests ที่ไม่สามารถเปลี่ยนแปลงได้; การพึ่งพาของ Python ใช้ข้อกำหนดที่มีอยู่ซึ่งถูกล็อกด้วยแฮช ภาพนี้ ถูกสร้างขึ้นจากแหล่งที่เชื่อถือได้โดยไม่ใช้แคช

โปรแกรมรวบรวมข้อมูลทำงานในฐานะผู้ใช้ที่ไม่ใช่ root ด้วยภาพระบบแบบอ่านอย่างเดียว (read-only image), ความสามารถของ Linux ที่ถูกจำกัด, ข้อจำกัดด้านทรัพยากร และไม่มีสภาพแวดล้อม Docker socket หรือ GitHub-token ไดเรกทอรีที่มันติดตั้งมีเพียงไดเรกทอรีการตั้งค่าใหม่, พื้นที่ทำงาน และไดเรกทอรีผลลัพธ์เท่านั้น แอปพลิเคชัน FastAPI ที่ถูกจำกัดนี้เปิดให้เข้าถึงฟังก์ชันการเข้าสู่ระบบ, กล่องสนทนา, การตั้งค่าบัญชีหรือการเก็บข้อมูลการสนทนา, สถานะ, การต่อ tục, การเสร็จสิ้น และการยกเลิก ไม่มีเส้นทางดาวน์โหลดข้อมูลแบบข้อความธรรมดา, เส้นทางบริหารจัดการทั่วไป, เส้นทางนำเข้าข้อมูล หรือจุดสิ้นสุดการลงนาม

ผู้ดูแลระบบจะหยุดการทำงานของคอนเทนเนอร์ที่เชื่อมต่อกับเครือข่าย ก่อนที่การดำเนินการยืนยัน จะอ่านค่าสุดท้ายที่ถูกแก้ไข evidence.zip หรือ evidence.parts.json. คอนเทนเนอร์แพ็กเกจไม่มีเครือข่าย ขั้นตอนการอัปโหลดมีชื่อเพียง connection.tgwsealed และ delivery*.tgwsealed; ทั้งหลักฐานข้อความธรรมดาและข้อมูลรับรอง Telegram ไม่ถูกอัปโหลดเป็นอาร์ติแฟกต์ ขั้นตอนการทำความสะอาดจะลบไดเรกทอรีส่วนตัวและคอนเทนเนอร์ออก และ GitHub จะทิ้ง เครื่องเสมือนรันเนอร์ที่โฮสต์ไว้หลังจากงานเสร็จสิ้น การเก็บรักษาอาร์ติแฟกต์เป็นเวลาหนึ่งวัน; ดาวน์โหลดก่อนหมดอายุ

เจ้าของ fork สามารถแทนที่ผู้เรียกหรือสร้างไฟล์ที่ลงนามใหม่ได้ ส่วน ผู้ตรวจสอบแบบเคร่งครัดต้องปฏิเสธผลลัพธ์ที่ได้ ขั้นตอนการทำงาน/ข้อมูลสรุปของผู้ลงนามที่แตกต่างกัน. วิธีการนี้ยังคงขึ้นอยู่กับว่าไม่มีข้อบกพร่องที่สามารถถูกใช้ประโยชน์ได้ในโค้ดที่ได้รับการอนุมัติ และความสมบูรณ์ของระบบรันเนอร์และโครงสร้างพื้นฐานการลงนามของ GitHub

การส่งต่อข้อมูลแบบเข้ารหัส#

กุญแจผู้รับแต่ละตัวเป็น RSA-3072 (รับการนำเข้า RSA-4096 ได้เช่นกัน), ค่าเลขชี้กำลัง 65537 แต่ละซองมีกุญแจ AES-256 ที่สุ่มใหม่และ nonce 96 บิต RSA-OAEP พร้อม SHA-256/MGF1-SHA256 ใช้ห่อหุ้มกุญแจ AES ส่วน AES-GCM พร้อมแท็ก 128 บิต ใช้ยืนยัน ความถูกต้องของส่วนนำและข้อมูลทั้งหมด ผู้รับสาธารณะเป็น DER SPKI ในรูปแบบ base64; ไฟล์กุญแจส่วนตัวมี DER PKCS8 ในรูปแบบ base64

ไบต์ของ Envelope คือ TGWSEAL1\n, ความยาวส่วนหัว JSON แบบ big-endian uint32, ส่วนหัว, ข้อความเข้ารหัส และแท็ก GCM ขนาด 16 ไบต์ ส่วนหัวมีความยาวพอดี algorithm, key, และ nonce; อัลกอริทึมคือ RSA-OAEP-256+A256GCM. ส่วน prefix ทั้งหมด ตั้งแต่ต้นจนถึงส่วน header เป็นข้อมูลเพิ่มเติมที่ได้รับการยืนยันตัวตนแบบ GCM ขนาดของ header ถูกจำกัด ไว้ที่ 8192 ไบต์ CLI ส่งข้อมูล payload ขนาดสูงสุด 8 GiB และทำการยืนยันตัวตนก่อน ที่จะติดตั้งผลลัพธ์ที่ร้องขอ; มันจะปฏิเสธการเขียนทับจุดหมายปลายทางที่มีอยู่แล้ว นี่คือโครงสร้างเฉพาะโครงการที่ห่อหุ้มปริมิทีฟการเข้ารหัสมาตรฐาน: RSA-OAEP พร้อม SHA-256 และ AES-256-GCM ซึ่งมีให้ใช้ใน OpenSSL และทุก ไลบรารีการเข้ารหัสหลัก

ไบต์ข้อมูลต้นฉบับได้รับการยืนยันแล้ว ก่อน การวางหลักฐานและ การรับรองในแพ็กเกจชั้นนอกที่เข้ารหัส ซึ่งช่วยหลีกเลี่ยงการพึ่งพาแบบวงกลม ระหว่างค่าแฮชของไฟล์เก็บถาวรกับใบรับรองที่อยู่ในไฟล์เก็บถาวรเดียวกันนั้น สำหรับรีโพสิตอรีสาธารณะ ข้อมูลเมตาดาต้าของการรับรอง (รีโพสิตอรี, กระบวนการทำงาน, การคอมมิต, ชื่ออาร์ติแฟกต์ และค่าแฮช) เป็นข้อมูลสาธารณะ อย่าใส่ชื่อแชทลงในข้อมูลเมตาดาต้าสาธารณะเด็ดขาด

ขอบเขตและการตรวจสอบความถูกต้อง#

โหมดนี้ใช้ระบบบันทึกที่มีลายเซ็นและเครื่องมือส่งออกบัญชี การสนทนาลับ, ประวัติการสนทนาที่ถูกลบก่อนการเก็บรวบรวม และข้อมูลที่บัญชีไม่สามารถเข้าถึงได้ จะถูกยกเว้น การสนทนาบนคลาวด์ส่วนตัวจะถูกรวมไว้เมื่อถูกเลือก ตัวเลือกการสนทนา มีขีดจำกัดสูงสุดที่ 20,000 บทสนทนา; เครื่องมือส่งออกบัญชีจะตรวจหาปริมาณข้อมูลที่มีอยู่เอง ข้อมูลที่ขาดหายไป ไฟล์ที่ล้มเหลว และ งานที่ยังไม่เสร็จจะถูกบันทึกไว้ ขีดจำกัดของไฟล์แนบและขีดจำกัดพื้นที่ดิสก์/เวลาของตัวรันเนอร์ยังคงมีผลบังคับใช้ การส่งข้อมูลขนาดใหญ่จะใช้ส่วนที่เข้ารหัสแทนการจำกัดการส่งที่ 4 GiB แบบคงที่ การเสร็จสิ้นหมายถึงงานที่เลือกไว้และถูกแช่แข็งได้เสร็จสิ้นแล้ว ไม่ใช่ว่าบันทึก Telegram ในอดีตทุกฉบับมีอยู่ในคลังข้อมูล บันทึกการสนทนาสามารถติดตามการอัปเดตแบบเรียลไทม์ได้ ทั้งสองโหมดไม่ใช่ภาพถ่ายแบบอะตอมิก ภาพหน้าจอและวิดีโอ บันทึกหน้าจอที่สร้างขึ้นไม่ถือเป็นส่วนหนึ่งของโหมดนี้

การทดสอบครอบคลุมการเข้าสู่ระบบใหม่แบบสังเคราะห์ การแยกขอบเขต สื่อ การยกเลิก การเสร็จสิ้นส่วนหนึ่งของกำหนดเวลา การออกจากระบบที่ล้มเหลว เส้นทางและฟิลด์ API ที่ถูกห้าม การปฏิเสธพื้นที่ทำงานที่โหลดไว้ล่วงหน้า การปฏิเสธเนื่องจากกุญแจผิดหรือการแก้ไขข้อมูล การตั้งค่าตัวตรวจสอบที่จำเป็น และความสามารถในการทำงานร่วมกันด้านการเข้ารหัสระหว่างเบราว์เซอร์และ Python การทดสอบการยอมรับของเบราว์เซอร์ ใช้การรับรองแบบจำลองที่มีป้ายกำกับชัดเจน; นี่ไม่ใช่การทดสอบ Sigstore ที่จริง การทดสอบความยอมรับบนโฮสต์จริง, Docker, การรับรองจาก GitHub และการทดสอบความยอมรับบน Telegram แบบสด ต้องรายงานแยกต่างหากจากการตรวจสอบแบบจำลองในเครื่องท้องถิ่น

เงื่อนไขของ GitHub Actions จำกัดการใช้ runner ที่ได้รับการโฮสต์ไว้ให้อยู่ในวงจรชีวิตของโครงการซอฟต์แวร์เท่านั้น การ fork ไม่ทำให้ข้อจำกัดเหล่านี้ถูกยกเลิก; เวอร์ชันทดลองนี้ห้ามโฆษณาว่าเป็นบริการโฮสต์ สำหรับการผลิตแบบฟรีและไม่มีข้อจำกัด Cloudflare Quick Tunnels ก็ถูกออกแบบมาเพื่อ การทดสอบและการพัฒนาเช่นกัน โปรแกรมช่วย/workflows เหล่านี้เหมาะ สำหรับการประเมินคุณสมบัตินี้; ความเหมาะสมสำหรับบริการผลิตยังคงเป็น ข้อกำหนดการปรับใช้ที่แยกต่างหาก

ลำดับการปล่อยเวอร์ชันของผู้ดูแลระบบ#

  1. ส่งและตรวจสอบ collector, supervisor, การกำหนดค่า container และการทดสอบ
  2. บันทึกการ commit ของ collector นั้นใน sealed-collector.yml, แล้วจึง commit/review workflow ที่สามารถใช้ซ้ำได้ อย่าทำการสร้าง checkout จาก SHA ของผู้เรียกมาโดยไม่ได้แจ้งให้ทราบ
  3. ปักหมุดการ commit ของ workflow ที่ใช้ซ้ำได้ใน sealed-witness.yml และเพิ่ม คู่ SHA ของ workflow/collector เข้าสู่ sealed_policy.json ในเวอร์ชันที่เชื่อถือได้
  4. เผยแพร่ทุก commit ที่ถูกอ้างอิงและตัวช่วย จากนั้นทดสอบ fork ที่แยกออกมา และใบรับรอง GitHub ที่จริง อย่ารวม commit ที่ถูกอ้างอิงโดย pin เหล่านี้เข้าด้วยกัน เว้นแต่การอ้างอิงเหล่านั้นจะถูกสร้างขึ้นใหม่และเผยแพร่ใหม่

ดูขั้นตอนการทำงานและเอกสารรับรองที่สามารถใช้ซ้ำได้ เพื่อเข้าใจความแตกต่างระหว่าง repositori ของผู้เรียกและผู้ลงนามต้นทาง