# Phala / Intel TDX · Yüksek güvenilirlikli dağıtım

Canonical page: https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/

Hetzner veya Phala Cloud üzerinde 7/24 çalışan, mühürlenmiş bir sunucu, Gateway DNS ve üçüncü tarafların tekrarlayabileceği kontroller.

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

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

Hetzner veya Phala Cloud üzerinde 7/24 çalışan, mühürlenmiş bir sunucu, Gateway DNS ve üçüncü tarafların tekrarlayabileceği kontroller.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Belgeler](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Dağıtım ve kurtarma](https://phishdestroy.io/tgwitness/tr/docs/reference/deployment/)

![Dağıtım ve kurtarma](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

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.cloud`komutuyla 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`.

Akış şeması · Operatör → Sunucu, gelen trafiğe izin vermeyen güvenlik duvarı (sağlayıcı API&#x27;si); Operatör → Tünel ve DNS (Cloudflare API&#x27;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ı · Operatör · Verifier, salt okunurbelirteçler · Sunucu, gelen trafiğe izinvermeyen güvenlik duvarı · Sağlayıcı günlüğü vegüvenlik duvarı · Tünel bağlayıcı adresi vegiriş · İmzalı /api/assurancebeyanı · Kanıt ZIP dosyası · Tünel ve DNS · Sunucuda oluşturulanimzalama anahtarı · sağlayıcı API&#x27;si · Cloudflare API&#x27;si · sadece giden

**Diyagramın metin olarak gösterimi**

1. Operatör → Sunucu, gelen trafiğe izin vermeyen güvenlik duvarı (sağlayıcı API&#x27;si)
2. Operatör → Tünel ve DNS (Cloudflare API&#x27;si)
3. Sunucu, gelen trafiğe izin vermeyen güvenlik duvarı → Tünel ve DNS (sadece giden)
4. Sunucu, gelen trafiğe izin vermeyen güvenlik duvarı → Sunucuda oluşturulan imzalama anahtarı
5. Verifier, salt okunur belirteçler → Sağlayıcı günlüğü ve güvenlik duvarı
6. Verifier, salt okunur belirteçler → Tünel bağlayıcı adresi ve giriş
7. Verifier, salt okunur belirteçler → İmzalı /api/assurance beyanı
8. Verifier, salt okunur belirteçler → Kanıt ZIP dosyası

**Bu sayfada**

- [Bir doğrulayıcının kontrol edebileceği şeyler](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#what-a-verifier-can-check)
- [Sağlayıcılar](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#providers)
- [Phala Cloud üzerinde Gizli VM (Intel TDX)](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx)
- [Başlamadan önce](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#before-you-start)
- [Panelden](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#from-the-panel)
- [Etki alanı gerektirmeyen hızlı tünel](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#quick-tunnel-without-a-domain)
- [Dağıt](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#deploy)
- [Hata ayıklama dağıtımı ve kilitleme](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#debug-deployment-and-lock)
- [Dağıtımı kaldır](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#remove-a-deployment)
- [Herhangi bir sunucu (kendi kendini doğrulamış)](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#any-server-self-attested)
- [Doğrula](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#verify)
- [Kanıt teslimi raporu](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#report-for-evidence-handover)
- [Dış tanık olarak Cloudflare](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#cloudflare-as-an-outside-witness)
- [Dağıtım sonucunu okuma](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#reading-the-deployment-result)

## 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](https://phala.com/) ü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](https://github.com/Dstack-TEE/meta-dstack/releases) 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](https://phishdestroy.io/tgwitness/tr/docs/reference/verification/#live-phala-cloud-deployment--4-november-2026) 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](https://phishdestroy.io/tgwitness/tr/docs/reference/verification/#phala-cloud-with-live-telegram-account--9-november-2026) ve [sanal makine içinde oluşturulan anahtara](https://phishdestroy.io/tgwitness/tr/docs/reference/verification/#session-key-created-inside-the-tdx-vm--9-november-2026) bakınız.

## Başlamadan önce

1. Bir Cloudflare bölgesi, hesap kimliği ve **Cloudflare Tunnel Edit**, **Zone Read** ve **DNS Edit** yetkilerine sahip bir API jetonu, `--cloudflare-token-file` veya `CLOUDFLARE_API_TOKEN`ile 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](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#quick-tunnel-without-a-domain) bunların hiçbirine ihtiyaç duymaz.
2. Özel bir projeye yazma erişimi olan sağlayıcı kimlik bilgileri; `lock` Aynı şeyi kullanır:

   - Hetzner: Okuma ve Yazma iznine sahip API jetonu;
   - DigitalOcean: yazma erişimine sahip kişisel erişim jetonu;
   - Linode: `linodes`, `firewall` ve `events` okuma/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:DescribeSecurityGroupRules` ve `ec2:RevokeSecurityGroupIngress`.
3. Ç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](https://phishdestroy.io/tgwitness/tr/docs/reference/high-assurance/#quick-tunnel-without-a-domain) 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](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) 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:

1. 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/head` ve `/api/assurance` sadece;
2. bu ana bilgisayar adları için proxy'li CNAME kayıtları oluşturur ve zaten mevcut olan adları reddeder;
3. 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;
4. 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](https://phishdestroy.io/tgwitness/tr/docs/reference/accounts/)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://phishdestroy.io/tgwitness/tr/docs/reference/witness/), `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](https://phishdestroy.io/tgwitness/tr/docs/reference/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:

1. sonuç, toplayıcı anahtar parmak izi, dağıtım, sağlayıcı, commit, sunucu, güvenlik duvarı, tünel;
2. her kontrolün durumu ve kaynağı (sağlayıcı API'si, Cloudflare API'si, toplayıcı beyanı, kanıt günlüğü);
3. 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üğü;
4. Tünelin bağlantılarını, yapılandırmasını ve denetim günlüğünü barındıran Cloudflare uç noktaları;
5. imzalanmış toplayıcı beyanı;
6. raporun neleri kapsadığı ve nelerin kapsamı dışında kaldığı;
7. 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](https://phishdestroy.io/tgwitness/tr/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)) |
| 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ı](https://phishdestroy.io/tgwitness/tr/docs/reference/verification/), test edilmiş dağıtımları ve kalan canlı kontrolleri listeler; [doğrulama kapsamı](https://phishdestroy.io/tgwitness/tr/docs/reference/evidence/#verification-scope) ise bu ortam kontrollerini arşiv edinimi ve bütünlüğüyle ilişkilendirir.
