Dokumentacja / 14
Telegram · Dbaj o bezpieczeństwo
Co opuszcza Twoją maszynę, co otwiera każdy sekret i co chronią zabezpieczenia, a co zostaje po Twojej stronie.
Miejsce, w którym wszystko się znajduje
Kolektor, panel i wszystkie wpisy zostają na Twojej maszynie. Domyślnie łączy się tylko z Telegramem, wszystko inne to osobny przełącznik.
- TelegramZawsze · zgodnie z Państwa wytycznymi
Połączenie konta z protokołem MTProto: bezpośrednie, SOCKS5, HTTP lub MTProxy. Tryb ukrywania adresu IP oczekuje na działający serwer proxy. Przełączenie na połączenie bezpośrednie wymaga trybu, który wyraźnie na to zezwala.
- Tekst poza witrynąOpcjonalne · domyślnie wyłączone
Dziennik, pliki i punkty kontrolne są szyfrowane algorytmem AES-GCM przed przesłaniem do magazynu danych zgodnego ze standardem S3. Klucz pozostaje w Państwa posiadaniu; załączniki są nazywane na podstawie haszów opartych na kluczu, a nie na podstawie hasha ich zawartości.
- PowiadomieniaOpcjonalne · domyślnie wyłączone
Wykaz problemów i liczba zmian wraz z tytułami czatów. Fragmenty wiadomości są wysyłane wyłącznie po włączeniu tej funkcji.
- Autorytet w zakresie znaczników czasuOpcjonalne · domyślnie wyłączone
Wyłącznie skrót SHA-256 podpisanego punktu kontrolnego oraz losowy nonce. Brak wiadomości, brak nazw użytkowników czatu.
- ŚwiadekOpcjonalne · domyślnie wyłączone
Narzędzie pobiera podpisane punkty kontrolne i liczniki przechwyceń za pomocą tokenu tylko do odczytu. Nie ma możliwości odczytu treści rozmów ani zmiany ustawień.
Ustawienie domyślne: z tego urządzenia wychodzi wyłącznie połączenie z serwisem Telegram.
Co kryje się za każdą tajemnicą
| Tajne | Gdzie jest przechowywany | Jakie możliwości to stwarza | W przypadku wycieku |
|---|---|---|---|
| Token panelu | panel-token.txt w katalogu danych; przeglądarka trzyma go dla karty | Wszystko we wszystkich przestrzeniach | Zatrzymaj TgWitness, usuń panel-token.txt, uruchom ponownie — dostaniesz nowy |
| Sesja w Telegramie | Vault, zaszyfrowany (credentials.enc) | Samo konto w serwisie Telegram | Zakończ sesję w aplikacji Telegram, wybierając opcję Ustawienia → Urządzenia |
| Klucz podpisujący | Vault, zaszyfrowany (signing.enc) | Podpisywanie wpisów Twoim odciskiem | Punkty kontrolne przechowywane gdzie indziej, świadek i znaczniki czasu nadal pokazują, co istniało wcześniej |
| Klucz do skarbca | vault.key obok danych albo zewnętrzny klucz główny | Sejf | Załóż, że sesja i klucz podpisu też wyciekły |
| Token Witness | Na serwerze Witness | Tylko odczyt: punkty kontrolne i stan | Usuń go na stronie świadka i utwórz nowy |
| Klucz treści poza witryną | Vault; wystarczy pobrać go raz, aby móc odzyskać dane | Kopię zewnętrzną | Kto ma też bucket, może ją odszyfrować — traktuj kopię jako ujawnioną |
Zakres ochrony
– omówiono
- Zmieniony, usunięty lub przestawiony wpis: pęka łańcuch skrótów albo podpis.
- Dziennik przycięty lub odbudowany po tym, jak zapisałeś punkt kontrolny gdzie indziej: punkt przestaje się zgadzać.
- Zgadywanie tokenu: 256 losowych bitów, porównanie w stałym czasie; 15 błędów na minutę i adres zostaje zablokowany.
- Wroga treść czatów: tekst zostaje tekstem, nigdy HTML; załączniki pobierają się jako pliki; panel nie ładuje niczego z innych stron.
- Skradziony katalog danych przy zewnętrznym kluczu sejfu: sesje i klucze pozostają zaszyfrowane.
Pozostawiamy to Państwu
- Główny token może wszystko. Innym dawaj ograniczony dostęp, a główny trzymaj dla siebie.
- Odcisk i punkty kontrolne trzymaj gdzie indziej.
- Szyfruj dysk i ogranicz uprawnienia.
- Zwykły HTTP poza localhost ujawnia token. Używaj HTTPS albo tunelu SSH.
- Sprawdzaj pokrycie pod kątem luk i testuj dostarczanie na własnych kontach i źródłach.
Udostępnij dostęp do sprawy z uprawnieniami, terminem ważności i limitem sesji.
Zabezpieczenie instalacji
- Używaj osobnego konta Telegram, nigdy głównego.
- Trzymaj panel na 127.0.0.1. Zdalnie tylko przez HTTPS (dołączony Caddy) albo tunel SSH.
- Zaszyfruj dysk z katalogiem danych.
- Ogranicz katalog danych do konta usługi (0700 w Unix, uprawnienia folderu w Windows).
- Trzymaj klucz sejfu osobno na serwerach: ustaw
TGWITNESS_VAULT_KEY_FILEprzed pierwszym uruchomieniem. - Zapisuj odcisk i punkty kontrolne w innym systemie, uruchom świadka na innym hoście.
- Nigdy nie należy przesyłać kluczy typu „
data/”, kluczy sesji, kluczy typu „panel-token.txt” ani kluczy do skarbca na GitHub ani w czacie. - Proszę nie rejestrować nagłówków
Authorizationani treści żądań na serwerze proxy odwrotnym.
Czy mogę zmienić token panelu bez utraty danych?
Tak, on tylko otwiera panel. Zatrzymaj TgWitness, usuń panel-token.txt, uruchom ponownie. Dziennik, sesje i klucze zostają. Jeśli ustawiono TGWITNESS_TOKEN, ta wartość ma pierwszeństwo przed plikiem.
Zgłoś lukę w zabezpieczeniach
Security → Report a vulnerability na GitHubie. Wersja, skutki i minimalny przykład na fikcyjnych danych. Nigdy nie wysyłaj danych logowania, folderów kont ani prawdziwych dowodów. Jeśli prywatne zgłoszenia są wyłączone, otwórz issue z prośbą o prywatny kanał, bez szczegółów exploita.