# Phala / Intel TDX · Wdrożenie o wysokim poziomie bezpieczeństwa

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

Zabezpieczony serwer działający 24 godziny na dobę, 7 dni w tygodniu, w chmurze Hetzner lub Phala Cloud, bramka DNS oraz testy, które może powtórzyć strona trzecia.

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

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

Zabezpieczony serwer działający 24 godziny na dobę, 7 dni w tygodniu, w chmurze Hetzner lub Phala Cloud, bramka DNS oraz testy, które może powtórzyć strona trzecia.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentacja](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Wdrażanie i przywracanie](https://phishdestroy.io/tgwitness/pl/docs/reference/deployment/)

![Wdrażanie i przywracanie](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

Wdrożenie o wysokim poziomie bezpieczeństwa dodaje niezależne kontrole środowiska gromadzenia danych do weryfikacji archiwum. Recenzent sprawdza zapisy dotyczące wdrożenia i dostępu przechowywane przez dostawcę usług w chmurze oraz Cloudflare, a wdrożenie Intel TDX zapewnia sprzętowe poświadczenie środowiska kolektora.

Zwykłe korzystanie z wersji lokalnej i Docker pozostaje bez zmian. Nic tutaj nie działa, dopóki nie wdrożysz za pomocą `python -m tgwitness.cloud`, a kolektor odczytuje dane z hosta tylko wtedy, gdy wdrożenie ustawia `TGWITNESS_ASSURANCE`.

Schemat blokowy · Operator → Serwer, zapora sieciowa bez reguł przychodzących (API dostawcy); Operator → Tunel i DNS (API Cloudflare); Serwer, zapora sieciowa bez reguł przychodzących → Tunel i DNS (tylko wychodzące); Serwer, zapora sieciowa bez reguł przychodzących → Klucz podpisujący utworzony na serwerze; Verifier, tokeny tylko do odczytu → Dziennik dostawcy i zapora sieciowa; Verifier, tokeny tylko do odczytu → Adres łącznika tunelowego i ruch przychodzący; Verifier, tokeny tylko do odczytu → Podpisane oświadczenie /api/assurance; Verifier, tokeny tylko do odczytu → Plik ZIP z dowodami · Operator · Verifier, tokeny tylko doodczytu · Serwer, zapora sieciowabez reguł przychodzących · Dziennik dostawcy i zaporasieciowa · Adres łącznika tunelowegoi ruch przychodzący · Podpisane oświadczenie/api/assurance · Plik ZIP z dowodami · Tunel i DNS · Klucz podpisującyutworzony na serwerze · API dostawcy · API Cloudflare · tylko wychodzące

**Schemat w formie tekstowej**

1. Operator → Serwer, zapora sieciowa bez reguł przychodzących (API dostawcy)
2. Operator → Tunel i DNS (API Cloudflare)
3. Serwer, zapora sieciowa bez reguł przychodzących → Tunel i DNS (tylko wychodzące)
4. Serwer, zapora sieciowa bez reguł przychodzących → Klucz podpisujący utworzony na serwerze
5. Verifier, tokeny tylko do odczytu → Dziennik dostawcy i zapora sieciowa
6. Verifier, tokeny tylko do odczytu → Adres łącznika tunelowego i ruch przychodzący
7. Verifier, tokeny tylko do odczytu → Podpisane oświadczenie /api/assurance
8. Verifier, tokeny tylko do odczytu → Plik ZIP z dowodami

**Na tej stronie**

- [Co może sprawdzić weryfikator](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#what-a-verifier-can-check)
- [Dostawcy](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#providers)
- [Poufna maszyna wirtualna w chmurze Phala Cloud (Intel TDX)](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx)
- [Zanim zaczniesz](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#before-you-start)
- [Z panelu](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#from-the-panel)
- [Szybki tunel bez domeny](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#quick-tunnel-without-a-domain)
- [Wdrożenie](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#deploy)
- [Wdrożenie debugowania i blokada](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#debug-deployment-and-lock)
- [Usuń wdrożenie](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#remove-a-deployment)
- [Dowolny serwer (z własnym certyfikatem)](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#any-server-self-attested)
- [Weryfikacja](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#verify)
- [Raport dotyczący przekazania dowodów](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#report-for-evidence-handover)
- [Cloudflare jako zewnętrzny świadek](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#cloudflare-as-an-outside-witness)
- [Odczytywanie wyniku wdrożenia](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#reading-the-deployment-result)

## Co może sprawdzić weryfikator

| Twierdzenie | Jak to jest sprawdzane | Prowadzona przez |
| --- | --- | --- |
| Serwer został utworzony za pośrednictwem API dostawcy w znanym momencie | Obiekt serwera i jego utworzenie w dzienniku dostawcy | Dostawca |
| Nikt nie korzystał ze ścieżek dostępu dostawcy | Dziennik żądań konsoli, odzyskiwanie, resetowanie hasła, odbudowa, ISO, obrazy, kopie zapasowe | Dostawca |
| Nie udało się nawiązać połączenia | Zapora dostawcy nie zawiera żadnych reguł przychodzących; połączenia SSH są ukrywane od pierwszego uruchomienia | Dostawca (zapora sieciowa), host (SSH) |
| Dostęp do panelu jest możliwy wyłącznie poprzez tunel | Ruch przychodzący przez tunel jest przekierowywany wyłącznie do panelu; łącznik działa z adresu serwera | Cloudflare |
| To właśnie to oprogramowanie działa | Podpisany skrót drzewa źródłowego kolektora jest równy kopii rozwijanej wersji wdrożonego commitu | Collector, zsynchronizowany z Git |
| Klucz podpisujący został utworzony na tym serwerze | Klucz podpisuje oświadczenie zawierające identyfikator serwera dostawcy oraz skrót otrzymanego pliku cloud-init | Collector, zweryfikowany przez dostawcę |
| Dziennik należy do tego klucza i serwera | Każdy proces rozpoczynający się w dowodzie ZIP zawiera pomiar hosta dla tego serwera | Dowody ZIP |
| Klucz Telegramu został utworzony podczas poświadczonego uruchomienia | `account.authorized` rejestruje `key_origin: "created"` | Dowody ZIP |

Moduł zbierający rejestruje stan SSH, sesje, historię logowań oraz informacje o uruchomieniu w podpisanych rekordach process-start i `host.state`. Na zwykłej maszynie wirtualnej są to lokalne rekordy inwentaryzacyjne, które osoba przeprowadzająca weryfikację porównuje z niezależnymi zapisami dostawcy. Poniższe wdrożenie Intel TDX dodatkowo weryfikuje pomiary oparte na sprzęcie.

Poświadczone wdrożenie nie gromadzi danych na podstawie zaimportowanego klucza sesji. Zaloguj się przez telefon lub kod QR albo użyj pliku sesji do niezależnego logowania: w obu przypadkach klucz autoryzacyjny Telegramu jest tworzony w ramach poświadczonego uruchomienia, dziennik rejestruje `key_origin: "created"`, a polecenie `python -m tgwitness.cloud verify` zwraca `account_key`. Dziennik z zaimportowanym kluczem nie przechodzi tej weryfikacji.

## Dostawcy

| `--provider` | Dane uwierzytelniające | Dostęp tylko do odczytu dla weryfikatora | Dziennik dostawcy dla weryfikatora | Przechowywane w celu |
| --- | --- | --- | --- | --- |
| `hetzner` | `HCLOUD_TOKEN` | Token odczytu tego samego projektu | Działania serwera i zapory sieciowej | O ile zasoby te istnieją |
| `digitalocean` | `DIGITALOCEAN_TOKEN` | Osobisty token dostępu tylko do odczytu | Akcje Droplet | Dopóki Droplet istnieje |
| `linode` | `LINODE_TOKEN` | `linodes`, `firewall`, `events` zakresy tylko do odczytu | Zdarzenia związane z kontami, wersje reguł zapory sieciowej | 90 dni |
| `vultr` | `VULTR_API_KEY` | Użytkownik z uprawnieniami do odczytu oraz `activity_logs` uprawnieniem | Dziennik aktywności konta (metoda, ścieżka, podmiot) | 30 dni, a przy subskrypcji dziennika audytowego – dłużej |
| `aws` | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` | `ec2:DescribeInstances`, `ec2:DescribeSecurityGroups`, `cloudtrail:LookupEvents` | Historia zdarzeń w CloudTrail | 90 dni |
| `phala` | `PHALA_CLOUD_API_KEY` | Klucz API tego samego obszaru roboczego | Wersje aplikacji i operacje na maszynie wirtualnej (CVM): zmiany konfiguracji i środowiska Docker Compose, ponowne uruchomienia, aktualizacje systemu operacyjnego | Chociaż aplikacja istnieje |
| `generic` | brak | brak | brak: **poświadczone samodzielnie** | – |

Dla każdej sprawy należy używać dedykowanego projektu, zespołu, konta lub subkonta: dzięki temu dostęp tylko do odczytu weryfikatora wyświetla wyłącznie to wdrożenie. Dane uwierzytelniające są odczytywane z `--provider-token-file` lub z powyższej zmiennej, nigdy z wiersza poleceń. W przypadku AWS plik zawiera `ACCESS_KEY_ID SECRET_ACCESS_KEY [SESSION_TOKEN]`; region to `--location`.

Każdy raport określa zakres zapisów każdego dostawcy. Krótko mówiąc: Hetzner rejestruje żądania konsoli; konsola odzyskiwania DigitalOcean, Lish/Glish firmy Linode oraz konsola internetowa Vultr nie są rejestrowane jako takie, więc konto root jest zablokowane przy pierwszym uruchomieniu, a logowanie do konsoli wymagałoby zresetowania hasła lub zmiany trybu rozruchu, co jest rejestrowane. Vultr zwraca adres konsoli dla każdego klucza, który może odczytać instancję; ani zapis, ani raport go nie przechowują.

## Poufna maszyna wirtualna w chmurze Phala Cloud (Intel TDX)

Gdy `--provider phala` kolektor działa w poufnej maszynie wirtualnej Intel TDX w [chmurze Phala Cloud](https://phala.com/), zarządzanej przez dstack. Host i pracownicy Phala nie mają dostępu do jej pamięci, a procesor podpisuje poświadczenie dotyczące tego, co uruchomiło się na maszynie. Weryfikator nie opiera się wyłącznie na zapewnieniach Phala: `tgwitness.tdx` samodzielnie sprawdza każde poświadczenie, aż do przypiętego certyfikatu Intel SGX Root CA, w oparciu o listy unieważnień firmy Intel oraz podpisane przez nią dane platformy, i odrzuca maszyny, które można debugować lub migrować.

| Wpis do raportu | Co pokazuje |
| --- | --- |
| `tdx_binding` | Poświadczenie obejmuje podpisane oświadczenie zbierającego oraz losową wartość niniejszego żądania. |
| `tdx_quote` | Firma Intel potwierdza ważność certyfikatu; certyfikat jest przyznawany wyłącznie wtedy, gdy Intel oceni platformę jako aktualną. |
| `tdx_compose_hash` | RTMR3, odtwarzany z dziennika zdarzeń dstack, mierzy liczbę operacji tworzenia wiadomości w aplikacji zgłaszanych przez moduł zbierający dane |
| `tdx_compose` | Ten kod jest bajt po bajcie identyczny z kodem wygenerowanym przez wdrożony commit: pliki źródłowe są przypisane na podstawie skrótu, oba obrazy na podstawie skrótu, nie ma żadnego innego kodu |
| `tdx_identity` | Poświadczenie pochodzi z wdrożonej aplikacji i instancji, przy użyciu kluczy z systemu KMS firmy Phala oraz zaszyfrowanego dysku |
| `tdx_os` | Wartości MRTD i RTMR0-2 są równe wartościom obliczonym przez weryfikator na podstawie obrazu systemu operacyjnego dstack opublikowanego przez Dstack-TEE, ustalonych na podstawie skrótu obrazu systemu operacyjnego zgłoszonego przez CVM oraz tabel ACPI generowanych przez QEMU dla konfiguracji maszyny wirtualnej: oprogramowania układowego, jądra, pliku initrd, wiersza poleceń wraz ze skrótem systemu plików root, pamięci, procesorów wirtualnych (vCPU) oraz urządzeń. Obraz deweloperski nie spełnia wymagań |

Obraz systemu operacyjnego (około 180 MB, z czego zachowuje się 21 MB) jest pobierany jednorazowo z [Dstack-TEE/meta-dstack](https://github.com/Dstack-TEE/meta-dstack/releases) do katalogu `dstack-images` obok zapisu; opcja `--tdx-image FOLDER` pozwala użyć innego folderu lub rozpakowanego obrazu, a opcja `--tdx-image none` pomija porównanie. Pomiar odbywa się zgodnie z `dstack-mr` oraz skrzynką `qemu-acpi` z Dstack-TEE/dstack. Prywatne regresje pomiarowe porównują własne dane wyjściowe ACPI programu QEMU z zachowanym cytatem z Phala Cloud; kwalifikacja na żywo wymaga również opublikowanego obrazu. `--tdx-measurements` nadal porównuje MRTD i RTMR0-2 , podane zamiast tego w formacie JSON.

Każde uruchomienie kolektora zarejestrowane w dzienniku zawiera takie poświadczenie, dlatego `verify --evidence` weryfikuje każde uruchomienie oraz obraz systemu operacyjnego, z którego nastąpił rozruch. Wersje aplikacji Phala oraz operacje CVM pełnią rolę dziennika dostawcy: zmiana konfiguracji Docker Compose po wdrożeniu powoduje odrzucenie raportu, a ponowne uruchomienia są wykazywane do weryfikacji.

W panelu wybierz **Poufna maszyna wirtualna · Phala Cloud** w sekcji **Więcej narzędzi → Dodatki → „Serwer 24/7”** i wklej klucz API Phala Cloud; szybki tunel działa tak samo jak na Hetznerze. Z wiersza poleceń:

```
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` odczytuje certyfikaty i listy unieważnionych certyfikatów firmy Intel z pliku zamiast pobierać je bezpośrednio od firmy Intel. Usługa Gateway DNS nie jest tutaj dostępna: Phala nie posiada zapory dostawcy dla ruchu wychodzącego.

Opcja `verify --source` tworzy instalator referencyjny na podstawie pobranego kodu, który uruchamia kod z tego pobrania na tym komputerze. W przypadku wdrożenia z repozytorium innego niż oficjalne opcja `verify` zwróci błąd, chyba że podasz dodatkowo opcję `--trust-source`; należy to zrobić wyłącznie w przypadku pobranego kodu, z którym się zapoznałeś.

### Sprawdź w trybie offline za pomocą verify.py

Odbiorca bez konta Phala sprawdza cytaty za pomocą samodzielnego weryfikatora w trybie offline:

```
python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_FINGERPRINT
python verify.py phala-tdx-attestation.json
```

W przypadku cytatu każdego rekordu `process.started` w archiwum dowodów oraz w przypadku cytatu podpisanego oświadczenia kolektora (również w ramach rekordu wdrożenia lub opublikowanego rekordu poświadczenia), skrypt `verify.py` sprawdza podpis ECDSA P-256 cytatu przy użyciu klucza poświadczającego, a także podpis raportu enklawy cytującej przy użyciu certyfikatu PCK, upewniając się, że raport ten wskazuje klucz poświadczający (SHA-256 klucza oraz dane uwierzytelniające QE), że pochodzi on z enklawy cytującej TDX firmy Intel w trybie produkcyjnym, a także łańcuch certyfikatów PCK → Intel SGX PCK Platform lub Processor CA → Intel SGX Root CA, którego wartość SHA-256 jest przypisana w pliku `verify.py`. Odrzuca moduły TD nadające się do debugowania lub migrowalne, sprawdza, czy REPORTDATA jest wartością SHA-512 rekordu początkowego (klucz dziennika, przebieg, drzewo źródłowe, host) lub podpisanego oświadczenia, a także wyświetla MRTD, RTMR0-3 oraz REPORTDATA.

Kolektor przechowuje również materiały uzupełniające firmy Intel (informacje o TCB, tożsamość QE, listy unieważnień oraz ich łańcuchy wydawców) wraz z każdą odpowiedzią, gdy usługa firmy Intel udziela odpowiedzi. Dzięki temu skrypt `verify.py` sprawdza podpisy i listy unieważnień firmy Intel oraz oblicza stan TCB na moment rejestracji lub na datę wydania materiałów uzupełniających, jeśli jest ona późniejsza. W przeciwnym razie wynik brzmi: „Stan TCB nie został sprawdzony (brak zabezpieczeń w archiwum)”. Informacje o tym, jaki kod uruchomiła maszyna wirtualna (mierzone przez kompozycję RTMR3, obraz systemu operacyjnego za MRTD oraz RTMR0–2), dziennik dostawcy oraz aktualna ocena firmy Intel pozostają przedmiotem weryfikacji za pomocą polecenia `python -m tgwitness.cloud verify`; w związku z tym weryfikacja offline oznacza, że przebieg poświadczonego gromadzenia danych jest niepełny i sam w sobie nie osiąga poziomu `sealed` ani profilu `attested`.

### Certyfikat poświadczający

W przypadku wdrożenia Phala plik `verify --report certificate.md` zapisuje również certyfikat: samodzielny plik `certificate.html` oraz plik A4 `certificate.pdf` zawierający werdykt, łańcuch zaufania od certyfikatu głównego firmy Intel do klucza kolektora, porównanie z serwerami standardowymi i o wysokim poziomie bezpieczeństwa, wyniki pomiarów obok wartości obliczonych na podstawie opublikowanego obrazu, informacje o tym, kto poświadcza każdą część, łańcuch certyfikatów firmy Intel, wszystkie kontrole, dziennik dostawcy oraz instrukcję powtórzenia weryfikacji. Raport w formacie JSON pozostaje dokumentem nadrzędnym; strony internetowe służą jedynie do jego wyświetlenia.

Raport jest opatrzony cyfrowym pieczęcią w postaci podpisów i znaczników czasu w pliku `certificate.seal.json` oraz w plikach `.tsq`/`.tsr` znajdujących się obok niego:

| Pieczęć | Co to wnosi |
| --- | --- |
| Kwalifikowany elektroniczny znacznik czasu, `http://tsa.belgium.be/connect` | Sygnatura czasowa zgodna z RFC 3161 na dokładnych bajtach pliku `certificate.json` pochodzącego od kwalifikowanego dostawcy usług zaufania rządu federalnego Belgii (FPS Policy and Support, BOSA). Jednostka ta figuruje jako kwalifikowana usługa znakowania czasem, ze statusem „przyznanym”, na belgijskiej liście zaufanych podmiotów UE; certyfikat główny (Belgium Root CA6) oraz pozycje tej listy, zgodnie z wersją opublikowaną 20 października 2026 r., są zapisane w pliku `tgwitness/tsa_roots.py`. Zgodnie z art. 41 rozporządzenia (UE) nr 910/2014 taki znacznik czasu uznaje się za dokładny pod względem daty i godziny oraz integralności danych w każdym państwie członkowskim UE |
| Sygnatura czasowa zgodnie z RFC 3161, FreeTSA | Drugi, niezależny znacznik czasu |
| Podpis weryfikatora | Ed25519 nad oświadczeniem podającym wartość SHA-256 raportu oraz wszystkie sygnatury czasowe, przy użyciu klucza weryfikatora (`--sign-with FOLDER`, domyślnie `~/.tgwitness/verifier`); plik PDF zawiera podpis wygenerowany tym samym kluczem |

`--timestamp URL` (powtarzalny) wybiera inne urzędy certyfikacyjne, `--timestamp none` – żaden, `--sign-with
none` pozostawia pieczęć niepodpisaną. `check-report` weryfikuje skrót raportu, podpis weryfikatora, każdy znacznik czasu w odniesieniu do zaufanego certyfikatu głównego oraz jego status kwalifikowany, a także podpis pliku PDF. Waga prawna kwalifikowanego znacznika czasu poza UE oraz całego raportu zależy od sądu lub organu, który go otrzymuje; pieczęć wskazuje, kiedy raport powstał i że nie został zmieniony.

Poświadczenie opiera się na module TDX firmy Intel i mikrokodzie oraz na fizycznej integralności magistrali pamięci. Każdy, kto kontroluje aplikację na koncie Phala, może wdrożyć inną kompozycję; pojawia się ona jako nowa wersja z nowym skrótem kompozycji. Host kontroluje źródło czasu maszyny oraz sieć.

Wdrożenie, weryfikacja poprzez `--evidence`, operacje restartu, porównanie obrazu systemu operacyjnego, zapieczętowany certyfikat oraz operacja zniszczenia zostały przeprowadzone na samej platformie Phala Cloud; proszę zapoznać się z [przebiegiem z dnia 4 listopada 2026 r.](https://phishdestroy.io/tgwitness/pl/docs/reference/verification/#live-phala-cloud-deployment--4-november-2026) W dniu 9 listopada przeprowadzono wdrożenie oparte na danych zebranych z aktywnego konta w aplikacji Telegram; w jednym z przebiegów wykorzystano klucz sesji utworzony wewnątrz maszyny wirtualnej. Proszę zapoznać się [z przebiegiem na koncie aktywnym](https://phishdestroy.io/tgwitness/pl/docs/reference/verification/#phala-cloud-with-live-telegram-account--9-november-2026) oraz [kluczem utworzonym w maszynie wirtualnej](https://phishdestroy.io/tgwitness/pl/docs/reference/verification/#session-key-created-inside-the-tdx-vm--9-november-2026).

## Zanim zaczniesz

1. Strefa Cloudflare, jej identyfikator konta oraz token API z uprawnieniami **Cloudflare Tunnel Edit**, **Zone Read** i **DNS Edit**, podany wraz z `--cloudflare-token-file` lub `CLOUDFLARE_API_TOKEN`. Dla weryfikatora: **odczyt tunelu Cloudflare**, **odczyt DNS** oraz, w przypadku dziennika audytowego, **odczyt ustawień konta**. Bez domeny [szybki tunel](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#quick-tunnel-without-a-domain) nie wymaga żadnej z tych rzeczy.
2. Dane uwierzytelniające dostawcy z uprawnieniami do zapisu w dedykowanym projekcie; `lock` korzysta z tego samego:

   - Hetzner: token API z uprawnieniami do odczytu i zapisu;
   - DigitalOcean: osobisty token dostępu z uprawnieniami do zapisu;
   - Linode: osobisty token dostępu z `linodes`, `firewall` oraz `events` zakresami odczytu/zapisu;
   - Vultr: klucz API dedykowanego konta lub subkonta;
   - AWS: dozwolone są poświadczenia IAM `ec2:DescribeVpcs`, `ec2:DescribeImages`, `ec2:CreateSecurityGroup`, `ec2:AuthorizeSecurityGroupIngress`, `ec2:RunInstances`, `ec2:CreateTags`, `ec2:DescribeInstances`, `ec2:DescribeSecurityGroupRules` oraz `ec2:RevokeSecurityGroupIngress`.
3. Commit do uruchomienia. Tag wydania jest jednokrotnie rozpoznawany jako odpowiadający mu commit za pomocą `git ls-remote`; serwer otrzymuje zawsze wyłącznie 40-znakowy commit.

## Z panelu

Na własnym komputerze, w menu **Więcej narzędzi → Dodatki → Serwer 24/7,** uruchamia się to samo `deploy` dla Hetznera w trzech krokach: wybierz Europę lub Stany Zjednoczone, wklej token Hetznera (odczyt i zapis), a następnie sprawdź typ serwera, miesięczną cenę, adres i wersję, które panel znalazł na podstawie tego tokenu. Nic nie zostanie utworzone przed potwierdzeniem. Panel wyświetla każdy krok zgodnie z raportami `deploy` , a następnie adres, token panelu oraz odcisk palca klucza podpisu. Bez domeny serwer otrzymuje [szybki tunel](https://phishdestroy.io/tgwitness/pl/docs/reference/high-assurance/#quick-tunnel-without-a-domain) ; **opcja Twoje serwery → Znajdź aktualny adres** wyszukuje go ponownie po ponownym uruchomieniu. Aby uzyskać stały adres w ramach własnej domeny, otwórz **Opcjonalne · własna domena** i dodaj token Cloudflare (przygotowany link wybiera opcje Zone Read, DNS Edit oraz Cloudflare Tunnel Edit).

Tokeny są przesyłane wraz z każdym żądaniem z karty przeglądarki do elementu TgWitness na tym samym komputerze i nie są nigdzie zapisywane; zapis wdrożenia, zredagowany plik cloud-init, token panelu oraz, w przypadku szybkiego tunelu, klucz adresu są przechowywane w `deployments/NAME` w katalogu danych. Panel udostępnia to wyłącznie głównemu administratorowi poprzez bezpośrednie połączenie typu loopback (`127.0.0.1`, bez nagłówków proxy ani tunelu); panel dostępny przez sieć wyświetla zamiast tego polecenia . Domyślną wersją jest tag wydania uruchomionego panelu, ustalany za pośrednictwem API GitHub. Lokalizacja, typ serwera i cena pochodzą z API Hetznera: `cpx22` tam, gdzie jest dostępna, w przeciwnym razie najtańszy typ x86 z co najmniej 2 GB pamięci.

## Szybki tunel bez domeny

`--quick-tunnel` zastępuje `--zone`, `--cloudflare-account` oraz `--panel-host`; nie jest wymagane żadne konto ani token Cloudflare:

```
python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \
    --ref 0123456789abcdef0123456789abcdef01234567 --quick-tunnel --provider-token-file hetzner.token
```

Na serwerze usługa cloudflared otwiera [szybki tunel](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) do panelu: losowy `https://….trycloudflare.com` adres, który zmienia się przy każdym ponownym uruchomieniu cloudflared lub serwera. Niewielka usługa na serwerze publikuje każdy adres w losowym temacie ntfy.sh , podpisując go (HMAC-SHA256) kluczem przechowywanym wyłącznie w katalogu wdrożeniowym (`address-key.txt`), i powtarza to co trzy godziny, ponieważ ntfy.sh przechowuje posty przez 12. `deploy` i **Find aktualny adres** akceptują wyłącznie podpisane posty, więc sfałszowany post nie może przekierować Ciebie i Twojego tokenu panelu na adres należący do kogoś innego. Temat znajduje się w rejestrze oraz w opublikowanym pliku cloud-init: każdy, kto je posiada, może odczytać aktualny adres, który nadal wymaga podania tokenu panelu. Serwer nie utrzymuje żadnego portu przychodzącego w żadnym przypadku.

Weryfikator nie posiada klucza adresu, a każdy, kto czyta ten wątek, może w nim publikować. Dlatego kolektor publikuje również sam adres, podpisany własnym kluczem Ed25519, a `verify` pobiera najnowszy wpis podpisany kluczem kolektora z rekordu wdrożenia; wpisy są uporządkowane według czasu, w którym ntfy.sh je odebrało, a nie według czasu, który podają. Kolektor sprzed tej zmiany niczego nie podpisuje, a `verify` pobiera wówczas najnowszy wpis i informuje o tym w ramach weryfikacji `statement`; sfałszowany wpis może jedynie spowodować niepowodzenie tej weryfikacji, ponieważ adres musi nadal odpowiadać kluczem kolektora.

Koszt: żadne konto Cloudflare nie przechowuje zapisów dotyczących szybkiego tunelu, więc `verify` zgłasza, że tunel, łącznik i sprawdzanie DNS są niedostępne, a wynik jest w najlepszym razie `incomplete` (w chmurze Phala Cloud sprawdzenie przebiega pomyślnie: łącznik działa wewnątrz mierzonego kompozytu); zapisy dostawcy, zapora sieciowa, podpisane oświadczenie, pomiary hosta i porównanie instalatorów są sprawdzane jak zwykle. Porównanie bajtów z instalatorem referencyjnym wymaga wdrożonego commitu, który już rozpoznaje `--quick-tunnel`; checkout wersji 0.7.0 kompiluje instalator domeny i zgłasza różnicę. Cloudflare oferuje szybkie tunele do celów testowych, zezwala na 200 żądań w trakcie przesyłania i nie obsługuje zdarzeń Server-Sent Events, więc aktualizacje na żywo w panelu (wersje po 0.7.0) mogą nie docierać przez tunel i konieczne jest ponowne załadowanie widoku; ta część nie została przetestowana. W przypadku , który musi działać, użyj własnej domeny.

## Wdrożenie

Najpierw sprawdź wszystko, co zostanie wysłane. `plan` nie wysyła żadnych żądań do dostawcy ani do Cloudflare:

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

Następnie należy przeprowadzić wdrożenie przy użyciu tych samych opcji i danych uwierzytelniających:

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

Typy serwerów na początek: `cpx22` (Hetzner), `s-1vcpu-2gb` (DigitalOcean), `g6-standard-1` (Linode), `vc2-1c-2gb` (Vultr), `t3.small` (AWS). `--location` oraz `--image` domyślnie na system Ubuntu 24.04 każdego dostawcy w regionie europejskim.

`--repository` pobiera commit z innego repozytorium Git dostępnego przez https, bez podawania danych uwierzytelniających w adresie URL (domyślnie `https://github.com/phishdestroy/TgWitness.git`). `deploy` akceptuje również `--out` inny katalog wdrożeniowy (domyślnie `deployments/NAME`; katalog, w którym znajduje się już wdrożenie, jest odrzucany) oraz `--wait`, czas w minutach, przez który należy czekać na podpisane oświadczenie kolektora: od 1 do 240, domyślnie 20 lub 60 dla `generic`.

Polecenie:

1. tworzy tunel Cloudflare, którego ruch przychodzący przekierowuje nazwę hosta panelu do panelu oraz, jeśli została podana, nazwę hosta świadka do `/api/witness/head` i `/api/assurance` wyłącznie;
2. tworzy rekordy CNAME z serwerem proxy dla tych nazw hostów, odrzucając nazwy, które już istnieją;
3. tworzy zaporę dostawcy bez reguł przychodzących oraz serwer za nią bez klucza SSH, bez kopii zapasowych, bez agenta konsoli oraz z cloud-init, który maskuje SSH, blokuje uprawnienia roota, instaluje `cloudflared`, pobiera dokładnie ten commit, sprawdza go i uruchamia TgWitness jako wzmocnioną usługę systemd;
4. oczekuje na podpisane oświadczenie kolektora i sprawdza, czy wymienia ono ten serwer oraz skrót tego pliku cloud-init.

`deployments/case-2026-11/` Następnie zawiera:

| Plik | Spis treści | Udostępnić? |
| --- | --- | --- |
| `deployment.json` | Identyfikatory, skróty, wykonane wywołania API (metoda, ścieżka, status) oraz pierwsze podpisane oświadczenie | Tak, za pomocą weryfikatora |
| `cloud-init.redacted.yaml` | Dokładna konfiguracja `cloud-init`, w której dwa klucze tajne zostały zastąpione przez `REDACTED` | Tak |
| `panel-token.txt` | Token panelu | Nie |

Hasło administratora dostawcy, token tunelu oraz token panelu nigdy nie są zapisywane `deployment.json`. Opublikuj odcisk palca kolektora podany na końcu za pośrednictwem kanału, nad którym nie masz wyłącznej kontroli, na przykład kanału świadka lub wiadomości do odbiorcy.

Zaloguj się do Telegrama przy `https://case.example.org` za pomocą tokenu panelu, zgodnie z [instrukcją obsługi konta](https://phishdestroy.io/tgwitness/pl/docs/reference/accounts/). Działania panelu są rejestrowane w podpisanym dzienniku; nie są to sesje SSH. [Świadek](https://phishdestroy.io/tgwitness/pl/docs/reference/witness/) może odpytywać `https://case-witness.example.org`.

Nie ma połączenia SSH: jeśli uruchomienie początkowe zakończy się niepowodzeniem, kolektor nigdy nie odpowie. Należy usunąć serwer i wdrożyć go ponownie lub skorzystać z wdrożenia debugowania, aby znaleźć przyczynę.

### Sekrety w danych użytkownika

Cloud-init przechowuje dwa klucze tajne: token panelu oraz token tunelu Cloudflare. Klucz podpisujący nie znajduje się wśród nich; jest on generowany na serwerze. Hetzner, DigitalOcean i Linode nie zwracają danych użytkownika za pośrednictwem swoich interfejsów API. Vultr zwraca je każdemu kluczowi, który ma uprawnienia do odczytu instancji, a EC2 poprzez `DescribeInstanceAttribute`. W przypadku AWS należy przekazać weryfikatorowi wyłącznie trzy działania wymienione w tabeli, nigdy `ec2:Describe*`. W przypadku Vultr należy założyć, że klucz weryfikatora może odczytać oba tokeny. Token tunelu pozwala komuś uruchomić drugi łącznik: `verify` zgłasza każdy łącznik, który nie znajduje się na serwerze, a oświadczenia kolektora nie mogą być w ten sposób sfałszowane, ponieważ każde z nich podpisuje nowe wyzwanie. W przypadku `--quick-tunnel` drugim sekretem jest klucz adresu: ktokolwiek go odczyta, może opublikować fałszywy adres, który panel zaakceptowałby.

W publicznym oświadczeniu kolekcjonera pominięto adres serwera oraz źródła logowań; oba te elementy pozostają w podpisanym dzienniku.

## Debugowanie wdrożenia i blokada

`--debug-ssh-key KEY --debug-ssh-from 198.51.100.4` Utrzymuje SSH dla jednego klucza z jednego adresu lub małej sieci, maksymalnie /24 dla IPv4 lub /48 dla IPv6. `KEY` jest już zarejestrowany u dostawcy: nazwa lub identyfikator klucza SSH w projekcie Hetzner, identyfikator lub odcisk palca klucza SSH w zespole DigitalOcean, nazwa użytkownika Linode, którego klucze SSH w profilu są dodane do konta root, identyfikator klucza SSH na koncie Vultr lub nazwa pary kluczy EC2 w danym regionie. Te opcje nie mają zastosowania do `generic`. Taki wdrożenie jest rejestrowane jako `debug` i **nigdy nie** jest zgłaszana jako o wysokim poziomie bezpieczeństwa. Po zakończeniu uruchom `sudo tgwitness-lock` jako ostatnie polecenie ostatniej sesji SSH, a następnie:

```
python -m tgwitness.cloud lock --record deployments/case-2026-11/deployment.json --provider-token-file hetzner.token
```

Zapora sieciowa traci wszystkie reguły przychodzące. Raporty pokazują następnie, kiedy połączenie SSH było dozwolone, a kiedy zostało zamknięte; okno to pozostaje widoczne.

## Usuń wdrożenie

`destroy` usuwa serwer i jego zaporę sieciową, zidentyfikowane na podstawie etykiety wdrożenia, tak aby wdrożenie, które zakończyło się niepowodzeniem w połowie, również zostało usunięte, a następnie rekordy DNS wskazujące na jego tunel oraz sam tunel. Dziennik serwera i klucz podpisujący są usuwane wraz z nim: najpierw należy wyeksportować dowody. Zapis pozostaje, oznaczony `removed`, wraz z wywołaniami API dotyczącymi usunięcia.

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

Usuwanie za pośrednictwem API jest zaimplementowane dla Hetznera. W przypadku innych dostawców `destroy` należy najpierw zatrzymać proces przed usunięciem czegokolwiek i podać nazwę etykiety do usunięcia w konsoli dostawcy. Ręcznie zainstalowany serwer (`generic`) traci jedynie swój tunel i rekordy DNS. Szybkie wdrożenie tunelu nie wymaga tokena Cloudflare: tunel kończy się na serwerze, a jego posty wygasają z serwisu ntfy.sh w ciągu 12 godzin.

## Dowolny serwer (z własnym certyfikatem)

`--provider generic` dotyczy serwera zakupionego lub zainstalowanego ręcznie. `deploy` tworzy tunel i DNS, zapisuje `install.sh` (prywatny) oraz `install.redacted.sh` (w celu publikacji), a następnie czeka. Skopiuj `install.sh` na świeżo zainstalowany serwer z systemem Ubuntu 24.04 i uruchom go tam:

```
sudo bash install.sh
```

Rejestruje on stan hosta w momencie działania (loginy, konta, `authorized_keys`, gniazda nasłuchujące, usługi, zaplanowane zadania, pakiety), instaluje commit, włącza zaporę sieciową hosta, usuwa się, maskuje SSH i kończy sesję. Raport dotyczący takiego serwera jest w najlepszym razie **SAMOŚWIADCZĄCY**: osoba, która uruchomiła instalator, miała przedtem uprawnienia roota, a weryfikatorowi nie jest dostępny żaden zapis dostawcy. Jest to jednak lepsze niż serwer o nieznanym pochodzeniu: spis zasobów, skrót instalatora i każde późniejsze logowanie są podpisane.

## Zweryfikuj

Weryfikator potrzebuje `deployment.json`opublikowanego instalatora, danych uwierzytelniających tylko do odczytu oraz, w idealnym przypadku, kopii commit’u i dowodu 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
```

Weryfikator żąda w danym momencie wszystkich wartości od dostawców i Cloudflare; zapis dostarcza jedynie identyfikatory, o które należy zapytać. Kod wyjścia wynosi 0 dla **PASS**, 1 dla **FAIL** oraz 2 dla **REVIEW**, **INCOMPLETE** lub **SELF-ATTESTED**. `--fingerprint` powinien pochodzić z niezależnego kanału; bez niego klucz jest porównywany wyłącznie z rekordem operatora. `python verify.py` nadal weryfikuje sam dowód ZIP, tak jak w sekcji [„Dowody](https://phishdestroy.io/tgwitness/pl/docs/reference/evidence/)”.

Działania dostawcy są klasyfikowane: tworzenie i uruchomienie w ciągu 30 minut od utworzenia są akceptowane; konsola, ratowanie, resetowanie hasła, odbudowa, ISO, obrazy, migawki, kopie zapasowe, Systems Manager, EC2 Instance Connect oraz otwarcia zapory sieciowej kończą się niepowodzeniem; działania związane z zasilaniem oraz wszystko, czego nie przewidziano, są oznaczane do weryfikacji. Nieznane działanie nigdy nie przechodzi niezauważone.

## Raport dotyczący przekazania dowodów

`--report report.md` tworzy raport w formacie Markdown, a `report.json` obok niego:

1. wynik, odcisk klucza kolektora, wdrożenie, dostawca, zatwierdzenie, serwer, zapora sieciowa, tunel;
2. każda kontrola wraz ze statusem i źródłem (API dostawcy, API Cloudflare, oświadczenie kolektora, dziennik dowodów);
3. dziennik dostawcy zawierający ocenę każdej czynności oraz, o ile dostawca to odnotowuje, podmiot wykonujący czynność;
4. punkty końcowe Cloudflare przechowujące połączenia tunelu, konfigurację oraz dziennik audytowy;
5. podpisane oświadczenie kolekcjonera;
6. co obejmuje raport, a co wykracza poza jego zakres;
7. polecenia umożliwiające odtworzenie tego stanu oraz element SHA-256 każdego przekazanego pliku.

Przekaż raport, `report.json`, `deployment.json`opublikowany instalator oraz dowody ZIP. Przygotuj raport jak najwcześniej: logi dostawców są przechowywane przez ograniczony czas.

## Cloudflare jako zewnętrzny świadek

Wszystko tutaj jest opcjonalne. Serwer działa nawet bez konta Cloudflare, a dwa z tych rozwiązań działają już dzisiaj:

| Co | Co pokazuje | W TgWitness |
| --- | --- | --- |
| Szybki tunel lub tunel w Twojej domenie | Dostęp do panelu jest możliwy wyłącznie poprzez tunel | Kreator serwera – patrz wyżej |
| przekaźnik drand `drand.cloudflare.com` | zapisy po rundzie drand są nowsze od tego: dziennik był tworzony na bieżąco | tryb dowodowy, **Więcej świadków**, brak konta ([format](https://phishdestroy.io/tgwitness/pl/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)) |
| Powiadomienia o stanie tunelu | gdy tunel nie działał, za pośrednictwem e-maila lub webhooka z Cloudflare | skonfiguruj je w panelu Cloudflare |
| Gateway DNS (`--gateway-dns`lub **Cloudflare Gateway DNS** w kreatorze) | każda nazwa wyszukiwana przez serwer, na którą Cloudflare odpowiadało przez TLS; zapora Hetznera nie pozwala DNS na dostęp do niczego innego; czy polityka bramy mogłaby przepisać odpowiedzi | Hetzner, bezpłatny plan Zero Trust, bez domeny; `verify` sprawdza zaporę sieciową, lokalizację, rejestrowanie, zasady, zapytania serwera oraz dziennik audytowy; tryb dowodowy kopiuje dziennik do rejestru |
| Brama z jednym klientem Cloudflare na serwerze, czyli zapora wychodząca, która zezwala wyłącznie na ruch przez Cloudflare | każde połączenie nawiązane przez serwer, a nie tylko DNS | jeszcze nie stworzono |
| Dostęp przed panelem | kto i kiedy zalogował się do panelu | nie zostało jeszcze wdrożone: wymaga własnej domeny |
| Rejestrowanie poleceń SSH | każde polecenie w sesji debugowania | jeszcze nie stworzono |

Logpush, który przechowywałby własną kopię Cloudflare w R2, jest funkcją dostępną w wersji Enterprise: w bezpłatnym planie Cloudflare odpowiada `logpush is not enabled for this account`. Dziennik bramy Gateway jest tam przechowywany przez 24 godziny, więc tryb dowodowy kopiuje go do podpisanego dziennika (**dziennik bramy Cloudflare Gateway zawierający zapytania DNS tego serwera**, token tylko do odczytu z uprawnieniem „Account Analytics Read”).

`--gateway-location ID` (w połączeniu z `--gateway-dns`) wykorzystuje istniejącą lokalizację DNS bramy, określoną przez jej 32-znakowy identyfikator, zamiast tworzyć nową; polecenie `destroy` pozostawia ją bez zmian.

Bez planu Zero Trust konto ma jedną lokalizację DNS. Gdy Cloudflare odrzuca inną, serwer udostępnia istniejącą, a jego zapytania są rozróżniane na podstawie adresu; filtr ten wymaga również uprawnień Zero Trust PII Read i `destroy` pozostawia wspólną lokalizację. Jedno zapytanie do dziennika obejmuje maksymalnie trzy godziny, więc odczyt kopii i `verify` odczyt odbywa się w trzygodzinnych przedziałach.

DNS bramy obejmuje systemowy serwer nazw. DNS przez HTTPS na porcie 443 do innego serwera nazw oraz połączenia z adresami, których nie można nigdzie znaleźć (na przykład centra danych Telegrama), nie są rejestrowane w jego dzienniku.

Cloudflare nie ma wglądu w szyfrowanie Telegrama, inne urządzenia powiązane z kontem Telegram (lista urządzeń w trybie dowodowym rejestruje je po stronie Telegrama) ani hiperwizor dostawcy.

## Odczytanie wyniku wdrożenia

W przypadku zwykłej maszyny wirtualnej dostawca kontroluje infrastrukturę hosta, a lokalny stan zasobów jest sprawdzany wraz z danymi dostawcy. W przypadku Intel TDX weryfikator dodatkowo sprawdza specyfikację sprzętową, powiązanie kolektora, kompozycję oraz pomiary systemu operacyjnego. Należy zapoznać się z poszczególnymi wynikami, aby sprawdzić, które kontrole zakończyły się powodzeniem, a które były niedostępne.

Szczegóły historyczne dotyczące zapory sieciowej zależą od dostawcy; Linode zachowuje wersje reguł. [rekord walidacji](https://phishdestroy.io/tgwitness/pl/docs/reference/verification/) zawiera listę przetestowanych wdrożeń i pozostałych aktywnych sprawdzeń, a [zakres weryfikacji](https://phishdestroy.io/tgwitness/pl/docs/reference/evidence/#verification-scope) łączy te sprawdzenia środowiska z pozyskiwaniem archiwów i ich integralnością.
