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

Canonical page: https://phishdestroy.io/tgwitness/th/docs/capture/

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

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/th/llms.txt)

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

เปิดใช้งาน JavaScript เพื่อสร้างกุญแจและถอดรหัสไฟล์เก็บถาวรของคุณ

**อ้างอิงเต็ม**

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [เอกสารประกอบ](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [การจับภาพแบบอิสระ](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md)

![การจับภาพแบบอิสระ](https://phishdestroy.io/tgwitness/assets/chapter-capture.svg?v=c979502bc92b)

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

เลือก `client=official_web` เพื่อดำเนินการ [พยานจากฝ่ายลูกค้าอย่างเป็นทางการ](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md) พร้อมด้วยระบบควบคุม Telegram Web และวิดีโอที่ได้รับการป้องกัน ต้องใช้พร็อกซีต้นทางของคุณเอง และติดตามการสนทนาที่แสดงผลหนึ่งครั้ง ค่าเริ่มต้น `client=api` ยังคงรักษาโหมดการส่งออกข้อมูลบัญชีแบบเต็มตามที่อธิบายไว้ด้านล่าง

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

**บนหน้านี้**

- [กระบวนการใช้งาน](https://phishdestroy.io/tgwitness/th/docs/capture/#user-flow)
- [งบประมาณเวลาการประชุม](https://phishdestroy.io/tgwitness/th/docs/capture/#session-time-budget)
- [เลือกโหมดนี้หรือพื้นที่ทำงานแบบถาวร](https://phishdestroy.io/tgwitness/th/docs/capture/#choose-this-mode-or-a-persistent-workspace)
- [อะไรคือเรื่องสาธารณะ และอะไรต้องเป็นเรื่องส่วนตัว](https://phishdestroy.io/tgwitness/th/docs/capture/#what-is-public-and-what-must-stay-private)
- [การแก้ไขปัญหา](https://phishdestroy.io/tgwitness/th/docs/capture/#troubleshooting)
- [การถอดรหัสและตรวจสอบข้อมูลแบบท้องถิ่น](https://phishdestroy.io/tgwitness/th/docs/capture/#local-decryption-and-verification)
- [วิธีที่ fork ถูกเก็บไว้ภายนอกกระบวนการจับภาพ](https://phishdestroy.io/tgwitness/th/docs/capture/#how-the-fork-is-kept-outside-the-capture-process)
- [การส่งต่อข้อมูลด้วยระบบเข้ารหัส](https://phishdestroy.io/tgwitness/th/docs/capture/#cryptographic-handoff)
- [ขอบเขตและการตรวจสอบความถูกต้อง](https://phishdestroy.io/tgwitness/th/docs/capture/#scope-and-validation)
- [ลำดับการปล่อยเวอร์ชันของผู้ดูแลระบบ](https://phishdestroy.io/tgwitness/th/docs/capture/#maintainer-release-sequence)

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

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

1. เลือก **GitHub Actions capture (preview)** บนหน้าหลักของโครงการ, หน้าจอเข้าสู่ระบบพื้นที่ทำงาน หรือ **Exports → Open capture helper** คุณยังสามารถ เปิด [helper อย่างเป็นทางการ](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) หรือ `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](https://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 อย่างเป็นทางการ](https://core.telegram.org/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](https://cli.github.com/manual/gh_attestation_verify)

## วิธีที่ 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](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#actions) จำกัดการใช้ runner ที่ได้รับการโฮสต์ไว้ให้อยู่ในวงจรชีวิตของโครงการซอฟต์แวร์เท่านั้น การ fork ไม่ทำให้ข้อจำกัดเหล่านี้ถูกยกเลิก; เวอร์ชันทดลองนี้ห้ามโฆษณาว่าเป็นบริการโฮสต์ สำหรับการผลิตแบบฟรีและไม่มีข้อจำกัด [Cloudflare Quick Tunnels](https://developers.cloudflare.com/tunnel/get-started/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 เหล่านี้เข้าด้วยกัน เว้นแต่การอ้างอิงเหล่านั้นจะถูกสร้างขึ้นใหม่และเผยแพร่ใหม่

ดู[ขั้นตอนการทำงานและเอกสารรับรองที่สามารถใช้ซ้ำได้](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) เพื่อเข้าใจความแตกต่างระหว่าง repositori ของผู้เรียกและผู้ลงนามต้นทาง
