Dokumentacja / 02
Telegram · Przechwytywanie za pomocą GitHub Actions
Wybierz Takeout, eksport przez zwykłe API lub dziennik czatu na tymczasowym runnerze GitHub.
Pełne odniesienie
TgWitness / Dokumentacja · Niezależne przechwytywanie
Podgląd dostępny z poziomu strony main. Rozgałęzienie uruchamia przypięty, wielokrotnego użytku przepływ pracy z
phishdestroy/TgWitness. Przepływ pracy eksportuje konto, wybrane czaty lub
dziennik zdarzeń jednego czatu przy użyciu nowo utworzonej sesji Telegramu, poświadcza dowód
w postaci pliku ZIP lub manifestu wieloczęściowego oraz przesyła wyłącznie
przekazane dane zaszyfrowane przez odbiorcę. Standardowy panel administracyjny nie jest udostępniany.
Wybierz client=official_web uruchomienie świadka oficjalnego klienta z zabezpieczonymi elementami sterującymi i wideo w Telegram Web. Wymaga to posiadania własnego serwera proxy upstream i obserwuje jeden wyrenderowany czat. Domyślnie client=api zachowuje tryby eksportu pełnego konta opisane poniżej.
Weryfikator porównuje archiwum z jego poświadczeniem na GitHubie, zatwierdzonym przepływem pracy i commitami kolektora, a także z podpisanymi skrótami dziennika i załączników. W procesie gromadzenia danych wykorzystywany jest przypięty kod źródłowy oraz nowa przestrzeń dyskowa. Recenzent może sprawdzić ten kod i zweryfikować dostarczone archiwum w odniesieniu do zarejestrowanego przebiegu procesu.
Na tej stronie
- Przebieg działania użytkownika
- Czas przeznaczony na sesję
- Wybierz ten tryb lub stały obszar roboczy
- Co jest sprawą publiczną, a co musi pozostać prywatne
- Rozwiązywanie problemów
- Lokalne odszyfrowywanie i weryfikacja
- W jaki sposób widelec pozostaje poza procesem przechwytywania
- Przekazanie kryptograficzne
- Zakres i walidacja
- Sekwencja wydawania aktualizacji przez opiekuna projektu
Schemat działania użytkownika#
Asystent wyjaśnia pięć etapów i umożliwia wypróbowanie podstawiania komunikatów lub kolektorów na przykładowych danych. Opcja Rozpocznij przechwytywanie otwiera kreatora.
- Choose GitHub Actions capture (preview) on the project homepage, the
workspace login screen, or Exports → Open capture helper. You can also
open the official helper
or
tgwitness/static/capture.htmlfrom a trusted checkout in a modern browser. The helper makes no network requests for key or file processing. The helper supports the site's interface languages; the temporary collection panel supports English and Russian and opens in the browser's language when it is one of them. - Wygeneruj klucz i zapisz plik sealed-key.json. Jest to jedyny prywatny klucz deszyfrujący. Skopiuj oddzielną wartość klucza publicznego odbiorcy. Utrata klucza prywatnego powoduje utratę dostępu zarówno do połączenia, jak i do archiwum. Potwierdź, że plik został zapisany, aby przejść do następnego kroku. Jeśli masz już plik dostawy, załaduj zapisany klucz i wybierz opcję Mam już archiwum.
- Utwórz fork projektu TgWitness, włącz funkcję „Actions” w tym forku i uruchom narzędzie Sealed chat capture. Wklej adres odbiorcy publicznego i wybierz 30, 60 lub 120 minut. Nigdy nie umieszczaj numeru telefonu, kodu logowania, hasła do Telegrama, klucza prywatnego ani sesji w danych wejściowych przepływu pracy, commitach, zgłoszeniach ani logach.
- Podczas działania aplikacji pobierz plik sealed-connection z sekcji „Artifacts” i rozpakuj go.
Załaduj
connection.tgwsealedw narzędziu pomocniczym, używając zapisanego klucza prywatnego. Powstały link zawiera losowy sekret dostępu w fragmencie adresu URL. Nie udostępniaj tego linku nikomu. Panel usuwa ten fragment i przechowuje sekret w pamięci sesji tej karty; nie jest on zapisywany w logach dostępu HTTP. - Otwórz link połączenia. Zaloguj się za pomocą kodu QR lub numeru telefonu i
kodu logowania. Wprowadź hasło do weryfikacji dwuetapowej, jeśli Telegram o to poprosi. Domyślnie
używana jest wbudowana pula poświadczeń API, tak samo jak w zwykłym obszarze roboczym. Możesz
rozwinąć opcjonalną sekcję niestandardowych poświadczeń i wprowadzić zarówno
api_id, jak iapi_hashz my.telegram.org/apps. Pozostaw oba pola puste, aby skorzystać z wbudowanej puli; niekompletna lub nieprawidłowo sformułowana para zostanie odrzucona. Importowanie sesji nie jest dozwolone. Wybierz tryb eksportu i zakres. Link połączeniowy zawiera sekret dostępu: zachowaj go w tajemnicy. - Wybierz opcję Telegram Takeout, Regular Telegram API lub Dziennik zdarzeń czatu. Aby wyeksportować dane z konta, wybierz wszystkie dostępne czaty lub załaduj i wybierz jeden lub więcej czatów, a następnie ustaw daty, typy czatów, kategorie kont i reguły dotyczące załączników. Sprawdź ustawienia i rozmiar, opcjonalnie zapisz ustawienia w formacie JSON dla niezależnego recenzenta, a następnie naciśnij Rozpocznij przechwytywanie. Ustawienia są niezmienne po rozpoczęciu. Wznowienie działa tylko wtedy, gdy ten proces nadal istnieje; przedwczesne zakończenie zachowuje zebrane dane i rejestruje luki. Upływ terminu po rozpoczęciu powoduje utworzenie wyraźnie częściowego archiwum; upływ terminu przed rozpoczęciem lub anulowanie nie powoduje utworzenia archiwum.
- Poczekaj na plik z wynikami w formacie SEALED, pobierz go i rozpakuj, a następnie odszyfruj
delivery.tgwsealedw programie pomocniczym. Otrzymasz plikdelivery.zip, zawierającyevidence.zip,attestation.jsonloraz instrukcje. Odszyfrowywanie w przeglądarce jest ograniczone do 256 MiB; w przypadku większych pakietów należy skorzystać z poniższego polecenia lokalnego do przesyłania strumieniowego. Duże wyniki zawierają równieżdelivery-NNNNNN.tgwsealedczęści; plik głównydelivery.tgwsealedzawiera wówczasevidence.parts.jsonoraz poświadczenie. Pobierz wszystkie części i złóż je lokalnie zgodnie z poniższym opisem. - Zakończ sesję tymczasową w ustawieniach Telegrama → Urządzenia, jeśli cofnięcie uprawnień nie zostało potwierdzone lub proces uruchamiający został zakończony. W przypadku normalnego zakończenia sesji wymagane jest wylogowanie, a proces rejestruje, czy cofnięcie uprawnień zostało potwierdzone.
Repozytorium musi zawierać opublikowane, przypięte zmiany źródłowe oraz zmiany dotyczące przepływu pracy wielokrotnego użytku. Sama lokalna gałąź nie może być wywołana przez inne repozytorium GitHub.
Przewidywany czas trwania sesji#
Przed rozpoczęciem pobierania funkcja Oblicz szacunkowy czas i rozmiar szacuje rozmiar wybranej historii i plików na podstawie liczby wiadomości oraz ograniczonej próbki. Wyświetlane informacje obejmują czas już poświęcony na logowanie, szacowany czas pobierania oraz rezerwę na pakowanie. W przypadku plików wstępne oszacowanie opiera się na szybkości 1 MiB/s i dwukrotnym marginesie czasowym; w miarę postępu operacji założenie to zostaje zastąpione zmierzoną szybkością. Jeśli szacowany czas przekracza pozostały czas, należy wybrać opcję Tylko wiadomości lub wybrać mniejszą liczbę czatów.
Zgłoszony przez Telegram czas oczekiwania na pobranie danych jest uwzględniany w budżecie. Moduł zbierający wstrzymuje gromadzenie danych, gdy pozostały czas jest potrzebny na pakowanie, zachowuje zebrane dane i oznacza wynik jako częściowy. W związku z tym sesja trwająca 120 minut wykorzystuje pozostały czas okna zbierania, zamiast czekać na upływ terminu przed przygotowaniem archiwum. Na ekranie wyświetlane są elementy wybrane, których pełnego rozmiaru nie udało się pobrać.
Wybierz ten tryb lub stały obszar roboczy#
| Tryb rejestracji | Konfigurowalny zakres | Różnica |
|---|---|---|
| Telegram Takeout – domyślna opcja | Wszystkie dostępne czaty w chmurze lub wybrane czaty, daty, kategorie kont, zasady dotyczące multimediów oraz widoki JSON/HTML | Korzysta z oficjalnego mechanizmu eksportu serwisu Telegram; może być wymagana zgoda lub konieczne może być oczekiwanie. Aplikacja Takeout może wyliczyć pozostałe kanały/grupy, o ile serwis Telegram na to zezwala, oraz zażądać dodatkowych danych osobowych. |
| Standardowe API serwisu Telegram | Te same opcje zakresu konta i formatowania wyników, z zastrzeżeniem metod dostępnych za pośrednictwem standardowego interfejsu API | Nie inicjuje usługi Takeout; nie można wyliczyć lewych kanałów/supergrup ani pobrać danych osobowych dostępnych wyłącznie w Takeout. Kontakty obejmują użytkowników Telegrama, a nie całą zapisaną listę kontaktów telefonicznych. Nadal obowiązują ograniczenia szybkości. |
| Dziennik wydarzeń na czacie | Jeden wybrany czat, zasady dotyczące załączników oraz opcjonalne awatary | Rejestruje historię i zmiany zaobserwowane podczas tego przebiegu. Nie mają tu zastosowania kategorie kont, filtry dat ani widoki zgodne z wersją na komputery stacjonarne. |
Wszystkie trzy tryby charakteryzują się tym samym poświadczeniem GitHub oraz szyfrowanym przesyłaniem danych. Takeout wybiera metodę pozyskiwania danych i nigdy nie jest w sposób niezauważalny zastępowany przez zwykły dostęp do API. TgWitness generuje widoki JSON/HTML na podstawie przechwyconych rekordów i zachowuje wybraną metodę pozyskiwania danych w eksporcie. Zobacz oficjalne API Takeout.
Domyślnie wykorzystywane są funkcje Takeout, wszystkie dostępne rodzaje czatów – w tym zarchiwizowane – wszystkie daty, profil konta i kontakty, kompatybilne pliki JSON i HTML oraz pobrane pliki. Początkowy limit przestrzeni dyskowej wynosi 4 GiB, z widocznymi limitami plików dla poszczególnych typów; w przypadku większych plików lub wyczerpania limitu pobrań wykorzystywane są skróty serwerowe, o ile są dostępne. Należy zapoznać się z tymi limitami przed rozpoczęciem gromadzenia danych. Skróty nie pozwalają na odtworzenie pliku. Opcjonalne zdjęcia, relacje, metadane sesji oraz dodatkowe dane osobowe pozostają odrębnymi opcjami.
Pobieranie danych może wymagać zatwierdzenia w istniejącej sesji Telegramu. Telegram ustala czas opóźnienia; nowe logowanie ani nowy proces nie pozwalają go ominąć. Maksymalny czas trwania sesji wynosi 120 minut, łącznie z logowaniem i zatwierdzeniem, więc w przypadku dużego konta lub długiego czasu oczekiwania na zatwierdzenie proces może się nie zakończyć. Trwały eksport lokalny pozwala wznowić tę samą sesję, ale nie przejmuje poświadczenia z serwisu GitHub.
Zatwierdź i sprawdź ustawienia#
Po Sprawdź ustawienia i rozmiar, użyj Zapisz ustawienia do weryfikacji. Zgadzam się
wynikowe sealed-export-settings.json z recenzentem przed pobraniem danych.
Wprowadzenie zmian powoduje unieważnienie zapisanej oceny. Osoba pobierająca dane podpisuje obowiązujące
ustawienia oraz ich skrót SHA-256, a potwierdzenia eksportu konta wiążą te same opcje.
Weryfikator zgłasza rzeczywisty tryb, wybór i kompletność danych oraz odrzuca
rozbieżności między dziennikiem a zagnieżdżonym eksportem konta.
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete
--expected-selection odrzuca inne ustawienia transportu, zakresu czatu, filtru lub
zasad dotyczących załączników. --require-complete akceptuje wyłącznie eksporty kont i dzienniki
czatów oznaczone jako kompletne. Bez tych flag weryfikacja nadal sprawdza pochodzenie i
integralność, jednocześnie zgłaszając zarejestrowane ustawienia i braki. Należy uzgodnić oczekiwany
wybór przed uruchomieniem i przechowywać go oddzielnie od archiwum. Zakres i interwały pozyskiwania określają materiał zebrany podczas
uruchomienia; podczas porównywania poprzednich wersji należy korzystać z zachowanych wcześniejszych obserwacji.
| Wymagania | Tryb |
|---|---|
| Wyeksportuj dostępne dane konta lub wybrane rozmowy w ramach sesji o ograniczonym czasie trwania i udostępnij recenzentowi archiwum poświadczone przez niezależną jednostkę | Zrzut ekranu z GitHub Actions (wersja zapowiedziowa) |
| Śledź na bieżąco kilka czatów, zarządzaj kontami, przeszukuj i przeglądaj stale powiększające się archiwum | Środowisko pracy lokalne lub Docker |
Spowoduje to uruchomienie oddzielnego procesu przechwytywania z nowymi danymi logowania. Nie spowoduje to przesłania istniejącego dziennika lokalnego, wyeksportowania aktualnie otwartego obszaru roboczego ani ponownego wykorzystania sesji w Telegramie. Niedokończonego procesu przechwytywania w chmurze nie można wznowić po zamknięciu programu wykonującego; nowy przepływ pracy uruchamia nowy proces przechwytywania.
Opcja Eksportuj → Otwórz narzędzie do przechwytywania w obszarze roboczym otwiera pełny kreator w ramach panelu. Samodzielna strona korzysta z tego samego kreatora, elementów sterujących i motywów. W obu przypadkach klucze i proces odszyfrowywania odbywają się w przeglądarce. Uruchomienie przepływu pracy GitHub oraz tymczasowy panel Telegramu otwierają się w osobnych kartach; kreator poinformuje Cię, kiedy należy do niego powrócić. Zablokowanie obszaru roboczego powoduje wyczyszczenie klucza przechowywanego w pamięci kreatora. Zapisany plik z kluczem pozostaje na Twoim urządzeniu.
Co jest sprawą publiczną, a co musi pozostać prywatne#
Zbieranie danych odbywa się za pomocą standardowego modulu uruchamiającego hostowanego przez GitHub. GitHub, zatwierdzony moduł zbierający oraz zależności, strona pomocnicza, przeglądarka i tunel HTTPS stanowią zaufane elementy tej konfiguracji. Tymczasowy serwer przetwarza sesję Telegrama oraz wiadomości w postaci zwykłego tekstu; dostarczane artefakty są szyfrowane dla odbiorcy.
Rozgałęzienie powoduje skopiowanie kodu projektu do Twojego repozytorium. Nie powoduje to wyeksportowania Twojego
konta w Telegramie. Dane wejściowe dla odbiorcy w ramach przepływu pracy to publiczny klucz szyfrujący.
Zachowaj sealed-key.json, danych logowania do Telegrama, kodów logowania, haseł 2FA oraz
odszyfrowanego adresu URL połączenia z dala od commitów, danych wejściowych przepływu pracy i publicznych logów.
Ten proces publikuje zaszyfrowane artefakty połączeń i wyników przez jeden dzień. Pobierz oba pliki w odpowiednim czasie; obowiązują zasady dotyczące dostępności GitHub Actions, limitów konta oraz rozliczeń. Publiczny fork nie gwarantuje nieograniczonego bezpłatnego dostępu do zasobów obliczeniowych. W narzędziu pomocniczym nie wprowadza się żadnych danych dotyczących płatności ani tokena dostępu do serwisu GitHub.
Prywatny klucz deszyfrujący pozostaje w przeglądarce/pliku użytkownika. Dane sesji Telegramu oraz obserwacje w postaci zwykłego tekstu z konieczności znajdują się w tymczasowym magazynie danych. GitHub i tunel HTTPS pozostają zaufaną infrastrukturą. Poświadczenie może ujawniać sumę kontrolną archiwum oraz tożsamość procesu; zawartość archiwum nie jest umieszczana w poświadczeniu. Sygnatura czasowa poświadczenia nie jest sygnaturą czasową wiadomości.
Rozwiązywanie problemów#
| Objaw | Kolejny krok |
|---|---|
| Przycisk „Brak przepływu pracy” | Utwórz własną gałąź, włącz funkcję „Akcje” i zsynchronizuj ją z wersją źródłową main. Nie edytuj zatwierdzonych pinów źródłowych w celu obejścia błędu. |
Nie sealed-connection artefaktu |
Sprawdź, czy zadanie zostało uruchomione i czy zakończyło etap uruchamiania/przesyłania. Uruchomienie może zostać uniemożliwione przez awarie związane z kolejką, modułem wykonawczym, pobieraniem obrazu, tunelem lub zasadami repozytorium. |
| Nie można nawiązać połączenia | Wczytaj zapisany klucz dla tego uruchomienia, rozpakuj pobrany plik i wybierz connection.tgwsealed. Program uruchamiający musi nadal być aktywny. |
| Historia została wstrzymana | Sprawdź stan panelu i skorzystaj z opcji „Wznów”, dopóki sesja pozostaje aktywna, lub zakończ pracę, korzystając z już zebranych danych. Ograniczenia serwisu Telegram oraz niedostępne treści mogą powodować luki w danych. |
Nie sealed-result |
Anulowanie lub wygaśnięcie przed rozpoczęciem odbioru nie powoduje utworzenia archiwum; proces kończy się wówczas komunikatem Brak archiwum. Nieudany etap odbioru, poświadczenia lub pakowania również uniemożliwia dostawę; w przypadku nieudanego etapu podawana jest przyczyna wskazana przez przełożonego bez danych osobowych. Można to sprawdzić bez podawania danych uwierzytelniających. |
| Przeglądarka nie może odszyfrować dużego archiwum | W przypadku pakietów większych niż 256 MiB należy skorzystać z poniższego interfejsu CLI do strumieniowania. Nieprawidłowy lub utracony klucz prywatny uniemożliwia odszyfrowanie wyniku. |
| Weryfikacja odrzuca osobę podpisującą | Należy skorzystać ze sprawdzonej, aktualnej instalacji TgWitness oraz dokładnie tego samego programu wywołującego OWNER/REPOSITORY. Nie akceptuj zastępczej polityki dostarczonej wraz z archiwum. |
| Telegram nadal wyświetla tę tymczasową sesję | Wyłącz tę funkcję w Ustawieniach → Urządzenia. Wylogowanie może się nie powieść, a w przypadku przymusowego zakończenia procesu czyszczenia może nie zostać przeprowadzone. |
Zanim zaczniesz polegać na tym podglądzie, przeprowadź małą rozmowę, nad którą masz kontrolę: utwórz wiadomość i załącznik, zbierz je, odszyfruj wynik, uruchom narzędzie weryfikacyjne, sprawdź wyniki dotyczące zasięgu/multimediów i potwierdź unieważnienie sesji w Telegramie. Zautomatyzowane kontrole wykorzystują syntetycznego klienta Telegramu oraz oddzielny test z wykorzystaniem prawdziwego certyfikatu GitHub; nie odnotowano żadnych testów na prawdziwych kontach w obecnej wersji.
Lokalne odszyfrowywanie i weryfikacja#
Należy korzystać z narzędzi pochodzących z niezależnego, zaufanego źródła, a nie z plików wykonywalnych udostępnionych przez nieznane archiwum dowodów:
python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip
# Unzip delivery.zip using your archive manager, then:
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
W przypadku dostawy wieloczęściowej należy najpierw odszyfrować główny pakiet i umieścić wyodrębniony manifest obok każdej zaszyfrowanej części, a następnie uruchomić:
python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip
python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
Manifest jest poświadczonym obiektem i wiąże wszystkie części oraz skompilowany plik ZIP.
Użyj --max-gib , aby ustawić odpowiedni limit weryfikacji w postaci nieskompresowanych danych dla
dużego archiwum; domyślna wartość to 4 GiB. Kontrole „expected-selection” i „complete-scope”
działają również w przypadku przesyłania wieloczęściowego.
Python 3.11+, zależności projektu oraz najnowsza wersja GitHub CLI obsługująca
--signer-digest oraz --deny-self-hosted-runners . Dostępny jest również generator kluczy CLI
: python -m tgwitness.sealed_crypto keygen sealed-key.json.
Weryfikator korzysta tgwitness/sealed_policy.json z zaufanej instalacji.
Sprawdza repozytorium wywołującego, przebieg procesu podpisywania przez dostawcę, zatwierdzone
zgłoszenie podpisującego, wymagania dotyczące hostowanego modułu wykonawczego, kompletny skrót pliku ZIP, dziennik wewnętrzny oraz
integralność załączników, aktualne pochodzenie klucza konta oraz oczekiwane zgłoszenie kolektora.
Wyświetla historię i wyniki multimedialne, zamiast sugerować, że wszystkie dane zostały zapisane.
Pusta lista zatwierdzonych wydań powoduje niepowodzenie zamknięcia. Aktualizacja polityki jest wyraźną
decyzją dotyczącą zaufania; nigdy nie należy automatycznie akceptować polityki zaproponowanej przez samo archiwum.
Aby korzystać z programu w trybie offline, należy wcześniej pobrać zaufane certyfikaty główne z zaufanego środowiska:
gh attestation trusted-root > trusted_root.jsonl
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl
Sygnatura czasowa poświadczenia dotyczy zobowiązania archiwum. Nie potwierdza ona autentyczności sygnatur czasowych wiadomości ani zegara systemowego kolektora. Zobacz opcje weryfikacji serwisu GitHub.
W jaki sposób widelec pozostaje poza procesem przechwytywania#
Element „caller” zawiera odwołanie na poziomie zadania do nadrzędnego przepływu pracy wielokrotnego użytku przy
pełnym identyfikatorze SHA zatwierdzenia. Ten przepływ pracy wyraźnie pobiera dane z repozytorium nadrzędnego
przy stałym identyfikatorze SHA kolektora. Domyślny actions/checkout w przepływie pracy wielokrotnego użytku
sprawdzałby wywołującego i celowo nie jest używany.
Ten przepływ pracy nie przywraca pamięci podręcznych wywołującego, nie wykorzystuje artefaktów wywołującego, nie uruchamia plików wywołującego ani nie akceptuje adresów URL źródeł/obrazów, poleceń powłoki, przygotowanych plików ZIP, ani skrótów do podpisania. Akceptuje określonego publicznego odbiorcę oraz czas trwania sesji. Działania, obraz bazowy Pythona oraz pakiety `cloudflared` są przypisane za pomocą niezmiennych skrótów; zależności Pythona korzystają z istniejących wymagań zablokowanych za pomocą skrótów. Obraz jest kompilowany z zaufanego źródła bez korzystania z pamięci podręcznej.
Kolektor działa jako użytkownik bez uprawnień roota, z obrazem tylko do odczytu, wyłączonymi możliwościami systemu Linux, ograniczeniami zasobów oraz bez gniazda Docker ani środowiska z tokenem GitHub. Jedynymi zamontowanymi katalogami są: katalog konfiguracji, obszar roboczy oraz katalogy wyjściowe. Ograniczona aplikacja FastAPI udostępnia funkcje logowania, okna dialogowe, konfigurowalne opcje dotyczące konta lub czatu, status, wznowienie, zakończenie oraz anulowanie. Nie ma ścieżki pobierania w postaci zwykłego tekstu, ścieżki ogólnej administracji, ścieżki importu ani punktu końcowego do podpisywania.
Kierownik zatrzymuje kontenery połączone z siecią, zanim operacja poświadczania
odczyta ostateczną, poprawioną wersję evidence.zip lub evidence.parts.json. Kontener pakujący nie ma dostępu do sieci.
W nazwach kroków przesyłania podano wyłącznie connection.tgwsealed i delivery*.tgwsealed;
ani dowody w postaci zwykłego tekstu, ani poświadczenia serwisu Telegram nie są przesyłane jako artefakty.
Czyszczenie usuwa prywatne katalogi i kontenery, a serwis GitHub likwiduje
hostowaną maszynę wirtualną środowiska uruchomieniowego po zakończeniu zadania. Okres przechowywania artefaktów wynosi jeden dzień; należy je pobrać przed upływem terminu ważności.
Właściciel rozgałęzienia może zastąpić podmiot wywołujący lub utworzyć inny podpisany plik. Rygorystyczny weryfikator musi odrzucić wynikający z tego inny przebieg procesu podpisu lub skrót. Rozwiązanie to nadal opiera się na założeniu, że w zatwierdzonym kodzie nie ma błędów, które można by wykorzystać, oraz na integralności środowiska uruchomieniowego GitHub i infrastruktury podpisywania.
Przekazywanie kryptograficzne#
Każdy klucz odbiorcy to RSA-3072 (akceptowane są również importy RSA-4096), wykładnik 65537. Każda kopertka posiada nowy, losowy klucz AES-256 oraz 96-bitowy nonce. Klucz AES jest zabezpieczony algorytmem RSA-OAEP z SHA-256/MGF1-SHA256. Algorytm AES-GCM z 128-bitowym tagiem uwierzytelnia cały prefiks i ładunek. Klucz publiczny odbiorcy jest w formacie DER SPKI zakodowanym w base64; plik klucza prywatnego zawiera DER PKCS8 zakodowany w base64.
Bajty koperty to TGWSEAL1\n: długość nagłówka JSON typu uint32 w formacie big-endian,
nagłówek, tekst zaszyfrowany oraz 16-bajtowy tag GCM. Nagłówek ma dokładnie algorithm,
key, a nonce; algorytm to RSA-OAEP-256+A256GCM. Cały prefiks
w nagłówku stanowi dodatkowe, uwierzytelnione dane GCM. Rozmiar nagłówka jest ograniczony
do 8192 bajtów. Interfejs CLI przesyła ładunki o wielkości do 8 GiB i przeprowadza uwierzytelnianie przed
zainstalowaniem żądanego wyniku; odmawia nadpisania istniejącego miejsca docelowego.
Jest to specyficzna dla projektu otoczka wokół standardowych prymitywów kryptograficznych:
RSA-OAEP z SHA-256 i AES-256-GCM, dostępna w OpenSSL i każdej większej
bibliotece kryptograficznej.
Oryginalne bajty dowodów są poświadczane przed umieszczeniem dowodu i poświadczenia w zaszyfrowanej paczce zewnętrznej. Pozwala to uniknąć zależności cyklicznej między skrótem archiwum a certyfikatem zawartym w tym samym archiwum. W przypadku repozytoriów publicznych metadane poświadczenia (repozytorium, przepływ pracy, commit, nazwa artefaktu i skrót) są jawne. Nigdy nie umieszczaj nazw czatów w metadanych publicznych.
Zakres i walidacja#
Ten tryb wykorzystuje silnik podpisywania dziennika i eksportu konta. Ciche czaty, usunięta historia sprzed rozpoczęcia gromadzenia danych oraz dane niedostępne dla konta są wykluczone. Prywatne czaty w chmurze są uwzględniane po ich zaznaczeniu. Liczba czatów w selektorze jest ograniczona do 20 000; eksport konta samodzielnie wykrywa zawartość. Brakujące dane, uszkodzone pliki i niedokończone zadania są rejestrowane. Nadal obowiązują limity załączników oraz limity miejsca na dysku i czasu działania programu. W przypadku dużych przesyłek wykorzystywane są zaszyfrowane części zamiast stałego limitu przesyłania wynoszącego 4 GiB. Zakończenie oznacza, że wybrane zadania w stanie zamrożonym zostały zakończone, a nie że każdy historyczny rekord Telegramu znajduje się w archiwum. Dziennik czatu może również śledzić aktualizacje na żywo; żaden z trybów nie stanowi atomowej migawki. Wygenerowane zrzuty ekranu i nagrania ekranu nie są częścią tego trybu.
Testy obejmują syntetyczne logowanie od nowa, izolację zakresu, nośniki, anulowanie, częściowe dotrzymanie terminu, nieudane wylogowanie, niedozwolone ścieżki i pola API, odrzucenie wstępnie załadowanego obszaru roboczego, odrzucenie z powodu błędnego klucza lub manipulacji, wymagane flagi weryfikatora oraz interoperacyjność szyfrowania między przeglądarką a Pythonem. Test akceptacyjny przeglądarki wykorzystuje wyraźnie oznaczony atrapy poświadczenia; nie jest to prawdziwy test Sigstore. Rzeczywiste testy z wykorzystaniem hostowanego środowiska uruchomieniowego, Docker, poświadczenia GitHub oraz testy akceptacyjne na żywo w Telegramie należy zgłaszać oddzielnie od lokalnych testów syntetycznych.
Warunki korzystania z GitHub Actions ograniczają wykorzystanie hostowanych runnerów do cyklu życia projektu oprogramowania. Utworzenie forka nie znosi tych ograniczeń; tej wersji zapoznawczej nie wolno promować jako nieograniczonego bezpłatnego hostingu produkcyjnego. Usługi Cloudflare Quick Tunnels są również przeznaczone do testowania i rozwoju. Skrypty pomocnicze/workflow nadają się do oceny tej funkcji; kwalifikowalność do usług produkcyjnych pozostaje odrębnym wymogiem wdrożeniowym.
Sekwencja wydawania aktualizacji przez opiekuna#
- Wprowadź zmiany i sprawdź kolektor, moduł nadzorujący, definicję kontenera oraz testy.
- Zapisz tę wersję kolektora w
sealed-collector.yml, a następnie zatwierdź/sprawdź wielokrotnego użytku. Nigdy nie wyprowadzaj po cichu checkoutu z SHA wywołującego. - Przypnij zatwierdzenie przepływu pracy wielokrotnego użytku w
sealed-witness.ymli dodaj jego parę SHA workflow/collector dosealed_policy.jsonw zaufanej wersji. - Opublikuj wszystkie komity, do których są odwołania, oraz skrypt pomocniczy, a następnie przetestuj niezależny fork oraz prawdziwy certyfikat GitHub. Nie łącz w jeden commit komitów, do których odwołują się te odnośniki, chyba że odwołania zostaną wygenerowane na nowo i opublikowane ponownie.
Aby zapoznać się z różnicą między repozytorium wywołującym a podpisującym z wyższego poziomu, zapoznaj się z gotowymi do ponownego wykorzystania schematami postępowania i oświadczeniami .