Belgeler / 02
Telegram · GitHub Actions kaydı
Geçici bir GitHub çalıştırıcısında Takeout, normal API dışa aktarımı veya sohbet günlüğünü seçin.
Tam referans
TgWitness / Belgeler · Bağımsız yakalama
Önizleme, main sayfasından erişilebilir. Bir fork,
phishdestroy/TgWitness. İş akışı, yeni oluşturulan bir Telegram oturumu kullanarak bir hesabı, seçilen sohbetleri veya bir
sohbetin olay günlüğünü dışa aktarır, kanıt
ZIP dosyasını veya çok parçalı manifestoyu doğrular ve yalnızca
alıcı tarafından şifrelenmiş aktarımları yükler. Normal yönetim paneli görünür değildir.
Seç client=official_web , korumalı Telegram Web denetimleri ve video ile resmi istemci tanığını çalıştırmayı seçin. Bu, kendi yukarı akış proxy'nizi gerektirir ve bir adet görüntülenmiş sohbeti izler. Varsayılan client=api aşağıda açıklanan tam hesap dışa aktarma modlarını korur.
Doğrulayıcı, arşivi GitHub tasdiki, onaylanmış iş akışı ve toplayıcı commit’leri ile imzalı günlük ve ek hash’leriyle karşılaştırarak kontrol eder. Toplama işlemi, sabitlenmiş üst akış kodu ve yeni depolama alanı kullanır. Bir gözden geçiren, bu kodu inceleyebilir ve teslim edilen arşivi, kaydedilmiş çalıştırma işlemiyle karşılaştırarak doğrulayabilir.
Bu sayfada
- Kullanıcı akışı
- Oturum süresi bütçesi
- Bu modu veya kalıcı bir çalışma alanını seçin
- Neler kamuya açıktır ve neler gizli kalmalıdır?
- Sorun Giderme
- Yerel şifre çözme ve doğrulama
- Çatalın yakalama sürecinin dışında nasıl tutulduğu
- Kriptografik devir teslim
- Kapsam ve geçerlilik
- Sorumlunun sürüm yayınlama sırası
Kullanıcı akışı#
Yardımcı, beş aşamayı açıklar ve örnek veriler üzerinde mesaj ya da toplayıcı değiştirme işlemini denemenize olanak tanır. Kaydı başlat sihirbazı açar.
- Proje ana sayfasında,
çalışma alanı giriş ekranında veya Dışa Aktarımlar → Capture yardımcı programını aç seçeneğinden GitHub Actions capture (önizleme) seçeneğini seçin. Ayrıca,
resmi yardımcı programı
veya güvenilir bir checkout'tan
tgwitness/static/capture.htmldosyasını modern bir tarayıcıda açabilirsiniz. Yardımcı program, anahtar veya dosya işleme için herhangi bir ağ isteğinde bulunmaz. Yardımcı program, sitenin arayüz dillerini destekler; geçici toplama paneli İngilizce ve Rusça dillerini destekler ve tarayıcının dili bu dillerden biri ise tarayıcının dilinde açılır. - Bir anahtar oluşturun ve sealed-key.json dosyasını kaydedin. Bu, tek özel şifre çözme anahtarıdır. Alıcıya ait ayrı açık anahtar değerini kopyalayın. Özel anahtarı kaybetmeniz halinde hem bağlantıya hem de arşive erişiminizi kaybedersiniz. Bir sonraki adıma geçmek için dosyayı kaydettiğinizi onaylayın. Zaten bir teslimat dosyanız varsa, kaydedilmiş anahtarı yükleyin ve Zaten bir arşivim var seçeneğini seçin.
- TgWitness’i çatallayın, çatallamada “Eylemler” özelliğini etkinleştirin ve Mühürlü sohbet yakalama işlevini çalıştırın. Genel alıcıyı yapıştırın ve 30, 60 veya 120 dakika seçeneğinden birini belirleyin. Asla iş akışı girdilerine, commit’lere, sorun bildirimlerine veya günlük dosyalarına telefon numarası, oturum açma kodu, Telegram şifresi, özel anahtar veya oturum bilgilerini eklemeyin.
- Çalıştırma sırasında, Artifacts'tan sealed-connection dosyasını indirin ve sıkıştırmasını açın.
Yardımcı programda
connection.tgwsealedkaydedilmiş özel anahtarı kullanarak yardımcı programa yükleyin. Ortaya çıkan bağlantının URL parçasında rastgele bir erişim gizli anahtarı bulunur. Bu bağlantıyı gizli tutun. Panel, bu parçayı kaldırır ve gizli anahtarı bu sekmenin oturum depolama alanında saklar; HTTP erişim günlüklerine kaydedilmez. - Bağlantı bağlantısını açın. QR kodu ile veya telefon numaranız ve
giriş kodunuzla oturum açın. Telegram isterse iki aşamalı doğrulama şifrenizi girin.
Tıpkı normal çalışma alanında olduğu gibi, varsayılan olarak yerleşik API kimlik bilgileri havuzu kullanılır.
İsteğe bağlı özel kimlik bilgileri bölümünü genişletip her ikisini de
api_idveapi_hashmy.telegram.org/apps adresinden gelen bilgileri girebilirsiniz. Yerleşik havuzu kullanmak için her iki alanı da boş bırakın; eksik veya hatalı biçimlendirilmiş bir çift reddedilir. Oturum içe aktarmalarına izin verilmez. Dışa aktarma modunu ve kapsamını seçin. Bağlantı bağlantısı bir erişim gizli anahtarı içerir: bunu gizli tutun. - Telegram Takeout, Normal Telegram API veya Sohbet olay günlüğü seçeneklerinden birini seçin. Hesap dışa aktarımı için, erişilebilir tüm sohbetleri seçin ya da bir veya daha fazla sohbeti yükleyip seçin; ardından tarihleri, sohbet türlerini, hesap kategorilerini ve ek kurallarını ayarlayın. Ayarları ve boyutu kontrol edin, isterseniz ayarları bağımsız bir inceleme görevlisi için JSON olarak kaydedin, ardından Yakalamayı başlat'a basın. Ayarlar başlatıldıktan sonra değiştirilemez. Devam ettirme işlevi yalnızca bu çalıştırıcı varken çalışır; erken sonlandırma, elde edilen verileri korur ve boşlukları kaydeder. Başlatıldıktan sonra son tarihin dolması, açıkça kısmi bir arşiv oluşturur; başlatılmadan önce son tarihin dolması veya iptal edilmesi durumunda arşiv oluşturulmaz.
- Sealed-result dosyasını bekleyin, indirip arşivini açın ve
delivery.tgwsealedyardımcı programda şifresini çözün.delivery.zipiçindeevidence.zip,attestation.jsonlve talimatlar içerir. Tarayıcıda şifre çözme 256 MiB ile sınırlıdır; daha büyük paketler için aşağıdaki yerel akış komutunu kullanın. Büyük sonuçlar ayrıcadelivery-NNNNNN.tgwsealedparçalar içerir; anadelivery.tgwsealeddosyaevidence.parts.jsonve doğrulama belgesini içerir. Her parçayı indirin ve aşağıda açıklandığı gibi yerel olarak birleştirin. - İptal işlemi onaylanmadıysa veya çalıştırıcı sonlandırıldıysa, Telegram Ayarlar → Cihazlar bölümünden geçici oturumu sonlandırın. Normal bir işlem sonunda oturumdan çıkış istenir ve çalıştırma, iptal işleminin onaylanıp onaylanmadığını kaydeder.
Depo, yayınlanmış sabitlenmiş kaynak ve yeniden kullanılabilir iş akışı commit’lerini içermelidir. Yalnızca yerel bir dal, başka bir GitHub deposu tarafından çağrılamaz.
Oturum süresi bütçesi#
Toplamadan önce, Süre ve boyutu hesapla Seçilen geçmişi ve dosyaları, mesaj sayıları ve sınırlı bir örneklemden yola çıkarak tahmin eder. Ekranda, oturum açmak için halihazırda harcanan süre, tahmini toplama süresi ve paketleme için ayrılan süre gösterilir. Dosyalar için ilk tahmin, 1 MiB/s hızı ve iki kat zaman payı kullanır; ilerleme durumu, bu varsayımı ölçülen hızla değiştirir. Kullanım Yalnızca mesajlar ya da tahmini süre kalan süreyi aştığında daha az sohbet seçin.
Telegram'da bildirilen Takeout bekleme süresi bütçeye eklenir. Toplayıcı, kalan sürenin paketleme için gerekli olduğu durumda toplama işlemini durdurur, toplanan verileri saklar ve kısmi bir sonuç olarak işaretler. Dolayısıyla 120 dakikalık bir oturum, arşivi hazırlamadan önce son tarihi beklemek yerine kalan toplama süresini kullanır. Ekranda, tam boyutlu olarak örneklem alınamayan seçimler gösterilir.
Bu modu veya kalıcı bir çalışma alanını seçin#
| Çekim modu | Yapılandırılabilir kapsam | Fark |
|---|---|---|
| Telegram Takeout, varsayılan seçenek | Erişilebilir tüm bulut sohbetleri veya seçilen sohbetler, tarihler, hesap kategorileri, medya ilkeleri ve JSON/HTML görünümleri | Telegram’ın resmi dışa aktarma mekanizmasını kullanır; onay veya bekleme süresi gerekebilir. Takeout, Telegram’ın izin verdiği durumlarda sol kanalları/grupları listeleyebilir ve ek kişisel veriler talep edebilir. |
| Standart Telegram API'si | Normal API aracılığıyla kullanılabilen yöntemlere tabi olmak kaydıyla, aynı hesap kapsamı ve çıktı seçenekleri | Takeout başlatılmaz; sol kanalları/süper grupları listeleyemez veya yalnızca Takeout’a özgü kişisel verileri alamaz. Kişiler, kaydedilmiş telefon rehberinin tamamını değil, Telegram kullanıcılarını kapsar. İstek sınırlamaları hâlâ geçerlidir. |
| Sohbet etkinliği günlüğü | Seçilmiş bir sohbet, ek dosyaları ile ilgili kurallar ve isteğe bağlı avatarlar | Bu çalıştırma sırasında gözlemlenen geçmiş verileri ve değişiklikleri kaydeder. Hesap kategorileri, tarih filtreleri ve masaüstü uyumlu görünümler geçerli değildir. |
Üç modun tümü de aynı GitHub onayına ve şifreli aktarıma sahiptir. Takeout, veri toplama yöntemini seçer ve hiçbir zaman normal API erişimi ile sessizce değiştirilmez. TgWitness, yakalanan kayıtlardan JSON/HTML görünümlerini oluşturur ve dışa aktarımda seçilen veri toplama yöntemini korur. Resmi Takeout API’sine bakınız.
Varsayılan olarak Takeout kullanılır; arşivlenmiş sohbetler dahil tüm erişilebilir sohbet türleri, tüm tarihler, hesap profili ve kişiler, uyumlu JSON ve HTML dosyaları ile dosya indirmeleri. Başlangıç medya bütçesi 4 GiB’dir ve tür bazında görünür dosya sınırları vardır; daha büyük dosyalar veya tükenmiş indirme bütçeleri durumunda, mümkün olduğunda sunucu hash’leri kullanılır. Toplamadan önce bu sınırları gözden geçirin. Hash’ler bir dosyayı yeniden oluşturamaz. İsteğe bağlı fotoğraflar, hikayeler, oturum meta verileri ve ek kişisel veriler ayrı seçenekler olarak kalır.
Takeout işlemi, mevcut bir Telegram oturumunda onay gerektirebilir. Gecikme süresini Telegram belirler; yeni bir oturum açma veya çalıştırma işlemi bu gecikmeyi atlayamaz. Maksimum yakalama süresi, oturum açma ve onay dahil olmak üzere 120 dakikadır; bu nedenle, büyük bir hesap veya uzun bir onay bekleme süresi nedeniyle işlem tamamlanmayabilir. Kalıcı bir yerel dışa aktarım, aynı oturumu devam ettirebilir, ancak GitHub doğrulamasını devralmaz.
Ayarları onaylayın ve doğrulayın#
Ayarları ve boyutu kontrol ettikten sonra, doğrulama amacıyla Ayarları Kaydet seçeneğini kullanın. Sonuçta ortaya çıkan
ayarları sealed-export-settings.json toplama işleminden önce gözden geçirenle mutabık kalın.
Değişiklikler, kaydedilmiş değerlendirmeyi geçersiz kılar. Toplayıcı, geçerli
ayarları ve bunların SHA-256 değerini imzalar; hesap dışa aktarma makbuzları da aynı seçenekleri bağlayıcı hale getirir.
Doğrulayıcı, gerçek modu, seçimi ve eksiksizliği bildirir ve dergi ile iç içe geçmiş hesap dışa aktarma arasında
bir uyuşmazlık olması durumunda bunu reddeder.
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete
--expected-selection farklı bir aktarım, sohbet kapsamı, filtre veya
ek politikasını reddeder. --require-complete Yalnızca hesap dışa aktarımlarını ve
tamamlanmış olarak kaydedilmiş sohbet günlüklerini kabul eder. Bu bayraklar olmasa bile, doğrulama işlemi yine de kaynağı ve
bütünlüğü kontrol ederken, kaydedilmiş ayarları ve eksiklikleri raporlar. Çalıştırmadan önce beklenen
seçimi kararlaştırın ve bunu arşivden ayrı tutun. Kapsam ve toplama aralıkları, çalıştırma sırasında yakalanan materyali tanımlar;
önceki sürümleri karşılaştırırken, saklanan önceki gözlemleri kullanın.
| İhtiyaç | Mod |
|---|---|
| Sınırlı süreli bir oturum sırasında erişilebilir hesap verilerini veya seçilen sohbetleri dışa aktarın ve denetçiye harici olarak tasdik edilmiş bir arşiv sunun | GitHub Actions ekran görüntüsü (önizleme) |
| Birkaç sohbeti sürekli olarak takip edin, hesapları yönetin, giderek büyüyen bir arşivi arayın ve okuyun | Yerel veya Docker çalışma alanı |
Bu işlem, yeni bir oturum açma bilgisiyle ayrı bir yakalama işlemini başlatır. Mevcut yerel günlüğünüzü yüklemez, o anda açık olan çalışma alanını dışa aktarmaz veya Telegram oturumunu yeniden kullanmaz. Tamamlanmamış bir bulut yakalama işlemi, çalıştırıcısı sonlandırıldıktan sonra devam ettirilemez; yeni bir iş akışı, yeni bir yakalama işlemini başlatır.
Çalışma alanındaki Dışa Aktarma → Yakalama Yardımcısını Aç seçeneği, panelin içinde sihirbazın tamamını açar. Bağımsız sayfa da aynı sihirbazı, denetimleri ve temaları kullanır. Her ikisi de anahtarları ve şifre çözme işlemlerini tarayıcınızda tutar. GitHub iş akışı başlatma işlemi ve geçici Telegram paneli ayrı sekmelerde açılır; sihirbaz, ne zaman geri dönmeniz gerektiğini size bildirir. Çalışma alanını kilitlediğinizde, sihirbazın bellekteki anahtarı silinir. Kaydettiğiniz anahtar dosyası cihazınızda kalır.
Neler kamuya açıktır ve neler gizli kalmalıdır?#
Toplama işlemi, GitHub tarafından barındırılan standart bir çalıştırıcı üzerinde gerçekleştirilir. Onaylanmış toplayıcı olan GitHub, bağımlılıklar, yardımcı sayfa, tarayıcı ve HTTPS tüneli, bu kurulumun güvenilir bileşenleridir. Geçici sunucu, Telegram oturumunu ve düz metin mesajlarını işler; teslim edilen veriler alıcı için şifrelenir.
Proje kodunun kopyaları, fork işlemiyle deponuza eklenir. Bu işlem değil Telegram
hesabınızı dışa aktarın. Alıcı iş akışı girdisi, bir genel şifreleme anahtarıdır.
Saklayın sealed-key.json, Telegram kimlik bilgileri, oturum açma kodları, 2FA şifreleri ve
şifresi çözülmüş bağlantı URL’si; bunlar, commit’lerden, iş akışı girdilerinden ve herkese açık günlüklerden elde edilir.
Bu iş akışı, şifrelenmiş bağlantı ve sonuç öğelerini bir gün boyunca yayınlar. Her ikisini de zamanında indirin; GitHub Actions’ın kullanılabilirliği, hesap sınırları ve faturalandırma koşulları geçerlidir. Herkese açık bir fork, sınırsız ücretsiz hesaplama gücü garantisi anlamına gelmez. Yardımcı programa herhangi bir ödeme bilgisi veya GitHub erişim jetonu girilmez.
Özel şifre çözme anahtarı tarayıcınızda/dosyanızda kalır. Telegram oturum verileri ve düz metin gözlemleri zorunlu olarak geçici depolama alanında bulunur. GitHub ve HTTPS tüneli güvenilir altyapı olarak kalır. Doğrulama işlemi, arşiv özetini ve iş akışı kimliğini kamuya açık hale getirebilir; arşiv içeriği ise doğrulama belgesine dahil edilmez. Doğrulama zaman damgası, mesaj zaman damgası değildir.
Sorun Giderme#
| Belirti | Sonraki adım |
|---|---|
| İş Akışı Çalıştırılmadı düğmesi | Kendi fork’unuzu açın, Actions özelliğini etkinleştirin ve bunu ana dal ile senkronize edin main. Bir hatayı atlatmak için onaylanmış upstream pinlerini düzenlemeyin. |
Hayır sealed-connection eser |
İşin başlatılıp başlatılmadığını ve başlatma/yükleme aşamasını tamamlayıp tamamlamadığını kontrol edin. Kuyruk, çalıştırıcı, görüntü indirme, tünel veya depo politikasındaki hatalar, başlatma işleminin gerçekleşmesini engelleyebilir. |
| Bağlantı açılamıyor | Bu çalıştırma için kaydedilmiş anahtarı yükleyin, indirilen dosyayı açın ve connection.tgwsealedseçeneğini seçin. Çalıştırıcı hala aktif durumda olmalıdır. |
| Tarih duraklatıldı | Panelin durumunu kontrol edin ve oturum aktifken “Devam Et” seçeneğini kullanın ya da toplanan verilerle işlemi tamamlayın. Telegram’daki sınırlamalar ve erişilemeyen içerikler bazı boşluklara neden olabilir. |
Hayır sealed-result |
Toplama işlemi başlamadan önce iptal edilmesi veya süresinin dolması durumunda arşiv oluşturulmaz; bu durumda işlem, Arşiv yok uyarısıyla sona erer. Toplama, onaylama veya paketleme adımlarından birinin başarısız olması da teslimatı engeller; başarısız olan adım, kişisel veriler içermeden denetçinin gerekçesini belirtir. Kimlik bilgilerini girmeden bunu inceleyin. |
| Tarayıcı, büyük boyutlu bir arşivi şifresini çözemiyor | 256 MiB'den büyük paketler için aşağıdaki streaming CLI'sini kullanın. Yanlış veya kaybolmuş bir özel anahtarla sonucun şifresi çözülemez. |
| Doğrulama işlemi, imzalayanı reddediyor | Güvenilir ve güncel bir TgWitness kurulumunu ve tam çağrı kaynağını kullanın OWNER/REPOSITORY. Arşivle birlikte sağlanan yedek politikayı kabul etmeyin. |
| Telegram, geçici oturumu hâlâ listeliyor | Bunu Ayarlar → Cihazlar bölümünden sonlandırın. Oturum kapatma işlemi başarısız olabilir ve zorla sonlandırılan iş akışı temizleme işlemini gerçekleştiremeyebilir. |
Bu önizlemeye güvenmeden önce, kontrolünüz altında olan küçük bir sohbet deneyin: bir mesaj ve ek oluşturun, bunları toplayın, sonucun şifresini çözün, doğrulayıcıyı çalıştırın, kapsam/medya sonuçlarını kontrol edin ve Telegram oturumunun iptal edildiğini teyit edin. Otomatik kontroller, sentetik bir Telegram istemcisi ile ayrı bir gerçek GitHub sertifika testi kullanır; mevcut sürümde canlı hesapla yapılan herhangi bir çalıştırma kaydedilmemiştir.
Yerel şifre çözme ve doğrulama#
Bilinmeyen bir kanıt arşivinden sağlanan yürütülebilir dosyaları değil, bağımsız ve güvenilir bir kurulumdan gelen araçları kullanın:
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
Birden fazla parçadan oluşan teslimatlarda, önce ana paketi şifresini çözün ve çıkarılan manifest dosyasını her şifreli parçanın yanına koyun, ardından şu komutu çalıştırın:
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, onaylanmış nesnedir ve her bir parçayı ve birleştirilmiş ZIP dosyasını birbirine bağlar.
Büyük bir arşiv için uygun bir sıkıştırılmamış doğrulama üst sınırı belirlemek üzere --max-gib komutunu kullanarak büyük bir arşiv için uygun bir sıkıştırılmamış doğrulama sınırı
belirleyin; varsayılan değer 4 GiB'dir. Beklenen seçim ve tam kapsam kontrolleri
çok parçalı teslimatlarda da çalışır.
Python 3.11 ve üzeri, projenin bağımlılıkları ve
--signer-digest ve --deny-self-hosted-runners destekleyen güncel bir GitHub CLI gereklidir. Ayrıca bir CLI anahtar oluşturucu
da mevcuttur: python -m tgwitness.sealed_crypto keygen sealed-key.json.
Doğrulayıcı, tgwitness/sealed_policy.json güvenilir kurulumdan alır.
Arayan depoyu, üst akış imzalayıcı iş akışını, onaylanmış imzalayıcı
taahhüdünü, barındırılan çalıştırıcı gereksinimini, eksiksiz ZIP özetini, dahili günlük ve
ek bütünlüğünü, yeni hesap anahtarı kaynağını ve beklenen toplayıcı taahhüdünü kontrol eder.
Tüm verilerin kaydedildiğini ima etmek yerine geçmişi ve ortam sonuçlarını görüntüler.
Boş bir onaylanmış sürüm listesi, "kapalı" olarak değerlendirilir. İlkenin güncellenmesi açık bir
güven kararını gerektirir; bir arşivin kendi önerdiği ilkeyi asla otomatik olarak kabul etmeyin.
Çevrimdışı kullanım için, güvenilir bir ortamdan önceden güvenilir kök sertifikaları edinin:
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
Onayın zaman damgası, arşivin taahhüdüyle ilgilidir. Bu, mesajların zaman damgalarını veya toplayıcının duvar saatini doğrulamaz. GitHub’ın doğrulama seçeneklerine bakınız.
Çatalın yakalama sürecinin dışında nasıl tutulduğu#
Çağırıcı, yukarı akıştaki yeniden kullanılabilir iş akışına iş düzeyinde bir referans içerir;
bu referans tam bir commit SHA’sına aittir. Söz konusu iş akışı, yukarı akış deposunu
sabit bir toplayıcı SHA’sında açıkça kontrol eder. Yeniden kullanılabilir bir iş akışındaki actions/checkout , çağrı yapanı kontrol eder ve kasıtlı olarak kullanılmamaktadır.
Bu iş akışı, çağıran tarafın önbelleklerini geri yüklemez, çağıran tarafın yapılarını kullanmaz, çağıran tarafın dosyalarını çalıştırmaz veya kaynak/görüntü URL’lerini, kabuk komutlarını, önceden hazırlanmış ZIP dosyalarını ya da imzalanacak hash değerlerini kabul etmez. Sınırlı sayıda genel alıcı ve oturum süresi kabul eder. Eylemler, Python temel görüntüsü ve cloudflared, değiştirilemez özetlerle sabitlenir; Python bağımlılıkları, mevcut hash kilitli gereksinimleri kullanır. Görüntü, önbellek kullanılmadan güvenilir kaynaktan oluşturulur.
Toplayıcı, salt okunur bir görüntü, devre dışı bırakılmış Linux yetkileri, kaynak sınırlamaları ve Docker soketi ya da GitHub jetonu ortamı bulunmayan bir root dışı kullanıcı olarak çalışır. Tek bağlama noktaları, yeni yapılandırma, çalışma alanı ve çıktı dizinleridir. Kısıtlanmış FastAPI uygulaması, oturum açma, diyaloglar, yapılandırılabilir hesap veya sohbet koleksiyonu, durum, devam ettirme, bitirme ve iptal işlevlerini sunar. Düz metin indirme yolu, genel yönetim yolu, içe aktarma yolu veya imzalama uç noktası bulunmamaktadır.
Denetçi, doğrulama işlemi
son düzeltilmiş sürümü okumadan önce ağa açık konteynerleri durdurur evidence.zip veya evidence.parts.json. Paketleme konteynerinde ağ bağlantısı yoktur.
Yükleme adımlarında yalnızca connection.tgwsealed ve delivery*.tgwsealed;
ne düz metin kanıtları ne de Telegram kimlik bilgileri artefakt olarak yüklenmez.
Temizleme işlemi özel dizinleri ve konteynerleri kaldırır ve GitHub, işin ardından
barındırılan çalıştırıcı sanal makinesini siler. Artefakt saklama süresi bir gündür; süresi dolmadan indirin.
Bir fork sahibi, çağrı yapanı değiştirebilir veya farklı bir imzalı dosya oluşturabilir. Sıkı doğrulayıcı, ortaya çıkan farklı imzalayıcı iş akışını/özetini reddetmelidir. Bu yapı, hâlâ onaylanmış kodda istismar edilebilir hataların bulunmamasına ve GitHub’ın çalıştırıcı ile imzalama altyapısının bütünlüğüne bağlıdır.
Kriptografik devir#
Her alıcı anahtarı RSA-3072’dir (RSA-4096 içe aktarmaları da kabul edilir), üs 65537’dir. Her zarf, yeni oluşturulmuş rastgele bir AES-256 anahtarı ve 96 bitlik bir nonce içerir. RSA-OAEP, SHA-256/MGF1-SHA256 ile AES anahtarını sarar. 128 bitlik etiket içeren AES-GCM, ön eki ve yükün tamamını doğrular. Alıcının açık anahtarı base64 formatında DER SPKI'dir; gizli anahtar dosyası ise base64 formatında DER PKCS8 içerir.
Zarf baytları şunlardır: TGWSEAL1\n, big-endian uint32 JSON başlık uzunluğu,
başlık, şifreli metin ve 16 baytlık bir GCM etiketinden oluşur. Başlık tam olarak algorithm,
keyve nonce; algoritma RSA-OAEP-256+A256GCM. Başlık boyunca uzanan tam önek
, GCM ek kimlik doğrulamalı verileridir. Başlık boyutu
8192 bayt ile sınırlıdır. CLI, 8 GiB'a kadar yükleri aktarır ve istenen çıktıyı
yüklemeden önce kimlik doğrulaması yapar; mevcut bir hedefin üzerine yazmayı reddeder.
Bu, standart kriptografik temel öğeleri çevreleyen projeye özgü bir zarftır:
SHA-256 ve AES-256-GCM ile RSA-OAEP; OpenSSL ve tüm büyük
kriptografi kütüphanelerinde mevcuttur.
Orijinal kanıt baytları, kanıt ve doğrulama bilgisi şifrelenmiş dış pakete yerleştirilmeden önce doğrulanır. Bu, arşivin hash değeri ile aynı arşivin içinde yer alan bir sertifika arasında döngüsel bir bağımlılığın ortaya çıkmasını önler. Halka açık depolar için, doğrulama meta verileri (depo, iş akışı, commit, artefakt adı ve özet) herkese açıktır. Halka açık meta verilere asla sohbet adları eklemeyin.
Kapsam ve doğrulama#
Bu mod, imzalı günlük ve hesap dışa aktarma motorunu kullanır. Gizli Sohbetler, toplamadan önceki silinmiş geçmiş ve hesabın erişemediği veriler dışarıda tutulur. Özel bulut sohbetleri, seçildiğinde dahil edilir. Sohbet seçici 20.000 diyalog ile sınırlıdır; hesap dışa aktarma kendi envanterini belirler. Eksik veriler, hatalı dosyalar ve tamamlanmamış görevler kaydedilir. Ek sınırları ve çalıştırıcı disk/zaman sınırları hâlâ geçerlidir. Büyük boyutlu aktarımlarda, sabit 4 GiB aktarım sınırı yerine şifrelenmiş parçalar kullanılır. Tamamlanma, seçilen dondurulmuş görevlerin bittiği anlamına gelir; arşivde her bir geçmiş Telegram kaydının mevcut olduğu anlamına gelmez. Sohbet günlüğü ayrıca canlı güncellemeleri de izleyebilir; her iki mod da atomik bir anlık görüntü değildir. Oluşturulan ekran görüntüleri ve ekran kayıtları bu modun bir parçası değildir.
Testler, sentetik yeni oturum açma, kapsam yalıtımı, medya, iptal, kısmi son tarih tamamlama, başarısız oturum kapatma, yasaklanmış API yolları ve alanları, önceden yüklenmiş çalışma alanının reddi, yanlış anahtar ve tahrifat reddi, zorunlu doğrulayıcı bayrakları ve tarayıcı/Python şifreleme arası çalışabilirliği kapsamaktadır. Tarayıcı kabul testi, açıkça etiketlenmiş sahte bir doğrulama belgesi kullanır; bu, gerçek bir Sigstore testi değildir. Gerçek barındırılan çalıştırıcı, Docker, GitHub tasdiki ve canlı Telegram kabul testleri, yerel sentetik kontrollerden ayrı olarak raporlanmalıdır.
GitHub Actions şartları , barındırılan çalıştırıcıların kullanımını yazılım projesinin yaşam döngüsüyle sınırlamaktadır. Bir fork, bu kısıtlamaları ortadan kaldırmaz; bu önizleme sürümü, kısıtlamasız ücretsiz üretim barındırma hizmeti olarak pazarlanmamalıdır. Cloudflare Quick Tunnels da test ve geliştirme amaçlıdır. Helper/workflow’lar, bu özelliği değerlendirmek için uygundur; üretim hizmetine uygunluk ise ayrı bir dağıtım gerekliliği olmaya devam eder.
Sorumlunun sürüm yayınlama sırası#
- Toplayıcıyı, denetleyiciyi, konteyner tanımını ve testleri kaydet ve gözden geçir.
- O toplayıcı taahhüdünü
sealed-collector.yml, ardından yeniden kullanılabilir iş akışını commit edin/inceleyin. Asla çağıran SHA'dan sessizce checkout türetmeyin. - Yeniden kullanılabilir iş akışı taahhüdünü
sealed-witness.ymlve bunun workflow/collector SHA çiftinisealed_policy.jsongüvenilir bir sürüme ekleyin. - Bahsedilen tüm commit’leri ve yardımcı dosyayı yayınlayın, ardından bağımsız bir fork’u ve gerçek GitHub sertifikasını test edin. Referanslar yeniden oluşturulup tekrar yayınlanmadıkça, bu pin’ler tarafından referans gösterilen commit’leri birleştirmeyin.
Arayan depo ile üst akış imzalayıcısı arasındaki fark hakkında bilgi edinmek için yeniden kullanılabilir iş akışlarına ve onay belgelerine bakınız.