TgWitness / Dokumentacja

Co zostało przetestowane →

Niektóre fragmenty tej strony są nadal w języku angielskim: angielski tekst źródłowy uległ zmianie po przetłumaczeniu.

Odniesienie / Zbieraj

Telegram · Jak przebiega gromadzenie danych

Zakres obserwacji, aktualizacje na żywo, ponowne weryfikacje, załączniki, własne działania oraz znaczenie luk w danych – wszystko to w ujęciu poszczególnych wpisów.

TgWitness / Dokumentacja · Kolekcja

Zbiór

TgWitness rejestruje to, co obserwuje podłączone konto Telegram. Monitorowanie na żywo zachowuje wiadomości, zarejestrowane edycje, powiadomienia o usunięciu oraz załączniki wraz z czasami ich obserwacji i kontekstem źródłowym. Odczyty historii, ponowne sprawdzanie oraz dostępne zapisy dziennika administracyjnego dodają do tego zapisu oddzielnie zidentyfikowane obserwacje.

Na tej stronie

Od logowania do dziennika#

W przypadku zdjęć i plików ulegających samozniszczeniu zobacz sekcję Pliki ulegające samozniszczeniu. Wyjaśnia ona działanie procesów priorytetowych, wyniki zapisane i niedostępne oraz ograniczenia blokowania potwierdzeń odczytu w kolektorze API.

Schemat blokowyAutoryzacja konta użytkownika → Wybierz dostępne grupy i kanały; Wybierz dostępne grupy i kanały → Zapisz ustawienia zdarzeń i załączników; Zapisz ustawienia zdarzeń i załączników → Rozpocznij obserwację; Rozpocznij obserwację → Otrzymuj aktualizacje od aktywnego klienta; Otrzymuj aktualizacje od aktywnego klienta → Należy stosować zasady dotyczące źródeł i zdarzeń; Należy stosować zasady dotyczące źródeł i zdarzeń → Dodaj podpisane zgłoszenie; Dodaj podpisane zgłoszenie → Przeglądaj lub eksportuj dziennik; Dodaj podpisane zgłoszenie → Przetwarzanie wszelkich załączników znajdujących się w kolejce; Przetwarzanie wszelkich załączników znajdujących się w kolejce → Proszę dołączyć wynik pobieraniaAutoryzacja kontaużytkownikaWybierz dostępne grupyi kanałyZapisz ustawieniazdarzeń i załącznikówRozpocznij obserwacjęOtrzymuj aktualizacjeod aktywnego klientaNależy stosować zasadydotyczące źródeł izdarzeńDodaj podpisanezgłoszeniePrzeglądaj lubeksportuj dziennikPrzetwarzaniewszelkich załącznikówznajdujących się wkolejceProszę dołączyć wynikpobierania
Schemat w formie tekstowej
  1. Autoryzacja konta użytkownika → Wybierz dostępne grupy i kanały
  2. Wybierz dostępne grupy i kanały → Zapisz ustawienia zdarzeń i załączników
  3. Zapisz ustawienia zdarzeń i załączników → Rozpocznij obserwację
  4. Rozpocznij obserwację → Otrzymuj aktualizacje od aktywnego klienta
  5. Otrzymuj aktualizacje od aktywnego klienta → Należy stosować zasady dotyczące źródeł i zdarzeń
  6. Należy stosować zasady dotyczące źródeł i zdarzeń → Dodaj podpisane zgłoszenie
  7. Dodaj podpisane zgłoszenie → Przeglądaj lub eksportuj dziennik
  8. Dodaj podpisane zgłoszenie → Przetwarzanie wszelkich załączników znajdujących się w kolejce
  9. Przetwarzanie wszelkich załączników znajdujących się w kolejce → Proszę dołączyć wynik pobierania

Autoryzacja, dostęp do źródła, działający kolektor oraz pełna dostawa to odrębne kwestie. Pomyślne zalogowanie się nie zapewnia dostępu do każdej grupy. Dostawa jest śledzona oddzielnie: zapisy pokrycia, odzyskiwanie luk w aktualizacjach oraz ponowne sprawdzanie pokazują, co dotarło.

Zakres monitorowania: wybrane czaty, folder lub całe konto#

Więcej narzędzi → Źródła → Zakres określa, które czaty są rejestrowane w obszarze roboczym.

Nowa konfiguracja rozpoczyna się od opcji Wybierz czaty. Istniejące zapisane wybory zostają zachowane. Wybranie opcji Wszystkie czaty w kreatorze konfiguracji powoduje wyświetlenie prośby o potwierdzenie, gdy załadowana lista zawiera ponad 50 czatów; oszacowanie rozmiaru pozostaje odrębną operacją opartą na próbie.

Tryb Rejestruje Nowe rozmowy
Wybrane czaty (ustawienie domyślne) Tylko czaty dodane ręcznie Nigdy nie dodawane automatycznie
Folder Telegram Rozmowy w jednym z folderów konta: rozmowy uwzględnione według nazwy, wraz z kategoriami folderu (kontakty, osoby spoza kontaktów, grupy, kanały, boty), pomniejszone o rozmowy wykluczone oraz, o ile folder to przewiduje, rozmowy zarchiwizowane Odpowiednie czaty są dodawane natychmiast po ich uruchomieniu; czaty dodane przez Państwa do folderu w aplikacji Telegram są pobierane w ciągu godziny
Całe konto Każda rozmowa, którą obserwuje dane konto Każda nowa rozmowa, grupa, rozmowa prywatna lub bot są dodawane w momencie pojawienia się ich pierwszej aktualizacji
  • Typy źródeł (kanały, grupy, czaty prywatne, boty) ograniczają działanie trybu folderowego i trybu całego konta. Wybrane czaty mogą być dowolnego typu, w tym czaty prywatne i boty; typy źródeł nigdy nie blokują czatu dodanego ręcznie. Wyłączenie typu, wykluczenie lub przełączenie na wybrane czaty zatrzymuje automatycznie dodawane źródła natychmiast po zapisaniu, jeszcze przed przeliczeniem listy źródeł, a także w sytuacji, gdy nie ma połączenia z Telegramem: ich nowe wiadomości, historia, historia nowych czatów, ustawienia partnerów oraz obserwacje profilu.
  • Czat, który dodasz ręcznie, pozostaje zarejestrowany w trybie folderowym i ogólnokontowym, nawet jeśli znajduje się poza folderem; zatrzymać go można jedynie poprzez Wyklucz, Usuń lub wstrzymanie. Czaty dodane automatycznie podążają za folderem: ten, który opuści folder, zostanie wstrzymany przy następnym przeliczeniu.
  • Wykluczone rozmowy nigdy nie są rejestrowane, niezależnie od trybu. W trybie folderowym i trybie całego konta opcje Wyklucz i Usuń w źródle umieszczają rozmowę na tej liście, dzięki czemu funkcja zakresu nie dodaje jej ponownie. Ręczne ponowne wybranie czatu (w sekcji „Źródła”, z listy „Czaty” lub w menu „Ustawienia” → Które czaty?) powoduje usunięcie go z listy. Lista może pomieścić do 5 000 czatów; po przekroczeniu tej liczby opcja Usuń nie działa, a zamiast tego można wstrzymać czat.
  • Własne działania (domyślnie włączone): wiadomości wysyłane przez to konto, wprowadzone przez nie zmiany oraz naciśnięcia przycisków klawiatury odpowiedzi. Po wyłączeniu tej opcji wiadomości wychodzące i zmiany są pomijane.
  • Przejście do folderu lub całego konta wymaga potwierdzenia: tryby te rejestrują prywatne rozmowy i wiadomości osób trzecich i powinny być stosowane wyłącznie na dedykowanym koncie. Potwierdzenie oraz każda zmiana zakresu są rejestrowane w wpisach typu scope.changed. Na koncie skonfigurowanym jako główne formularz zakresu oraz funkcja „Investigation” odrzucają wybór folderu lub całego konta, podobnie jak funkcja „start”; można z nich korzystać wyłącznie w ramach jednorazowej kopii bez rejestrowania.
  • Czat dodane przez zakres pojawiają się jako źródła oznaczone jako auto, rejestrowane jako scope.applied (na początku i co godzinę) lub source.discovered (nowy czat podczas obserwacji). Powrót do wybranych czatów powoduje natychmiastowe wstrzymanie wszystkich automatycznie dodanych źródeł, bez ponownego odczytywania listy czatów konta. Wykluczony czat przestaje być rejestrowany natychmiast po zapisaniu zakresu, a jego źródło zostaje wstrzymane, nawet jeśli Telegram nie zwraca listy czatów. Podczas obserwacji zapisanie zakresu powoduje jego ponowne zastosowanie, nawet jeśli wartości nie uległy zmianie.

Zakres tych trybów:

  • Czaty tajne korzystają z wbudowanej integracji Pseudo-secret, z modułem protokołu instalowanym z panelu oraz przełącznikiem włączającym tę funkcję dla poszczególnych kont. Historia w chmurze oraz funkcja „Takeout” korzystają z odrębnej ścieżki pozyskiwania danych.
  • Okresy pracy w trybie offline. Po ponownym uruchomieniu TgWitness wznawia pracę od zapisanej pozycji aktualizacji, zwraca się do Telegrama o brakujące aktualizacje i ponownie sprawdza czaty. Telegram przechowuje ograniczoną liczbę zaległych danych, więc po długiej przerwie w działaniu raporty i skrypt verify.py wykazują pozostały przedział jako lukę (zobacz pokrycie).
  • Na początku wyświetlane są tylko pierwsze 1,000 dialogów (limit można ustawić w sekcji Więcej narzędzi → Parametry); starsze czaty są dodawane, gdy ponownie staną się aktywne. Wcześniejsza historia dodanego czatu nie jest pobierana — w razie potrzeby należy wykonać migawkę historii lub pełny eksport czatu.
  • Warunki dotyczące folderów, które ulegają ciągłym zmianom (wyciszone, przeczytane), nie mają zastosowania: takie czaty pozostają pod obserwacją.
  • Przyciski bota wbudowane (z funkcją wywołania zwrotnego), naciśnięte w innej aplikacji, są niewidoczne dla drugiej sesji; odpowiedź lub edycja bota zostaje zarejestrowana. Naciśnięcia klawiszy odpowiedzi są traktowane jako wiadomości wychodzące i oznaczane jako button_press.
  • Więcej rozmów oznacza więcej zapytań. Telegram nakłada ograniczenia na konta, których aktywność uzna za nadmierną, co stanowi kolejny powód, by korzystać z dedykowanych kont.

Starannie wybrane rozmowy#

Strict: read only the chosen chats appears under Chosen chats and is off by default. It is meant for a permission that covers the chosen chats only. While it is on:

  • Powiadomienia serwisowe serwisu Telegram (777000) nie są odczytywane: ani w momencie rozpoczęcia, ani zakończenia obserwacji, ani co minutę w trakcie obserwacji. Nie są zapisywane żadne rekordy typu session.security_baseline ani account.security_event.
  • Lista sesji konta nie jest odczytywana: ani w momencie rozpoczęcia, ani zakończenia obserwacji (pominięte jest również pytanie panelu dotyczące innych sesji w ramach dowodów dla danej sprawy oraz trybów ochrony dowodów), ani co dwie minuty w trakcie obserwacji, ani w momencie nawiązania połączenia, ani podczas sprawdzania połączenia, w ramach którego wpis Current autoryzacji jest wyświetlany jako pominięty. Status weryfikacji dwuetapowej używany przez kontrolę przejęcia również nie jest odczytywany. W związku z tym wartości account.sessions, session.concurrent_at_start i session.takeover_risk nie są zapisywane, a sesja zakończona na innym urządzeniu nie jest zgłaszana jako session_revoked_externally.
  • Chociaż jest to jedyna sesja na tym koncie (należy ustawić tę opcję jako jedyną sesję lub jej wersję automatyczną), lista sesji jest nadal odczytywana co dwie minuty podczas monitorowania, a gdy nawiązywane jest połączenie, zapisywana jest wartość session.exclusive_ended, gdy pojawia się kolejna sesja. W tym okresie wartość 777000 pozostaje nieodczytana, chociaż z zapisu `session.exclusive_from` wynika, że powiadomienia o logowaniu w Telegramie są nadal rejestrowane.
  • Powiadomienia o usunięciu są porównywane z wynikami sprawdzania sesji tylko wtedy, gdy takie sprawdzenie odbyło się w ciągu ostatnich 10 minut (pod warunkiem, że jest to jedyna sesja lub po otwarciu okna Sesje tego konta). W przeciwnym razie, o ile ostatnia kontrola uprawnień nie wykazała, że to konto nie mogło usunąć wiadomości (co nigdy nie ma miejsca w czatach prywatnych i zwykłych grupach), pojawia się komunikat: Nie wiadomo, kto ją usunął: mogło to być samo to konto, z innej sesji lub z innego urządzenia.
  • W przypadku zaimportowanego klucza sesji żadna pozycja w dzienniku nie zawiera informacji o czasie zalogowania się tej sesji, dopóki nie zostanie odczytana lista sesji (na przykład w sekcji Sesje tego konta). Do tego momentu eksporty czatów oraz automatyczne eksporty kont wykorzystują zwykłą sesję zamiast Takeout, podając jako powód session_age_unknown.
  • Włączenie czatu nie powoduje odczytania wcześniejszych wiadomości. Bez tego przełącznika każdy włączony czat (w sekcji „Źródła”, w Czatach, poprzez dołączenie z panelu lub w kreatorze konfiguracji) otrzymuje jedną podstawową migawkę (baseline) swoich najnowszych wiadomości, do wartości określonej w opcji Więcej narzędzi → Parametry → Największa migawka historii (domyślnie 500), gdy uruchomi się następna obserwacja. Migawka oczekująca, której termin upływa w czasie, gdy przełącznik jest włączony, zostaje odrzucona. Czat, do którego dołączyłeś z panelu, również nie jest odczytywany jako nowy czat (licznik Gdy pojawi się nowy czat lub bot, domyślnie 100), a otwarcie wybranego czatu bez zapisanych wiadomości w sekcji „Czaty” nie powoduje automatycznego załadowania jego ostatnich 100 wiadomości. Historia i migawki, które uruchamiasz samodzielnie, nadal odczytują historię.
  • Ustawienie dotyczące treści wrażliwych na koncie nie jest ani odczytywane, ani zmieniane. Bez przełącznika logowanie oraz każde nowe połączenie włączają je, gdy jest wyłączone, a Telegram zezwala na tę zmianę (account.content_settings); ustawienie to należy do konta i ma zastosowanie we wszystkich aplikacjach Telegramu. Treści oznaczone przez Telegram jako wrażliwe mogą pozostać ukryte.
  • Aktualizacje dotyczące rozmów telefonicznych nie są rejestrowane jako account.phone_call.
  • Zatrzymanie obserwacji powoduje zapisanie jedynie odcisku klucza sesji; nie powoduje to odczytania listy sesji ani wartości 777000.

Nie ogranicza to zakresu danych przesyłanych przez Telegram: aktualizacje wszystkich czatów nadal docierają do tej sesji, a rejestrowane są tylko wybrane czaty. Lista czatów konta (do poziomu Czaty odczytane z listy konta) oraz jej foldery są nadal odczytywane na początku, a także ponownie podczas zapisywania zakresu w trakcie obserwacji, w celu znalezienia wybranych czatów. Powiadomienia o usunięciu bez czatu (`deletion.unscoped`) są nadal rejestrowane: zawierają one wyłącznie identyfikatory wiadomości i mogą należeć do wybranego czatu prywatnego lub zwykłej grupy. Sprawdzanie zamrożonych kont (help.getAppConfig), inne kontrole połączeń oraz funkcje, które włączasz samodzielnie (automatyczne kończenie innych sesji, sonda świadka, pseudo-tajne czaty, Sesje tego konta oraz lista zalogowanych urządzeń Telegrama w sekcji Więcej Świadkowie, która odczytuje listę sesji przy każdym przejściu znacznika czasu i która generuje sygnały dla celów Śledź czaty oraz Dowody w sprawie) nadal działają.

Należy włączyć tę funkcję przed zalogowaniem się; w przeciwnym razie samo logowanie sprawdza aktualne uprawnienia i włącza wyświetlanie treści wrażliwych. Każda zmiana jest podpisanym rekordem typu `scope.changed`, a `observation.started` zawiera wartość jako `scope.strict`. Przejście do folderu lub na poziom całego konta powoduje wyłączenie tej funkcji.

Zakres i wybór zdarzeń#

Każdy obszar roboczy ma własne źródła. TgWitness nie dołącza do grup, nie przyjmuje zaproszeń ani nie wylicza automatycznie wszystkich członków. Źródła muszą być już dostępne dla konta. Podczas uruchamiania kolektor sprawdza wybrane źródła w odniesieniu do widocznych okien dialogowych konta; sprawdzanych jest pierwszych 1,000 okien dialogowych, chyba że opcja Więcej narzędzi → Parametry → Czaty odczytane z listy konta stanowi inaczej. Brakujące źródło jest oznaczone jako dostęp niepotwierdzony, a nie zakłada się, że zostało ono usunięte.

Kontekst Gromadzi Skutki wyłączenia funkcji
Nowe wiadomości Zwykłe dostarczone wiadomości W przypadku późniejszych edycji lub usunięć może brakować wcześniej zarejestrowanego tekstu, z którym można by je porównać.
Edycje Dostarczono zredagowane wersje wiadomości Zmiany pośrednie nie są później odtwarzane.
Usunięcia Powiadomienia o usunięciu o określonym zakresie oraz powiadomienia na poziomie konta o nieokreślonym zakresie Powiadomienia o usunięciu nie są dodawane do dziennika.
Reakcje Dostarczone migawki reakcji Nie dodaje się oddzielnych aktualizacji dotyczących reakcji.
Członkostwo Przekazywano komunikaty dotyczące usług członkowskich oraz aktualizacje dla uczestników Uwagi dotyczące członkostwa nie są uwzględniane.

Ustawienia mają zastosowanie do wszystkich wybranych źródeł w obszarze roboczym. Proszę zapisać formularz, aby zastosować zmiany; zmiany są rejestrowane wraz z podpisanymi wartościami „przed” i „po”. Wyłączenie kategorii nie powoduje usunięcia wcześniejszych zapisów. Ponowne włączenie tej kategorii nie powoduje uzupełnienia pominiętych aktualizacji.

Zapisy operacyjne oraz inne zdarzenia związane z obsługą grup pozostają niezależne od tych ustawień. Komunikaty serwisowe dotyczące członkostwa mogą tworzyć zapisy wiadomości, gdy funkcja członkostwa jest włączona, nawet jeśli standardowe przechwytywanie nowych wiadomości jest wyłączone. Przechwycone obiekty z Telegrama zachowują osadzone metadane; ustawienie to nie jest regułą redagowania.

Usunięcia w prywatnych czatach i zwykłych grupach pojawiają się jako identyfikatory wiadomości bez przypisania do czatu. Czaty te współdzielą jedną sekwencję identyfikatorów wiadomości dla całego konta, więc gdy wiadomość o tym identyfikatorze została wcześniej zapisana, jej czat jest znany: usunięcie jest rejestrowane w tym czacie wraz z chat_resolution wyjaśniającym, w jaki sposób. Identyfikatory, które nigdy nie zostały zapisane, pozostają usunięciem bez zakresu z wyraźnie nierozwiązanym czatem. Są to powiadomienia o usunięciu w Telegramie, zachowywane nawet wtedy, gdy nie można jeszcze skojarzyć ich z czatem. Schemat powiadomienia zawiera identyfikatory; dziennik dodaje czas odbioru oraz wszelkie zapisane informacje kontekstowe dotyczące wiadomości, w tym deleted_message_was_outgoing. Dostępne wpisy w dzienniku administratora stanowią oddzielne źródło informacji o akcji, podmiocie wykonującym oraz czasie źródłowym.

Własne działania#

Wiadomości wysyłane przez obserwowane konto są oznaczone jako outgoing. Informacja o edycji wiadomości wychodzącej wskazuje, że w czatach prywatnych i grupach tylko jej autor może ją edytować, natomiast posty na kanałach mogą być edytowane przez innych administratorów. Gdy wysyłana wiadomość powtarza tekst przycisku z najnowszej zapisanej klawiatury odpowiedzi w tej rozmowie, opatrzona jest oznaczeniem „button_press” wraz z linkiem do zapisu tej klawiatury.

Wyłączenie własnych działań dotyczy również ponownej weryfikacji w tle oraz automatycznej historii nowych czatów. Pominięte wiadomości wychodzące przesuwają pozycję ponownej weryfikacji do przodu, dzięki czemu nie mogą one blokować późniejszych wiadomości przychodzących. Wyraźnie wykonane działania w panelu oraz ręcznie zlecone migawki historii pozostają zarejestrowane.

Tryb dochodzeniowy: dołączanie do zespołów i komunikacja z botami#

Więcej narzędzi → Źródła → Zakres → Tryb dochodzeniowy przygotowuje zakres dla dedykowanego konta, które dołącza do czatów zespołowych, uruchamia boty i pisze do nich: całe konto, każdy typ źródła, własne działania oraz dla każdego czatu lub bota, który się pojawia – jego profil i ostatnie 200 widocznych wiadomości. Sprawdź formularz i naciśnij Zapisz zakres; przełączenie na całe konto wymaga standardowego potwierdzenia.

  • Przyciski. Przyciski znajdujące się pod wiadomością są zachowywane wraz z nią i wyświetlane w sekcji „Czat”: linki, aplikacje internetowe, linki logowania, teksty do skopiowania, dane dotyczące oddzwaniania, zapytania wbudowane, prośby o podanie numeru telefonu lub lokalizacji. Linki są wyświetlane jako tekst i nigdy nie są otwierane przez panel. Gdy bot zmienia wyłącznie przyciski (np. nowy link do płatności), stanowi to nową wersję wiadomości, zarówno w przypadku aktualizacji na żywo, jak i ponownych sprawdzeń.
  • Nowe czaty i boty. W trybie folderowym oraz trybie całego konta, gdy pojawia się nowy czat lub bot, zapisywane są one natychmiast po ich pojawieniu się:

    • jego profil jako rekord source.profile: opis bota i polecenia, tekst informacyjny dotyczący użytkownika, grupy lub kanału, członkowie, powiązany czat oraz link zaproszeniowy, o ile Telegram go udostępnia;
    • najnowsze widoczne wiadomości (do 1 000) w postaci migawki historii oznaczonej jako new_chat: wcześniejsze wiadomości z czatu zespołowego, do którego właśnie dołączył użytkownik, lub to, co powiedział bot, zanim obserwator zauważył czat. Wiadomości już zapisane na żywo nie są powtarzane.

    Nowo wybrane czaty korzystają z tych ustawień po zastosowaniu zakresu, w tym czaty już obecne na liście okien dialogowych konta. Wstępne ładowanie profilu i historii odbywa się jednocześnie dla maksymalnie trzech czatów; operacje dotyczące tego samego czatu są wykonywane po kolei. Każdy etap historii/profilu wykorzystuje skonfigurowany limit czasu operacji, więc zablokowane żądania zwalniają przypisany do nich proces roboczy. Historia jest zapisywana przed opcjonalnym odczytem profilu; niepowodzenie odczytu profilu nie uniemożliwia zapisania historii. Etapy, które zakończyły się niepowodzeniem, są ponawiane po 5 sekundach, a czas ten wydłuża się dwukrotnie do maksymalnie 5 minut, bez angażowania procesora podczas opóźnienia. ID oczekujące, terminy ponownych prób oraz zakończone etapy są zapisywane lokalnie. Ponowne uruchomienie wznawia tylko etapy niedokończone; ponowna próba odczytu profilu nie powtarza zakończonego odczytu historii. Źródła wyłączone przed nadejściem ich kolejki są pomijane. Przegląd pokazuje aktywne, oczekujące i ponawiane ładowania czatów oddzielnie od pobrań załączników. FloodWait wstrzymuje tę pracę, a po jego zakończeniu jest ona wznawiana; awarie są rejestrowane, a rejestrowanie czatu na żywo jest kontynuowane. Obejmuje to oczekiwanie podczas ustalania tożsamości nowego czatu: oczekujące zadanie związane z profilem/historią jest zachowywane do ponownej próby, a istniejące dłuższe oczekiwanie na poziomie konta nie ulega skróceniu. Pracownicy dzielą się tym oczekiwaniem; współbieżność nie omija limitów żądań Telegrama. - Profile na żądanie. Czat → Profil → Zapisz profil – teraz zapisuje bieżący profil dowolnego źródła; najnowszy profil jest wyświetlany nad wiadomościami. - Migawki stanu czatu (wersja zapoznawcza). Stan poza strumieniem wiadomości zmienia się bez wysyłania wiadomości: odpięcie każdej wiadomości nie pozostawia śladu na poziomie wiadomości, administrator traci uprawnienia, prezent jest ukrywany, zamieniany, ulepszany lub zwracany. Podczas obserwacji każde włączone źródło jest okresowo odczytywane i zapisywane jako podpisany chat.state rekord: tytuł, nazwy użytkowników, opis, liczba członków i administratorów, powiązany czat, tryb spowolniony, identyfikatory przypiętych wiadomości (do 100), administratorzy wraz z ich uprawnieniami i tytułami oraz prezenty wyświetlane na kanałach i profilach użytkowników (do 100). Każdy zapis zawiera listę różnic w stosunku do poprzedniej migawki: zmienione pola wraz ze stanem przed i po, przypięte wiadomości dodane lub usunięte, administratorzy oraz prezenty dodane, zmienione lub nie figurujące już na liście. - Część, której Telegram odmawia udostępnienia (na przykład lista administratorów kanału dla członka, który nie jest administratorem), jest wymieniona w errors; jej wcześniejsza wartość jest zachowana i wymieniona w carried_forward, nigdy nie jest zgłaszana jako usunięta. - Rekord, w którym jedynymi zmianami są liczby oraz sprawdzenie, które nie wykazało żadnych zmian, odnosi się do ostatniego pełnego stanu z state_seq i skumulowanym state_overrides. Pełny stan jest zapisywany co najmniej co siedem dni oraz za każdym razem, gdy zmienia się cokolwiek poza liczbą. - parts_complete oznacza listy z limitem. Dodawanie wymaga kompletnej wcześniejszej listy, usuwanie wymaga kompletnej bieżącej listy, a jawne puste wartości oznaczają wyczyszczenie listy. - Więcej narzędzi → Parametry → Stan czatu pozwala ustawić interwał (domyślnie 12 godzin, 0 wyłącza migawki ), przerwę między źródłami, które części są odczytywane oraz to, czy sprawdzanie, które nie wykazało zmian, jest rejestrowane. FLOOD_WAIT oraz FLOOD_PREMIUM_WAIT zatrzymują pozostałe żądania migawek, zachowują wszelkie dłuższe terminy obowiązujące dla całego konta oraz pozostawiają przerwany czat kwalifikujący się do kolejnej próby po upływie tego czasu oczekiwania. - Niewidoczne. Przyciski wbudowane (wywołania zwrotne) naciśnięte w innej aplikacji Telegram, wyskakujące okienko lub link, którym bot odpowiada na takie naciśnięcie, oraz linki zaproszeniowe używane w innej aplikacji nie docierają do TgWitness. To, co bot wysyła lub edytuje później, jest rejestrowane.

Działanie z poziomu panelu#

W sekcji „Czat” dodano teraz miniklient korzystający z konta Telegram wybranego obszaru roboczego:

  • Proszę wpisać wiadomość w postaci zwykłego tekstu lub wybrać opcję „Odpowiedz” pod zapisaną wiadomością. Wysyłana wiadomość jest rejestrowana nawet wtedy, gdy zakres rejestracji nie obejmuje wysyłanych aktualizacji.
  • Naciśnij przycisk „Press” znajdujący się pod bieżącym przyciskiem zwrotnym lub tekstowym. Serwer ponownie pobiera wiadomość i odrzuca działanie, jeśli treść wprowadzona z klawiatury różni się od zapisanej wersji. Potwierdzenia zwrotne zachowują tekst wyskakującego okienka Telegrama, flagę powiadomienia oraz adres URL; odpowiedź jest również wyświetlana pod rozmową. Adresy URL pozostają tekstem, który można zaznaczyć, i nie są otwierane automatycznie.
  • Naciśnij + → Otwórz link do Telegrama, wprowadź @username, publiczny link https://t.me/name, https://t.me/+invite / joinchat/invite lub link do bota z ?start=parameter, a następnie naciśnij Zapisz podgląd. Oryginalny link i podgląd Telegrama są podpisywane przed dołączeniem. Dołącz / otwórz i obserwuj, a następnie dołącz do grupy/kanału lub otwórz użytkownika/bota, dodaj czat jako włączone źródło i wyślij do bota polecenie /start, podając parametr startowy. Prośba o dołączenie oczekująca na zatwierdzenie przez administratora jest rejestrowana jako oczekująca, a nie jako członkostwo.

Włącz opcję Rozpocznij obserwację, aby rejestrować przychodzące odpowiedzi na żywo. Działania panelu działają, gdy obserwacja jest wstrzymana; panel zapisuje wówczas swoje bezpośrednie odpowiedzi, a obserwacja na żywo rejestruje pozostałą część rozmowy. Nowo dodane źródła korzystają ze skonfigurowanego profilu/historii pobierania danych podczas trwania obserwacji. Gdy źródło jest wstrzymane, włącz je w sekcji Więcej narzędzi → Źródła przed wysłaniem lub naciśnięciem jego przycisków.

interaction.preview, interaction.requested i interaction.result to standardowe, podpisane zdarzenia dziennika uwzględniane w eksportach dowodów. Żądania identyfikują konto, wiadomość/przycisk lub rekord podglądu oraz wskazują, czy obserwacja była uruchomiona. Potwierdzenia rozróżniają wynik pomyślny, odrzucenie, zatwierdzenie w toku oraz wynik nieznany. Przerwane żądanie mogło dotrzeć do Telegramu: proszę sprawdzić czat przed rozpoczęciem nowej czynności. Ponowne użycie identyfikatora żądania powoduje pobranie zapisanego potwierdzenia bez powtarzania akcji, również po ponownym uruchomieniu. Panel zachowuje ten identyfikator po otrzymaniu niejednoznacznej odpowiedzi dotyczącej tej samej akcji w trakcie bieżącej sesji na stronie. Zachowuje go również, gdy odświeżenie widoku nie powiedzie się po pomyślnym wykonaniu akcji: potwierdzenie pozostaje widoczne, a ponowne kliknięcie powoduje jego pobranie. Wywołania zwrotne i RPC typu „join” mają jedną próbę wykonania; operacje odczytu z możliwością ponownej próby zachowują skonfigurowaną politykę ponownych prób. Natychmiastowe przełączenie czatów powoduje wyczyszczenie wersji roboczej i adresata odpowiedzi oraz wyłącza wysyłanie do momentu załadowania nowej rozmowy.

Ten miniklient obsługuje przyciski tekstowe i przyciski z funkcją wywołania zwrotnego. Przyciski miniaplikacji uruchamiają opcję Otwórz miniaplikację, która uruchamia aplikację w izolowanej przeglądarce (miniaplikacje). Logowanie, prośby o numer telefonu i lokalizację, płatności, zapytania wbudowane oraz załączniki nadal wymagają klienta Telegramu; zapisane metadane tych przycisków pozostają widoczne. Nowe elementy sterujące wykorzystują tekst w języku angielskim.

Poziomy weryfikacji#

Ponowne sprawdzanie polega na ponownym zapytaniu serwisu Telegram o pominięte wiadomości, edycje oraz wiadomości, których serwis już nie zwraca. Źródła oznaczone gwiazdką są źródłami priorytetowymi, domyślnie sprawdzanymi ponownie co 15 minut; wszystkie pozostałe źródła – co 6 godzin. Wybrane czaty są początkowo traktowane jako źródła priorytetowe, natomiast czaty dodane poprzez folder lub całe konto – jako źródła zwykłe. W każdym przebiegu ponownie sprawdzanych jest maksymalnie 30 źródeł, a pozostałe czekają do następnej minuty; po ponownym połączeniu źródła priorytetowe są sprawdzane w pierwszej kolejności. Oba interwały ustawia się w sekcji Więcej narzędzi → Źródła → Rejestracja → Ponowna kontrola (wartość 0 wyłącza dany poziom) i są one rejestrowane jako recheck.changed.

Pominięte wiadomości są pobierane od miejsca, w którym zatrzymało się poprzednie przejście, maksymalnie do wartości określonej w Więcej narzędzi → Parametry → Liczba odzyskanych pominiętych wiadomości na czat i przejście (domyślnie 1,000). Po długiej przerwie ponowna weryfikacja wypełnia zatem całą lukę, nawet jeśli najpierw zapisano wiadomości na żywo nowsze niż ta luka. Czat, który wciąż nadrabia zaległości, jest ponownie sprawdzany w następnej minucie zamiast czekać na swój interwał warstwy; recheck.completed pokazuje continues_after, dopóki nie zostanie zakończone.

Porównania obejmują treść wiadomości, podmioty, klawiatury (w tym usunięcia) oraz treść i tożsamość załączników. Sama zmiana skrótów dostępu do plików lub odwołań do plików nie stanowi edycji, podobnie jak elementy uzupełniane automatycznie przez Telegram: ładowanie podglądu linku, wyświetlenia relacji, płatne materiały multimedialne odblokowane przez to konto oraz potwierdzenie otrzymania faktury. Każda zapisana wersja w sekcji „Czat” zawiera link do pełnego wpisu w dzienniku, w tym metadanych multimediów.

Historia wiadomości i przypisanie autorstwa#

Załóżmy, że narzędzie rejestrujące odnotowuje komunikat „Spotkanie o godz. 10:00”, następnie widzi komunikat „Spotkanie o godz. 11:00”, a potem otrzymuje powiadomienie o usunięciu. Dodaje ono trzy odrębne zapisy. Oryginalny tekst pozostaje, edycja stanowi oddzielną wersję, a powiadomienie odnotowuje, że zaobserwowano usunięcie.

Jeśli gromadzenie danych rozpoczęło się po zniknięciu pierwszej wersji, tekst ten jest niedostępny. Jeśli podczas przerwy w działaniu serwisu nastąpiło kilka zmian, zapisane mogą zostać jedynie wersje zaobserwowane później. Powiadomienie o usunięciu nie pozwala na odzyskanie treści, które nigdy nie zostały zarejestrowane.

Zapis łączy w sobie kilka źródeł:

Źródło Zachowane informacje
Wiadomość na żywo lub aktualizacja edycji Identyfikator wiadomości, metadane nadawcy, wersja przechwycona, czas odbioru oraz podana data wiadomości/edycji w Telegramie.
Powiadomienie o usunięciu na żywo Zgłoszone identyfikatory wiadomości, czas odbioru, surowe powiadomienie oraz linki do wcześniej zapisanych treści.
Dostępny dziennik administratora Działanie, podmiot, data źródłowa oraz treść dostarczonej wiadomości, odczytane przez konto posiadające wymagane uprawnienia.
Interakcja z panelem Żądana czynność i jej zarejestrowany wynik w ramach wybranego konta.
Sprawdź ponownie Aktualna odpowiedź serwisu Telegram w porównaniu z wcześniej zapisaną wiadomością.

observed_at jest to czas, w którym rekord został zapisany w zegarze kolektora i wzrasta wraz z seq. Rekordy zapisane podczas przetwarzania aktualizacji na żywo zawierają również received_at, czyli czas, w którym aktualizacja dotarła do kolektora, oraz processing_delay_ms, czyli czas od odbioru do zapisania; aktualizacje zatrzymane podczas rozpoczęcia obserwacji są przetwarzane w kolejności nadejścia przed późniejszymi. source_at zachowuje datę źródłową, o ile zdarzenie ją podaje. Obserwacje przesunięcia zegara telegramu, zapisy nieciągłości zegara oraz zewnętrzne kontrole czasu zapewniają odpowiedni kontekst czasowy. Pola zwykłego powiadomienia o wiadomości opisują to powiadomienie; zapisy dziennika administracyjnego i interakcji zachowują własne atrybuty.

Migawki historyczne#

Migawka pobiera najnowsze widoczne wiadomości z włączonego źródła, maksymalnie 500 na żądanie. Wyniki są oznaczane jako obserwacje historyczne. Ręczne migawki są uruchamiane równolegle z obserwacją. Powtarzające się obserwacje są przechowywane jako oddzielne rekordy. Włączenie źródła powoduje również wykonanie jednej migawkibaseline’owej tego źródła, chyba że włączona jest opcja „tylko wybrane czaty”.

Tworzenie migawek zostaje przerwane, jeśli źródło zostanie wyłączone w trakcie odczytu. Odpowiedzi muszą pochodzić z żądanej rozmowy i zawierać ściśle malejące dodatnie identyfikatory wiadomości poniżej żądanego granicy. Nieprawidłowa odpowiedź przerywa tworzenie migawki przed zapisaniem tej wiadomości; już zachowane wiadomości pozostają w podpisanym dzienniku wraz z zapisem przerwania.

Zrzuty ekranu są zgodne z polityką dotyczącą załączników, ale pozostają oddzielone od przełączników zdarzeń na żywo. Nie odtwarzają one usuniętych wiadomości ani pominiętych wersji pośrednich. Można złożyć wniosek o ich utworzenie w trakcie wstrzymania; wszelkie załączniki umieszczone w kolejce pozostają w oczekiwaniu do momentu rozpoczęcia obserwacji i uruchomienia modułu pobierania.

Uruchomienie Historii to osobne zadanie na wyłączność: kolejno odczytuje wybrane źródła i pobiera ich załączniki z kolejki, bez uruchamiania monitoringu. Wstrzymanie zwalnia konto, a wznowienie kontynuuje zapisany przebieg. Filtry dat, języka i odpowiedzi dla kilku wolnych kont opisuje Rozproszony eksport czatu.

Obsługa załączników#

Pobieranie załączników jest domyślnie włączone i zostaje wstrzymane, gdy wolne miejsce na dysku spadnie poniżej 1 GiB. Moduł zbierający rejestruje obserwację wiadomości i zadanie pobierania łącznie. Zadanie zachowuje oryginalny deskryptor multimediów oraz zasady dotyczące rozmiaru, dzięki czemu załącznik poddany późniejszej edycji nie zostanie zastąpiony bez powiadomienia.

Pobieranie odbywa się po przechwyceniu wiadomości. Zakończone pobieranie tworzy rekord media.saved wraz z jego wartością SHA-256 i liczbą bajtów. Pominięte, nieudane, ponowione i przerwane operacje mają odrębne wyniki; plik uznaje się za zachowany, gdy istnieje jego rekord media.saved . Zakończony plik musi również odpowiadać liczbie bajtów podanej w oryginalnym deskryptorze załącznika będącego przedmiotem obserwacji. Krótka lub nieoczekiwanie długa odpowiedź nie jest rejestrowana jako zachowane medium.

Plik i jego wpis w katalogu są zapisywane na dysku przed zapisaniem wartości media.saved. Gdy poprzedni proces kolektora zakończył się bez prawidłowego zamknięcia, przy kolejnym uruchomieniu odczytywane są wszystkie pliki zarejestrowane jako zapisane podczas tego przebiegu. Plik, którego brakuje lub którego bajty różnią się od zarejestrowanego skrótu SHA-256, otrzymuje rekord typu media.missing_after_restart, jego pobieranie jest ponownie umieszczane w kolejce, a bajty, w których występują różnice, są przenoszone do katalogu media-damaged/. Pliki przeniesione do magazynu zewnętrznego nie są odczytywane.

W ramach jednego obszaru roboczego zadania oczekujące w kolejce na tę samą reprezentację załącznika czekają na aktywny transfer, a następnie ponownie sprawdzają zapisane bajty przed ponownym wykorzystaniem. Każde zadanie przechowuje własny wynik ze znakiem oraz odwołanie do wcześniejszego rekordu zapisanego pliku. Anulowanie oczekującego zadania nie powoduje anulowania aktywnego transferu; jeśli transfer ten zakończy się niepowodzeniem lub zostanie anulowany, kolejne zadanie może podjąć kolejną próbę. Różne załączniki mogą być pobierane równocześnie.

Zadania o tym samym koncie, reprezentacji, oczekiwanej wielkości i akcji przechwytywania pozostają w kolejce, dopóki trwa wykonywanie jednego pasującego zadania. Nie zajmują one slotów pobierania, więc inne pliki mogą zostać uruchomione nawet wtedy, gdy na początku kolejki znajduje się wiele kopii jednego powolnego pliku. Zakończenie próby powoduje wznowienie kolejki. Nadal obowiązują pasy priorytetowe, zapisane opóźnienia ponownych prób oraz własność historii; każda obserwacja otrzymuje własny wynik.

Eksporty czatu wykorzystują również aktywny transfer w celu wielokrotnego udostępniania plików w ramach tego samego katalogu eksportowego. Każda wiadomość zachowuje odwołanie do załącznika, a ponowne wykorzystanie wymaga sprawdzenia aktualnego rozmiaru i skrótu SHA-256. Różne pliki mogą być sprawdzane równolegle bez blokowania wspólnego transferu. Tymczasowe ścieżki pobierania i kopiowania są unikalne dla każdej operacji; w przypadku anulowania operacji system czeka na zakończenie działania wszelkich aktywnych lokalnych programów odczytujących pliki przed wyczyszczeniem pamięci. Indeks plików eksportowych serializuje wyłącznie dostęp do metadanych, a nie generowanie skrótów plików ani ich pobieranie.

Odczyty hashów serwerowych dla różnych załączników również przebiegają równolegle, dzieląc trzy sloty żądań plików klienta z pobieraniem bajtów. Powtarzające się odczyty tej samej reprezentacji wykorzystują wyłącznie kompletny wynik z pamięci podręcznej. Odczyty plików nie zajmują miejsca w zwykłej kolejce żądań; zapisane terminy FloodWait są ponownie sprawdzane, gdy żądanie otrzymuje slot.

Limity są ustalane dla poszczególnych typów: zdjęcia, filmy, pliki GIF i animacje, okrągłe wiadomości wideo, wiadomości głosowe, muzyka i pliki audio, naklejki oraz pliki. Każdy typ można wyłączyć i ma on własny limit rozmiaru od 1 do 2 000 MiB; nowe obszary robocze rozpoczynają się od 20 MiB dla zdjęć, 100 MiB dla filmów, 50 MiB dla plików, plików audio i okrągłych filmów, 20 MiB dla wiadomości głosowych i plików GIF oraz 5 MiB na naklejki. W nowych obszarach roboczych pliki GIF i naklejki są domyślnie wyłączone do momentu ich włączenia. Obszary robocze z zasadami zapisanymi przed wprowadzeniem limitów dla poszczególnych typów zachowują wszystkie typy włączone i utrzymują jeden limit dla każdego typu. Maksymalny rozmiar pliku ustala się jednocześnie dla wszystkich typów. Wyłączenie danego typu powoduje utworzenie rekordu media.skipped; pliki o nieznanym rozmiarze lub przekraczające limit nie są pobierane. Duże pliki otrzymują dodatkowy czas pobierania w oparciu o ich rozmiar i prędkość bazową wynoszącą 256 KiB/s. Zadania pozostają aktywne po ponownym uruchomieniu, jednak wygasłe odwołania, utrata dostępu lub usunięte pliki mogą nadal uniemożliwić ich odzyskanie. Zadania oczekujące zachowują zapisany dla nich limit, więc podwyższony limit ma zastosowanie wyłącznie do nowych plików. Wyłączenie typu lub obniżenie jego limitu powoduje również pominięcie wykluczonych plików oczekujących, z których każdy posiada rekord typu „media.skipped”; wyłączenie pobierania wstrzymuje działanie kolejki do momentu ponownego włączenia tej funkcji.

Wstrzymanie, zablokowanie, rozłączenie i ponowne uruchomienie#

Czynność lub stan Efekt
Zmień obszar roboczy Zmienia widok panelu; pozostałe narzędzia do gromadzenia danych zachowują swój stan.
Zablokuj panel lub zamknij kartę Serwer i proces monitorowania pozostają uruchomione.
Wstrzymanie obserwacji Zatrzymuje działanie tego modułu zbierającego i zachowuje zadania związane z załącznikami znajdujące się w kolejce.
Wyłącz źródło Wyłącza przyszłe przechwytywanie w określonym zakresie; zadania związane z multimediami oczekujące w kolejce na tę funkcję są wstrzymywane na czas jej wyłączenia.
Usuń źródło Narzędzie pomija tę platformę jako źródło i usuwa profile użytkowników; zapisane już dane pozostają w dzienniku, do którego można jedynie dodawać nowe wpisy. Załączniki, które wciąż oczekują na przetworzenie, są rejestrowane jako nieudane (source_removed). W trybie folderowym i trybie całego konta są one również pomijane.
Zmiana trasy połączenia Wymaga wstrzymania działania, zamyka stare sesje klientów i anuluje niedokończone logowanie.
Zatrzymanie procesu w języku Python Narzędzie zatrzymuje działanie wszystkich obszarów roboczych; w trybie offline nie są rejestrowane żadne obserwacje.
Ponowne uruchomienie po zakończeniu aktywnej obserwacji Próba wznowienia zapisanego zakresu przy użyciu zapisanej sesji. Ręczne wstrzymanie usuwa ten zamiar.

Kolektor rejestruje wykryte rozłączenia, ponowne próby, błędy, uruchomienia/zatrzymania oraz sygnały kontrolne. Krótkie przerwy mogą zostać pominięte podczas okresowych kontroli łączności. Po ponownym uruchomieniu żądane są pominięte aktualizacje od zapisanej pozycji aktualizacji, a obserwowane czaty są okresowo sprawdzane ponownie; zobacz format dowodów. Migawka dodaje aktualny stan jako kontekst, a luka pozostaje zarejestrowana.

Izolacja i weryfikacja kont#

Każdy obszar roboczy posiada własny dziennik, uprawnienia, klucz podpisujący, zasady oraz kolejkę. Tylko aktywny klient danego obszaru roboczego może wprowadzać obserwacje na bieżąco. Klienci, których wnioski zostały odrzucone, oczekują na rozpatrzenie, zostali zastąpieni lub przeprowadzają test połączenia, nie mogą wprowadzać aktualizacji na bieżąco do dziennika tego obszaru roboczego. Różne konta mogą obserwować tę samą grupę, jednak ich dzienniki pozostają oddzielne.

Każde zdarzenie zawiera poprzedni skrót oraz podpis Ed25519. Eksport obejmuje cały dziennik obszaru roboczego poprzez stały numer sekwencyjny. Filtry panelowe nie filtrują eksportu; gromadzenie danych może trwać poza jego granicami w trakcie przygotowywania eksportu.

Dziennik weryfikacyjny sprawdza ciąg zdarzeń i podpisy w ramach wyświetlanego zakresu. Jego wynik jest kasowany w momencie zmiany obszaru roboczego, a panel identyfikuje nowe rekordy dodane po przeprowadzeniu kontroli. Eksport do formatu ZIP pozwala również zweryfikować zebrane pliki multimedialne.

Oddzielnie zachować odciski palców i punkty kontrolne. Zobacz zakres weryfikacji, aby zapoznać się z kontrolami pozyskiwania danych w każdym trybie, oraz codzienne operacje, aby zapoznać się z rutynowym gromadzeniem danych.