Referans / Kurulum
Phala / Intel TDX · Yüksek güvenilirlikli dağıtım
Hetzner veya Phala Cloud üzerinde 7/24 çalışan, mühürlenmiş bir sunucu, Gateway DNS ve üçüncü tarafların tekrarlayabileceği kontroller.
TgWitness / Belgeler · Dağıtım ve kurtarma
Yüksek güvenilirlikli dağıtım, arşiv doğrulamasına toplama ortamının bağımsız kontrollerini de ekler. İnceleme görevlisi, bulut sağlayıcısı ve Cloudflare tarafından tutulan dağıtım ve erişim kayıtlarını sorgular; ayrıca Intel TDX dağıtımı, toplayıcının ortamına ilişkin donanım doğrulamasını da ekler.
Sıradan yerel ve Docker kullanımı değişmemiştir.
python -m tgwitness.cloudkomutuyla dağıtmadıkça hiçbir şey çalışmaz ve toplayıcı, yalnızca dağıtım ayarlandığında ana bilgisayarını okur
TGWITNESS_ASSURANCE.
Diyagramın metin olarak gösterimi
- Operatör → Sunucu, gelen trafiğe izin vermeyen güvenlik duvarı (sağlayıcı API'si)
- Operatör → Tünel ve DNS (Cloudflare API'si)
- Sunucu, gelen trafiğe izin vermeyen güvenlik duvarı → Tünel ve DNS (sadece giden)
- Sunucu, gelen trafiğe izin vermeyen güvenlik duvarı → Sunucuda oluşturulan imzalama anahtarı
- Verifier, salt okunur belirteçler → Sağlayıcı günlüğü ve güvenlik duvarı
- Verifier, salt okunur belirteçler → Tünel bağlayıcı adresi ve giriş
- Verifier, salt okunur belirteçler → İmzalı /api/assurance beyanı
- Verifier, salt okunur belirteçler → Kanıt ZIP dosyası
Bu sayfada
- Bir doğrulayıcının kontrol edebileceği şeyler
- Sağlayıcılar
- Phala Cloud üzerinde Gizli VM (Intel TDX)
- Başlamadan önce
- Panelden
- Etki alanı gerektirmeyen hızlı tünel
- Dağıt
- Hata ayıklama dağıtımı ve kilitleme
- Dağıtımı kaldır
- Herhangi bir sunucu (kendi kendini doğrulamış)
- Doğrula
- Kanıt teslimi raporu
- Dış tanık olarak Cloudflare
- Dağıtım sonucunu okuma
Bir doğrulayıcının kontrol edebileceği şeyler#
| İddia | Nasıl kontrol edilir? | Yöneten: |
|---|---|---|
| Sunucu, bilinen bir zamanda sağlayıcı API'si aracılığıyla oluşturuldu | Sunucu nesnesi ve sağlayıcının kendi günlüğünde oluşturulması | Sağlayıcı |
| Hiç kimse sağlayıcının erişim yollarını kullanmadı | Konsol istekleri, kurtarma, şifre sıfırlama, yeniden oluşturma, ISO, görüntüler ve yedeklemelerin günlüğü | Sağlayıcı |
| Hiçbir şey buna bağlanamadı | Sağlayıcının güvenlik duvarında gelen trafiğe ilişkin kural yoktur; SSH, ilk açılışta gizlenir. | Sağlayıcı (güvenlik duvarı), ana bilgisayar (SSH) |
| Panele yalnızca tünel üzerinden erişilebilir | Tünel girişi yalnızca panele yönlendirilir; konektör sunucunun adresinden çalışır | Cloudflare |
| Bu yazılım tam olarak şu şekilde çalışır: | Toplayıcının imzalanmış kaynak ağacı hash değeri, dağıtılmış commit'in bir kopyasına eşittir | Collector, Git ile karşılaştırılarak kontrol edilir |
| İmza anahtarı o sunucuda oluşturuldu | Anahtar, sağlayıcının sunucu kimliğini ve aldığı cloud-init'in hash değerini belirten bir beyanı imzalar | Collector, sağlayıcıyla karşılaştırılarak kontrol edilir |
| Günlük, o anahtara ve sunucuya aittir | ZIP kanıtındaki her işlem başlangıcı, o sunucu için ana bilgisayar ölçümünü içerir | Kanıt ZIP |
| Telegram anahtarı, doğrulanmış çalıştırma sırasında oluşturuldu | account.authorized, key_origin: "created" değerini kaydeder |
Kanıt ZIP |
Toplayıcı, SSH durumunu, oturumları, oturum açma geçmişini ve önyükleme bilgilerini imzalı
process-start ve host.state kayıtlarında kaydeder. Sıradan bir sanal makinede bunlar yerel envanter
kayıtlarıdır ve denetçi bunları sağlayıcının bağımsız kayıtlarıyla karşılaştırır. Aşağıdaki
Intel TDX dağıtımı, donanım destekli ölçümleri de ek olarak doğrular.
Onaylı bir dağıtım, içe aktarılan bir oturum anahtarı üzerinden veri toplamaz. Telefon veya
QR ile oturum açın ya da bağımsız bir oturum açma için oturum dosyasını kullanın: her iki durumda da Telegram
yetkilendirme anahtarı onaylı çalıştırma içinde oluşturulur, günlük
key_origin: "created" kaydeder ve python -m tgwitness.cloud verify komutu
account_key değerini geçer. İçe aktarılmış bir anahtara sahip günlük bu kontrolü geçemez.
Sağlayıcılar#
--provider |
Kimlik Bilgileri | Doğrulayıcının salt okunur erişimi | Doğrulayıcı için sağlayıcı günlüğü | Şu amaçla tutulur: |
|---|---|---|---|---|
hetzner |
HCLOUD_TOKEN |
Aynı projenin okuma jetonu | Sunucu ve güvenlik duvarı işlemleri | Kaynaklar mevcut olduğu sürece |
digitalocean |
DIGITALOCEAN_TOKEN |
Salt okunur kişisel erişim jetonu | Droplet eylemleri | Droplet mevcut olduğu sürece |
linode |
LINODE_TOKEN |
linodes, firewall, events salt okunur kapsamlar |
Hesap olayları, güvenlik duvarı kural sürümleri | 90 gün |
vultr |
VULTR_API_KEY |
Okuma erişimi olan ve activity_logs izin |
Hesap etkinlik günlüğü (yöntem, yol, aktör) | 30 gün; denetim günlüğü aboneliği ile daha uzun süre |
aws |
AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY |
ec2:DescribeInstances, ec2:DescribeSecurityGroups, cloudtrail:LookupEvents |
CloudTrail olay geçmişi | 90 gün |
phala |
PHALA_CLOUD_API_KEY |
Aynı çalışma alanına ait bir API anahtarı | Uygulama revizyonları ve CVM işlemleri: Docker Compose yapılandırması ve ortam değişiklikleri, yeniden başlatmalar, işletim sistemi yükseltmeleri | Uygulama mevcut olduğu sürece |
generic |
yok | yok | yok: kendi kendini doğrulamış | – |
Her vaka için ayrı bir proje, ekip, hesap veya alt hesap kullanın: doğrulayıcının
salt okunur erişimi, yalnızca bu dağıtımı gösterir. Kimlik bilgileri,
--provider-token-file yukarıdaki değişkenden okunur, asla komut satırından okunmaz. AWS için dosya
şunu içerir ACCESS_KEY_ID SECRET_ACCESS_KEY [SESSION_TOKEN]; bölge --location.
Her rapor, her sağlayıcının kayıtlarının kapsamını belirtir. Kısaca: Hetzner konsol isteklerini günlüğe kaydeder; DigitalOcean’ın Kurtarma Konsolu, Linode’un Lish/Glish’i ve Vultr’un web konsolu bu şekilde günlüğe kaydedilmez, bu nedenle root ilk önyüklemede kilitlenir ve bir konsol oturumu için şifre sıfırlama veya önyükleme değişikliği gerekir; bunlar ise günlüğe kaydedilir. Vultr, konsol adresini, örneği okuyabilen herhangi bir anahtara döndürür; ne kayıtta ne de raporda bu adres saklanır.
Phala Cloud üzerindeki Gizli VM (Intel TDX)#
Toplayıcı --provider phala toplayıcı, dstack tarafından yönetilen Phala Cloud üzerindeki bir Intel TDX gizli sanal makinesinde
çalışır. Barındırıcı ve Phala personeli, makinenin
belleğini okuyamaz ve işlemci, makinenin neyle önyükleme yaptığına dair bir tasdik belgesi imzalar. Doğrulayıcı,
Phala’nın sözüne güvenmez: tgwitness.tdx her bir tasdiki, sabitlenmiş Intel
SGX Kök Sertifika Yetkilisi'ne kadar, Intel'in iptal listeleri ve Intel'in imzalı platform verileriyle karşılaştırarak kendisi kontrol eder ve hata ayıklanabilen veya taşınabilen
makineleri reddeder.
| Rapor girişi | Neleri gösterir? |
|---|---|
tdx_binding |
Onay belgesi, toplayıcının imzalı beyanını ve bu isteğin rastgele değerini kapsar. |
tdx_quote |
Intel, bu tasdiki garanti eder; ancak Intel, platformu güncel olarak değerlendirdiğinde onay verilir. |
tdx_compose_hash |
dstack olay günlüğünden yeniden oynatılan RTMR3, toplayıcının raporladığı uygulama oluşturma işlemlerini ölçer. |
tdx_compose |
Bu kod, dağıtılan commit'in derlediği kodun bayt bayt aynısıdır: kaynak dosyalar hash ile, her iki görüntü de özet ile sabitlenmiştir; başka hiçbir kod yoktur. |
tdx_identity |
Doğrulama, Phala'nın KMS'sinden alınan anahtarlar ve şifrelenmiş bir disk ile birlikte, devreye alınmış uygulama ve örneğinden sağlanır. |
tdx_os |
MRTD ve RTMR0-2, doğrulayıcının Dstack-TEE tarafından yayınlanan dstack işletim sistemi görüntüsünden hesapladığı değerlere eşittir; bu değerler, CVM'nin bildirdiği işletim sistemi görüntüsü hash'i ve QEMU'nun sanal makinenin yapısı için oluşturduğu ACPI tablolarından elde edilir: bellenim, çekirdek, initrd, kök dosya sistemi hash'ini içeren komut satırı, bellek, vCPU'lar ve aygıtlar. Bir geliştirme görüntüsü başarısız olur |
İşletim sistemi görüntüsü (yaklaşık 180
MB, bunun 21
MB'si saklanır) bir kez
Dstack-TEE/meta-dstack
adresinden
dstack-images
klasörüne, kaydın yanına indirilir; --tdx-image FOLDER
seçeneği başka bir klasör veya açılmış bir görüntü kullanır,
--tdx-image none
seçeneği karşılaştırmayı atlar. Ölçüm, Dstack-TEE/dstack'teki dstack-mr
ve qemu-acpi
kutularını takip eder. Özel ölçüm regresyonları, QEMU'nun kendi ACPI
çıktısını ve saklanan bir Phala Cloud alıntısını karşılaştırır; canlı yeterlilik testi için yayınlanmış görüntü de gereklidir.
--tdx-measurements
, bunun yerine JSON olarak verilen MRTD ve RTMR0-2
'yi karşılaştırmaya devam eder.
Günlüğe kaydedilen her toplayıcı başlatma işlemi böyle bir doğrulama içerir, bu nedenle
verify --evidence her başlatma işlemini ve önyüklenen işletim sistemi görüntüsünü kontrol eder. Phala'nın uygulama revizyonları
ve CVM'nin işlemleri sağlayıcı günlüğü işlevi görür: dağıtımdan sonra değiştirilen bir Docker Compose yapılandırması
raporun geçersiz kalmasına neden olur ve yeniden başlatmalar inceleme için listelenir.
Panelde, Daha fazla araç → Ekstralar → Sunucu 24/7 altında Gizli sanal makine · Phala Cloud seçeneğini seçin ve bir Phala Cloud API anahtarını yapıştırın; hızlı tünel, Hetzner’da olduğu gibi çalışır. Komut satırından:
python -m tgwitness.cloud deploy --provider phala --name case-1 --server-type tdx.small \
--ref v0.8.0 --repository https://github.com/phishdestroy/TgWitness --quick-tunnel \
--provider-token-file phala-key.txt
python -m tgwitness.cloud verify --record deployments/case-1/deployment.json \
--provider-token-file phala-key.txt --cloud-init deployments/case-1/docker-compose.yaml \
--source CHECKOUT_OF_COMMIT --fingerprint COLLECTOR_FINGERPRINT --report certificate.md
python -m tgwitness.cloud check-report --report certificate.pdf --verifier-fingerprint VERIFIER_KEY
--tdx-collateral Intel'in sertifikalarını ve iptal listelerini Intel'den indirmek yerine
bir dosyadan okur. Gateway DNS burada kullanılamaz: Phala'da giden trafik için sağlayıcı güvenlik duvarı
bulunmamaktadır.
verify --source komutu, aldığınız kod kopyasından referans yükleyiciyi oluşturur; bu yükleyici, söz konusu
kod kopyasının kodunu bu bilgisayarda çalıştırır. Resmi depo dışındaki bir depodan yapılan
dağıtımlarda, verify komutu, --trust-source parametresini de belirtmediğiniz sürece işlemi reddeder; bunu yalnızca
içeriğini incelediğiniz bir kod kopyası için yapın.
verify.py ile çevrimdışı kontrol#
Phala hesabı olmayan bir alıcı, tek başına çalışan doğrulayıcıyla teklifleri çevrimdışı olarak kontrol eder:
python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_FINGERPRINT
python verify.py phala-tdx-attestation.json
Bir kanıt arşivindeki her process.started kaydının alıntısı için ve
imzalı bir toplayıcı beyanının alıntısı için (ayrıca bir dağıtım kaydında veya yayınlanmış bir tasdik kaydında),
verify.py, alıntının ECDSA P-256 imzasını tasdik anahtarıyla, alıntı yapan
enklav raporunun imzasını PCK sertifikasıyla karşılaştırarak, bu raporun tasdik anahtarını
(anahtarın SHA-256'ı ve QE kimlik doğrulama verileri) belirtip belirtmediğini, üretimin üretim modundaki Intel'in TDX alıntı
enklavından gelip gelmediğini ve PCK sertifikası → Intel SGX PCK Platformu veya İşlemci
CA → Intel SGX Kök CA zincirini kontrol eder; bu zincirin SHA-256 değeri verify.py dosyasında sabitlenmiştir. Hata ayıklanabilir veya
taşınabilir TD'leri reddeder, REPORTDATA'nın başlangıç kaydının (günlük anahtarı, çalıştırma, kaynak
ağacı, ana bilgisayar) veya imzalı ifadenin SHA-512 değeri olup olmadığını kontrol eder ve MRTD, RTMR0-3 ile REPORTDATA değerlerini yazdırır.
Toplayıcı ayrıca, Intel'in hizmeti yanıt verdiğinde her alıntıyla birlikte Intel'in teminatlarını (TCB Bilgisi, QE Kimliği, iptal listeleri ve bunların
düzenleyici zincirleri) depolar. Bununla birlikte, verify.py, Intel'in
imzalarını ve iptal listelerini kontrol eder ve kaydedilen zamana göre veya
teminatın düzenlenme tarihi daha geç ise o tarihe göre TCB durumunu hesaplar. Bu olmadan sonuç "TCB durumu
kontrol edilmedi (arşivde teminat yok)" şeklinde görünür. VM'nin hangi kodu çalıştırdığı (RTMR3 ölçümlerini oluşturan,
MRTD ve RTMR0-2'nin arkasındaki işletim sistemi görüntüsü), sağlayıcı günlüğü ve Intel'in güncel derecelendirmesi,
python -m tgwitness.cloud verify komutunun kontrollerinde kalır; bu nedenle çevrimdışı kontrol, onaylanmış toplama çalışmasını
kısmi olarak işaretler ve tek başına sealed kademesine veya attested profiline ulaşmaz.
Doğrulama sertifikası#
Bir Phala dağıtımı için verify --report certificate.md ayrıca sertifikayı da yazar:
bağımsız bir certificate.html ve bir A4 certificate.pdf dosyası; bu dosyalarda karar, Intel'in kök sertifikasından toplayıcı anahtarına kadar uzanan güven zinciri,
standart ve yüksek güvenilirlikli sunucularla karşılaştırma,
yayınlanan görüntüden hesaplanan değerlerin yanındaki ölçümler, her bir
bölümün garantörleri, Intel sertifika zinciri, her kontrol, sağlayıcı günlüğü ve
doğrulamanın nasıl tekrarlanacağı yer alır. JSON raporu resmi kayıt olarak kalır; sayfalar bunu görüntüler.
Rapor, certificate.seal.json dosyasında ve yanındaki .tsq/.tsr dosyalarında imzalar ve zaman damgaları ile dijital olarak mühürlenmiştir:
| Mühür | Neler ekliyor? |
|---|---|
Nitelikli elektronik zaman damgası, http://tsa.belgium.be/connect |
Belçika federal hükümetinin nitelikli güven hizmeti sağlayıcısından (FPS Policy and Support, BOSA) alınan certificate.json'in tam baytları üzerinde RFC 3161 zaman damgası. Bu birim, Belçika'nın AB güvenilir listesinde nitelikli zaman damgası hizmeti olarak, "onaylanmış" statüsüyle listelenmiştir; kök (Belçika Kök CA6) ve listenin girişleri, 20 Ekim 2026 tarihinde yayınlanan listeye göre, tgwitness/tsa_roots.py'te sabitlenmiştir. (AB) 910/2014 sayılı Tüzüğün 41. maddesi uyarınca, bu tür bir zaman damgası, tarih ve saat açısından ve verilerin bütünlüğü açısından her AB üye devletinde doğru kabul edilir. |
| RFC 3161 zaman damgası, FreeTSA | İkinci, bağımsız bir zaman damgası |
| Doğrulayıcı imzası | Ed25519, raporun SHA-256 değerini ve her zaman damgasını belirten bir ifade üzerinde, doğrulayıcının kendi anahtarıyla (--sign-with FOLDER, varsayılan ~/.tgwitness/verifier) uygulanır; PDF dosyası aynı anahtarla imzalanır |
--timestamp URL (tekrarlanabilir) diğer yetkilileri seçer, --timestamp none hiçbirini seçmez, --sign-with
none mührü imzasız bırakır. check-report, raporun hash değerini, doğrulayıcı imzasını,
her zaman damgasını güvenilir bir kök sertifikaya ve onun nitelikli durumuna göre kontrol eder ve PDF'nin imzasını doğrular. AB dışında
nitelikli bir zaman damgasının ve raporun bir bütün olarak hukuki geçerliliği, raporu alan mahkeme
veya yetkili kuruma bağlıdır; mühür, raporun ne zaman mevcut olduğunu ve değiştirilmediğini gösterir.
Doğrulama, Intel’in TDX modülüne ve mikro koduna ve bellek veriyolunun fiziksel bütünlüğüne dayanır. Phala’nın hesabındaki uygulamayı kontrol eden kişi başka bir derleme dağıtabilir; bu, yeni bir derleme hash’i ile yeni bir revizyon olarak görünür. Ana bilgisayar, makinenin zaman kaynağını ve ağını kontrol eder.
Dağıtım, --evidence, yeniden başlatma, işletim sistemi görüntüsü karşılaştırması, mühürlü sertifika ve imha işlemleri Phala Cloud üzerinde gerçekleştirilmiştir; 4 Kasım 2026 tarihli çalıştırmaya bakınız. 9 Kasım'da, canlı bir Telegram hesabından toplanan bir dağıtım gerçekleştirilmiştir; bir çalıştırmada sanal makine (VM) içinde oluşturulan bir oturum anahtarı kullanılmıştır. Canlı hesap çalıştırmasına ve sanal makine içinde oluşturulan anahtara bakınız.
Başlamadan önce#
- Bir Cloudflare bölgesi, hesap kimliği ve Cloudflare Tunnel Edit,
Zone Read ve DNS Edit yetkilerine sahip bir API jetonu,
--cloudflare-token-fileveyaCLOUDFLARE_API_TOKENile verilir. Doğrulayıcı için: Cloudflare Tunnel Read, DNS Read ve denetim günlüğü için Account Settings Read. Etki alanı olmadan, hızlı tünel bunların hiçbirine ihtiyaç duymaz. - Özel bir projeye yazma erişimi olan sağlayıcı kimlik bilgileri;
lockAynı şeyi kullanır:- Hetzner: Okuma ve Yazma iznine sahip API jetonu;
- DigitalOcean: yazma erişimine sahip kişisel erişim jetonu;
- Linode:
linodes,firewallveeventsokuma/yazma kapsamlarına sahip kişisel erişim jetonu; - Vultr: Özel bir hesabın veya alt hesabın API anahtarı;
- AWS: IAM kimlik bilgileri izin verilir
ec2:DescribeVpcs,ec2:DescribeImages,ec2:CreateSecurityGroup,ec2:AuthorizeSecurityGroupIngress,ec2:RunInstances,ec2:CreateTags,ec2:DescribeInstances,ec2:DescribeSecurityGroupRulesveec2:RevokeSecurityGroupIngress.
- Çalıştırılacak commit. Bir sürüm etiketi,
git ls-remote; sunucu her zaman yalnızca 40 karakterlik commit'i alır.
Panelden#
Kendi bilgisayarınızda, Diğer araçlar → Ekstralar → 24/7 Sunucu
seçeneği, Hetzner için aynı deploy
işlemini üç
adımda yürütür: Avrupa veya Amerika Birleşik Devletleri'ni seçin, bir Hetzner belirtecini (Okuma ve Yazma) yapıştırın, ardından
panelin bu belirteçle bulduğu sunucu türünü, aylık fiyatı, adresi ve sürümü inceleyin. Onay vermeden önce
hiçbir şey oluşturulmaz. Panel, her adımı deploy
'un bildirdiği şekilde gösterir; ardından
adres, panel jetonu ve imzalama anahtarı parmak izi görüntülenir. Alan adı olmadan sunucuya bir
hızlı tünel
atanır; Sunucularınız → Mevcut adresi bul seçeneği
, yeniden başlatmanın ardından adresi
tekrar arar. Kendi alan adınız altında sabit bir adres için,
İsteğe Bağlı · kendi alan adınız seçeneğini
açın ve bir Cloudflare jetonu ekleyin (hazırlanan bağlantı, Bölge
Okuma, DNS Düzenleme ve Cloudflare Tüneli Düzenleme seçeneklerini seçer).
Jetonlar, her istekle birlikte tarayıcı sekmesinden aynı bilgisayardaki TgWitness adresine aktarılır
ve hiçbir yere kaydedilmez; dağıtım kaydı, sansürlenmiş cloud-init, panel jetonu ve
hızlı tünel için adres anahtarı, deployments/NAME veri dizini içinde saklanır.
Panel, bunu yalnızca doğrudan bir loopback bağlantısı üzerinden ana yöneticiye sunar
(127.0.0.1, proxy veya tünel başlıkları olmadan); ağ üzerinden erişilen bir panel ise bunun yerine komutları
gösterir. Sürüm, varsayılan olarak çalışan panelin sürüm etiketidir ve bu,
GitHub API'si aracılığıyla belirlenir. Konum, sunucu türü ve fiyat, Hetzner'in API'sinden alınır: cpx22 sunuluyorsa buradan,
aksi takdirde en az 2 GB belleğe sahip en ucuz x86 türü kullanılır.
Etki alanı gerektirmeyen hızlı tünel#
--quick-tunnel yerine geçer --zone, --cloudflare-account ve --panel-host; Cloudflare
hesabı veya jetonu kullanılmaz:
python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \
--ref 0123456789abcdef0123456789abcdef01234567 --quick-tunnel --provider-token-file hetzner.token
Sunucuda, cloudflared panele bir
hızlı tünel
açar: bu, https://….trycloudflare.com adres açar; bu adres, cloudflared
veya sunucu yeniden başlatıldığında değişir. Sunucudaki küçük bir hizmet, her adresi rastgele bir ntfy.sh
konusuna gönderir; bu adres, yalnızca dağıtım dizininde bulunan bir anahtarla (HMAC-SHA256) imzalanır
(address-key.txt) ve ntfy.sh gönderileri 12 saat boyunca sakladığı için bunu her üç saatte bir tekrarlar.
deploy Güncel adresi bul, yalnızca imzalı gönderileri kabul eder; bu sayede sahte bir gönderi,
sizi ve panel jetonunuzu başka birinin adresine yönlendiremez. Konu, kayıtta ve
yayınlanan cloud-init'te bulunur: bunlara sahip olan herkes, hâlâ
panel jetonunu isteyen güncel adresi okuyabilir. Sunucu, her iki durumda da gelen bağlantı noktası açmaz.
Bir doğrulayıcının adres anahtarı yoktur ve konuyu okuyan herkes bu konuya gönderi yapabilir. Bu nedenle toplayıcı
kendi Ed25519 anahtarıyla imzalanmış adresi de yayınlar ve verify, dağıtım kaydında toplayıcı anahtarıyla imzalanmış en yeni
gönderiyi alır; gönderiler, iddia ettikleri zamana göre değil, ntfy.sh'nin
onları aldığı zamana göre sıralanır. Bu değişiklikten önceki bir toplayıcı hiçbir şeyi imzalamaz ve
verify daha sonra en yeni gönderiyi alır ve bunu statement kontrolünde belirtir; sahte bir gönderi
sadece bu kontrolün başarısız olmasına neden olabilir, çünkü adres yine de toplayıcının anahtarıyla yanıt vermelidir.
Maliyeti: Hiçbir Cloudflare hesabı hızlı tünelin kayıtlarını tutmaz, bu nedenle verify,
tünel, konektör ve DNS kontrolünü kullanılamaz olarak bildirir ve sonuç en iyi ihtimalle incomplete olur (Phala
Cloud'da ise kontrol başarılı olur: konektör, ölçülen compose içinde çalışır);
sağlayıcı kayıtları, güvenlik duvarı, imzalı beyan, ana bilgisayar ölçümleri ve yükleyici karşılaştırması
her zamanki gibi kontrol edilir. Referans yükleyiciyle bayt karşılaştırması, --quick-tunnel'i zaten tanıyan
dağıtılmış bir commit gerektirir; 0.7.0 checkout'u etki alanı yükleyicisini derler ve
farkı bildirir. Cloudflare deneme amaçlı hızlı tüneller sunar, 200 istek
işlemine izin verir ve Server-Sent Events'i taşımaz; bu nedenle panelin canlı güncellemeleri (0.7.0'dan sonraki sürümler)
bu tünel üzerinden gelmeyebilir ve sayfanın yeniden yüklenmesi gerekebilir; bu kısım denenmemiştir. Kalıcı olması
gerekli bir durum için kendi etki alanınızı kullanın.
Dağıtım#
Öncelikle gönderilecek her şeye bir göz atın. plan Hiçbir sağlayıcıya veya Cloudflare’e istek göndermez:
python -m tgwitness.cloud plan --provider hetzner --name case-2026-11 --server-type cpx22 \
--ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \
--cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org
Ardından aynı seçenekler ve kimlik bilgileriyle dağıtın:
python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \
--ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \
--cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org \
--witness-host case-witness.example.org \
--provider-token-file hetzner.token --cloudflare-token-file cloudflare.token
Başlangıç için sunucu türleri: cpx22 (Hetzner), s-1vcpu-2gb (DigitalOcean), g6-standard-1
(Linode), vc2-1c-2gb (Vultr), t3.small (AWS). --location ve --image her bir
sağlayıcının Avrupa bölgesindeki Ubuntu 24.04 sürümüne varsayılan olarak ayarlanır.
--repository başka bir https Git deposundan, URL’de kimlik bilgileri olmadan
commit alır (varsayılan https://github.com/phishdestroy/TgWitness.git). deploy ayrıca --out
başka bir dağıtım dizini için de kabul eder (varsayılan deployments/NAME; halihazırda bir
dağıtım içeren bir dizin reddedilir) ve --wait, toplayıcının imzalı beyanı için beklenecek dakika sayısı:
1 ila 240, varsayılan 20 veya 60 generic.
Komut:
- bir Cloudflare tüneli oluşturur; bu tünelin girişi, panel ana bilgisayar adını panele ve,
varsa, tanık ana bilgisayar adını
/api/witness/headve/api/assurancesadece; - bu ana bilgisayar adları için proxy'li CNAME kayıtları oluşturur ve zaten mevcut olan adları reddeder;
- gelen kuralları olmayan bir sağlayıcı güvenlik duvarı ve bunun arkasında SSH anahtarı,
yedekleme, konsol ajanı bulunmayan ve SSH'yi maskeleyen, root erişimini kilitleyen,
cloudflared, tam olarak o commit’i alır, kontrol eder ve TgWitness’yi güçlendirilmiş bir systemd hizmeti olarak başlatır; - toplayıcının imzalı beyanını bekler ve bu beyanın bu sunucuyu ve bu cloud-init'in hash değerini belirtip belirtmediğini kontrol eder.
deployments/case-2026-11/ içinde şunlar bulunur:
| Dosya | İçindekiler | Paylaşmak ister misiniz? |
|---|---|---|
deployment.json |
Kimlikler, hash değerleri, yapılan API çağrıları (yöntem, yol, durum) ve ilk imzalanmış ifade | Evet, doğrulayıcı ile |
cloud-init.redacted.yaml |
İki gizli bilgisi şu şekilde değiştirilmiş olan tam cloud-init komutu: REDACTED |
Evet |
panel-token.txt |
Panel jetonu | Hayır |
Sağlayıcının kök şifresi, tünel jetonu ve panel jetonu hiçbir zaman
deployment.json. Sonunda yazdırılan toplayıcı parmak izini, tek başınıza kontrol etmediğiniz bir kanal aracılığıyla yayınlayın
; örneğin bir tanık kanalı veya alıcıya gönderilen bir mesaj.
Telegram'da https://case.example.org adresinden,
hesap kılavuzunda belirtildiği gibi panel jetonuyla Telegram'da oturum açın. Panel eylemleri imzalı günlüğe kaydedilir; bunlar
SSH oturumları değildir. Bir tanık, https://case-witness.example.org.
SSH yoktur: önyükleme başarısız olursa, toplayıcı asla yanıt vermez. Sunucuyu silip yeniden dağıtın veya nedeni bulmak için hata ayıklama dağıtımı kullanın.
Kullanıcı verilerindeki gizli bilgiler#
Cloud-init iki gizli bilgiyi taşır: panel jetonu ve Cloudflare tünel jetonu.
İmza anahtarı bunların arasında yer almaz; sunucuda oluşturulur. Hetzner, DigitalOcean ve Linode,
API'leri aracılığıyla kullanıcı verilerini döndürmez. Vultr,
örneği okuyabilen herhangi bir anahtara bu verileri döndürür; EC2 ise DescribeInstanceAttribute. AWS için doğrulayıcıya yalnızca tablodaki üç
eylemi verin, asla ec2:Describe*. Vultr için, doğrulayıcının anahtarının her iki
jetonu da okuyabildiğini varsayalım. Bir tünel jetonu, birinin ikinci bir konektör çalıştırmasına izin verir: verify sunucuda bulunmayan herhangi bir konektörü
bildirir ve toplayıcının ifadeleri bu şekilde taklit edilemez çünkü her biri
yeni bir meydan okumayı imzalar. --quick-tunnel ikinci gizli anahtar ise adres anahtarıdır:
bunu okuyan herhangi biri, panelin kabul edeceği sahte bir adres gönderebilir.
Toplayıcının kamuya açık açıklamasında sunucunun adresi ve oturum açma kaynakları belirtilmez; her ikisi de imzalı günlüğünde yer alır.
Hata ayıklama dağıtımı ve kilitleme#
--debug-ssh-key KEY --debug-ssh-from 198.51.100.4 SSH, tek bir adresten veya küçük bir ağdan gelen tek bir anahtar için saklanır;
IPv4 için en fazla /24 veya IPv6 için en fazla /48. KEY zaten sağlayıcıya kayıtlıdır:
Hetzner projesindeki bir SSH anahtarının adı veya kimliği, DigitalOcean ekibindeki bir
SSH anahtarının kimliği veya parmak izi, SSH anahtarları root'a eklenen bir Linode kullanıcı adı,
Vultr hesabındaki bir SSH anahtarının kimliği veya bölgedeki bir EC2 anahtar çiftinin adı. Bu
seçenekler generic. Bu tür bir dağıtım debug şeklinde kaydedilir ve asla
yüksek güvenilirlikli olarak raporlanmaz. İşiniz bittiğinde, sudo tgwitness-lock son
SSH oturumunun son komutu olarak çalıştırın, ardından:
python -m tgwitness.cloud lock --record deployments/case-2026-11/deployment.json --provider-token-file hetzner.token
Güvenlik duvarı tüm gelen kuralları kaybeder. Raporlar daha sonra SSH’ye ne zaman izin verildiğini ve ne zaman kapatıldığını gösterir; bu pencere görünür kalır.
Bir dağıtımı kaldır#
destroy dağıtımın etiketine göre sunucuyu ve güvenlik duvarını siler; böylece
yarı yolda başarısız olan bir dağıtım da kaldırılır; ardından tüneline yönlendiren
DNS kayıtları ve tünel silinir. Sunucunun günlüğü ve imzalama anahtarı da bununla birlikte silinir: önce
kanıtları dışa aktarın. Kayıt, removed, kaldırma işleminin API çağrılarıyla birlikte kalır.
python -m tgwitness.cloud destroy --record deployments/case-2026-11/deployment.json --confirm case-2026-11 \
--provider-token-file hetzner.token --cloudflare-token-file cloudflare.token
Hetzner için API üzerinden silme işlevi uygulanmıştır. Diğer sağlayıcılar için destroy herhangi bir şeyi silmeden önce
durur ve sağlayıcının konsolunda silinecek etiketin adını belirtir. Elle kurulan bir
sunucu (generic) yalnızca tünelini ve DNS kayıtlarını kaybeder. Hızlı tünel dağıtımı için
Cloudflare jetonuna gerek yoktur: tüneli sunucuda sona erer ve gönderileri ntfy.sh'den
12 saat içinde silinir.
Herhangi bir sunucu (kendi kendini doğrulayan)#
--provider generic Bu, satın alınan veya manuel olarak kurulan bir sunucu içindir. deploy tüneli
ve DNS'yi oluşturur, install.sh (özel) ve install.redacted.sh (yayınlamak için) yazar ve bekler.
Kopyalayın install.sh yeni kurulmuş bir Ubuntu 24.04 sunucusuna kopyalayın ve orada çalıştırın:
sudo bash install.sh
Sunucuyu olduğu gibi kaydeder (girişler, hesaplar, authorized_keys, dinleme soketleri,
hizmetler, zamanlanmış işler, paketler), taahhüdü yükler, ana bilgisayar güvenlik duvarını etkinleştirir,
kendini siler, SSH’yi maskeler ve oturumu sonlandırır. Böyle bir sunucuya ait rapor en iyi ihtimalle
KENDİ KENDİNİ DOĞRULAMALI’dır: yükleyiciyi çalıştıran kişi, bunu yapmadan önce root erişimine sahipti ve doğrulayıcının elinde hiçbir sağlayıcı kaydı
bulunmamaktadır. Yine de açıklanamayan bir sunucudan daha iyidir: envanter,
yükleyici hash’i ve sonraki her oturum açma işlemi imzalanmıştır.
Doğrula#
Doğrulayıcının şunlara ihtiyacı vardır deployment.json, yayınlanmış yükleyici, salt okunur kimlik bilgileri ve
ideal olarak, ilgili commit'in bir kopyası ile bir kanıt ZIP:
git clone -c core.autocrlf=false https://github.com/phishdestroy/TgWitness.git checkout
git -C checkout checkout 0123456789abcdef0123456789abcdef01234567
python -m tgwitness.cloud verify --record deployment.json \
--provider-token-file read-only.token --cloudflare-token-file cloudflare-read.token \
--fingerprint COLLECTOR_FINGERPRINT --cloud-init cloud-init.redacted.yaml \
--source checkout --evidence tgwitness-evidence.zip --report report.md
Her sağlayıcı ve Cloudflare değeri, o anda doğrulayıcı tarafından talep edilir; kayıt
sadece sorgulanacak kimlik numaralarını sağlar. Çıkış kodu, PASS için 0, FAIL için 1 ve
REVIEW, INCOMPLETE veya SELF-ATTESTED için 2'dir. --fingerprint bağımsız bir
kanaldan gelmelidir; bu olmadan anahtar yalnızca operatörün kaydıyla karşılaştırılır. python verify.py
ZIP, Evidence bölümünde olduğu gibi kanıtı yine kendisi doğrular.
Sağlayıcı eylemleri sınıflandırılır: oluşturma ve oluşturulduktan sonraki 30 dakika içinde başlatma işlemleri geçer; konsol, kurtarma, şifre sıfırlama, yeniden oluşturma, ISO, görüntüler, anlık görüntüler, yedeklemeler, Sistem Yöneticisi, EC2 Instance Connect ve güvenlik duvarı açılışları başarısız olur; güç eylemleri ve beklenmeyen her şey inceleme için işaretlenir. Bilinmeyen bir eylem asla sessizce geçmez.
Kanıt teslimi raporu#
--report report.md Markdown raporunu yazar ve report.json yanında:
- sonuç, toplayıcı anahtar parmak izi, dağıtım, sağlayıcı, commit, sunucu, güvenlik duvarı, tünel;
- her kontrolün durumu ve kaynağı (sağlayıcı API'si, Cloudflare API'si, toplayıcı beyanı, kanıt günlüğü);
- her eylemin değerlendirmesini ve sağlayıcının kaydettiği durumlarda, eylemi gerçekleştiren kişiyi içeren sağlayıcı günlüğü;
- Tünelin bağlantılarını, yapılandırmasını ve denetim günlüğünü barındıran Cloudflare uç noktaları;
- imzalanmış toplayıcı beyanı;
- raporun neleri kapsadığı ve nelerin kapsamı dışında kaldığı;
- Bunu yeniden oluşturmak için komutlar ve kendisine verilen her dosyanın SHA-256'si.
Raporu, report.json, deployment.json, yayınlanmış yükleyiciyi ve
kanıtları ZIP teslim edin. Raporu erken hazırlayın: sağlayıcı günlükleri sınırlı bir süre saklanır.
Dış tanık olarak Cloudflare#
Buradaki her şey isteğe bağlıdır. Cloudflare hesabı olmasa bile sunucu yine de çalışır ve bunlardan ikisi bugün şu anda çalışır durumda:
| Ne | Neleri gösterir? | TgWitness içinde |
|---|---|---|
| Hızlı tünel veya kendi alan adınızın tüneli | Panele yalnızca tünel üzerinden erişilebilir | sunucu sihirbazı, yukarıya bakın |
drand aktarıcısı drand.cloudflare.com |
drand turundan sonraki kayıtlar ondan daha yenidir: günlük, olaylar gerçekleşirken yazılmıştır | kanıt modu, Daha fazla tanık, hesap yok (biçim) |
| Tünel durum bildirimleri | tünel kapalıyken, Cloudflare'den e-posta veya webhook yoluyla | Bunları Cloudflare kontrol panelinde ayarlayın |
Gateway DNS (--gateway-dns, ya da sihirbazda Cloudflare Gateway DNS) |
sunucunun aradığı her isim, Cloudflare tarafından TLS üzerinden yanıtlanır; Hetzner güvenlik duvarı, DNS'nin başka hiçbir yere erişmesine izin vermez; bir Ağ Geçidi politikasının yanıtları yeniden yazıp yazamayacağı | Hetzner, ücretsiz Zero Trust planı, alan adı yok; verify güvenlik duvarını, konumu, günlük kaydı, politikaları, sunucunun sorgularını ve denetim günlüğünü kontrol eder; kanıt modu, günlüğü dergiye kopyalar |
| Sunucudaki Cloudflare One istemcisiyle bağlantı sağlayan ağ geçidi; yalnızca Cloudflare'e izin veren bir giden trafik güvenlik duvarı | sunucunun kurduğu her bağlantı, sadece DNS değil | henüz oluşturulmadı |
| Panelin önünden erişim | panele kim ne zaman giriş yaptı | henüz geliştirilmemiştir: kendi alan adınız gereklidir |
| SSH komut günlüğü | hata ayıklama oturumundaki her komut | henüz oluşturulmadı |
Cloudflare'in kendi kopyasını R2'de tutan Logpush, bir Enterprise özelliğidir: ücretsiz
planda Cloudflare yanıt verir logpush is not enabled for this account. Gateway günlüğü orada 24
saat kalır, bu nedenle kanıt modu onu imzalı günlüğe kopyalar (Cloudflare Gateway’in
bu sunucunun DNS sorgularının günlüğü; Account Analytics Read ile okunur bir belirteç).
--gateway-location ID (--gateway-dns ile birlikte kullanıldığında), yeni bir konum oluşturmak yerine,
32 karakterlik kimliğiyle belirtilen mevcut bir Ağ Geçidi DNS konumunu kullanır; destroy komutu ise bu konumu olduğu gibi bırakır.
Zero Trust planı olmadan bir hesabın tek bir DNS konumu vardır. Cloudflare başka bir konumu reddettiğinde,
sunucu mevcut konumu paylaşır ve sorguları adresine göre ayırt edilir; bu filtre
ayrıca Zero Trust PII Read'e de ihtiyaç duyar ve destroy ortak bir konum bırakır. Bir günlük sorgusu
en fazla üç saat sürer, bu nedenle kopyalama ve verify okuma işlemleri üç saatlik aralıklarla gerçekleştirilir.
Gateway DNS, sistem çözümleyicisini kapsar. 443 numaralı bağlantı noktası üzerinden HTTPS üzerinden başka bir çözümleyiciye yapılan DNS işlemleri ve hiçbir yerde aranmayan bir adrese (örneğin Telegram’ın veri merkezleri) yapılan bağlantılar, günlüğünde yer almaz.
Cloudflare, Telegram’ın şifrelemesinin içini, Telegram hesabındaki diğer cihazları (kanıt modundaki cihaz listesi bunları Telegram tarafında kaydeder) veya sağlayıcının hipervizörünü göremez.
Dağıtım sonucunu okuma#
Sıradan bir sanal makine (VM) için, sağlayıcı ana bilgisayar altyapısını kontrol eder ve yerel envanter sağlayıcının kayıtlarıyla birlikte kontrol edilir. Intel TDX için, doğrulayıcı ek olarak donanım teklifi, toplayıcı bağlaması, oluşturma ve işletim sistemi ölçümlerini de kontrol eder. Hangi kontrollerin başarılı olduğunu veya kullanılamadığını görmek için tek tek sonuçları okuyun.
Geçmiş güvenlik duvarı ayrıntıları sağlayıcıya bağlıdır; Linode kural sürümlerini saklar. doğrulama kaydı , test edilmiş dağıtımları ve kalan canlı kontrolleri listeler; doğrulama kapsamı ise bu ortam kontrollerini arşiv edinimi ve bütünlüğüyle ilişkilendirir.