Odniesienie / Bezpieczeństwo i projekt
Architektura
Elementy składowe: moduł zbierający, panel, dziennik, moduły robocze oraz moduł „witness”, a także sposób przepływu danych między nimi.
Jeden proces w języku Python obsługuje panel FastAPI oraz dowolną liczbę izolowanych obszarów roboczych, z których każdy posiada klienta konta użytkownika Telethon. Baza danych SQLite przechowuje podpisany dziennik zdarzeń z możliwością wyłącznie dodawania wpisów oraz zmienne ustawienia operacyjne. W zaszyfrowanym sejfie przechowywane są dane uwierzytelniające API, obiekt StringSession oraz klucz podpisujący. Interfejs użytkownika stanowi zwykły pakiet plików HTML/CSS/JavaScript: nie jest wymagana kompilacja w środowisku Node, korzystanie z sieci CDN ani pobieranie interfejsu użytkownika w czasie wykonywania.
Opcjonalne rejestratory przeglądarki i AyuGram działają w oddzielnych procesach lub kontenerach.
Pakiet tgwitness_capture pakiet posiada własny format zdarzeń, klucze, artefakty,
API punktów kontrolnych, niezależnego świadka oraz samodzielny weryfikator. Jest on dołączony do głównego
koła i można go również zainstalować samodzielnie z addons/capture, bez konieczności importowania
modułu zbierającego. capture_api.py i capture_connections.py
zapewniają dostępne wyłącznie dla administratora elementy sterujące w zakresie obszaru roboczego pod /api/capture;
tokeny połączeń są przechowywane w zaszyfrowanym skarbcu. Żaden rejestrator ani żądanie wychodzące nie uruchamia się
w ramach głównego procesu. Każde jawne polecenie weryfikuje nowe wyzwanie względem
przypiętego klucza rejestratora. Eksporty są weryfikowane przed pobraniem i zachowują swój oryginalny
podpis; nie stają się one zdarzeniami wiadomości w Telegramie. Sesje gromadzenia danych i trasy proxy
pozostają przy każdym kliencie. Informacje na temat wdrażania i granic zaufania można znaleźć w angielskim przewodniku dotyczącym niezależnego
przechwytywania.
| Moduł | Odpowiedzialność |
|---|---|
| collector.py | Autoryzacja, wybór okien dialogowych, aktualizacje, migawki, kolejka multimediów, monitorowanie połączeń |
| interactions.py / telegram_client.py | Wyraźnie określone działania paneli, podpisane potwierdzenia, trwałe identyfikatory żądań oraz polityka ponownych prób wywołań zwrotnych i dołączania w ramach danego zadania |
| message_content.py | Porównanie widocznych wiadomości, z wyłączeniem metadanych dotyczących dostępu do sieci transportowej |
| workers.py | Należy poczekać na zakończenie pracy procesów eksportujących pliki przed przeprowadzeniem operacji czyszczenia po anulowaniu |
| distributed_export.py / distributed_pages.py | Równoległe zadania czatu, rezerwacje na konto, podpisane punkty kontrolne oraz czyszczenie po weryfikacji archiwum |
| distributed_takeout.py / export_timing.py | Sesje Takeout z możliwością wznowienia oraz czasy dla każdego uruchomienia lub wznowienia |
| store.py | Transakcje WAL, uporządkowany łańcuch zdarzeń, filtry zapytań, ustawienia operacyjne |
| fulltext.py | Wyprowadzony indeks pełnotekstowy (formy wyrazów, BM25), powiązany z nagłówkiem podpisanego dziennika; nigdy nie jest eksportowany |
| security.py | Tworzenie plików prywatnych, zaszyfrowany sejf, podpisywanie algorytmem Ed25519, blokada pojedynczego procesu |
| evidence.py | Eksport pełnego dziennika, pliki pochodne, punkty kontrolne, weryfikacja załączników |
| verify.py | Samodzielny weryfikator tylko do odczytu (biblioteka standardowa + kryptografia): archiwa, zakres, dzienniki świadków i posty na kanałach, pliki profilowe |
| app.py | Uwierzytelnione API, cykl życia, walidacja żądań, panel statyczny |
| profiles.py | Kolektory obsługujące wiele kont, kontroler wspólnego dostępu, cykl życia dostosowany do poszczególnych obszarów roboczych |
| access.py | Dotacje o określonym zakresie, sprawdzanie uprawnień, ograniczenia adresów IP, limity sesji oraz konsola administratora |
| proxy_catalog.py | Zrzuty ekranu z kanałów publicznych, kontrole transmisji, wspólna pula serwerów proxy oraz selekcja oparta na stanie sprawności |
| provenance.py | Podpisane pomiary tożsamości, kodu i zależności w trakcie procesu pozyskiwania danych |
| network.py | Zweryfikowane ścieżki dla poszczególnych obszarów roboczych; status i dowody poddane redakcji; opcje przesyłania danych w ramach Telethon |
| sessions.py | Konwersja zweryfikowanych schematów bazy danych Telethon w formacie SQLite do trybu tylko do odczytu w trybie offline |
| account_import.py | Wykrywanie i normalizacja w pamięci obsługiwanych plików kont oraz plików JSON |
| tdata.py | Ograniczony, nowoczesny czytnik plików ZIP TData, weryfikacja sum kontrolnych i odszyfrowania, bez wyodrębniania danych |
| doctor.py | Lokalne testy gotowości bez gromadzenia danych, logowania ani instalacji pakietów |
| download.py | Uwierzytelniony eksport strumieniowy z możliwością pobrania, z ograniczonymi operacjami odczytu i bez nadpisywania danych |
| monitoring.py | Zweryfikowane zasady dotyczące zdarzeń w poszczególnych obszarach roboczych oraz reguły dotyczące załączników w zależności od typu, udostępniane przez osoby odpowiedzialne za obsługę, statusy oraz podpisane potwierdzenia odbioru |
| scope.py | Zakres monitorowania (wybrane czaty, folder Telegramu, całe konto), typy źródeł, wykluczenia, poziomy ponownej weryfikacji |
| dossier.py | Profile użytkowników dla poszczególnych czatów tworzone na podstawie zapisanych danych: fakty wraz z odniesieniami do zapisów, skróty SHA-256/pHash awatarów, ekstrakcja wzmianek |
| witness_api.py | Tokeny świadków z prawem tylko do odczytu oraz podpisany nagłówek dziennika, który mogą pobrać |
| witness.py | Niezależny proces świadectwa: własny klucz i dziennik, weryfikacja tożsamości, podpisane posty na kanałach, eksport |
| alerts.py | Powiadomienia w aplikacji Apprise oraz lista powiadomień na panelu |
| logging_config.py | Rejestrowanie w konsoli oraz rotacyjna diagnostyka serwera w przypadku uruchomień bez okien graficznych |
| static/ | Interfejs dostosowujący się do różnych urządzeń, lokalna brama dostępu, filtry, szczegóły, eksport danych, konfiguracja konta |
| demo.py | Wyraźnie oznaczony dziennik syntetyczny, oddzielony od rzeczywistych danych |
Moduły obsługi obserwacji są rejestrowane przed nawiązaniem połączenia. Gromadzenie danych na żywo jest ograniczone przez tożsamość aktywnego klienta, wyraźny stan działania, włączone źródła lub zakres obserwacji (tryby folderowe lub obejmujące całe konto dodają nową rozmowę jako źródło przy jej pierwszej aktualizacji) oraz zasady dotyczące zdarzeń. Odrzuceni i zastąpieni klienci nie mogą przekazywać aktualizacji na żywo. Surowe reakcje i aktualizacje członkostwa zachowują ograniczenia widoczności. Treść przychodzącej wiadomości oraz związane z nią zadanie trwałego nośnika są zapisywane łącznie. Zadania zachowują oryginalny deskryptor TL i wiążą jego skrót z podpisaną obserwacją wiadomości. Semantyka nadawcy, edytora i usuwającego jest rozdzielona.
Każdy obszar roboczy obsługuje jedno konto i posiada własny katalog oraz tożsamość podpisującą. Główny obszar roboczy pozostaje w katalogu głównym ze względu na kompatybilność; dodatkowe obszary robocze znajdują się w katalogu profiles/<id>/. Całą instalacją zarządza jeden token typu „bearer”; obszary robocze nie stanowią oddzielnych podmiotów autoryzacyjnych. Blokady procesów chronią katalogi; blokady bazy danych serializują wstawianie zdarzeń. Każde dodanie jest zapisywane synchronicznie do dziennika WAL bazy SQLite w trybie pełnej synchronizacji. Wyzwalacze aktualizacji/usuwania zdarzeń uniemożliwiają zwykłe edycje w aplikacji; administratorzy systemu plików pozostają w granicach strefy zaufania.
Autoryzacja API odbywa się za pomocą tokenu typu bearer. Operacje logowania są serializowane i ograniczone czasowo. Przesyłanie danych na konto wykorzystuje dedykowany limit 12 MiB dla zakodowanego treści oraz limit 8 MiB dla zdekodowanego pliku; zwykłe żądania API zachowują limit 16 KiB. Konwersja przebiega w wątku roboczym, przechowuje przesyłane dane w pamięci i zwraca znormalizowane dane wejściowe do uwierzytelnionej przeglądarki. Logowanie za pomocą kodu QR posiada kandydata dla każdego obszaru roboczego, krótkotrwały identyfikator, zadanie oczekujące oraz możliwość jawnego anulowania. Tylko zaakceptowana autoryzacja staje się aktywnym klientem. Funkcja Telegram FloodWait zwraca wartość Retry-After; dane uwierzytelniające i surowe komunikaty o błędach RPC nie są ujawniane w błędach API. Eksporty dziennika przebiegają poza asynchroniczną pętlą zdarzeń i są serializowane dla każdego obszaru roboczego. Przesyłają one strumieniowo stabilną migawkę odczytu równolegle z ciągłym zapisem do dziennika WAL. Zadania pozyskiwania czatów mogą działać równolegle na oddzielnych kontach; każde konto pozostaje zarezerwowane do momentu zatrzymania zadania. Zadanie wstrzymane lub nieudane zachowuje swoje punkty kontrolne. Pomyślna weryfikacja archiwum pozwala na wyczyszczenie plików roboczych, pozostawiając plik ZIP, podpisany plan i status. Kolektory obszarów roboczych współdzielą pętlę procesów/zdarzeń.
Aktualne migawki historii i aktualizacje na żywo mogą się nakładać. Obie stanowią odrębne obserwacje, oznaczone źródłem; duplikaty nie są automatycznie zwijane. Nie stosuje się żadnych wnioskowań na podstawie brakujących identyfikatorów, sfabrykowanego usuniętego tekstu, wymuszonego wyliczania członków ani automatycznego dołączania do grup. Nie jest to wdrażane.
Aby zapoznać się z wyjaśnieniami przeznaczonymi dla operatorów, proszę zapoznać się z opisem działania procesu gromadzenia danych oraz formatami kont i sesji.
Konfiguracja sieciowa znajduje się w zaszyfrowanym sejfie. Zastosowanie trasy powoduje zamknięcie starych klientów i anulowanie niedokończonych procesów logowania; późniejsze połączenia korzystają z tej trasy bez bezpośredniego rozwiązania awaryjnego. Nowa instalacja z kluczem zewnętrznym generuje klucz Fernet dla każdego obszaru roboczego za pomocą algorytmu HKDF-SHA256 na podstawie pliku klucza głównego oraz zapisanej losowej wartości solującej. Zapewnia to ochronę kluczy w oddzielnym miejscu od katalogu danych, a nie w postaci zwykłego tekstu w dzienniku lub treściach multimedialnych.
Lokalny wpis demonstracyjny wykorzystuje oddzielnie wygenerowaną zdolność procesową, nigdy skonfigurowany token panelu. Wydanie i akceptacja wymagają wyraźnego trybu demonstracyjnego, syntetycznego katalogu głównego bez dodatkowych obszarów roboczych ani autoryzowanej sesji, pętli zwrotnej peer/Host, braku nagłówków przekierowujących przez serwer proxy oraz braku żądań przeglądarki międzydomenowych. Aktywne interfejsy API zachowują uwierzytelnianie typu „bearer” i odrzucają zmiany w gromadzeniu danych w trybie demonstracyjnym.