Niektóre fragmenty tej strony są nadal w języku angielskim: angielski tekst źródłowy uległ zmianie po przetłumaczeniu.
Odniesienie / Dowody
Telegram · Format dowodów
Zawartość podpisanego pliku ZIP, rodzaje zapisów, potwierdzenia przetwarzania, profile użytkowników, kopie zewnętrzne oraz weryfikacja w trybie offline.
TgWitness przechowuje widoczne na koncie obserwacje z Telegrama w podpisanym dzienniku. Odbiorcy mogą zweryfikować zapisane rekordy, załączniki i raporty przy użyciu zaufanego klucza kolektora, sprawdzić czas zewnętrzny od strony trzeciej dla ostatniego rekordu oraz porównać dziennik z punktem kontrolnym, który zachowali wcześniej. Ta strona opisuje formaty, kontrole oraz materiały, które należy zachować do przekazania.
Użytkownicy mogą rozpocząć od uruchomienia pliku VERIFY.cmd w systemie Windows: program poprosi o podanie oryginalnego pliku ZIP oraz niezależnie uzyskanego odcisku klucza, wyświetli wynik wraz z objaśnieniem oraz zapisze oddzielny protokół weryfikacji. Informacje na temat konfiguracji i limitów zaufania można znaleźć w sekcji dotyczącej programów uruchamiających weryfikację oraz w sekcji poświęconej przenośnemu środowisku uruchomieniowemu.
Na tej stronie
- Co jest podpisane
- Porównanie eksportów czatów
- Przekazanie sprawy do dochodzenia
- Fragment dotyczący przekazania
- Czytelne raporty
- Kanonizacja zdarzeń
- Semantyka aktora
- Zakres: ciągłość, luki i nieobserwowane identyfikatory
- Producent
- Profile osób
- Niezależny świadek
- Manifest i punkty kontrolne
- Zakres weryfikacji
- Załączniki
- Trwałe gromadzenie i przetwarzanie potwierdzeń (0.2)
- Przygotowanie RFC 3161 i weryfikacja odpowiedzi (0.2)
- Opcjonalne rekordy w trybie gromadzenia dowodów: drand i urządzenia Telegram
Co jest podpisane#
| Materiały | Ochrona | Co należy zachować |
|---|---|---|
| Każdy wpis w dzienniku, w tym zdarzenia operacyjne | Łańcuch SHA-256 oraz podpis Ed25519 dla każdego zdarzenia | Oryginalny events.jsonl, odcisk klucza zaufanego oraz zachowany punkt kontrolny |
| Zawartość pliku ZIP z dowodami | manifest.sig podpisuje manifest kanoniczny, zawierający listę skrótów plików treści |
Kompletny plik ZIP, zawierający manifest oraz podpis |
| Zachowane załączniki | SHA-256 i liczba bajtów w podpisanym zdarzeniu typu „media.saved”; skrót pliku w podpisanym manifeście ZIP |
Oryginalne dane w zweryfikowanym pliku ZIP |
| Punkt kontrolny | Podpis Ed25519 obejmujący długość dziennika, skrót nagłówka, klucz publiczny oraz czas utworzenia | Niezależna kopia zachowana przed wprowadzeniem spornej zmiany |
| Potwierdzenie wykonania | Podpisany zapis wersji kolektora, skrótów plików źródłowych oraz ustawień początkowych, zawarty również w pliku process.started |
Potwierdzenie odbioru, powiązany dziennik oraz dowody środowiskowe dla wybranego trybu weryfikacji |
Czytelne raporty: report.html i jego części, report.json, report.pdf, chat.pdf |
Pieczęć Ed25519 na każdym pliku potwierdzająca jego zawartość; plik PDF zawiera również standardowy podpis PDF (zobacz Czytelne raporty ) | Otrzymany plik oraz odcisk klucza zaufanego; plik ZIP, którego dotyczy opis |
| Samodzielny plik CSV | Brak samodzielnego podpisu kryptograficznego; same skróty zdarzeń są niewystarczające | W celu sprawdzenia integralności prosimy o użycie dokładnie tej samej kopii, która znajduje się w zweryfikowanym pliku ZIP. |
| Zrzuty ekranu, wydruki lub pliki PDF wygenerowane przez przeglądarkę | Brak podpisu TgWitness na materiale pochodnym | Należy zachować oryginalny, zweryfikowany pakiet oraz udokumentować sposób powstania jego pochodnej wersji |
Kolektor weryfikuje podpisy dziennika przed wygenerowaniem każdego formatu eksportu. Czytelne raporty w formatach HTML i PDF posiadają własne pieczęcie; samodzielny plik CSV jest sprawdzany jako część podpisanego archiwum ZIP. Należy zachować archiwum ZIP, aby zachować bajty załączników i manifest, a także oddzielny punkt kontrolny w celu porównania dziennika z wcześniejszym punktem granicznym.
Formaty i ścieżki weryfikacji#
Tryb pozyskiwania i format wyjściowy odpowiadają na różne pytania. Tryb dostarcza dowody dotyczące gromadzenia i środowiska; każdy format zachowuje lub przedstawia część tego zapisu z uwzględnieniem poniższych sprawdzeń.
| Wynik | Weryfikacja i wykorzystanie |
|---|---|
| Dowody ZIP | Zdarzenia kanoniczne, podpisany manifest, zasięg, wpisy dotyczące przechowywania, załączniki i dostępne zewnętrzne potwierdzenia; sprawdź archiwum i wybrany tryb pozyskiwania danych. |
| Pojemnik ASiC-E | Plik ZIP z dowodami jako kontener ETSI ASiC-E (EN 319 162-1) zawierający wpis typu Mmimetype oraz plik META-INF/ASiCManifest.xml, podpisany za pomocą CAdES przy użyciu własnego certyfikatu środowiska pracy na poziomie B-B lub B-T, gdy włączone jest stemplowanie czasowe. Narzędzia weryfikujące, takie jak EU DSS, sprawdzają format i integralność, a ponieważ certyfikat jest wydany samodzielnie, zgłaszają brak kotwicy zaufania. EU DSS 6.3 z ustawieniami domyślnymi odrzuca kontener zawierający ponad 1000 plików („Wykryto zbyt wiele plików”). verify.py sprawdza manifest Ed25519 i każdy wymieniony plik, wartości SHA-256 w pliku META-INF/ASiCManifest.xml oraz w dodanym pliku ASiCManifestNNN.xml lub ASiCEvidenceRecordManifest.xml, a także zgłasza błąd w przypadku wpisu w pliku META-INF/, którego żaden z nich nie obejmuje. Nie sprawdza podpisów CAdES i informuje o tym. |
| Raporty w formacie HTML i JSON | Indywidualnie zapieczętowane widoki z odniesieniami do źródeł, wymienione również w manifeście pliku ZIP. Ich zarejestrowane liczby podsumowują rodzaje zdarzeń dziennika. |
| Raporty w formacie PDF | Pieczęć Ed25519 wraz z podpisem PDF opartym na standardzie PAdES dla zakresu bajtów: B-B lub B-T wraz z sygnaturą czasową podpisu, jeśli funkcja sygnatury czasowej jest włączona. Narzędzie weryfikujące TgWitness wykorzystuje zaufany klucz Ed25519; wyświetlanie informacji o zaufaniu certyfikatu przez przeglądarkę stanowi odrębną kontrolę. |
| CSV | Widok arkusza kalkulacyjnego objęty manifestem pliku ZIP. Eskapowanie formuł zabezpiecza korzystanie z arkusza kalkulacyjnego; oryginalny podpisany tekst pozostaje w dzienniku. |
| JSONL | Podpisane zapisy zdarzeń, w tym odniesienia do załączników. Plik ZIP z dowodami zawiera dodatkowo zachowane bajty załączników. |
| Eksport czatu i widoki zgodne z wersją na komputery stacjonarne | Pozyskiwanie historii i dostępnych zapisów dziennika administracyjnego wraz z żądanym renderowaniem i podpisanym archiwum. Zapisane wersje monitoringu na żywo stanowią odrębną ścieżkę pozyskiwania danych. |
| Pliki multimedialne i zapisy zawierające wyłącznie skróty | Zapisane bajty są porównywane z ich wartością SHA-256 oraz odniesieniem do komunikatu. Przechwytywanie wyłącznie skrótów pozwala zachować dostępne metadane skrótów do późniejszego porównania z bajtami pliku. |
| STIX/MISP i profile osób | Wyodrębnione obserwacje powiązane ze źródłem, identyfikatory kont i dopasowania analityczne. Sygnatury profili i skróty rekordów można porównać z oryginalnymi dowodami; pochodzenie pamięci podręcznej awatarów jest oznaczone oddzielnie. |
| Fragment protokołu przekazania | Podpisane zasady ujawniania, niezmienione zapisy oraz oznaczone zminimalizowane zapisy zachowujące oryginalne skróty/podpisy. Należy użyć zachowanego oryginału do porównania wymagającego ukrytych pól. |
| Świadek i potwierdzenia czasowe | Wcześniejsze granice dziennika, ciągłość oraz poszczególne zweryfikowane deklaracje czasowe. Towarzyszą one kontrolom pozyskiwania i archiwizacji. |
| Dostawa chroniona hasłem | Chroni załączony pakiet podczas przesyłania. .tgwpw wykorzystuje szyfrowanie uwierzytelnione algorytmem AES-GCM, w tym uwierzytelniony rekord końcowy; załączony dziennik zachowuje swoje podpisy i potwierdzenia odbioru. |
Wydruk lub zrzut ekranu to prezentacja podpisanego materiału. Jego identyfikator raportu , odcisk klucza oraz kod QR pomagają zlokalizować oryginalny plik w celu weryfikacji. Oświadczenia o przechowywaniu rejestrują informacje o wyznaczonym ekspertu oraz o przekazaniu danych; wyniki weryfikacji i potwierdzenia odbioru są przechowywane jako oddzielne dowody.
Podpisy zewnętrzne#
Podpis może również pochodzić z klucza, którego TgWitness nigdy nie przechowuje, takiego jak
kwalifikowany podpis elektroniczny śledczego lub pieczęć organizacji. W przypadku Eksport, Zewnętrzny
podpis w przypadku przygotowanego eksportu bez hasła przekazuje bajty do podpisania: nowy
META-INF/ASiCManifestNNN.xml wyświetlenie listy wszystkich plików wraz z ich wartościami SHA-256 dla kontenera ASiC-E
lub eksportu manifest.json dla pliku ZIP. Podpisujący zwraca plik CMS (CAdES)
.p7s, w osobnym pliku lub z treścią osadzoną w dokumencie.
TgWitness sprawdza, czy podpis obejmuje dokładnie te bajty, oraz weryfikuje go przy użyciu certyfikatu podpisującego (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448). Łańcuch jest sprawdzany wyłącznie względem certyfikatów głównych dostarczonych przez operatora; unieważnienie, listy zaufanych podmiotów oraz status kwalifikowany nie są sprawdzane. Panel wyświetla jeden stan dla każdego podpisu: oczekiwanie na podpis, dołączony i niesprawdzony, zweryfikowany, algorytm nieobsługiwany, podpis nieważny, podpisane bajty nie zgadzają się lub certyfikat nie jest połączony w łańcuchu z dostarczonym certyfikatem głównym. Zmiana eksportu po rozdysponowaniu bajtów powoduje ustawienie wszystkich jego podpisów na „podpisane bajty nie zgadzają się”.
Pobieranie z podpisami powoduje umieszczenie podpisów i ich manifestów w META-INF
w kontenerze ASiC-E. W przypadku pliku ZIP umieszcza niezmieniony plik ZIP oraz .p7s pliki oraz
SIGNATURES.txt do zewnętrznego pliku ZIP. Nieprawidłowe podpisy oraz podpisy nakładające się na inne bajty
są pomijane. Podpis oparty na algorytmie, którego TgWitness nie może zweryfikować, jest dołączany;
panel wyświetla jego stan, podobnie jak SIGNATURES.txt w przypadku pliku ZIP.
O podpisanych obrazkach z czatu#
Pobranie podpisanego pliku ZIP z podglądu obrazu powoduje zapisanie stron w formacie PNG, pages.sig.json oraz
README.txt. Każda strona kończy się numerami rekordów dziennika, które wyświetla, czatem,
czasem renderowania, odciskiem klucza obszaru roboczego oraz poleceniem, które go weryfikuje. Panel
wysyła jedynie wartości SHA-256 i numery rekordów każdej strony; serwer potwierdza, że rekordy
należą do czatu, podpisuje oświadczenie (tgwitness-image-attestation-v1) za pomocą
klucza obszaru roboczego i rejestruje podpisanie jako export.image_attested.
python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip
Weryfikator sprawdza podpis, przyporządkowuje każdy plik PNG do podpisanej strony i podaje
odcisk klucza. --fingerprint Porównuje tożsamość podpisującego z odciskiem palca uzyskanym od
nadawcy w sposób niezależny. --evidence odczytuje podpisany plik ZIP z dowodami z tego samego obszaru roboczego i
wymaga, aby każdy zapis obrazów był obecny z tym samym skrótem. Zmieniony piksel,
zmienione oświadczenie lub inny klucz powodują niepowodzenie weryfikacji. Obrazy przedstawiają zapisane dane w
własnym układzie TgWitness; nie pokazują tego, co Telegram wyświetlał komukolwiek.
Porównanie eksportów czatów#
Należy zweryfikować i porównać dwa podpisane pliki ZIP z eksportem czatu z niezależnie zachowanymi odciskami palców podpisujących:
python -m tgwitness.verify first.zip --compare second.zip \
--fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256
Opcje --require i --require-tier nie mogą być używane razem z opcją --compare; należy sprawdzić wymagany
profil każdego archiwum za pomocą jego własnej weryfikacji.
Gdy oba archiwa rejestrują te same numeryczne identyfikatory konta i czatu, rekordy są łączone w pary
na podstawie identyfikatora wiadomości. Niezmienione oznacza zgodność całego zapisanego rekordu JSON:
pełny tekst, autor, daty, adresat odpowiedzi, zagnieżdżone metadane i pola nieznane są
uwzględnione. Kolejność kluczy obiektu JSON nie ma znaczenia; znaczenie mają natomiast brakujące pola, wartości null, typy wartości
oraz kolejność tablic. Podgląd składający się z 300 znaków służy wyłącznie do wyświetlania. Zmienione wpisy
oznaczają różniące się elementy najwyższego poziomu changed_fields, w tym zmiany niewidoczne w tym podglądzie.
Podczas dopasowywania zduplikowane identyfikatory wiadomości są odrzucane, a nie nadpisywane.
Różnicą może być zmieniona nazwa wyświetlana, liczba wyświetleń, adnotacja do kolekcji lub inne metadane obserwacji. Edycje w Telegramie pojawiają się jako osobne zdarzenia edycji, a weryfikacja każdego archiwum pokazuje, czy archiwum to jest nienaruszone. Nieprzetworzone rekordy pozostają w porównaniu i są porównywane na podstawie ich zapisanej reprezentacji.
W przypadku różniących się lub brakujących identyfikatorów kont/czatów narzędzie wyszukuje potencjalne
odpowiedniki na podstawie nadawcy, pełnego tekstu, skrótu pliku, typu multimediów oraz pięciosekundowego
tolerancji czasowej, a następnie zgłasza je jako Dopasowane zamiast Niezmienione. Nieprzetworzone
rekordy pozostają bez dopasowania. Różnice w sparowanych rekordach są wymienione w changed,
w tym w trybie treści. Przy użyciu opcji --json opcja matched zlicza potencjalne pary, a
unchanged zlicza pary, których kompletne zapisane rekordy są identyczne. Istniejące
wyjście changed_fields oraz całkowitoliczbowe unchanged pozostają zgodne z
wcześniejszymi wynikami porównań. Format archiwum i weryfikacja podpisu pozostają bez zmian.
Przekazanie sprawy do dalszego dochodzenia#
- W notatkach dotyczących sprawy należy odnotować numer referencyjny sprawy, operatora, numeryczny identyfikator konta Telegram, wybrane źródła, zasady gromadzenia danych oraz okres gromadzenia. TgWitness zapisuje obserwacje oraz obsługuje notatki powiązane ze źródłami i zbiory danych w panelu Case Board. Dokumentację dotyczącą przekazania i przechowywania należy przechowywać wraz z materiałami sprawy. Sprawdź planowaną konfigurację gromadzenia danych za pomocą procedury akceptacji na żywo.
- Przed wykorzystaniem eksportowanych danych należy niezależnie zachować odcisk klucza publicznego obszaru roboczego. Należy pozostawić włączony tryb dowodowy (ustawienie domyślne), tak aby punkty kontrolne otrzymywały potwierdzenia zgodne z RFC 3161 i OpenTimestamps. Podczas gromadzenia danych należy zapisywać podpisane punkty kontrolne poza kolektorem. Należy rejestrować przerwy oraz ograniczenia widoczności konta.
- Proszę wyeksportować podpisany plik ZIP i zachować podpisane potwierdzenie wykonania. Proszę użyć punktu kontrolnego na granicy eksportowanego dziennika lub przed nią. Późniejszy punkt kontrolny może prawidłowo odrzucić wcześniejszy eksport jako zbyt krótki. Eksporty obejmują pełny dziennik obszaru roboczego, niezależnie od filtrów panelowych; proszę przejrzeć materiał przed jego udostępnieniem.
-
Odbiorca powinien zweryfikować plik ZIP za pomocą zaufanej kopii weryfikatora, niezależnie dostarczonego odcisku palca oraz certyfikatu głównego urzędu czasoprzestrzennego, uzyskanego oddzielnie. Z zaufanego środowiska z aktywnym środowiskiem Python:
python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidenceOdcisk palca i sprawdzony znacznik czasu ostatniego zapisu spełniają minimalne wymagania dotyczące dowodów; w przeciwnym razie opcja
--require evidencekończy działanie z kodem 2. Punkt kontrolny stanowi dodatkową weryfikację, ponieważ jest podpisany kluczem kolektora. Pomyślny wynik zwracakey_pinned: trueorazcheckpoint_checked: true, gdy oba dane wejściowe są podane i zaakceptowane. Należy zachować wynik weryfikacji.For a handover requiring the final exported record to be witnessed, use `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`. This refuses an export with an unwitnessed tail. Add `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the witness posts as external time. See the [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).- Zapisz w rejestrze przechowywania archiwum wartość SHA-256, granicę eksportu, datę transferu, nadawcę oraz
odbiorcę. Zachowaj oryginalny pakiet w nienaruszonym stanie i pracuj
na kopiach. Udostępniaj pliki dowodowe zamiast prywatnego katalogu danych aplikacji,
który zawiera również sesje kont i klucze podpisywania.
Do przesyłania wybierz plik ZIP z szyfrowaniem AES-256 chroniony hasłem lub bezpieczniejszy kontener
.tgwpw. Plik ZIP wykorzystuje niedrogą metodę generowania hasła programu WinZip; należy użyć długiego, losowego hasła. Plik.tgwpwwykorzystuje algorytm scrypt oraz AES-256-GCM i otwiera się za pomocą samodzielnego polecenia weryfikatoraunseal-password. Hasło nie jest przechowywane i służy wyłącznie do ochrony poufności; odbiorca odszyfrowuje archiwum i weryfikuje podpisany plik eksportowy znajdujący się w środku, który pozostaje niezmieniony. - Aby nadać sygnaturę czasową punktowi kontrolnemu poza trybem dowodowym, należy postępować zgodnie z procedurą RFC 3161 i zachować żądanie, punkt kontrolny, informacje o zaufanym urzędzie certyfikacji oraz zweryfikowaną odpowiedź organu certyfikującego. Samo przygotowanie żądania nie zapewnia uzyskania sygnatury czasowej.
- Zapisz w rejestrze przechowywania archiwum wartość SHA-256, granicę eksportu, datę transferu, nadawcę oraz
odbiorcę. Zachowaj oryginalny pakiet w nienaruszonym stanie i pracuj
na kopiach. Udostępniaj pliki dowodowe zamiast prywatnego katalogu danych aplikacji,
który zawiera również sesje kont i klucze podpisywania.
Do przesyłania wybierz plik ZIP z szyfrowaniem AES-256 chroniony hasłem lub bezpieczniejszy kontener
W przypadku pliku .tgwpw należy użyć niezależnie uzyskanego weryfikatora i wybrać nowy plik wyjściowy
z oryginalnym rozszerzeniem: python verify.py unseal-password export.tgwpw --out evidence.zip.
Polecenie wyświetla monit o podanie hasła; opcja --password-stdin odczytuje jedną linię w celu automatyzacji.
Nigdy nie nadpisuje istniejącego pliku i publikuje tekst jawny dopiero po uwierzytelnieniu wszystkich rekordów.
Następnie należy przeprowadzić standardową weryfikację podpisu na odszyfrowanym pliku.
Kontener wykorzystuje algorytm scrypt (N=131072, r=8, p=1, sól o długości 16 bajtów; około 128 MiB pamięci RAM)
oraz AES-256-GCM z rekordami o rozmiarze 1 MiB i uwierzytelnionym rekordem końcowym. Zaszyfrowany
rekord metadanych przechowuje wewnętrzną nazwę pliku, dzięki czemu pobrane kontenery można przemianować.
Pomyślna weryfikacja potwierdza integralność w odniesieniu do zaufanego klucza kolektora i zachowanego zakresu. Zobacz zakres weryfikacji, aby zapoznać się z założeniami dotyczącymi zaufania oraz wynikami walidacji przeprowadzonych kontroli.
Fragment protokołu przekazania#
Podpisany plik ZIP zawiera cały dziennik obszaru roboczego. Gdy sąd, prawnik lub biuro ds. nadużyć potrzebuje
tylko niektórych czatów, określonego okresu lub konkretnych osób, opcja Eksporty → Wyciąg do przekazania przygotowuje zredukowaną
kopię (tgwitness-handover-v1) zgodnie z wybranymi zasadami ujawniania.
Operator określa cel i wybiera rozmowy, opcjonalny okres (UTC), osoby, których
dotyczy wyciąg, co dzieje się z pozostałymi osobami (są wyświetlane, zastępowane pseudonimami P01, P02… lub pominięte
), które treści wiadomości pozostają, które załączniki i zdjęcia profilowe są uwzględnione oraz czy
numery telefonów i adresy e-mail w tekstach są zamaskowane. Cel i te zasady znajdują się w
podpisanym manifeście oraz w raporcie; dziennik rejestruje wpis „handover.exported” wraz z danymi dostępu, które
go przygotowały, oraz skrótem SHA-256 pliku, a nie jego treścią.
Skrypt verify.py sprawdza fragment na dwa sposoby. Rekord oznaczony jako niezmieniony jest weryfikowany w całości: jego
treść jest porównywana z jego skrótem, podpisem Ed25519 oraz linkiem do dołączonego poprzednika. W przypadku
rekordu zminimalizowanego zachowywane są oryginalny skrót i podpis, więc podpis nadal się zgadza, ale
pól, których treść została utajniona, nie da się na tej podstawie ponownie obliczyć; rekord określa, co zostało utajnione, a raport
to zaznacza. Rekordy usług dotyczące całego konta (rozpoczęcia i zakończenia, luki w zasięgu, powiadomienia o połączeniu, sieci i pamięci masowej,
zmiany zakresu i ustawień) zachowują tylko pola wymienione dla danego rodzaju: listy czatów w nich zawarte są ograniczane do wybranych
czatów, a ich sumy są przeliczane; luka w sondażu na żywo w czacie spoza wyboru powoduje utratę tego czatu, liczby jego wiadomości
oraz konta świadka; w wybranym czacie sondażowym konto świadka jest zastępowane jego pseudonimem, chyba że
wszyscy są widoczni lub jest to jedna z wybranych osób. Manifest podaje długość dziennika i jego nagłówek wraz z podpisem zbierającego nad tym
nagłówkiem oraz zlicza pominięte rekordy; plik coverage.json opisuje wybrane czaty. Nowe wyciągi zawierają również
plik proofs.jsonl: dla każdego uwzględnionego rekordu oraz dla nagłówka dziennika ścieżka Merkle’a od
oryginalnego skrótu rekordu do korzenia dziennika wymienionego w podpisanym manifeście. Plik verify.py sprawdza każdą
ścieżkę, dzięki czemu każdy rekord jest identyfikowany jako należący do tego samego dziennika o danej długości i nagłówku, bez konieczności
przeglądania całego dziennika; wyciągi zawierające 100 wiadomości są sprawdzane w ciągu około jednej sekundy, niezależnie od rozmiaru dziennika.
--range=CHAT:FROM-TO dodatkowo potwierdza, że wiadomości od FROM do TO z danego czatu znajdują się w wyciągu
i podaje liczbę rekordów, które zostały w tym zakresie sprawdzone. Nazwy zawarte w nazwach
plików nie są wykrywane. Przed udostępnieniem należy przejrzeć ostateczne pliki: swobodny tekst, nazwy plików i wybrane
załączniki nadal mogą umożliwić identyfikację osób. Należy zachować pełny, podpisany plik ZIP: wyciąg stanowi ujawnienie, a nie zamiennik.
Czytelne raporty#
Podpisane dowody, pliki przekazywane oraz archiwa ZIP czatów zawierają czytelne raporty w formatach HTML i JSON, a także
PDF, o ile dostępne są wymagane czcionki, w wybranym języku raportu. Każdy
raport jest zabezpieczony kluczem Ed25519 obszaru roboczego i można go zweryfikować osobno: `
python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]`.
report.html/chat.html: instrukcja plombowania (tgwitness-report-seal-v1) zamyka plik i podpisuje każdy poprzedzający go bajt (SHA-256). Długie dzienniki i czaty są dzielone na części o konfigurowalnej wielkości (Ustawienia raportu, od 500 do 100 000 rekordów; domyślnie 5 000):records/records-0001.htmllubmessages/messages-0001.html, z których każdy jest opatrzony numerem, zakresem i sumą oraz wymieniony wraz z plikiem SHA-256 w podpisanym manifeście. Serie sygnałów kontrolnych kolektora są wyświetlane jako jeden wiersz, chyba że w ustawieniach raportu wybrano wyświetlanie ich pojedynczo.report.json(tgwitness-report-json-v1, kluczeformat,report,seal): pieczęć podpisuje SHA-256 kanonicznego JSON zreport, dzięki czemu fakty mogą być odczytywane przez systemy obsługi spraw i skrypty, a na ich podstawie można dokonać wyboru w celu ochrony danych, przy czym podpisany plik pozostaje nienaruszony.report.pdf/chat.pdf: formalny dokument przeznaczony do wydruku i archiwizacji, podpisany dwukrotnie w tych samych bajtach, obejmujący cały plik z wyjątkiem wartości podpisu (/ByteRange). Standardowym podpisem PDF jest PAdES baseline (ETSI EN 319 142-1,/SubFilter /ETSI.CAdES.detached: CMS z algorytmem SHA-256 i ECDSA P-256, certyfikatem podpisującym v2, bez czasu podpisania CMS; deklarowany czas to/M) na poziomie B-B lub B-T z sygnaturą czasową RFC 3161 w CMS, gdy funkcja sygnatury czasowej jest włączona, a instytucja certyfikująca sygnaturę czasową odpowiada na trasie w przypadku żądań spoza Telegramu. Wykorzystuje samodzielnie wydany certyfikat podpisywania dokumentów przechowywany w skarbcu obszaru roboczego; jego numer seryjny podmiotu jest odciskiem palca klucza Ed25519. Pieczęć Ed25519 jest przesyłana wewnątrz CMS jako niepodpisany atrybut2.25.240684792623320047764573196045913242332i określa SHA-256 certyfikatu za pomocą"content": "pdf-byte-range", dzięki czemu klucz Ed25519 poświadcza certyfikat. Certyfikat nie jest kwalifikowany: czytnik plików PDF wyświetla podpis jako ważny, a podpisującego jako nieznanego lub niezaufanego, dopóki certyfikat nie zostanie uznany za zaufany; zamiast tego należy porównać odcisk palca klucza Ed25519. Pliki PDF w języku chińskim, japońskim i koreańskim wymagają czcionki na serwerze (lub wTGWITNESS_FONT_DIR); bez niej plik ZIP zawiera wyłącznie raporty w formacie HTML i JSON .report.en.html,report.en.pdf/chat.en.html,chat.en.pdf: angielski oryginał tego samego raportu, gdy język raportu nie jest angielski, opieczętowany i podpisany w ten sam sposób i wskazany w podpisanym manifeście podreport.original. Raport w wybranym języku zaczyna się od zalecenia, aby złożyć angielski oryginał wraz z tłumaczeniem poświadczonym lub przysięgłym; zob. Tłumaczenie raportów dla sądu.
W kanale lub supergrupie Telegram
numeruje wiadomości 1, 2, 3… w kolejności. Eksport czatu zawiera listę
pierwszego i ostatniego numeru, liczbę obecnych wiadomości oraz każdy ciąg brakujących numerów w
message-ids.json
, manifeście i nagłówku chat.json
, a także zaznacza każdą lukę w miejscu, w którym występuje ona w
transkrypcji. verify.py
ponownie je zlicza od chat.json
. Brakujący numer to wiadomość, której Telegram
nie zwrócił (usunięta przed eksportem lub niewidoczna dla konta); w czatach prywatnych i
grupach podstawowych numery są wspólne dla wszystkich czatów danego konta, a luki nie są liczone.
Po odczytaniu historii eksport ponownie żąda od Telegrama podania wszystkich brakujących numerów, według numerów (channels.getMessages, maksymalnie 10 000 numerów, w tym 1 000 poniżej pierwszej wiadomości, rozłożonych równomiernie na wszystkie luki, jeśli jest ich więcej). Wynik znajduje się w message-ids.json oraz w raporcie. Pusta odpowiedź oznacza, że numer jest niedostępny dla tego konta w momencie ponownej weryfikacji; przyczyna nie jest przy tym określona. Wiadomość zwrócona podczas ponownej weryfikacji zostaje dodana do eksportu i oznaczona found_on_recheck.
Gdy w obszarze roboczym obserwacji wykryto, że wiadomości z czatu zostały usunięte, nie występowały podczas ponownej kontroli lub zostały edytowane, eksport czatu dodaje journal-changes.jsonl: te zapisy dziennika, każdą zapisaną wersję oraz powiadomienie, a każdy z nich wraz z skrótem i podpisem Ed25519, które otrzymał w dzienniku. verify.py Ponownie oblicza skrót każdego zapisu, weryfikuje jego podpis względem klucza eksportu oraz porównuje liczbę z podpisanym manifestem; eksport dowodów zawiera kompletny łańcuch skrótów. Raport wymienia te wiadomości w sekcji „Usunięcia” oraz „Wcześniejsze wersje”.
Każdy raport rozpoczyna się od W skrócie: jeden akapit, a następnie to, co pokazuje materiał, i to, co zawiera zapis. Własna pieczęć strony zmienia kolor na bursztynowy, gdy przeglądarka sprawdzi podpis pieczęci, a nie samą stronę: przeglądarka nie nadaje stronie własnych bajtów. Zmienia kolor na zielony tylko wtedy, gdy czytelnik przeciągnie plik do pola sprawdzania na końcu strony i każdy bajt się zgadza, oraz tylko wtedy, gdy wyświetlana strona jest tym plikiem; w przeciwnym razie zmienia kolor na czerwony.
Każdy raport podaje dokładną nazwę programu: commit w systemie Git, w którym kolektor uruchamia się po pobraniu kodu lub
instalator ustawia TGWITNESS_COMMIT, oraz SHA-256 plików źródłowych (source_tree_sha256,
kanoniczny JSON ścieżki → SHA-256 każdego pliku .py, .js, .css, .html i .svg w
pakiecie), które odtwarza pobranie kodu z tego commitu, o ile pliki nie zostały zmienione. Klient Telegram
jest nazywany na podstawie swojej biblioteki, warstwy API i centrum danych. W momencie rozpoczęcia obserwacji oraz rozpoczęcia i zakończenia eksportu czatu
kolektor pyta Telegram o jego czas (updates.getState, w
całych sekundach) i rejestruje czas Telegram pomniejszony o czas zegara kolektora, z uwzględnieniem niepewności wynikającej z
czasu przesyłu w obie strony; raporty przedstawiają te pomiary w sekcji „Łańcuch dowodowy”. Eksport czatu rejestruje również
moment odczytania historii, oprócz dat wiadomości.
Przeglądarka raportów w trybie offline i przewodnik po archiwizacji#
Przed otwarciem plików chat.html lub report.html należy rozpakować cały plik ZIP. Przeglądarka umożliwia wyszukiwanie,
filtrowanie, przeglądanie uczestników, wskaźników, szczegółów zapisów oraz wybór plików JSON i CSV bez konieczności korzystania z serwera. Należy
trzymać pliki viewer/ i media/ obok raportu. Wybrane elementy są pochodnymi: należy użyć pliku verify.py SELECTION.json
--evidence ARCHIVE.zip, aby porównać je z podpisanym archiwum.
Narzędzie weryfikujące sprawdza identyfikator raportu, klucz podpisu, granice archiwum oraz każdą wybraną pozycję; pozycje edytowane,
brakujące i zduplikowane nie przechodzą weryfikacji. Uwagi dotyczące wyboru oraz czas utworzenia pozostają niepodpisanymi metadanymi.
Luki w numeracji wiadomości są wyświetlane wyłącznie w przypadku kompletnego, niefiltrowanego strumienia czatu w porządku rosnącym. Ukrycie kategorii lub niepowodzenie w załadowaniu fragmentu danych nie może sprawić, że pominięty wiersz stanie się dowodem na brak wiadomości. Podświetlanie wyników wyszukiwania działa na tekście zwykłym przed zastosowaniem sekwencjiHTML, zachowując dosłowne znaczniki.
Przeglądarka sprawdza podpisy manifestu, identyfikator raportu i klucz oraz wszystkie wymienione skróty plików. Odrzuca niejednoznaczne lub nieprawidłowo sformowane struktury ZIP, zduplikowane nazwy i niebezpieczne ścieżki, a także ogranicza rozmiar plików do 256 MiB i deklarowaną całkowitą zawartość do 4 GiB. W przypadku większych archiwów należy użyć samodzielnego weryfikatora. Ta kontrola przeglądarkowa uzupełnia sprawdzanie łańcuchów dzienników i semantyki danych przeprowadzane przez weryfikator.
Plik README.txt zawiera przewodnik startowy, zsynchronizowany spis plików, instrukcje weryfikacji oraz
uwagi dotyczące formatu danych w języku raportu, a po nim znajduje się kompletny przewodnik w języku angielskim. Plik SHA256SUMS obejmuje
wymienione w nim pliki, z wyłączeniem samego siebie, plików manifest.json i manifest.sig; podpisany manifest
obejmuje również plik SHA256SUMS. Należy pozostawić oryginalny plik ZIP bez zmian, a pliki robocze zapisać poza
rozpakowanym folderem. Raporty PDF zawierają zakładki sekcji oraz identyfikatory sprawy/raportu na kolejnych stronach.
Czat w momencie eksportu#
Eksport czatu rejestruje informacje podane przez Telegram na temat czatu w momencie rozpoczęcia eksportu: własne
etykiety Telegram (scam, fake, restricted wraz z uzasadnieniami, verified), nazwy użytkowników, opis, liczbę
członków i administratorów, powiązaną dyskusję, ochronę treści, informację, czy nowi członkowie widzą wcześniejsze
wiadomości oraz od której wiadomości na tym koncie widoczna jest historia (available_min_id), datę
pierwszej wiadomości, jeśli jest to data utworzenia czatu, oraz SHA-256 zdjęcia czatu (zapisanego w media/).
Rejestruje pozycję konta eksportującego w czacie: rolę, datę dołączenia, kto je zaprosił, a w przypadku
administratora – jego uprawnienia. Zamiast tego podawana jest nazwa żądania, które Telegram odrzuciło.
Gdy konto eksportujące jest kontem administratora, eksport odczytuje dziennik administratora czatu (Telegram przechowuje go przez około
48 godzin) do pliku admin-log.json: usunięcia i edycje wraz z dostarczoną treścią,
kontem wykonującym czynność oraz datą działania źródłowego. Wpisy te uzupełniają
zarchiwizowane wersje dziennika na żywo oraz zapisy potwierdzeń usunięć.
Wskaźniki#
Lista raportów oraz archiwum zawierają oznaczenia indicators.csv
, indicators.stix.json
(STIX 2.1
)
oraz indicators.misp.json
(zdarzenie MISP
), na podstawie których dział ds. nadużyć może podjąć działania w odniesieniu do zarejestrowanych wiadomości:
linki i domeny (również ukryte w tekście, przyciskach i podglądach linków), adresy kryptowalut,
nazwy użytkowników i linki zaproszeniowe Telegram
, numery telefonów, adresy e-mail oraz zapisane zdjęcia.
Adresy Bitcoin, Litecoin, Dogecoin i TRON są uwzględniane tylko wtedy, gdy ich suma kontrolna base58 jest poprawna,
adresy segwit – gdy ich suma kontrolna bech32 lub bech32m jest poprawna, a adresy TON – gdy ich suma CRC
jest poprawna; adresy EVM i Solana są oznaczone jako niesprawdzone. Zdjęcia zawierają SHA-256
oraz percepcyjny
hash (dHash, 64 bity), który pozostaje niemal niezmieniony w przypadku ponownej kompresji lub zmiany rozmiaru kopii. Raporty zapisują
wskaźniki w taki sposób, aby nie otwierały się przypadkowo (hxxps[://]example[.]com
); pliki zachowują
wartości w niezmienionej postaci. Każdy wskaźnik jest oznaczony jako nieznany i nieprzeznaczony do automatycznego wykrywania (STIX
,
indicator_types: unknown
, MISP
, to_ids: false
, dystrybucja do własnej organizacji): umieszczenie na
liście oznacza, że wiadomość go zawierała, a nie że jest złośliwy. Link, którego tekst wskazuje
inny adres niż ten, który się otwiera, jest zaznaczony w raporcie.
Raporty typu „PDF” kończą się oświadczeniem biegłego, które należy podpisać odręcznie, listą kontrolną dla notariusza lub biegłego sądowego oraz kodem QR (znajdującym się również na pierwszej stronie) zawierającym identyfikator raportu, odcisk klucza oraz SHA-256 danych referencyjnych, dzięki czemu wydruk pozwala na powrót do archiwum.
Kanonizacja zdarzeń#
Dane wejściowe skrótu składają się dokładnie z następujących pól:
seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash
Serializacja przy użyciu formatu JSON zgodnego z Pythonem w kodowaniu UTF-8, z posortowanymi kluczami obiektów, bez escapingu znaków ASCII, bez zbędnych spacji oraz bez wartości NaN/nieskończoności:
json.dumps(value, ensure_ascii=False, sort_keys=True,
separators=(",", ":"), allow_nan=False).encode("utf-8")
Suma kontrolna SHA-256 tych bajtów stanowi skrót zdarzenia. Podpis generowany jest algorytmem Ed25519 na podstawie 32 surowych bajtów skrótu, a następnie kodowany w base64. Pierwszy poprzedni skrót (previous_hash) składa się z 64 zer. Numery sekwencyjne zaczynają się od 1 i rosną o 1. Wszystkie zdarzenia, w tym zdarzenia operacyjne, są ujęte w jednym łańcuchu. Nie stosuje się eliminacji zduplikowanych dostarczeń: powtarzające się obserwacje stanowią odrębne potwierdzenia odbioru, a nie twierdzenie o odrębnych działaniach w Telegramie.
Surowe dane Telegramu mają postać ciągów znaków zgodnych z normą ISO; pola binarne stają się obiektami zawierającymi
bytes_base64. Tekst wiadomości, encje, deskryptory multimediów, metadane odpowiedzi, reakcje
oraz działania serwisowe są zachowywane w surowych metadanych wiadomości, o ile zostały dostarczone. Wiadomość na żywo
zachowuje również aktualizację Telegramu, która ją dostarczyła, w transport_update; gdy
ta aktualizacja zawiera tę samą wiadomość co raw, jej message jest
{"same_as": "raw"} zamiast drugiej kopii.
observed_at to czas UTC, w którym kolekcjoner utworzył rekord; source_at to data
podana przez to zdarzenie Telegram. Rekordy zapisywane podczas przetwarzania aktualizacji na żywo zawierają
payload.received_atczas UTC, w którym aktualizacja dotarła do kolektora, oraz
payload.processing_delay_ms. Edycje na żywo zachowują podaną datę edycji, migawki historii
zachowują datę wiadomości wraz z aktualnym czasem obserwacji, a zwykłe
powiadomienie o usunięciu rejestruje czas odbioru z datą źródła równą null. Wpisy w dzienniku administracyjnym
zachowują oddzielnie podaną datę działania. Kolejność odbioru i kolejność zdarzeń źródłowych
to odrębne osie czasu, a obserwacje zegarowe i potwierdzenia odbioru z zewnętrznych źródeł
są dostępne do porównania.
Semantyka podmiotów#
Przypisanie pochodzi ze źródła zdarzenia. message.new.actor_id oraz
message.edited.payload.sender_id zachowują nadawcę wiadomości. Zwykłe
powiadomienia message.deleted zawierają identyfikatory wiadomości i mają pole aktora o wartości null;
dostępne wpisy dziennika administracyjnego zawierają podaną akcję, aktora i datę.
Wiadomości usługi członkostwa zachowują nadawcę i typ akcji, surowe aktualizacje uczestników
zachowują podany actor_id, a migawki reakcji zachowują podane
liczby i widoczne tożsamości. Należy odczytywać te zapisy wraz z przechwyconymi
wersjami i potwierdzeniami interakcji z panelem.
Powiadomienia o usunięciu w prywatnych czatach i zwykłych grupach zawierają wyłącznie identyfikatory wiadomości.
Czaty te korzystają z jednej sekwencji identyfikatorów dla całego konta, więc identyfikator określa pojedynczą wiadomość na
tym koncie. Gdy wiadomość o tym identyfikatorze została wcześniej zapisana w tym dzienniku,
usunięcie jest rejestrowane w tym czacie jako `message.deleted` z `payload.chat_resolution`
określającym nazwę metody. Identyfikatory, które nigdy nie zostały zapisane, są przechowywane jako deletion.unscoped: jest to
rzeczywiste powiadomienie o usunięciu, którego czat nie został skojarzony. Różni się to
od message.missing_on_recheck, które rejestruje niedostępny wynik zapytania, oraz
od luki w zapisanych identyfikatorach wiadomości. Kanały i supergrupy numerują wiadomości w ramach poszczególnych czatów i
nigdy nie są dopasowywane w ten sposób. Gdy usunięta wiadomość została wysłana przez obserwowane konto,
payload.deleted_message_was_outgoing ma wartość true; nadal nie podano osoby, która dokonała usunięcia.
Powiadomienie bez zakresu zachowuje własną etykietę, ponieważ pasująca rozmowa może znajdować się poza bieżącym zakresem obserwacji lub nie mieć jednoznacznego dopasowania. Ponowna kontrola braku pozostaje oddzielną obserwacją od powiadomienia o usunięciu w liczbach raportów, filtrach i etykietach. Późniejsze odzyskanie usuwa bieżący stan braku, zachowując jednocześnie wcześniejszą nieudaną kontrolę w podpisanej historii; powiadomienia o usunięciu pozostają odrębnym typem zdarzenia.
Wiele identyfikatorów wiadomości, które w ramach jednego powiadomienia odnoszą się do tej samej rozmowy, jest grupowanych jako
deletion.batch – niezależnie od ich liczby – z identyfikatorami wiadomości dokładnie takimi, jak je wysłał Telegram,
oraz z informacją o tym, ile z nich wysłało dane konto. Powiadomienie z Telegrama
zawiera listę tych wiadomości; dziennik administratora rozmowy podaje nazwisko administratora, który podjął działanie, w miejscu, gdzie konto
może to odczytać. Powiązanie (message.deletion_attributed) jest tworzone w zależności od tego, co nastąpi wcześniej:
ankieta, w której wpis w dzienniku administratora został zauważony przed powiadomieniem o usunięciu, jest dopasowywana w momencie zarejestrowania
powiadomienia.
Zakres: ciągłość, luki oraz niezauważone identyfikatory#
Każdy podpisany plik ZIP zawiera coverage.json, raport HTML otwiera się z tym samym podsumowaniem, a
verify.py ponownie oblicza je na podstawie events.jsonl, zamiast polegać na treści pliku:
- Ciągła obserwacja od X do Y. Okres rozpoczyna się od
observation.started, a kończy się w momencie pauzy, zatrzymania, utraty połączenia z Telegramem, wylogowania, uruchomienia procesu bez uporządkowanego zatrzymania lub upływu ponad trzech minut bez żadnego zapisu podczas obserwacji (sygnały kontrolne są zapisywane co minutę, więc brak sygnału oznacza, że proces się zatrzymał, zawiesił lub komputer przeszedł w stan uśpienia). Gdy interwał sygnałów kontrolnych zostanie zmieniony w sekcji Więcej narzędzi → Parametry, każdy sygnał kontrolny rejestruje tę zmianę, a dopuszczalna cisza wynosi trzy interwały, nigdy mniej niż trzy minuty. - W wykazie luk podano czas między okresami wraz z przyczyną. Luka, która w momencie ostatniego
wpisu pozostawała nadal otwarta, została oznaczona jako
not_resumed_by_last_record. - Nie odnotowano identyfikatorów wiadomości. W przypadku kanałów i supergrup, w których wiadomości są numerowane według czatu, brakujące identyfikatory pomiędzy odnotowanymi są wymienione jako przedziały. Są one zgłaszane jako nieodnotowane — usunięte, nigdy niedostarczone lub znajdujące się poza zapisaną historią — nigdy jako usunięte. Czaty prywatne i zwykłe grupy korzystają z tej samej sekwencji dla całego konta, więc luki w obrębie jednego takiego czatu nie mają znaczenia i nie są tam wymieniane.
- Powiadomienia o lukach na poziomie czatu (na przykład prośba serwisu Telegram o odtworzenie różnic w jednym kanale) są traktowane jako notatki; nie przerywają one globalnego zasięgu monitorowania.
- Zapisy sesji. Osobno wymieniono okna, w których licznik aktualizacji Telegrama wzrósł, mimo że żadna aktualizacja
nie dotarła do tej sesji (
updates_diverted), sesja ta została usunięta z listy sesji Telegrama, podczas gdy jej połączenie nadal działało (session_revoked_externally), lub odpowiedź sondy świadka nadeszła wyłącznie z historii (probe_ack_missed_live). Weryfikator informuje również o pochodzeniu klucza sesji Telegrama, innych sesjach zalogowanych w momencie rozpoczęcia obserwacji, sesjach dodanych podczas obserwacji, powiadomieniach bezpieczeństwa Telegrama (777000), innych sesjach zakończonych w obszarze roboczym, okresach wyłącznej sesji, liczbie sond świadków oraz aktualizacjach dotyczących połączeń telefonicznych. Zobacz konta. Gdy włączona jest opcja ścisłego wyboru czatów (scope.strictwobservation.started), lista sesji (z wyjątkiem sytuacji, gdy jest to jedyna sesja lub gdy włączona jest funkcja Urządzenia Telegram), powiadomienia dotyczące bezpieczeństwa oraz aktualizacje połączeń telefonicznych nie są gromadzone, więc ich brak nic nie oznacza, a usunięcie jest przypisywane do sesji tylko wtedy, gdy odbyła się ona w ciągu 10 minut przed tym zdarzeniem.
Sekwencja aktualizacji (pts)#
Telegram wprowadza aktualizacje dotyczące wiadomości z pts: jedną sekwencję dla konta
(czaty prywatne i grupy podstawowe łącznie) oraz po jednej dla każdego kanału lub supergrupy.
Kolektor rejestruje każdy otrzymany ciąg bez luk jako coverage.sequence
rekord: pierwszy i ostatni pts, liczbę aktualizacji każdego typu oraz informację, czy
zostały one przesłane na żywo, czy zwrócone przez getDifference lub getChannelDifference. Przerwa to
coverage.gap rekord, a coverage.gap_closed określa pts punkt, od którego sekwencja
znów jest kompletna.
Nieprzerwany ciąg pokazuje, że każda aktualizacja Telegrama oznaczona numerem w tej sekwencji, od
pierwszej do ostatniej, pts dotarła do klienta Telegram tego kolekcjonera. Nie mówi to nic o
treściach, których Telegram nigdy nie wysłał na to konto, o czasie przed pierwszą zarejestrowaną
pts, ani o odcinkach, których zbieracz nie zapisał. pts Przesunięcie, którego nie
obejmuje żaden zarejestrowany odcinek ani różnica, jest wyświetlane jako przerwa.
GET /api/continuity odpowiedzi dla przedziału (since, until, chat_id), czy każda
sekwencja jest nieprzerwana, oraz podaje listę przerw wraz z ich przyczynami. verify.py wyświetla te same
dane z zapisów archiwum w sekcji „Ciągłość sekwencji”.
Brakujące numery wiadomości (gap_summary)#
For a reader's guide to this section and to observation periods and gaps, see Coverage and missing material.
Podgląd. coverage.json → gap_summary mierzy numery przypisane przez Telegram, których ten
kolektor nigdy nie zarejestrował. Telegram numeruje wiadomości raz na kanał lub supergrupę oraz raz na
konto w ramach prywatnych czatów, botów i zwykłych grup. Liczba pomiędzy dwiema zaobserwowanymi
wiadomościami oznacza, że wiadomość została zaobserwowana lub brakuje jej; ciągły zakres stanowi potwierdzenie, że
każda wiadomość w nim oznaczona została zaobserwowana. Luka nie wskazuje żadnego podmiotu ani przyczyny.
| Dziedzina | Znaczenie |
|---|---|
status |
on lub off, gdy jest wyłączone w sekcji Więcej narzędzi → Parametry → Analiza luk |
parameters |
Parametry, które doprowadziły do uzyskania wyniku, aby można było go powtórzyć |
chats[] |
Jeden wpis na kanał lub supergrupę, z których każdy jest osobno ponumerowany |
account |
Sekwencja prywatnych czatów, botów i zwykłych grup w ramach całego konta |
status (dla każdej sekwencji) |
applicablelub not_applicable z reason |
observed_from, observed_to, span |
Pierwszy i ostatni zaobserwowany numer oraz rozmiar zakresu |
observed, observed_without_content |
Liczby zaobserwowane; te znane wyłącznie na podstawie zapisu o usunięciu lub ponownej weryfikacji |
missing, density, gap_ranges, largest_gap |
Liczby nigdy nie zaobserwowane, ich udział w zakresie, liczba przebiegów, najdłuższy przebieg |
clusters[] |
Wymienione braki: low, high, missingoraz sąsiednie zaobserwowane liczby after / before wraz z czasami ich odnotowania |
service_estimate |
Tylko po włączeniu: ile brakujących numerów stanowiłoby komunikaty serwisowe przy ich zaobserwowanym udziale. Nigdy nie odejmować od missing |
Ważność danych wynika z dziennika, nigdy nie jest zakładana:
- Kanały i supergrupy są mierzone na poziomie poszczególnych czatów, również w eksporcie wybranych czatów.
Pomiar opiera się na wpisach wybranych przez nadawcę
not_applicable. - Sekwencja obejmująca całe konto jest mierzona wyłącznie od pierwszej do ostatniej wiadomości, która
nadeszła w czasie, gdy aktywna była funkcja gromadzenia danych z całego konta, i obejmuje prywatne czaty, boty, zwykłe
grupy oraz wiadomości własne konta, bez wykluczania żadnego z tych czatów (
scope.changed). Liczby oznaczone jakodeletion.unscopedsą traktowane jako zaobserwowane bez treści. Eksport lub przekazanie wybranych czatów nie pozwala na jej pomiar. Jeśli funkcja gromadzenia danych z całego konta była wyłączana i włączana, pojawia się adnotacja informująca, że numery użyte w międzyczasie są wyświetlane jako luki. - Komunikaty serwisowe to wpisy w dzienniku posiadające własne numery, więc same wypełniają luki ; opcjonalna wartość szacunkowa służy jedynie jako kontekst.
verify.py przelicza gap_summary na podstawie events.jsonl z parametrami zawartymi w podpisanym
coverage.json (wartości domyślne dla starszych archiwów) oraz
wyświetla w podsumowaniu zasięgu wiersz obejmujący całe konto. get_capture_status(MCP i wiersz poleceń) zwraca ten sam pomiar dla czatów, do których użytkownik może mieć dostęp;
sekwencja obejmująca całe konto dotyczy wyłącznie dostępu obejmującego cały obszar roboczy.
Powtarzające się obserwacje jednej wiadomości usługi liczą się tylko raz, a oszacowanie usługi konta wykorzystuje wyłącznie liczby mieszczące się w mierzonym zakresie. Zastosowany zakres musi wyraźnie zachować własne wiadomości konta przed włączeniem pomiaru obejmującego całe konto; pomiar rozpoczyna się od rekordów zawierających te informacje. Mierzony zakres obejmuje trwającą obserwację, a jej wznowienie jest odnotowywane. Zapytanie do archiwum na żywo ma limit czasowy, obejmujący skanowanie bazy danych, i oznacza niedokończony pomiar jako częściowy.
Telegram dokumentuje oddzielne sekwencje identyfikatorów wiadomości. Liczby te opisują obserwacje; powiadomienia o usunięciu, ponowne sprawdzenia oraz wpis w dzienniku administratora wyjaśniający, dlaczego brakuje danej liczby w miejscu, w którym Telegram ją zgłasza.
Gdy Telegram przestaje akceptować konto, rekord coverage.gap kończący obserwację
zawiera cause (account_banned, account_frozen, account_deleted, session_duplicated,
session_revoked, session_expired, session_ended lub not_authorized) oraz błąd Telegram;
verify.py określa przyczynę zakończenia okresu.
Zakres obejmuje zarejestrowane okresy obserwacji, przerwy oraz wyniki komunikatów. Należy go oceniać łącznie z wybranymi czatami, okresem oraz polityką dotyczącą załączników; ponowna weryfikacja wyników i zarejestrowanych luk pokazuje, w jakim stopniu aktualizacje konta zostały zaobserwowane.
Producent#
Podpisany manifest plików ZIP z dowodami, eksportów czatów, dzienników świadków oraz oświadczeń
w plikach profili użytkowników zawiera producer: oprogramowanie, wersję, projekt (PhishDestroy),
stronę główną i repozytorium źródłowe. Raport HTML i weryfikator wyświetlają ten podpisany
rekord producenta. Suma kontrolna pliku źródłowego identyfikuje zarejestrowane drzewo źródłowe w celu porównania
z zaufaną kopią. Pochodzenie wykonania jest sprawdzane oddzielnie poprzez
poświadczenie pozyskania z serwisu GitHub lub
pomiary Intel TDX, o ile są one włączone. Archiwa utworzone przed
wprowadzeniem pola producenta są nadal obsługiwane i identyfikowane jako rekordy starszego typu.
Każdy rekord observation.started podaje również nazwę klienta Telegram, który dokonał obserwacji: jego api_id
(nigdy skrót), niezależnie od tego, czy jest to wbudowana para publiczna, czy własna aplikacja operatora,
opis klienta przesłany w żądaniu połączenia Telegram oraz rodzaj trasy połączenia
wraz z trybem IP (bez adresu proxy ani klucza tajnego). Raport oraz plik custody.json zawierają listę wszystkich
unikalnych klientów i tras wraz z datą ich zarejestrowania, a także liczbę przypadków, w których żaden z wymienionych serwerów proxy nie odpowiedział,
oraz liczbę przypadków, w których plik Telegram wykrył adres serwera. Potwierdzają to dzienniki zarejestrowane wcześniej.
Profile osób#
Plik profilu (tgwitness-dossier-v1, JSON) jest generowany na żądanie na podstawie zapisów już znajdujących się
w dzienniku dla jednej rozmowy; żadne dane nie są pobierane z serwisu Telegram, a zawartość profilu nigdy nie jest
zapisywana w dzienniku (włączanie i wyłączanie profili jest rejestrowane jako dossier.changed).
Dla każdej osoby, której wiadomość została zapisana, podaje się imię i nazwisko oraz historię nazw użytkownika, oznaczenia Telegrama
(bot, oszustwo, fałszywy, premium, zweryfikowany, z ograniczeniami, usunięty) widoczne w momencie zapisywania, identyfikatory zdjęć profilowych
identyfikatory zdjęć profilowych, skrót SHA-256 oraz skrót percepcyjny (pHash, zgodny z imagehash.phash)
awatara z lokalnej pamięci podręcznej awatarów wraz z podobnymi awatarami, aktywność (pierwsza i ostatnia wiadomość,
liczby, edytowane i usunięte udostępnienia, wiadomości według godzin UTC), kto odpowiada komu, inne czaty
w tym dzienniku, w których dana osoba pisała, oraz wymienione portfele (BTC, EVM, TRON, TON, LTC,
DOGE, XMR, SOL; adresy Base58Check są weryfikowane pod kątem sum kontrolnych), numery telefonów, nazwy użytkowników oraz
linki, w tym linki ukryte w tekście.
Każdy fakt zawiera odniesienie do wpisu w dzienniku (seq), z którego pochodzi, a record_hashes zawiera
skrót każdego wpisu, do którego się odwołuje. Oświadczenie jest podpisane kluczem obszaru roboczego:
python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip
Sprawdza podpis, weryfikuje sam eksport dowodów (podpis, łańcuch skrótów i pliki) oraz upewnia się, że każdy przywołany zapis istnieje w niezmienionej postaci w tym eksporcie tego samego obszaru roboczego. Skróty awatarów są oznaczone jako pochodzące z lokalnej pamięci podręcznej (a nie z zapisów dziennika). Wzmianki są dopasowaniami wzorców i wskazówkami do sprawdzenia. Profile są włączane dla poszczególnych czatów, można je eksportować jako plik ZIP zaszyfrowany algorytmem AES-256 z hasłem oraz są usuwane po wyłączeniu lub gdy czat zostanie usunięty ze źródeł.
Niezależny świadek#
Dziennik świadka (tgwitness-witness-v1) i jego posty na kanale są sprawdzane względem
eksportu dowodów za pomocą polecenia verify.py --witness … --channel …; zob. niezależny świadek.
W przypadku publicznego adresu https://t.me/s/… lub https://telegram.me/s/… weryfikator odczytuje
datę każdego posta z Telegrama, a najwcześniejsza taka data posta na początku eksportu
stanowi czas zewnętrzny dla ostatniego rekordu. Daty z dowolnego innego źródła są dostarczanymi metadanymi.
Manifest i punkty kontrolne#
Plik manifest.json zawiera format, czas eksportu, klucz publiczny, odcisk palca, długość dziennika,
skrót nagłówka, zakres, producenta, ograniczenia oraz skrót SHA-256 każdego elementu treści innego
niż same pliki manifest.json i manifest.sig.
Plik manifest.sig to podpis base64 Ed25519 nad kanonicznym manifestem JSON.
Narzędzie weryfikujące odrzuca nieoczekiwane lub brakujące elementy, zduplikowane nazwy, uszkodzone pliki,
uszkodzoną sekwencję lub łańcuch, nieprawidłowe podpisy oraz niezgodność z podanym punktem kontrolnym.
Nigdy nie wyodrębnia ścieżek archiwum. Ogranicza całkowity zadeklarowany rozmiar po rozpakowaniu do 4 GiB;
opcja --max-gib N pozwala na tworzenie większych archiwów dzięki podwyższeniu limitu w sekcji Więcej narzędzi → Parametry.
Duże archiwum jest sprawdzane jednocześnie przez kilka procesów: elementy są poddawane funkcji skrótu równolegle,
a po pierwszych 5 000 rekordów skrót treści i podpis każdego rekordu są sprawdzane
przez procesy robocze, podczas gdy proces główny śledzi łańcuch, pokrycie i powiązania
w kolejności. --jobs N ustawia liczbę procesów; domyślnie auto zakłada jeden na każdy procesor,
maksymalnie 16, a --jobs 1 wszystko odbywa się w jednym procesie. Wynik jest taki sam w obu przypadkach,
a zmiana jest odrzucana z tym samym komunikatem. Skróty w pozycjach wskazanych przez zachowane
punkty kontrolne i kotwice znaczników czasu są przechowywane podczas tego pojedynczego przebiegu, więc każda kotwica jest
porównywana bez ponownego odczytywania dziennika. Na komputerze z 32 wątkami przetworzenie archiwum o wielkości 10,8 GB zawierającego
400 000 rekordów zajęło 58,9 s w jednym procesie, 15,2 s przy 4 procesach i 8,4 s przy 16; jedno przejście po
rekordach w kolejności określa wówczas limit.
Uruchom weryfikację z zainstalowanej wersji TgWitness lub zweryfikowanej kopii. Kopia zawarta w archiwum umożliwia przenośne użytkowanie; przed uruchomieniem porównaj tę kopię z zaufaną instalacją.
Punkt kontrolny podpisuje oświadczenie zawierające klucz publiczny, długość dziennika, skrót
głowy oraz czas utworzenia. Zawiera on również najnowszą rundę drand, jaką obszar roboczy
pobierał (drand_anchor
): kolektor przed każdym okresowym punktem kontrolnym wysyła zapytanie do przekaźnika drand poprzez
trasę zewnętrzną obszaru roboczego, więc mają zastosowanie Hide IP, serwery proxy oraz wyłączona
trasa zewnętrzna, co sprawia, że sam punkt kontrolny nigdy nie łączy się z zewnątrz. Weryfikator może sprawdzić,
czy późniejsze archiwum zawiera ten sam prefiks. Za pomocą opcji --checkpoint
i --check-drand
potwierdza on tę rundę u przekaźników drand i zgłasza, że punkt kontrolny został podpisany
nie wcześniej niż w momencie tej rundy; runda ta nie zmienia poziomu pewności. Zachowaj
punkt kontrolny poza kolektorem, tak aby późniejsza weryfikacja porównywała archiwum z
odniesieniem przechowywanym oddzielnie od niego. Klucz kolektora podpisuje je, więc
wiązuje z nim zapisy tylko wtedy, gdy odbiorca uzyskał je przed archiwum, poprzez
inny kanał; samo w sobie nie spełnia minimalnych wymagań dotyczących dowodu.
Odczytywanie wyniku weryfikacji#
Weryfikator generuje oddzielne raporty dotyczące integralności archiwum, powiązania z podpisującym oraz kontroli pewności.
Prawidłowy podpis wskazuje, że bajty nie uległy zmianie od momentu
podpisania. Operator przekazuje odbiorcy odcisk klucza za pośrednictwem oddzielnego
kanału. Bez --fingerprint, nienaruszony archiwum przechodzi pomyślnie kontrole podpisu i formatu
z signer_pinned: false, a ostatnia linia zaczyna się od
EVIDENCE: minimum not met · missing: confirmed signer key.
W przypadku zautomatyzowanej polityki archiwizacji lokalnej, która wymaga przypisanej osoby podpisującej oraz minimalnego zestawu dowodów:
python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence
Należy użyć odcisku palca zachowanego za pośrednictwem zaufanego kanału odbiorcy. Zaufany
świadek może również przypiąć kolektor za pomocą spójnego dziennika poświadczonego; należy podać opcje
--witness, --witness-fingerprint oraz --require-witness. Opcja --strict powoduje zakończenie działania ze
statusem 2 w przypadku nieprzypiętego podpisującego; niespełnienie wymagań --require-tier lub --require evidence również
powoduje zakończenie działania ze statusem 2. Opcja --require evidence wymaga podania --fingerprint oraz zewnętrznego czasu od
strony trzeciej obejmującego ostatni wpis.
Należy zapoznać się z signer_pinned, requirements_met oraz wynikami weryfikacji, a nie tylko z
kodem wyjścia. Zamiast tego funkcja Sealed acquisition wykorzystuje swój
weryfikator poświadczeń oraz zatwierdzoną politykę do uwierzytelnienia skrótu akwizycji.
Zakres weryfikacji#
Weryfikacja sprawdza archiwum oraz tryb gromadzenia danych użyty do jego utworzenia. Należy wybrać tryb, którego granica zaufania odpowiada danemu przypadkowi, a następnie zachować jego dane wejściowe do weryfikacji.
| Tryb gromadzenia danych | Co sprawdza weryfikator | Dane wejściowe do weryfikacji i granica zaufania |
|---|---|---|
| Lokalny obszar roboczy | Zapisać sygnatury, łańcuch skrótów, manifest oraz bajty załączników | Odcisk palca kolektora zachowany przez odbiorcę oraz czas zewnętrzny pochodzący od strony trzeciej: zweryfikowane potwierdzenia zgodne z RFC 3161 lub OpenTimestamps albo posty świadków odczytane z serwisu t.me. Zachowane punkty kontrolne i zapisy świadków stanowią podstawę do weryfikacji. |
| Lokalny obszar roboczy z niezależnym świadkiem | Kontrola archiwum oraz zgodność z wcześniejszym prefiksem dziennika zachowanym przez świadka | Odcisk i wpisy świadka; rejestr kontroli klucza prowadzony przez powiernika pokazuje, kto przechowuje klucz świadka. Z --channel https://t.me/s/… daty nadane wpisom przez Telegram dają czas zewnętrzny |
| Przechwytywanie działań GitHub Actions | Potwierdzenie na GitHubie skrótu archiwum, zatwierdzonego przepływu pracy i commitów kolektora, hostowanego runnera, nowego źródła sesji/klucza oraz wewnętrznej integralności archiwum | Polityka zaufanych weryfikatorów, repozytorium wywołujących oraz pakiet poświadczeń GitHub; gromadzenie danych odbywa się w ramach przypiętego przepływu pracy |
| Wdrożenie w chmurze | Dane dotyczące cyklu życia dostawcy i dostępu, stan zapory sieciowej i usługi Cloudflare, a także podpisany zapis działania kolektora | Zapytania do dostawcy i Cloudflare mają charakter wyłącznie odczytowy; dostępność poszczególnych kontroli zależy od dostawcy |
| Poufna maszyna wirtualna Intel TDX | Należy zacytować podpis i status platformy, powiązanie z oświadczeniem kolektora, pomiary kompozycji oraz pomiary systemu operacyjnego | Łańcuch zaufania firmy Intel oraz przewidywane pomiary wdrożeniowe; należy zachować wyniki każdej wymaganej kontroli TDX |
W przypadku pozyskiwania danych w trybie zamkniętym zatwierdzony zbieracz otrzymuje dane poprzez uwierzytelnione połączenie z Telegramem w ramach zweryfikowanego środowiska. Poświadczenie wiąże archiwum z tym konkretnym uruchomieniem, więc weryfikacja obejmuje zarówno sam proces pozyskiwania, jak i późniejszą integralność plików. Opiera się to na zatwierdzonym kodzie oraz łańcuchu zaufania platformy wymienionym powyżej. Weryfikacja przechwytywania w serwisie GitHub wymaga sesji utworzonej w ramach danego uruchomienia i odrzuca przechwytywanie z importowanych sesji.
Potwierdzenie uruchomienia rejestruje wersję kolektora, skróty plików oraz ustawienia startowe. Pochodzenie z serwisu GitHub oraz pomiary TDX zapewniają weryfikację środowiska; rekord walidacji identyfikuje przetestowane konfiguracje.
Skąd pochodzą wiadomości#
Telegram dostarcza wiadomości do każdego klienta, w tym do oficjalnych aplikacji, w ramach sesji MTProto. Klucz autoryzacyjny sesji jest negocjowany w oparciu o przypisany klucz serwera Telegramu, a każda aktualizacja jest dostarczana w postaci zaszyfrowanej i poddawana kontroli integralności przy użyciu tego klucza. Kolektor odbiera wiadomości poprzez uwierzytelnioną sesję konta i podpisuje każdą obserwację w dzienniku w momencie jej nadejścia, podając identyfikatory czatu, wiadomości i nadawcy oraz datę nadaną każdej wiadomości przez Telegram. W GitHub Actions oraz wdrożeniach Intel TDX poświadczenie wiąże również tę sesję i klucz podpisujący z zatwierdzonym uruchomieniem kolektora.
Dziennik rejestruje pochodzenie klucza autoryzacyjnego. Logowanie za pomocą telefonu lub kodu QR,
lub niezależne logowanie z pliku sesji powoduje zapisanie account.authorized z
key_origin: "created"; zbieranie danych na podstawie zaimportowanego klucza .session, TData lub JSON powoduje zapisanie
imported. Zaimportowany klucz istnieje również niezależnie od źródła, z którego pochodzi. Poświadczone wdrożenia
odrzucają zaimportowane klucze.
Pochodzenie zapisu w Telegramie opiera się na uwierzytelnionym połączeniu konta,
zapisach połączeń i przechwyceń w dzienniku, przechwyconych ramkach MTProto dopasowanych do wpisów
w dzienniku (tgwitness/forensics/), dacie Telegramu każdej
wiadomości oraz – w przypadku poświadczonego przechwycenia – zweryfikowanym środowisku wykonania. Podpisy archiwalne
zabezpieczają ten zapis do późniejszej weryfikacji. Zachowane punkty kontrolne ustalają wcześniejsze granice dziennika,
zapisy pokrycia pokazują wyniki gromadzenia danych, a zweryfikowane zewnętrzne znaczniki czasu
umieszczają zatwierdzone bajty w osi czasu.
W przypadku lokalnego obszaru roboczego odbiorca dostarcza dane wejściowe od zaufanego kolektora lub świadka. W przypadku zapieczętowanego pozyskiwania zaufana polityka i poświadczenie wiążą skrót archiwum z zatwierdzonym wykonaniem kolektora. Są to różne ścieżki weryfikacji; należy zgłosić sprawdzenia zakończone dla wybranej ścieżki.
Załączniki#
Pliki są identyfikowane za pomocą skrótu SHA-256 w katalogu media/. Plik media.saved powiązuje skrót oraz długość w bajtach z konkretnym zdarzeniem wiadomości. Surowymi nazwami plików są metadane, nigdy lokalne ścieżki. Bajty multimediów są pobierane asynchronicznie, więc natychmiastowe usunięcie może uniemożliwić ich przechwycenie. Wyniki obejmują: wyłączone gromadzenie danych, pliki o zbyt dużym rozmiarze lub o nieznanym rozmiarze, niepowodzenia pobierania oraz przerwane pobieranie. Awaria procesu może pozostawić częściowe pliki bez odnośników; nie są one uwzględniane w eksportach.
Eksportator ZIP weryfikuje zapisane pliki multimedialne na podstawie ich nazw. Eksporty w formatach JSONL, CSV i HTML weryfikują sygnatury zdarzeń, ale nie zawierają danych multimedialnych. Raporty pochodne mają charakter pomocniczy; plik events.jsonl stanowi autorytatywny zapis zdarzeń.
Pełny eksport czatu zapisuje załączniki zgodnie z ustawieniami załączników w obszarze roboczym w katalogu
media/, nadając im nazwy w formacie SHA-256. Każdy rekord wiadomości w pliku chat.json zawiera nazwę pliku (file,
file_sha256) lub powód jego braku (file_status), wraz z informacją o tym, co widział czytelnik
wokół tekstu: linki za tekstem, źródło przekazania, przyciski botów, podpis, wyświetlenia oraz
licznik czasu automatycznego usunięcia. Plik verify.py sprawdza, czy każdy wymieniony plik znajduje się w podpisanym manifeście
pod tym skrótem.
Trwałe gromadzenie i przetwarzanie potwierdzeń (0.2)#
Operacja dotycząca pliku multimedialnego oraz zapis zdarzenia wiadomości odbywają się w ramach jednej transakcji. Zadanie przechowuje oryginalny deskryptor wiadomości z Telegramu; podpisana obserwacja wiąże się z jej skrótem SHA-256, kontem oraz zasadami dotyczącymi rozmiaru. Funkcja odzyskiwania weryfikuje tę powiązanie przed pobraniem. Nigdy nie pobiera aktualnej wiadomości i nie zastępuje w sposób niewidoczny nowszego załącznika. Przerwane zadania są ponawiane, natomiast trwała awaria pozostaje jednoznacznym wynikiem.
Każdy obszar roboczy posiada własny dziennik i tożsamość podpisującą. Zdarzenie `process.started` zawiera identyfikator uruchomienia, zegary lokalne, wersje zależności, skróty plików źródłowych, początkowe konto/zakres oraz ustawienia przechwytywania. Sygnały kontrolne zawierają identyfikator uruchomienia, czas monotoniczny oraz stan kolejki. Potwierdzenie uruchomienia można również pobrać jako oddzielnie podpisane oświadczenie. W celu weryfikacji środowiska wykonania należy je połączyć z poświadczeniem GitHub lub kontrolami TDX opisanymi w Zakres weryfikacji.
Automatyczne punkty kontrolne są zachowywane lokalnie podczas uruchamiania, co pięć minut w trakcie obserwacji (Więcej narzędzi → Parametry → Podpisany punkt kontrolny co) oraz przy prawidłowym zatrzymaniu. Weryfikacja przy uruchomieniu i eksport porównują dziennik z najnowszym zachowanym lokalnym punktem kontrolnym. Pozwala to wykryć cofnięcie zmian w bazie danych, gdy punkt kontrolny pozostaje nienaruszony. Niezależne przechowywanie zapewnia dostępność tego odniesienia poza obszarem roboczym; zweryfikowany zewnętrzny znacznik czasu dodatkowo zakotwicza je w czasie.
Po ponownym uruchomieniu program wznawia zapisany punkt aktualizacji serwisu Telegram (catch_up_from w observation.started) oraz wysyłane są żądania dotyczące pominiętych aktualizacji. Zapisana pozycja obejmuje wyłącznie aktualizacje, których przetwarzanie zostało zakończone, dlatego aktualizacje, które nadal czekały na przetworzenie w momencie zamknięcia połączenia lub zatrzymania procesu, są ponownie żądane. Okresowa ponowna weryfikacja rejestruje message.recovered na obecność pominiętych wiadomości oraz message.missing_on_recheck gdy aplikacja Telegram nie zwraca już zapisanej wiadomości; ta ostatnia sytuacja nie stanowi powiadomienia o usunięciu i nie wskazuje podmiotu, który dokonał usunięcia, ani czasu.
Kopia zapasowa i przywracanie danych poza serwerem (S3)#
Kopia zewnętrzna (Ustawienia → Powiadomienia i kopia zewnętrzna → Kopia zewnętrzna lub
Więcej narzędzi → Dodatki → Dowody i kopie zapasowe; domyślnie wyłączona) przesyła segmenty dziennika, zachowane pliki, punkty kontrolne
wraz z ich sygnaturami czasowymi oraz gotowe eksporty czatów do magazynu zgodnego ze standardem S3, zaszyfrowane algorytmem
AES-256-GCM przed przesłaniem przy użyciu klucza przechowywanego w skarbcu obszaru roboczego; stosowana jest retencja Object Lock,
jeśli zasób to obsługuje. Bez pobranego klucza kopia nie może zostać odczytana. Przywróć i zweryfikuj
za pomocą polecenia python -m tgwitness.replica restore --key-file KEY.json --out DIR.
Przywrócenie danych wymaga pustego, zwykłego katalogu. Pobrane i odszyfrowane obiekty pozostają w prywatnej pamięci tymczasowej do momentu zweryfikowania całego dziennika oraz każdego zachowanego punktu kontrolnego. Niebezpieczne ścieżki obiektów, niespójne zakresy segmentów oraz dzienniki krótsze niż punkt kontrolny są odrzucane; w przypadku niepowodzenia weryfikacji przywrócone pliki nie są publikowane. Kontrole retencji porównują zwrócony tryb blokady obiektu oraz datę z terminem wysłanym podczas przesyłania (z tolerancją zaokrąglenia wynoszącą jedną sekundę). Wygasły, nieważny lub skrócony termin nie jest uznawany za zweryfikowany. Status informuje o losowo wybranym obiekcie, którego retencja została odczytana dla danej operacji przesyłania.
Brakujące lub uszkodzone pliki lokalne są zgłaszane jako błąd danego przebiegu i kursor pozostaje przed tym miejscem, dzięki czemu plik zostanie ponownie przetworzony podczas następnego przebiegu; pliki, punkty kontrolne i eksporty znajdujące się za nim są nadal kopiowane. Funkcja przywracania sprawdza wszystkie odniesienia do zachowanych plików pod kątem odszyfrowanych skrótów i zarejestrowanych rozmiarów. Identyczne, nakładające się segmenty dziennika pochodzące z przerwanych operacji przesyłania są deduplikowane; sprzeczne nakładania się są odrzucane. Punkty kontrolne utworzone podczas przesyłania są odkładane do momentu, aż objęte nimi zapisy dziennika zostaną skopiowane, dzięki czemu zakończony przebieg nie publikuje punktu kontrolnego przed odpowiadającym mu wpisem w dzienniku.
Przesyłanie strumieniowe migawek eksportu#
Eksporty strumieniowe wykorzystują stabilną migawkę odczytu bazy danych SQLite. Jej początek może być starszy niż aktualny dziennik na żywo w momencie zakończenia pobierania. Punkt kontrolny utworzony po tej migawce może prawidłowo wskazywać, że archiwum jest krótsze; należy porównać go z punktem kontrolnym znajdującym się w miejscu lub przed eksportowanym prefiksem, a nie z dowolnym późniejszym punktem kontrolnym.
Przygotowanie RFC 3161 i weryfikacja odpowiedzi (0.2)#
Tryb dowodowy wysyła wyłącznie skróty SHA-256 każdego podpisanego punktu kontrolnego do wymienionych w RFC 3161
instytucji certyfikujących oraz kalendarzy OpenTimestamps, korzystając z trasy obszaru roboczego, a nigdy poprzez MTProxy.
Znaczniki czasu są domyślnie włączone w każdym celu konfiguracyjnym; dowody dotyczące danej sprawy rejestrują również drand.
Odpowiedzi są przechowywane w checkpoints/anchors/, eksportowane jako .tsr oraz .ots pliki w katalogu anchors/,
i sprawdzane przez verify.py (--tsa-ca sprawdza podpis TSA; potwierdza dowody OpenTimestamps
za pomocą ots upgrade i ots verify).
Podmiot RFC 3161, który dwukrotnie z rzędu nie powiodł się, przed kolejną próbą czeka: jeden interwał, następnie
dwa, cztery i tak dalej, aż do sześciu godzin lub tak długo, jak wymaga tego jego Retry-After, maksymalnie do jednego dnia. Przejście, które
wykrywa wyłącznie oczekujące podmioty, nie tworzy żadnego zapisu; w przeciwnym razie anchor.completed wymienia je w sekcji
deferred wraz z retry_at. Dopóki nie udzielą odpowiedzi, panel wyświetla sygnatury czasowe jako Degraded.
Panel przygotowuje archiwum żądania zawierające kanoniczne bajty pliku checkpoint.json, odcisk wiadomości SHA-256 oraz losowy nonce w pliku timestamp.tsq, sumy kontrolne i instrukcje. Nie jest wysyłane żadne żądanie sieciowe; tokenem zwracanym przez organ dla tego żądania jest znacznik czasu.
python -m tgwitness.anchor verify sprawdza odpowiedź względem bajtów punktu kontrolnego i pierwotnego żądania, bez OpenSSL. Plik zaufanego CA trzeba wskazać jawnie; dołączone certyfikaty nie są automatycznie uznawane za zaufane. W CLI sprawdzenie żądania jest opcjonalne, więc zachowaj żądanie i podaj --request, aby sprawdzić nonce. Wynik informuje, czy zostało sprawdzone. Podpis punktu kontrolnego kolektora i dziennik nadal trzeba osobno zweryfikować zaufanym odciskiem kolektora.
Weryfikacja sprawdza podpis odpowiedzi, bajty punktu kontrolnego oraz, jeśli zostały dostarczone,
oryginalne żądanie w ramach określonego zaufania do urzędu certyfikacji (CA). W przypadku znaczników czasu uzyskanych w trybie dowodowym skrypt verify.py sprawdza również zapisane dowody OCSP lub
CRL (unieważnienie certyfikatu podpisującego).
Zobacz procedurę i wyniki walidacji.
Opcjonalne zapisy w trybie dowodowym: urządzenia typu drand i Telegram#
Dwa dodatkowe rejestry mogą działać w ramach tych samych przebiegów co znaczniki czasu. Oba są aktywne tylko wtedy, gdy
tryb dowodowy jest włączony. Dowody dotyczące danej sprawy włączają drand; w przeciwnym razie oba są wyłączone. Można je przełączać
w sekcji Więcej narzędzi → Dodatki → Dowody i kopie zapasowe → Więcej świadków · opcjonalnie,
lub "drand": true oraz "devices": true w POST /api/evidence. Awaria jednego z nich nie zatrzymuje
działania drugiego ani znaczników czasu; panel wyświetla najnowszy wynik każdego z nich pod formularzem.
drand
(beacon.drand
). Każde przejście zapisuje najnowszą rundę drand quicknet, czyli publiczną
losowość League of Entropy (runda co 3 sekundy), w dzienniku: chain
,
round
, randomness
, signature
, round_time
oraz relay
, który udzielił odpowiedzi. Zweryfikowana
nieprzewidywalna runda stanowi dolną granicę czasową dla kolejnych materiałów połączonych skrótami.
Zweryfikowany znacznik czasu w późniejszym punkcie kontrolnym stanowi górny punkt odniesienia czasowego. Kontrole te
ograniczają zakres połączonego materiału. Kolektor wysyła zapytanie najpierw do drand.cloudflare.com
, a następnie do przekaźników Protocol Labs, poprzez trasę obszaru roboczego, po jednym żądaniu na przejście.
verify.py
sprawdza, czy każda wartość losowa jest zgodna z SHA-256
dla danego podpisu oraz czy czas rundy
jest prawidłowy, a także zgłasza liczbę rund, najdłuższy okres bez rundy oraz to, jak bardzo zegar kolektora
opóźniał się względem drand. --check-drand
porównuje rundy z przekaźnikiem Cloudflare i przekaźnikiem Protocol Labs, ze wszystkimi z nich lub z losową
próbką 100 z długiego dziennika; runda, która się różni, nie przechodzi weryfikacji.
Urządzenia , Telegram, (account.devices). Każdy przebieg odczytuje sesje konta o numerze
account.getAuthorizations, a lista Telegram wyświetlana w Ustawieniach → Urządzenia, i rejestruje je:
w całości, jeśli uległa zmianie od poprzedniego przebiegu, wraz z skrótami sesji added i removed,
w przeciwnym razie tylko jej liczbę i SHA-256. Zachowywane są model urządzenia, platforma, aplikacja i wersja,
data utworzenia i ostatniej aktywności, kraj oraz region; adresy IP nie są zachowywane, ponieważ
eksportowane dowody opuszczają Twoje ręce. Własna sesja kolektora jest aktywna przez cały czas, więc
tylko aktywność innych sesji liczy się jako zmiana. verify.py zgłasza, jak często lista
została zarejestrowana, a także każdą nową i zakończoną sesję. Odczytuje listę tylko podczas trwania obserwacji.
Co pokazują: drand porządkuje zapisy względem czasu publicznego, a lista urządzeń stanowi oświadczenie serwisu Telegram przekazane za pośrednictwem kolektora, podpisane przez kolektora tak jak każdy inny zapis.
Dziennik Cloudflare Gateway (cloudflare.gateway_dns). W przypadku serwera, który korzysta z
bramy Cloudflare Gateway ( – Gateway DNS ), każda
kopia zawiera dane zarejestrowane przez bramę od momentu poprzedniej kopii: jeden wpis na okno trwające maksymalnie trzy
godziny z from, until, location_id, address serwera (jeśli jest ustawiony) oraz
queries jako [at, name, type, rcode, decision, colo], również w przypadku braku wpisów. Należy to ustawić w
(dziennik Cloudflare Gateway) : konto, lokalizacja, opcjonalny adres oraz token tylko do odczytu (odczyt danych analitycznych konta
Analytics Read; Zero Trust PII Read, aby zachować jeden adres wspólnej lokalizacji). Panel sprawdza
je za pomocą jednego żądania przed zapisaniem; token pozostaje zaszyfrowany i nigdy nie trafia do dziennika.
verify.py zawiera listę okien, najczęściej wyszukiwanych nazw oraz wszelkich okresów, których nie obejmuje żadna kopia; rekord,
którego liczba nie zgadza się z liczbą zapytań, kończy się niepowodzeniem. Okno, które zawiera więcej niż jedną stronę
zapytań w ciągu jednej sekundy, zachowuje tę stronę i informuje, że reszta brakuje. Kopia jest
odpowiedzią Cloudflare przesłaną przez kolektor, podpisaną przez kolektor; w ciągu 24 godzin każdy, kto posiada
token tylko do odczytu, może porównać ją z danymi Cloudflare.