# Telegram · Przechwytywanie za pomocą GitHub Actions

Canonical page: https://phishdestroy.io/tgwitness/pl/docs/capture/

Wybierz Takeout, eksport przez zwykłe API lub dziennik czatu na tymczasowym runnerze GitHub.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/pl/llms.txt)

Wybierz Takeout, eksport przez zwykłe API lub dziennik czatu na tymczasowym runnerze GitHub.

Proszę włączyć obsługę JavaScript, aby wygenerować klucz i odszyfrować archiwum.

**Pełne odniesienie**

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentacja](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Niezależne przechwytywanie](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md)

![Niezależne przechwytywanie](https://phishdestroy.io/tgwitness/assets/chapter-capture.svg?v=c979502bc92b)

**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](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md) 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](https://phishdestroy.io/tgwitness/pl/docs/capture/#user-flow)
- [Czas przeznaczony na sesję](https://phishdestroy.io/tgwitness/pl/docs/capture/#session-time-budget)
- [Wybierz ten tryb lub stały obszar roboczy](https://phishdestroy.io/tgwitness/pl/docs/capture/#choose-this-mode-or-a-persistent-workspace)
- [Co jest sprawą publiczną, a co musi pozostać prywatne](https://phishdestroy.io/tgwitness/pl/docs/capture/#what-is-public-and-what-must-stay-private)
- [Rozwiązywanie problemów](https://phishdestroy.io/tgwitness/pl/docs/capture/#troubleshooting)
- [Lokalne odszyfrowywanie i weryfikacja](https://phishdestroy.io/tgwitness/pl/docs/capture/#local-decryption-and-verification)
- [W jaki sposób widelec pozostaje poza procesem przechwytywania](https://phishdestroy.io/tgwitness/pl/docs/capture/#how-the-fork-is-kept-outside-the-capture-process)
- [Przekazanie kryptograficzne](https://phishdestroy.io/tgwitness/pl/docs/capture/#cryptographic-handoff)
- [Zakres i walidacja](https://phishdestroy.io/tgwitness/pl/docs/capture/#scope-and-validation)
- [Sekwencja wydawania aktualizacji przez opiekuna projektu](https://phishdestroy.io/tgwitness/pl/docs/capture/#maintainer-release-sequence)

## 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.

1. 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](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) or `tgwitness/static/capture.html` from 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.
2. 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**.
3. 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.
4. Podczas działania aplikacji pobierz **plik sealed-connection** z sekcji „Artifacts” i rozpakuj go. Załaduj `connection.tgwsealed` w 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.
5. 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 i `api_hash` z [my.telegram.org/apps](https://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.
6. 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.
7. Poczekaj na **plik z wynikami w formacie SEALED**, pobierz go i rozpakuj, a następnie odszyfruj `delivery.tgwsealed` w programie pomocniczym. Otrzymasz plik `delivery.zip`, zawierający `evidence.zip`, `attestation.jsonl`oraz 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.tgwsealed` części; plik główny `delivery.tgwsealed` zawiera wówczas `evidence.parts.json` oraz poświadczenie. Pobierz wszystkie części i złóż je lokalnie zgodnie z poniższym opisem.
8. 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.

## 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

| 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](https://core.telegram.org/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ź

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

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](https://cli.github.com/manual/gh_attestation_verify).

## W jaki sposób widelec pozostaje poza  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.

## 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

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](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#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](https://developers.cloudflare.com/tunnel/get-started/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.

## wydawania aktualizacji przez opiekuna#

1. Wprowadź zmiany i sprawdź kolektor, moduł nadzorujący, definicję kontenera oraz testy.
2. 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.
3. Przypnij zatwierdzenie przepływu pracy wielokrotnego użytku w `sealed-witness.yml` i dodaj jego parę SHA workflow/collector do `sealed_policy.json` w zaufanej wersji.
4. 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](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) .
