TgWitness / Dokumentacja

Co zostało przetestowane →

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

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 blokowyOperator → 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 dowodamiOperatorVerifier, tokeny tylko doodczytuSerwer, zapora sieciowabez reguł przychodzącychDziennik dostawcy i zaporasieciowaAdres łącznika tunelowegoi ruch przychodzącyPodpisane oświadczenie/api/assurancePlik ZIP z dowodamiTunel i DNSKlucz podpisującyutworzony na serwerzeAPI dostawcyAPI Cloudflaretylko 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#

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#

  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 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 ; 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:

  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. 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:

  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.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ą.