Odniesienie / Konfiguracja
Phala / Intel TDX · Wdrożenie o wysokim poziomie bezpieczeństwa
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 / Dokumentacja · Wdrażanie i przywracanie
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 w formie tekstowej
- 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
Na tej stronie
- Co może sprawdzić weryfikator
- Dostawcy
- Poufna maszyna wirtualna w chmurze Phala Cloud (Intel TDX)
- Zanim zaczniesz
- Z panelu
- Szybki tunel bez domeny
- Wdrożenie
- Wdrożenie debugowania i blokada
- Usuń wdrożenie
- Dowolny serwer (z własnym certyfikatem)
- Weryfikacja
- Raport dotyczący przekazania dowodów
- Cloudflare jako zewnętrzny świadek
- Odczytywanie wyniku wdrożenia
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, 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
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. 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 oraz kluczem utworzonym w maszynie wirtualnej.
Zanim zaczniesz#
- Strefa Cloudflare, jej identyfikator konta oraz token API z uprawnieniami Cloudflare Tunnel Edit,
Zone Read i DNS Edit, podany wraz z
--cloudflare-token-filelubCLOUDFLARE_API_TOKEN. Dla weryfikatora: odczyt tunelu Cloudflare, odczyt DNS oraz, w przypadku dziennika audytowego, odczyt ustawień konta. Bez domeny szybki tunel nie wymaga żadnej z tych rzeczy. - Dane uwierzytelniające dostawcy z uprawnieniami do zapisu w dedykowanym projekcie;
lockkorzysta 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,firewallorazeventszakresami 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:DescribeSecurityGroupRulesorazec2:RevokeSecurityGroupIngress.
- 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
; 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
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:
- 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/headi/api/assurancewyłącznie; - tworzy rekordy CNAME z serwerem proxy dla tych nazw hostów, odrzucając nazwy, które już istnieją;
- 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; - 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. Działania panelu są rejestrowane w podpisanym dzienniku; nie są to
sesje SSH. Świadek 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.jsonopublikowanego 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”.
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:
- wynik, odcisk klucza kolektora, wdrożenie, dostawca, zatwierdzenie, serwer, zapora sieciowa, tunel;
- każda kontrola wraz ze statusem i źródłem (API dostawcy, API Cloudflare, oświadczenie kolektora, dziennik dowodów);
- dziennik dostawcy zawierający ocenę każdej czynności oraz, o ile dostawca to odnotowuje, podmiot wykonujący czynność;
- punkty końcowe Cloudflare przechowujące połączenia tunelu, konfigurację oraz dziennik audytowy;
- podpisane oświadczenie kolekcjonera;
- co obejmuje raport, a co wykracza poza jego zakres;
- polecenia umożliwiające odtworzenie tego stanu oraz element SHA-256 każdego przekazanego pliku.
Przekaż raport, report.json, deployment.jsonopublikowany 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) |
| 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-dnslub 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 zawiera listę przetestowanych wdrożeń i pozostałych aktywnych sprawdzeń, a zakres weryfikacji łączy te sprawdzenia środowiska z pozyskiwaniem archiwów i ich integralnością.