TgWitness / Dokumentacja

Co zostało przetestowane →

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.

127.0.0.1domyślny adres panelu
256-bitowylosowy token panelu
0Sieci CDN, narzędzia analityczne lub czcionki zdalne
Ed25519podpis na każdym wpisie

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.

06 / CO WYCHODZI Z URZĄDZENIAInstalacja
PAN/PANI KOMPUTER LUB SERWER
Panel127.0.0.1:8787 · token bearer
KolektorJeden klient Telegramu na obszar roboczy
KATALOG DANYCH
RejestrSQLite · łańcuchowanie skrótów · podpisane
Pliki multimedialnepliki nazwane na podstawie skrótu SHA-256
VaultFernet · sesja, para API, klucz podpisujący, serwer proxy
  • 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.

Opcjonalne lokalizacje docelowe konfiguruje się dla poszczególnych obszarów roboczych.

Co kryje się za każdą tajemnicą

TajneGdzie jest przechowywanyJakie możliwości to stwarzaW przypadku wycieku
Token panelupanel-token.txt w katalogu danych; przeglądarka trzyma go dla kartyWszystko we wszystkich przestrzeniachZatrzymaj TgWitness, usuń panel-token.txt, uruchom ponownie — dostaniesz nowy
Sesja w TelegramieVault, zaszyfrowany (credentials.enc)Samo konto w serwisie TelegramZakończ sesję w aplikacji Telegram, wybierając opcję Ustawienia → Urządzenia
Klucz podpisującyVault, zaszyfrowany (signing.enc)Podpisywanie wpisów Twoim odciskiemPunkty kontrolne przechowywane gdzie indziej, świadek i znaczniki czasu nadal pokazują, co istniało wcześniej
Klucz do skarbcavault.key obok danych albo zewnętrzny klucz głównySejfZałóż, że sesja i klucz podpisu też wyciekły
Token WitnessNa serwerze WitnessTylko odczyt: punkty kontrolne i stanUsuń go na stronie świadka i utwórz nowy
Klucz treści poza witrynąVault; wystarczy pobrać go raz, aby móc odzyskać daneKopię 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

  1. Używaj osobnego konta Telegram, nigdy głównego.
  2. Trzymaj panel na 127.0.0.1. Zdalnie tylko przez HTTPS (dołączony Caddy) albo tunel SSH.
  3. Zaszyfruj dysk z katalogiem danych.
  4. Ogranicz katalog danych do konta usługi (0700 w Unix, uprawnienia folderu w Windows).
  5. Trzymaj klucz sejfu osobno na serwerach: ustaw TGWITNESS_VAULT_KEY_FILE przed pierwszym uruchomieniem.
  6. Zapisuj odcisk i punkty kontrolne w innym systemie, uruchom świadka na innym hoście.
  7. 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.
  8. Proszę nie rejestrować nagłówków Authorization ani 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.