# Telegram · Penangkapan GitHub Actions

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

Pilih Takeout, ekspor API biasa atau jurnal obrolan pada runner GitHub sementara.

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

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

Pilih Takeout, ekspor API biasa atau jurnal obrolan pada runner GitHub sementara.

Aktifkan JavaScript untuk membuat kunci dan mendekripsi arsip Anda.

**Referensi lengkap**

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Penangkapan mandiri](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md)

![Penangkapan mandiri](https://phishdestroy.io/tgwitness/assets/chapter-capture.svg?v=c979502bc92b)

**Pratinjau tersedia dari halaman `main`.** Sebuah fork menjalankan alur kerja yang disematkan dan dapat digunakan kembali dari `phishdestroy/TgWitness`. Alur kerja tersebut mengekspor akun, obrolan yang dipilih, atau jurnal peristiwa dari satu obrolan menggunakan sesi Telegram yang baru dibuat, memverifikasi berkas ZIP atau manifes multipart sebagai bukti, dan hanya mengunggah data yang dienkripsi oleh penerima. Panel administrasi biasa tidak ditampilkan.

Pilih `client=official_web` untuk menjalankan [saksi klien resmi](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md) dengan kontrol Telegram Web yang dilindungi dan video. Fitur ini memerlukan proxy hulu milik Anda sendiri dan memantau satu obrolan yang ditampilkan. Secara default, `client=api` tetap mempertahankan mode ekspor akun lengkap yang dijelaskan di bawah ini.

Verifikator memeriksa arsip tersebut dengan membandingkannya terhadap surat pernyataan GitHub-nya, alur kerja yang telah disetujui, serta commit pengumpul, dan hash jurnal serta lampiran yang telah ditandatangani. Proses pengumpulan menggunakan kode hulu yang telah di-pin dan penyimpanan baru. Seorang peninjau dapat memeriksa kode tersebut dan memverifikasi arsip yang diserahkan dengan membandingkannya terhadap catatan proses eksekusinya.

**Di halaman ini**

- [Alur pengguna](https://phishdestroy.io/tgwitness/id/docs/capture/#user-flow)
- [Alokasi waktu sesi](https://phishdestroy.io/tgwitness/id/docs/capture/#session-time-budget)
- [Pilih mode ini atau ruang kerja permanen](https://phishdestroy.io/tgwitness/id/docs/capture/#choose-this-mode-or-a-persistent-workspace)
- [Apa yang bersifat publik, dan apa yang harus tetap bersifat pribadi](https://phishdestroy.io/tgwitness/id/docs/capture/#what-is-public-and-what-must-stay-private)
- [Pemecahan Masalah](https://phishdestroy.io/tgwitness/id/docs/capture/#troubleshooting)
- [Dekripsi dan verifikasi lokal](https://phishdestroy.io/tgwitness/id/docs/capture/#local-decryption-and-verification)
- [Bagaimana garpu tersebut tetap berada di luar proses penangkapan](https://phishdestroy.io/tgwitness/id/docs/capture/#how-the-fork-is-kept-outside-the-capture-process)
- [Serah terima kriptografis](https://phishdestroy.io/tgwitness/id/docs/capture/#cryptographic-handoff)
- [Ruang lingkup dan validasi](https://phishdestroy.io/tgwitness/id/docs/capture/#scope-and-validation)
- [Urutan rilis pengelola](https://phishdestroy.io/tgwitness/id/docs/capture/#maintainer-release-sequence)

## pengguna#

Pemandu ini menjelaskan lima tahap dan memungkinkan Anda mencoba penggantian pesan atau pengumpul pada data contoh. **Pilihan Mulai Penangkapan** akan membuka wizard.

1. Pilih **GitHub Actions capture (pratinjau)** di halaman beranda proyek, layar masuk ruang kerja, atau **Ekspor → Buka pembantu capture**. Anda juga dapat membuka [pembantu resmi](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) atau `tgwitness/static/capture.html` dari checkout tepercaya di peramban modern. Helper ini tidak melakukan permintaan jaringan apa pun untuk pemrosesan kunci atau file. Helper ini mendukung bahasa antarmuka situs; panel pengumpulan sementara mendukung bahasa Inggris dan Rusia, serta terbuka dalam bahasa browser jika bahasa tersebut termasuk di antaranya.
2. Buat kunci dan simpan **berkas sealed-key.json**. Ini adalah satu-satunya kunci pribadi untuk mendekripsi. Salin nilai kunci publik **penerima** yang terpisah. Jika kunci pribadi hilang, Anda akan kehilangan akses baik ke koneksi maupun arsip. Pastikan Anda telah menyimpannya untuk melanjutkan ke langkah berikutnya. Jika Anda sudah memiliki berkas pengiriman, muat kunci yang telah disimpan dan pilih **Saya sudah memiliki arsip**.
3. Lakukan fork pada TgWitness, aktifkan fitur Actions di fork tersebut, lalu jalankan **fitur Sealed chat capture**. Tempelkan alamat publik penerima dan pilih durasi 30, 60, atau 120 menit. Jangan pernah mencantumkan nomor telepon, kode login, kata sandi Telegram, kunci pribadi, atau sesi di input alur kerja, commit, isu, atau log.
4. Selama proses berjalan, unduh **sealed-connection** dari Artifacts dan ekstrak file tersebut. Muat `connection.tgwsealed` di dalam helper, menggunakan kunci pribadi yang telah disimpan. Tautan yang dihasilkan berisi rahasia akses acak di fragmen URL-nya. Jaga kerahasiaan tautan ini. Panel akan menghapus fragmen tersebut dan menyimpan rahasia di penyimpanan sesi tab ini; rahasia tersebut tidak disimpan dalam log akses HTTP.
5. Buka tautan koneksi. Masuk menggunakan kode QR, atau dengan nomor telepon Anda dan kode masuk. Masukkan kata sandi verifikasi dua langkah jika Telegram memintanya. Kumpulan kredensial API bawaan digunakan secara default, sama seperti ruang kerja biasa. Anda dapat memperluas bagian kredensial khusus opsional dan memasukkan keduanya `api_id` dan `api_hash` dari [my.telegram.org/apps](https://my.telegram.org/apps). Biarkan kedua kolom kosong untuk menggunakan kumpulan bawaan; pasangan yang tidak lengkap atau salah format akan ditolak. Impor sesi tidak diperbolehkan. Pilih mode ekspor dan cakupan. Tautan koneksi berisi rahasia akses: jaga kerahasiaannya.
6. Pilih **Telegram Takeout**, **API Telegram Reguler**, atau **jurnal peristiwa obrolan**. Untuk ekspor akun, pilih semua obrolan yang dapat diakses atau muat dan pilih satu atau lebih obrolan, lalu tentukan tanggal, jenis obrolan, kategori akun, dan aturan lampiran. Periksa pengaturan dan ukuran, secara opsional simpan file JSON pengaturan untuk peninjau independen, lalu tekan **Mulai penangkapan**. Pengaturan tidak dapat diubah setelah dimulai. Fitur Lanjutkan hanya berfungsi selama proses ini masih berjalan; penghentian dini akan menyimpan data yang telah diperoleh dan mencatat celah data. Kedaluwarsa batas waktu setelah proses dimulai akan menghasilkan arsip yang secara eksplisit tidak lengkap; kedaluwarsa sebelum proses dimulai atau pembatalan tidak akan menghasilkan arsip apa pun.
7. Tunggu hingga **hasil yang disegel** tersedia, unduh dan ekstrak, lalu dekripsi `delivery.tgwsealed` di dalam helper. Anda akan menerima `delivery.zip`, yang berisi `evidence.zip`, `attestation.jsonl`, serta petunjuk. Dekripsi melalui browser terbatas hingga 256 MiB; paket yang lebih besar gunakan perintah streaming lokal di bawah ini. Hasil berukuran besar juga mencakup `delivery-NNNNNN.tgwsealed` bagian-bagian; bagian utama `delivery.tgwsealed` kemudian berisi `evidence.parts.json` dan surat keterangan. Unduh setiap bagian dan gabungkan secara lokal seperti yang dijelaskan di bawah ini.
8. Akhiri sesi sementara di Pengaturan Telegram → Perangkat jika pencabutan belum dikonfirmasi atau proses berjalan dihentikan. Penyelesaian normal akan meminta pengguna untuk keluar, dan proses tersebut mencatat apakah pencabutan telah dikonfirmasi.

Repositori tersebut harus berisi commit sumber yang telah dipublikasikan dan disematkan serta commit alur kerja yang dapat digunakan kembali. Cabang lokal saja tidak dapat dipanggil oleh repositori GitHub lainnya.

## waktu sesi#

Sebelum pengambilan, **Hitung waktu dan ukuran** memperkirakan riwayat dan berkas yang dipilih berdasarkan jumlah pesan dan sampel terbatas. Tampilan mencakup waktu yang telah dihabiskan untuk masuk, perkiraan waktu pengumpulan, dan cadangan waktu untuk pengemasan. Untuk berkas, perkiraan awal menggunakan 1 MiB/s dan margin waktu dua kali lipat; kemajuan menggantikan asumsi tersebut dengan laju yang terukur. Gunakan **Hanya pesan** atau pilih lebih sedikit obrolan jika perkiraan waktunya melebihi waktu yang tersisa.

Waktu tunggu Takeout yang dilaporkan oleh Telegram dimasukkan ke dalam anggaran. Pengumpul menghentikan proses pengumpulan ketika waktu yang tersisa diperlukan untuk pengemasan, menyimpan data yang telah dikumpulkan, dan menandai hasil sebagian. Oleh karena itu, sesi berdurasi 120 menit memanfaatkan sisa jendela pengumpulan yang tersedia alih-alih menunggu batas waktu sebelum menyiapkan arsip. Tampilan menampilkan pilihan-pilihan yang ukuran penuhnya tidak dapat diambil sampelnya.

## Pilih mode ini atau  permanen#

| Mode pengambilan gambar | Ruang lingkup yang dapat dikonfigurasi | Perbedaan |
| --- | --- | --- |
| Telegram Takeout, pilihan bawaan | Semua obrolan cloud yang dapat diakses atau obrolan yang dipilih, tanggal, kategori akun, kebijakan media, dan tampilan JSON/HTML | Menggunakan mekanisme ekspor resmi Telegram; mungkin diperlukan persetujuan atau masa tunggu. Takeout dapat mencantumkan saluran/grup yang tersisa jika Telegram mengizinkannya dan meminta data pribadi tambahan. |
| API Telegram Standar | Cakupan akun dan pilihan keluaran yang sama, tergantung pada metode yang tersedia melalui API reguler | Tidak menginisialisasi Takeout; tidak dapat menampilkan daftar saluran/supergrup yang tersisa atau mengambil data pribadi yang hanya tersedia di Takeout. Kontak yang dimaksud mencakup pengguna Telegram, bukan seluruh daftar kontak telepon yang tersimpan. Batasan frekuensi tetap berlaku. |
| Jurnal acara obrolan | Satu obrolan yang dipilih, kebijakan lampiran, dan avatar opsional | Menampilkan riwayat dan perubahan yang teramati selama proses ini berlangsung. Kategori akun, filter tanggal, dan tampilan yang kompatibel dengan Desktop tidak berlaku. |

Ketiga mode tersebut memiliki sertifikasi GitHub dan pengiriman terenkripsi yang sama. Takeout memilih metode akuisisi dan tidak akan pernah diganti secara diam-diam dengan akses API biasa. TgWitness menghasilkan tampilan JSON/HTML dari catatan yang ditangkap dan mempertahankan metode akuisisi yang dipilih dalam ekspor. Lihat [API resmi Takeout](https://core.telegram.org/api/takeout).

Secara default, fitur ini menggunakan Takeout, mencakup semua jenis obrolan yang dapat diakses—termasuk obrolan yang diarsipkan—semua tanggal, profil akun, dan kontak, serta file JSON dan HTML yang kompatibel, dan unduhan file. Kuota media awal adalah 4 GiB, dengan batas ukuran file per jenis yang terlihat; untuk file yang lebih besar atau jika kuota unduhan telah habis, akan digunakan hash server jika tersedia. Periksa batas-batas ini sebelum melakukan pengumpulan. Hash tidak dapat merekonstruksi sebuah file. Foto opsional, cerita, metadata sesi, dan data pribadi tambahan tetap menjadi pilihan terpisah.

Proses pengambilan data mungkin memerlukan persetujuan dalam sesi Telegram yang sudah ada. Telegram yang menentukan waktu tunda tersebut; proses login baru atau pelaksana baru tidak dapat melewatinya. Jendela waktu pengambilan maksimum adalah 120 menit, termasuk proses login dan persetujuan, sehingga akun besar atau waktu tunggu persetujuan yang lama mungkin tidak dapat diselesaikan. Ekspor lokal yang tetap ada dapat melanjutkan sesi yang sama, tetapi tidak mewarisi sertifikasi GitHub.

### Setujui dan verifikasi

Setelah **memeriksa pengaturan dan ukuran**, gunakan "**Simpan Pengaturan" untuk verifikasi**. Setujui hasil `sealed-export-settings.json` dengan peninjau sebelum pengumpulan. Perubahan akan membatalkan penilaian yang telah disimpan. Pengumpul menandatangani pengaturan yang berlaku beserta SHA-256-nya, dan tanda terima ekspor akun mengikat opsi yang sama. Verifikator melaporkan mode aktual, pemilihan, dan kelengkapan, serta menolak ketidaksesuaian antara jurnal dan ekspor akun bersarang.

```
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete
```

`--expected-selection` menolak jenis transportasi, cakupan obrolan, filter, atau kebijakan lampiran yang berbeda. `--require-complete` hanya menerima ekspor akun dan jurnal obrolan yang tercatat sebagai lengkap. Tanpa bendera-bendera ini, verifikasi tetap memeriksa asal-usul dan integritas sambil melaporkan pengaturan yang tercatat serta celah yang ada. Sepakati pilihan yang diharapkan sebelum proses dijalankan dan simpan secara terpisah dari arsip. Ruang lingkup dan interval akuisisi mengidentifikasi materi yang ditangkap selama proses; gunakan pengamatan sebelumnya yang disimpan saat membandingkan versi-versi sebelumnya.

| Kebutuhan | Mode |
| --- | --- |
| Ekspor data akun yang dapat diakses atau obrolan yang dipilih selama sesi terbatas, dan berikan arsip yang telah diverifikasi secara eksternal kepada pihak yang melakukan peninjauan | Tangkapan layar GitHub Actions (pratinjau) |
| Memantau beberapa obrolan secara terus-menerus, mengelola akun, mencari, dan membaca arsip yang terus bertambah | Ruang kerja lokal atau Docker |

Ini akan memulai proses penangkapan terpisah dengan login baru. Proses ini tidak akan mengunggah jurnal lokal Anda yang sudah ada, mengekspor ruang kerja yang sedang terbuka, atau menggunakan kembali sesi Telegram-nya. Proses penangkapan di cloud yang belum selesai tidak dapat dilanjutkan setelah pelaksananya dihentikan; alur kerja baru akan memulai proses penangkapan baru.

Pilihan **Ekspor → Buka alat bantu penangkapan** di ruang kerja akan membuka wizard lengkap di dalam panel. Halaman mandiri menggunakan wizard, kontrol, dan tema yang sama. Keduanya menyimpan kunci dan proses dekripsi di browser Anda. Proses awal alur kerja GitHub dan panel Telegram sementara terbuka di tab terpisah; wizard akan memberi tahu Anda kapan harus kembali. Mengunci ruang kerja akan menghapus kunci yang tersimpan di memori wizard. File kunci yang Anda simpan tetap berada di perangkat Anda.

## Apa yang bersifat publik, dan apa yang harus tetap bersifat

Pengumpulan data dijalankan pada runner standar yang dihosting di GitHub. GitHub, pengumpul yang telah disetujui serta dependensinya, halaman pembantu, peramban, dan terowongan HTTPS merupakan bagian-bagian yang tepercaya dalam konfigurasi ini. Host sementara memproses sesi Telegram dan pesan teks biasa; artefak yang dikirimkan dienkripsi untuk penerima.

Proses forking menyalin kode proyek ke repositori Anda. Proses ini **tidak** mengekspor akun Telegram Anda. Input alur kerja penerima berupa kunci enkripsi publik. Simpan `sealed-key.json`, kredensial Telegram, kode login, kata sandi 2FA, dan URL koneksi yang telah didekripsi agar tidak dimasukkan ke dalam commit, input alur kerja, dan log publik.

Alur kerja ini mempublikasikan artefak koneksi/hasil yang terenkripsi selama satu hari. Unduh keduanya tepat waktu; ketersediaan GitHub Actions, batasan akun, dan penagihan berlaku. Fork publik bukanlah jaminan akan sumber daya komputasi gratis tanpa batas. Tidak ada pembayaran atau token akses GitHub yang dimasukkan ke dalam helper.

Kunci dekripsi pribadi tetap tersimpan di browser/file Anda. Materi sesi Telegram dan catatan teks biasa pasti tersimpan di dalam penyimpanan sementara. GitHub dan terowongan HTTPS tetap menjadi infrastruktur tepercaya. Proses pengesahan mungkin membuat ringkasan arsip dan identitas alur kerja menjadi publik; isi arsip tidak disertakan dalam pengesahan. Cap waktu pengesahan bukanlah cap waktu pesan.

## Pemecahan

| Gejala | Langkah selanjutnya |
| --- | --- |
| Tidak **Jalankan alur kerja** tombol | Buatlah fork Anda sendiri, aktifkan Actions, dan sinkronkan dengan upstream `main`. Jangan mengedit pin hulu yang telah disetujui untuk menghindari kegagalan. |
| Bukan `sealed-connection` artefak | Periksa apakah pekerjaan tersebut telah dimulai dan menyelesaikan tahap startup/pengunggahan. Kegagalan pada antrian, runner, pengunduhan gambar, terowongan, atau kebijakan repositori dapat menghambat proses startup. |
| Tidak dapat membuka koneksi | Muat kunci yang telah disimpan untuk sesi ini, ekstrak artefak yang telah diunduh, dan pilih `connection.tgwsealed`. Runner harus masih aktif. |
| Sejarah sedang ditangguhkan | Periksa status panel dan gunakan opsi "Lanjutkan" selama sesi masih aktif, atau selesaikan dengan data yang sudah terkumpul. Batasan Telegram dan konten yang tidak dapat diakses dapat menyebabkan adanya celah. |
| Tidak `sealed-result` | Pembatalan atau kedaluwarsa sebelum proses pengumpulan dimulai tidak akan menghasilkan arsip; proses tersebut kemudian berakhir dengan pemberitahuan **Tidak ada arsip**. Langkah pengumpulan, pengesahan, atau pengemasan yang gagal juga akan menghambat pengiriman; langkah yang gagal tersebut mencantumkan alasan yang diberikan oleh supervisor tanpa menyertakan data pribadi. Periksa hal tersebut tanpa perlu memasukkan kredensial. |
| Browser tidak dapat mendekripsi arsip berukuran besar | Gunakan CLI streaming di bawah ini untuk paket yang ukurannya lebih besar dari 256 MiB. Kunci pribadi yang salah atau hilang tidak dapat mendekripsi hasilnya. |
| Proses verifikasi menolak penandatangan | Gunakan instalasi TgWitness terbaru yang terpercaya dan pemanggil yang tepat `OWNER/REPOSITORY`. Jangan terima kebijakan pengganti yang disertakan dalam arsip tersebut. |
| Telegram masih mencantumkan sesi sementara tersebut | Hentikan prosesnya di Pengaturan → Perangkat. Proses keluar mungkin gagal, dan alur kerja yang dihentikan secara paksa mungkin tidak menjalankan proses pembersihan. |

Sebelum mengandalkan pratinjau ini, cobalah percakapan kecil yang Anda kendalikan: buat pesan dan lampiran, kumpulkan keduanya, dekripsi hasilnya, jalankan verifikator, periksa hasil cakupan/media, dan pastikan pencabutan sesi Telegram. Pemeriksaan otomatis menggunakan klien Telegram sintetis ditambah uji sertifikat GitHub asli yang terpisah; belum ada catatan pengujian menggunakan akun aktif pada revisi saat ini.

## Dekripsi dan  lokal#

Gunakan alat dari sumber yang tepercaya dan independen, bukan berkas yang dapat dieksekusi yang disediakan oleh arsip bukti yang tidak dikenal:

```
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
```

Untuk pengiriman multipart, dekripsi paket utama terlebih dahulu dan simpan manifest yang telah diekstrak di samping setiap bagian yang terenkripsi, lalu jalankan:

```
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 adalah subjek yang telah diverifikasi dan mengikat setiap bagian serta berkas ZIP yang telah digabungkan. Gunakan `--max-gib` untuk menetapkan batas verifikasi tanpa kompresi yang sesuai untuk arsip berukuran besar; nilai defaultnya adalah 4 GiB. Pemeriksaan "expected-selection" dan "complete-scope" juga berfungsi pada pengiriman multipart.

Python 3.11 ke atas, dependensi proyek, dan GitHub CLI versi terbaru yang mendukung `--signer-digest` dan `--deny-self-hosted-runners` diperlukan. Generator kunci CLI juga tersedia: `python -m tgwitness.sealed_crypto keygen sealed-key.json`.

Verifikator menggunakan `tgwitness/sealed_policy.json` dari instalasi tepercaya. Verifikator memeriksa repositori pemanggil, alur kerja penandatangan hulu, komitmen penandatangan yang disetujui, persyaratan pelaksana yang dihosting, ringkasan ZIP lengkap, jurnal internal, dan integritas lampiran, asal kunci akun yang baru, serta komitmen pengumpul yang diharapkan. Verifikator menampilkan riwayat dan hasil media, bukan menyiratkan bahwa semua data telah disimpan. Daftar rilis yang disetujui yang kosong akan dianggap gagal. Memperbarui kebijakan merupakan keputusan kepercayaan yang eksplisit; jangan pernah menerima kebijakan yang diusulkan oleh arsip itu sendiri secara otomatis.

Untuk penggunaan offline, peroleh akar sertifikat tepercaya terlebih dahulu dari lingkungan yang tepercaya:

```
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
```

Cap waktu pada surat pernyataan tersebut berkaitan dengan komitmen arsip. Cap waktu tersebut tidak mengautentikasi cap waktu pesan atau jam dinding milik pengumpul. Lihat [opsi verifikasi GitHub](https://cli.github.com/manual/gh_attestation_verify).

## Bagaimana garpu tetap berada di luar  penangkapan#

Panggilan tersebut berisi referensi tingkat pekerjaan ke alur kerja hulu yang dapat digunakan kembali pada SHA commit lengkap. Alur kerja tersebut secara eksplisit melakukan check-out **repositori hulu pada SHA kolektor tetap**. Alur kerja default `actions/checkout` dalam alur kerja yang dapat digunakan kembali akan melakukan checkout terhadap pemanggil dan secara sengaja tidak digunakan.

Alur kerja ini tidak memulihkan cache pemanggil, menggunakan artefak pemanggil, menjalankan file pemanggil, atau menerima URL sumber/gambar, perintah shell, file ZIP yang telah disiapkan, atau hash untuk ditandatangani. Alur kerja ini menerima penerima publik yang terbatas dan durasi sesi yang ditentukan. Tindakan, gambar dasar Python, dan cloudflared dikunci oleh ringkasan yang tidak dapat diubah; ketergantungan Python menggunakan persyaratan yang sudah terkunci dengan hash. Gambar tersebut dibangun dari sumber tepercaya tanpa cache.

Collector berjalan sebagai pengguna non-root dengan image read-only, kemampuan Linux yang dibatasi, batasan sumber daya, serta tanpa lingkungan soket Docker atau token GitHub. Satu-satunya direktori yang dipasang adalah direktori konfigurasi baru, ruang kerja, dan direktori keluaran. Aplikasi FastAPI yang dibatasi ini menyediakan fitur login, dialog, pengaturan akun atau koleksi obrolan yang dapat dikonfigurasi, status, lanjutkan, selesaikan, dan pembatalan. Tidak ada rute unduhan teks biasa, rute administrasi umum, rute impor, atau titik akhir penandatanganan.

Pengawas menghentikan kontainer yang terhubung ke jaringan sebelum tindakan verifikasi membaca versi final yang telah diperbaiki `evidence.zip` atau `evidence.parts.json`. Kontainer pengemasan tidak memiliki jaringan. Langkah-langkah unggahan hanya menyebutkan `connection.tgwsealed` dan `delivery*.tgwsealed`; baik bukti teks biasa maupun kredensial Telegram tidak diunggah sebagai artefak. Proses pembersihan menghapus direktori dan kontainer pribadi, dan GitHub membuang VM runner yang dihosting setelah pekerjaan selesai. Retensi artefak berlaku selama satu hari; unduh sebelum masa berlaku habis.

Pemilik fork dapat mengganti pihak yang memanggil atau membuat berkas bertanda tangan yang berbeda. Pemeriksa ketat harus menolak hasil yang dihasilkan **alur kerja penandatangan yang berbeda/ringkasan**. Pembangunan ini masih bergantung pada tidak adanya bug yang dapat dieksploitasi dalam kode yang telah disetujui serta pada integritas runner dan infrastruktur penandatanganan GitHub.

## kriptografis#

Setiap kunci penerima menggunakan RSA-3072 (impor RSA-4096 juga diterima), dengan eksponen 65537. Setiap amplop memiliki kunci AES-256 acak yang baru dan nonce 96-bit. RSA-OAEP dengan SHA-256/MGF1-SHA256 membungkus kunci AES. AES-GCM dengan tag 128-bit mengautentikasi prefiks dan muatan secara keseluruhan. Kunci publik penerima berbentuk DER SPKI dalam base64; berkas kunci pribadi berisi DER PKCS8 dalam base64.

Byte-byte amplop terdiri dari `TGWSEAL1\n`, panjang header JSON tipe uint32 big-endian, header, teks terenkripsi, dan tag GCM berukuran 16 byte. Panjang header tepat `algorithm`, `key`, dan `nonce`; algoritmanya adalah `RSA-OAEP-256+A256GCM`. Awalan lengkap hingga header merupakan data otentikasi tambahan GCM. Ukuran header dibatasi hingga 8192 byte. CLI mengalirkan muatan hingga 8 GiB dan melakukan otentikasi sebelum menyiapkan keluaran yang diminta; CLI menolak menimpa tujuan yang sudah ada. Ini adalah selubung khusus proyek di sekitar primitif kriptografi standar: RSA-OAEP dengan SHA-256 dan AES-256-GCM, yang tersedia di OpenSSL dan setiap perpustakaan kriptografi utama.

Byte bukti asli diverifikasi **sebelum** bukti dan verifikasi tersebut dimasukkan ke dalam paket luar yang terenkripsi. Hal ini mencegah terjadinya ketergantungan sirkuler antara hash arsip dan sertifikat yang terdapat di dalam arsip yang sama. Untuk repositori publik, metadata verifikasi (repositori, alur kerja, commit, nama artefak, dan ringkasan) bersifat publik. Jangan pernah mencantumkan nama obrolan dalam metadata publik.

## Ruang lingkup dan

Mode ini menggunakan mesin jurnal bertanda tangan dan ekspor akun. Obrolan Rahasia, riwayat yang dihapus sebelum proses pengumpulan, serta data yang tidak dapat diakses oleh akun tersebut tidak termasuk. Obrolan cloud pribadi memenuhi syarat jika dipilih. Pemilih obrolan dibatasi hingga 20.000 dialog; ekspor akun akan mendeteksi inventarisnya sendiri. Data yang hilang, berkas yang gagal, dan tugas yang belum selesai dicatat. Batas lampiran serta batas ruang disk dan waktu pelaksana tetap berlaku. Pengiriman berukuran besar menggunakan bagian-bagian terenkripsi alih-alih batas pengiriman tetap sebesar 4 GiB. Penyelesaian berarti tugas-tugas terpilih yang dibekukan telah selesai, bukan berarti setiap catatan historis Telegram ada di dalam arsip. Jurnal obrolan juga dapat memantau pembaruan secara langsung; tidak ada satu pun mode yang merupakan snapshot atomik. Tangkapan layar dan rekaman layar yang dihasilkan bukan bagian dari mode ini.

Pengujian mencakup login baru sintetis, isolasi cakupan, media, pembatalan, penyelesaian tenggat waktu sebagian, kegagalan logout, jalur dan bidang API yang dilarang, penolakan ruang kerja yang dimuat sebelumnya, penolakan kunci salah dan manipulasi, bendera verifikator yang diwajibkan, serta interoperabilitas enkripsi browser/Python. Pengujian penerimaan browser menggunakan attestation tiruan yang diberi label jelas; ini bukanlah pengujian Sigstore yang sesungguhnya. Pengujian penerimaan menggunakan hosted-runner asli, Docker, attestation GitHub, dan Telegram langsung harus dilaporkan secara terpisah dari pemeriksaan sintetis lokal.

[Ketentuan GitHub Actions](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#actions) membatasi penggunaan runner yang dihosting hanya untuk siklus hidup proyek perangkat lunak. Membuat fork tidak menghapus pembatasan ini; pratinjau ini tidak boleh dipromosikan sebagai layanan hosting produksi gratis tanpa batasan. [Cloudflare Quick Tunnels](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) juga ditujukan untuk pengujian dan pengembangan. Fitur helper/workflows cocok untuk mengevaluasi fitur ini; kelayakan layanan produksi tetap menjadi persyaratan penyebaran yang terpisah.

## rilis pengelola#

1. Lakukan commit dan tinjau kode kolektor, pengawas, definisi kontainer, serta serangkaian pengujian.
2. Simpan commit kolektor tersebut di `sealed-collector.yml`, lalu lakukan commit/tinjau alur kerja yang dapat digunakan kembali. Jangan pernah secara diam-diam menentukan checkout berdasarkan SHA pemanggil.
3. Sematkan commit alur kerja yang dapat digunakan kembali di `sealed-witness.yml` dan tambahkan pasangan SHA workflow/collector-nya ke `sealed_policy.json` dalam rilis tepercaya.
4. Publikasikan semua commit yang dirujuk beserta helper-nya, lalu uji fork independen dan sertifikat GitHub yang asli. Jangan menggabungkan (squash) commit yang dirujuk oleh pin-pin ini kecuali jika rujukan tersebut dibuat ulang dan dipublikasikan kembali.

Lihat [alur kerja yang dapat digunakan kembali dan pernyataan kepastian](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) untuk memahami perbedaan antara repositori pemanggil dan penandatangan hulu.
