Odniesienie / Bezpieczeństwo i projekt
Telegram · Bezpieczeństwo i przetwarzanie danych
Model zagrożeń, model dostępu, dane poufne w stanie spoczynku, narażenie sieciowe, import sesji oraz sposób zgłaszania luk w zabezpieczeniach.
TgWitness / Dokumentacja · Wdrażanie i przywracanie
Ta strona opisuje dostęp, przechowywanie i ochronę sieci w lokalnym lub serwerowym obszarze roboczym. W przypadku gromadzenia danych na serwerze GitHub Runner lub w poufnej maszynie wirtualnej Intel TDX należy zapoznać się z trybami weryfikacji, które dodają kontrole środowiska gromadzenia danych. Połączenia kont, powiadomienia, sygnatury czasowe, kopie poza lokalizacją oraz świadkowie mają własne ustawienia routingu.
| Obszar | W skrócie |
|---|---|
| Dostęp | Klucz administratora oraz dostęp o ograniczonym zakresie do kont i czatów, siedem uprawnień oraz sesje z możliwością cofnięcia; domyślnie localhost |
| Sekrety w stanie spoczynku | Sesja, para API, klucz podpisujący oraz ustawienia serwera proxy są szyfrowane za pomocą algorytmu Fernet |
| Wiadomości i pliki multimedialne | Pliki w obszarze roboczym, chronione przez szyfrowanie dysku lub woluminu oraz uprawnienia do plików na hoście |
| Rzetelność | Łańcuch skrótów SHA-256 oraz podpis Ed25519 na każdym wpisie |
| Czas zewnętrzny | Potwierdzenia zgodne z RFC 3161 i OpenTimestamps, wpisy świadków opatrzone datą przez Telegram oraz poświadczenia GitHub; zachowane punkty kontrolne, zapisy świadków i pomiary Intel TDX stanowią dowody potwierdzające. Weryfikator zgłasza, które warunki dowodowe są spełnione. |
W sprawie zgłoszeń luk w zabezpieczeniach prosimy zapoznać się z polityką bezpieczeństwa.
Na tej stronie
Model dostępu#
Token panelu głównego zapewnia pełną kontrolę. Inne osoby mogą otrzymać dostęp o ograniczonym zakresie: wybrane obszary robocze i czaty, uprawnienia, termin ważności, ograniczenia adresów IP, limity logowań oraz sesje z możliwością cofnięcia. Dostęp ograniczony do czatu nie pozwala na wykonywanie operacji w całym obszarze roboczym, nawet jeśli odpowiednie uprawnienie jest zaznaczone. Każdy obszar roboczy posiada własny dziennik, skarbnicę i klucz podpisujący w ramach jednego procesu; rozdzielenie użytkowników na hoście wynika z kont systemu operacyjnego.
Panel domyślnie nasłuchuje na localhost. Logowanie w przeglądarce powoduje wymianę tokena dostępu na poświadczenie sesji; przeglądarka wysyła je jako token typu „bearer”. Jest ono przechowywane w pamięci sessionStorage, a nie w pliku cookie uwierzytelniającym. Zablokowanie lub wylogowanie powoduje wyczyszczenie sesji przeglądarki. Zamknięcie przeglądarki lub zakończenie sesji nie zatrzymuje gromadzenia danych.
Wydane tokeny i poświadczenia sesji są przechowywane w postaci skrótów w zaszyfrowanym skarbcu. Unieważnienie powoduje zakończenie powiązanych sesji; zmiany uprawnień mają wpływ na kolejne żądania. Pobranych plików nie można odzyskać. Administrator może również ograniczyć własne sesje przeglądarki, jednak skrypty wykorzystujące bezpośrednio token panelu głównego zachowują pełny dostęp i omijają te ograniczenia sesji przeglądarki.
Niepowodzenia uwierzytelniania podlegają ograniczeniom częstotliwości na podstawie adresu klienta. Ograniczenia adresów IP opierają się na adresie widocznym dla aplikacji; przed wykorzystaniem tej funkcji należy sprawdzić działanie serwera proxy odwrotnego. Dane uwierzytelniające Witness pozostają oddzielnymi danymi uwierzytelniającymi typu „read-only” służącymi do sprawdzania stanu i punktów kontrolnych.
Dostęp do wersji demonstracyjnej#
/api/demo-access to celowo nieautoryzowany bootstrap dla wyraźnie
uruchomionego, izolowanego, syntetycznego środowiska demonstracyjnego. Generuje on oddzielną uprawnienie na czas trwania procesu,
nigdy nie udostępnia prawdziwego tokenu panelu ani nie zastępuje tokenu TGWITNESS_TOKEN. Wydanie i wykorzystanie wymagają
połączenia typu loopback oraz hosta, bez przekazywanych nagłówków i bez żądań międzydomenowych. Dodatkowe
obszary robocze lub autoryzowana sesja uniemożliwiają tę ścieżkę. Aktywne obszary robocze nigdy nie wydają
tego uprawnienia. Wersja demonstracyjna nie może łączyć kont ani zmieniać ustawień gromadzenia danych.
Zawartość paneli i eksporty#
Panel nie wykorzystuje żadnych zewnętrznych czcionek, narzędzi analitycznych, zasobów CDN ani osadzonych mediów zdalnych. Tekst pochodzący z Telegrama jest wstawiany jako zwykły tekst, a nie kod HTML. Pobrane załączniki są udostępniane jako załączniki binarne. Eksporty w formacie JSONL zachowują oryginalne ciągi znaków; kod HTML je zamienia; komórki plików CSV, które mogłyby stać się formułami, są poprzedzone apostrofem.
Eksportowane dane nie zawierają kluczy uwierzytelniających ani podpisujących, ale celowo zawierają zebrane metadane źródłowe, identyfikatory oraz ewentualnie treści osobiste lub wrażliwe. W surowych metadanych źródłowych mogą występować skróty dostępu do serwisu Telegram oraz odniesienia do plików.
Sekrety w stanie spoczynku#
Dane uwierzytelniające API Telegrama, sesja oraz klucz podpisujący są szyfrowane za pomocą algorytmu Fernet. W przypadku lokalnych wiadomości i multimediów szyfrowanie zapewnia dysk lub wolumin hosta; w obszarze roboczym przechowywane są zwykłe pliki. Eksporty mogą wykorzystywać pliki ZIP z szyfrowaniem AES-256 chronione hasłem, a kopie poza lokalizacją korzystają z szyfrowania AES-256-GCM.
Domyślnym miejscem przechowywania klucza do skarbca jest katalog danych chronionych. Aby przechowywać go oddzielnie, należy użyć zewnętrznego pliku klucza głównego przedstawionego poniżej. W systemie Unix nowe pliki kluczy prywatnych mają tryb dostępu 0600, a nowe katalogi danych – 0700; w systemie Windows należy ustawić listę kontroli dostępu (ACL) katalogu dla konta usługowego oraz uprawnionych administratorów. Istniejące uprawnienia do katalogów pozostają zachowane.
Zewnętrzny klucz główny#
W przypadku nowego katalogu danych zmienna TGWITNESS_VAULT_KEY_FILE może dostarczyć zewnętrzny losowy klucz główny. Algorytm HKDF-SHA256 oraz oddzielna losowa wartość solą generują inny klucz Fernet dla każdego obszaru roboczego. Plik vault.external.json musi zostać zachowany na potrzeby odzyskiwania danych. Brakujące lub nieprawidłowe klucze główne powodują niepowodzenie operacji. Istniejące lokalne skarbce nie są migrowane w trybie cichym. Panel wyświetla wybrany tryb przechowywania kluczy. Szyfrowanie dysku chroni lokalne pliki wiadomości i multimediów w obu trybach; szczegóły konfiguracji znajdują się w sekcjach „ połączenie” i „ ochrona danych”.
Serwery proxy i trasy sieciowe#
Konfiguracja serwera proxy jest szyfrowana w skarbcu. Hasła i klucze MTProxy nie są zwracane przez API ani zapisywane w rejestrach dowodowych. Każdy obszar roboczy wybiera własną trasę Telegramu oraz tryb IP.
Opcja „Ukryj adres” blokuje bezpośrednie połączenie awaryjne z Telegramem i wymaga korzystania z serwera proxy dla zewnętrznych żądań HTTP. Wyraźnie wybrany tryb awaryjny zezwala na bezpośredni dostęp do Telegrama po upływie określonego opóźnienia; tryb tunelu/VPN zezwala na bezpośrednie połączenia. Wybranie trybu tunelu nie powoduje instalacji ani weryfikacji VPN. Ustawienia te nie kontrolują całego ruchu sieciowego na komputerze, przeglądarek, menedżerów pakietów ani lokalnego rozpoznawania nazw DNS przez serwer proxy.
MTProxy obsługuje wyłącznie ruch z aplikacji Telegram. Żądania zewnętrzne mogą korzystać z oddzielnego proxy SOCKS5/HTTP, trasy SOCKS5/HTTP obszaru roboczego lub dozwolonej trasy bezpośredniej; można je również wyłączyć. Niezależny moduł „witness” posiada własne ustawienia transportowe. Zwykłe uwierzytelnianie SOCKS5/HTTP CONNECT nie jest szyfrowane przez same protokoły proxy. Fałszywe klucze tajne TLS MTProxy nadal nie są obsługiwane.
Logowanie i import sesji#
Przekonwertowane pliki .tgwitness-session zawierają sekret autoryzacyjny w postaci zwykłego tekstu do momentu załadowania i zapisania w skarbcu. Interfejs CLI działający w trybie offline akceptuje zweryfikowane schematy Telethon. Import z panelu obsługuje dodatkowo formaty Pyrogram SQLite, nowoczesny plik ZIP TData dla pojedynczego konta oraz udokumentowane dane wejściowe w formacie JSON. Funkcja ta jest uwierzytelniana, ograniczona do czterech plików / 8 MiB, a przesyłane dane są przetwarzane w pamięci bez rozpakowywania archiwum ani zapisywania oryginalnych plików. Znormalizowane dane uwierzytelniające są zwracane wyłącznie do wysyłającej żądanie, uwierzytelnionej przeglądarki; są one zapisywane w zaszyfrowanym sejfie po pomyślnym uwierzytelnieniu w Telegramie. Należy chronić pliki oryginalne i przekonwertowane oraz unikać sytuacji, w której równoczesne klienty klonują dane uwierzytelniające.
Przetwarzanie danych TData weryfikuje sumy kontrolne kontenerów, lokalne skróty deszyfrujące oraz długości struktur. Podane lokalne hasło do wersji Desktop jest używane tymczasowo i nie jest przechowywane. Ograniczony parser obsługuje formaty Desktop, które weryfikuje, a odrzuca pozostałe. Obrazy QR są generowane lokalnie, zawierają krótkotrwałe tokeny logowania do Telegrama i nigdy nie są wysyłane do zewnętrznej usługi renderującej. Zablokowanie, zmiana obszaru roboczego, nowe logowanie oraz zmiany trasy anulują oczekujące próby skanowania QR. Odświeżenie lub zamknięcie karty może spowodować, że próba pozostanie w toku do momentu wygaśnięcia. Pomyślne zalogowanie za pomocą kodu QR nadal wymusza powiązanie konta. Zwykłe treści API pozostają ograniczone do 16 KiB; uwierzytelniona trasa importu akceptuje do 12 MiB zakodowanego JSON, osobno egzekwując mniejszy limit dla zdekodowanego pliku.
Kody logowania oraz hasła do dwuetapowej weryfikacji w Telegramie nie są przechowywane. Stan numeru telefonu/skrótu kodu jest przechowywany w pamięci podczas autoryzacji. Sesje w Telegramie zapewniają dostęp do konta; nigdy nie należy przesyłać katalogu danych, sesji, tokenu, klucza do skarbca ani prywatnego klucza podpisującego na GitHub.
Dzienniki i transport#
Domyślna odpowiedź walidacyjna API została zastąpiona, aby nie powtarzała wartości poświadczeń. Rejestrowanie dostępu do aplikacji jest wyłączone. Nie należy konfigurować proxy odwrotnego w celu rejestrowania nagłówków autoryzacji ani treści żądań. Panel nasłuchuje na localhost; dostęp zdalny odbywa się poprzez dostarczony tunel SSH, Cloudflare Tunnel lub Caddy HTTPS, więc tokeny i klucze logowania są przesyłane w ramach protokołów SSH lub TLS.
Integralność i czas zewnętrzny#
W ramach weryfikacji sprawdzane są podpisy rekordów, łańcuch skrótów, załączniki oraz manifest eksportu
pod kątem zgodności z kluczem kolektora. Prawidłowy podpis świadczy o tym, że bajty nie uległy zmianie od momentu
ich podpisania. Każdy obszar roboczy tworzy swój klucz podpisujący przy pierwszym uruchomieniu i wyświetla swój
odcisk palca w panelu oraz w każdym eksporcie. Operator przekazuje odcisk palca
odbiorcy za pośrednictwem oddzielnego kanału, a --fingerprint przypisuje klucz.
Zmieniony, wstawiony lub usunięty rekord powoduje przerwanie łańcucha skrótu lub podpisu, a
weryfikator zgłasza to zdarzenie. Zewnętrzne znaczniki czasu oraz świadek dodatkowo zabezpieczają dziennik poza
obszarem roboczym. Wyzwalacze SQLite w tabeli dziennika jedynie zapobiegają przypadkowemu
nadpisaniu lub usunięciu rekordu przez aplikację. TGWITNESS_VAULT_KEY_FILE zapewnia, że klucz
skarbca nie znajduje się w kopii katalogu danych.
Potwierdzenia zgodne z RFC 3161 i OpenTimestamps oraz wpisy świadków, których daty weryfikator odczytuje z serwisu Telegram, wiążą prefiks dziennika, którego dotyczą, z czasem ustalonym przez stronę trzecią. Runda drand zapisana w dzienniku wskazuje, że rekordy znajdujące się po niej zostały utworzone nie wcześniej niż w momencie opublikowania tej rundy. Zweryfikowane poświadczenie GitHub zawiera również zweryfikowany czas swojego podpisu, co wiąże całe archiwum z czasem zewnętrznym. Punkt kontrolny jest podpisany kluczem kolektora i wiąże zapisy do niego włącznie od momentu, w którym odbiorca go uzyskał, za pośrednictwem innego kanału. Świadectwo pokazuje, że drugi klucz zachował początek dziennika; zapis kontroli klucza powiernika wskazuje, kto jest w posiadaniu tego klucza. Oba stanowią weryfikacje uzupełniające; minimum to czas określony przez stronę trzecią. Rejestracja w GitHub Actions lub wdrożenie Intel TDX dodaje pochodzenie przepływu pracy lub pomiary sprzętowe środowiska gromadzenia danych.
Każda odpowiedź weryfikacyjna zawiera listę warunków dowodowych wraz ze sposobem ich sprawdzenia, pogrupowanych według ich roli w minimalnym zestawie:
| Rola | Warunek |
|---|---|
| Wymagane | Integralność; klucz podpisujący przypisany za pomocą --fingerprint; czas zewnętrzny obejmujący ostatni zapis (potwierdzenie RFC 3161 sprawdzone za pomocą --tsa-ca, potwierdzenie OpenTimestamps potwierdzone za pomocą --check-bitcoin, wpis świadka odczytany z t.me za pomocą --channel, pieczęć Bitcoin świadka lub sprawdzone poświadczenie GitHub) |
| Funkcje dodatkowe, niebędące częścią minimalnego zestawu | Świadek z własnym kluczem; zachowany punkt kontrolny; poświadczony przebieg zbierania danych |
Ten minimum wymagane do uznania za dowód czy wszystkie trzy wymagane warunki dotyczą ostatniego wyeksportowanego
rekordu; zweryfikowany i poświadczony przebieg zbioru dodaje attested profil.
W ostatnim wierszu podano wynik, a w odpowiedzi wymieniono opcje, które spełniałyby
brakujące warunki. Bez --fingerprint ostatnia linijka zaczyna się od
EVIDENCE: minimum not met · missing: confirmed signer key.
Gdy zweryfikowane znaczniki czasu obejmują jedynie wcześniejsze rekordy, w odpowiedzi podaje się rekord, do
którego obowiązuje wartość minimalna. --require evidence lub --require attested program kończy działanie z kodem 2, gdy
profil nie został osiągnięty dla całego eksportu, a żądana w wierszu poleceń
kontrola, której nie można wykonać, jest zgłaszana jako niewykonana z tym samym kodem. Każdy raport
zawiera te same warunki wraz z ich stanem w danej kopii oraz poleceniem, które je
sprawdza. Poziomy pewności oraz --strict pozostają dostępne; te
format dowodów przedstawia listę kontroli dla każdego trybu pobierania.
Jeśli podejrzewają Państwo wystąpienie problemu#
Zachowaj oryginalny katalog danych i użyj oddzielnej kopii do analizy. Zgłoś wersję, w której wystąpił błąd, operację oraz kroki pozwalające na odtworzenie błędu za pośrednictwem polityki bezpieczeństwa, zachowując poufność danych konta i danych uwierzytelniających.