# Telegram · Sygnatury czasowe

Canonical page: https://phishdestroy.io/tgwitness/pl/docs/reference/timestamp/

Sygnatury czasowe zgodne z RFC 3161 dla podpisanych punktów kontrolnych: jakie dane są przesyłane do organu certyfikującego oraz w jaki sposób weryfikowana jest odpowiedź.

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

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

Sygnatury czasowe zgodne z RFC 3161 dla podpisanych punktów kontrolnych: jakie dane są przesyłane do organu certyfikującego oraz w jaki sposób weryfikowana jest odpowiedź.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentacja](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Dowody i weryfikacja](https://phishdestroy.io/tgwitness/pl/docs/reference/evidence/)

![Dowody i weryfikacja](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

TgWitness przygotowuje żądania zgodne z RFC 3161 i weryfikuje odpowiedzi od podmiotu uprawnionego do nadawania znaczników czasu (TSA). Ta procedura ręczna nie obejmuje ani wyboru podmiotu TSA, ani przesyłania danych; tryb dowodowy wykonuje obie te czynności zgodnie z harmonogramem ([format dowodowy](https://phishdestroy.io/tgwitness/pl/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)). Przygotowane żądanie **nie** stanowi **jeszcze dowodu w postaci znacznika czasu**.

## Co potwierdza ten dowód

Schemat blokowy · Uwagi dotyczące konta → Łańcuch SHA-256 i podpisy Ed25519; Łańcuch SHA-256 i podpisy Ed25519 → Podpisany punkt kontrolny; Podpisany punkt kontrolny → Skrót z dokładnością do bajta oraz losowy nonce; Skrót z dokładnością do bajta oraz losowy nonce → Żądanie zgodne z RFC 3161; Żądanie zgodne z RFC 3161 → Niezależna agencja TSA; Niezależna agencja TSA → Podpisana odpowiedź TSA; Podpisany punkt kontrolny → Weryfikacja danych, wartości nonce oraz wyraźne zaufanie do urzędu certyfikacji (CA); Podpisana odpowiedź TSA → Weryfikacja danych, wartości nonce oraz wyraźne zaufanie do urzędu certyfikacji (CA) · Uwagi dotyczące konta · Łańcuch SHA-256 ipodpisy Ed25519 · Podpisany punktkontrolny · Skrót z dokładnościądo bajta oraz losowynonce · Żądanie zgodne z RFC3161 · Niezależna agencja TSA · Podpisana odpowiedźTSA · Weryfikacja danych,wartości nonce orazwyraźne zaufanie dourzędu certyfikacji(CA)

**Schemat w formie tekstowej**

1. Uwagi dotyczące konta → Łańcuch SHA-256 i podpisy Ed25519
2. Łańcuch SHA-256 i podpisy Ed25519 → Podpisany punkt kontrolny
3. Podpisany punkt kontrolny → Skrót z dokładnością do bajta oraz losowy nonce
4. Skrót z dokładnością do bajta oraz losowy nonce → Żądanie zgodne z RFC 3161
5. Żądanie zgodne z RFC 3161 → Niezależna agencja TSA
6. Niezależna agencja TSA → Podpisana odpowiedź TSA
7. Podpisany punkt kontrolny → Weryfikacja danych, wartości nonce oraz wyraźne zaufanie do urzędu certyfikacji (CA)
8. Podpisana odpowiedź TSA → Weryfikacja danych, wartości nonce oraz wyraźne zaufanie do urzędu certyfikacji (CA)

Podpis kolektora wiąże zapisy z jego kluczem. Zaufana odpowiedź TSA może potwierdzić, że dany punkt kontrolny istniał w czasie podanym przez TSA. Punkt kontrolny może następnie powiązać prefiks dziennika. Ta górna granica czasowa dotyczy tego zatwierdzonego prefiksu; poszczególne działania w Telegramie zachowują swoje zarejestrowane czasy zdarzeń.

## Procedura

Weryfikator dziennika zgłasza kroki wsteczne oraz niemożliwe do przeanalizowania wartości `observed_at` w `chronology`, jeśli takie występują, i dołącza ostrzeżenie do wyników polecenia. Zachowuje podpisane znaczniki czasu i nadal sprawdza ich podpisy. Krok wstecz może wynikać z korekty zegara, dlatego należy to zweryfikować na podstawie zapisów zegara hosta. Czas niezależny pochodzi ze zweryfikowanych zewnętrznych znaczników czasu, wpisów świadków odczytanych z ich publicznej strony t.me oraz rund drand; opcja `--strict` reguluje przypisywanie podpisujących oraz obsługiwane formaty.

Zarejestrowane wartości drand są poddawane offline kontrolom spójności strukturalnej i skrótu. `--check-drand` porównuje wybrane zarejestrowane rundy z odpowiedziami przekaźników HTTPS; wynik wskazuje, ile rund zostało porównanych i które przekaźniki udzieliły odpowiedzi, a porównane rundy dostarczają uwierzytelnioną dolną granicę czasu.

1. Zachowaj odcisk klucza kolektora za pośrednictwem oddzielnego, zaufanego kanału; identyfikuje on kolektor niezależnie od badanego pliku ZIP.
2. W **sekcji Eksportuj → Przygotuj żądanie znacznika czasu** proszę pobrać plik ZIP z żądaniem dla wybranego obszaru roboczego. Proszę rozpakować pliki `checkpoint.json`, `timestamp.tsq`, `SHA256SUMS` oraz `README.txt`. Proszę nie zmieniać bajtów punktu kontrolnego.
3. Proszę wybrać TSA odpowiedni do danego dochodzenia. Proszę przesłać plik `timestamp.tsq`, korzystając z udokumentowanej metody, a plik `application/timestamp-query` – w przypadku usługi HTTP. Proszę zapisać oryginalną odpowiedź binarną jako plik `timestamp.tsr` wraz z punktem końcowym, czasem pobrania oraz wynikiem żądania. Żądanie zawiera skrót i licznik losowy zamiast samych wiadomości; metadane sieciowe nadal ujawniają treść żądania.
4. Należy uzyskać zaufany certyfikat główny niezależnie od treści odpowiedzi, a także wszelkie wymagane certyfikaty pośrednie. Certyfikat zawarty w odpowiedzi nie staje się zaufany wyłącznie z tego powodu, że się tam znajduje.
5. Z poziomu zaufanej instalacji TgWitness proszę zweryfikować:

```
python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem
```

W razie potrzeby dodaj `--intermediates tsa-intermediates.pem`. OpenSSL nie jest potrzebny: podpis, odwołanie do certyfikatu podpisu i łańcuch są sprawdzane w Pythonie biblioteką `cryptography`, tym samym kodem, którego używa `verify.py --tsa-ca`. `openssl ts -verify` pozostaje niezależną drugą kontrolą dla eksperta, który jej chce.

1. Proszę wyeksportować plik ZIP z podpisanym dziennikiem po osiągnięciu punktu kontrolnego, tak aby zawierał on ten prefiks. Proszę zweryfikować przy użyciu niezależnie znanego odcisku palca:

```
python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json
```

Wskazuje to, że eksport zawiera prefiks z sygnaturą czasową. Skrypt `verify.py` odczytuje potwierdzenia z sygnaturą czasową wyłącznie z pliku ZIP, w którym są one przechowywane w trybie dowodowym; ręczna odpowiedź jest sprawdzana w kroku 5. i obejmuje zapisy do tego punktu kontrolnego.

1. Należy zachować plik ZIP, punkt kontrolny, żądanie, odpowiedź, łańcuch certyfikatów, wyniki weryfikacji oraz zapis przekazania poza kolektorem. Weryfikację należy powtórzyć w momencie odbioru.

Aby przygotować zapytanie na podstawie zapisanego punktu kontrolnego:

```
python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip
```

Proces przygotowania standaryzuje format JSON i dołącza odpowiedni punkt kontrolny do archiwum. Należy wykorzystać **bajty punktu kontrolnego z tego archiwum** do weryfikacji TSA, nawet jeśli plik wejściowy zawierał inne znaki spacji.

## Granice weryfikacji

| Sprawdź | Obecne działanie |
| --- | --- |
| Dane | Wartość SHA-256 dokładnych bajtów punktu kontrolnego musi być zgodna z odpowiedzią |
| Zapytanie | W przypadku algorytmu `--request` weryfikowane są oryginalne zapytanie oraz wartość nonce |
| Podpis TSA | Podpis, certyfikat podpisu i jego łańcuch do wskazanego CA są sprawdzane na chwilę znacznika czasu |
| Podpis zbierającego | Oddzielnie zweryfikowane przez weryfikatora dziennika przy użyciu przypiętego klucza |
| Unieważnienie | Tryb dowodowy przechowuje dowody OCSP/CRL sprawdzane przez skrypt `verify.py` |
| Zaplanowane przesłanie | Tryb dowodowy, włączany przy każdym celu konfiguracji |

`--request` jest formalnie opcjonalny, ale bez niego nie da się zweryfikować pierwotnego nonce. W tej pełnej procedurze `request_checked` w wyniku musi mieć wartość true. Każdy certyfikat w łańcuchu musi być ważny w chwili znacznika, a certyfikat podpisu musi służyć wyłącznie do znakowania czasem.

Odpowiedź TSA powiązuje przesłane bajty punktu kontrolnego z podanym czasem. Należy zweryfikować ten wynik z zapisami pozyskania danych i weryfikacją środowiska dla wybranego trybu. Tryb dowodowy obejmuje kwalifikowany serwer TSA rządu belgijskiego `http://tsa.belgium.be/connect`; odpowiedzi RFC 3161 są podpisane, więc zwykły protokół HTTP nie osłabia ich bezpieczeństwa). Po przekazaniu certyfikatu głównego tego dostawcy do `--tsa-ca`, `verify.py` zgłasza kwalifikowany znacznik czasu eIDAS oraz jego jednostkę pomiaru czasu; rozporządzenie (UE) nr 910/2014, art. 41 ust. 2, zakłada dokładność czasu oraz integralność powiązanych danych.

### Unieważnienie certyfikatu podpisu

Zaraz po każdej odpowiedzi tryb dowodowy pobiera dowód unieważnienia certyfikatu podpisu TSA: odpowiedź OCSP z adresu AIA OCSP certyfikatu, w przeciwnym razie listę CRL z punktu jej dystrybucji (maksymalnie 4 MiB). Jest on przechowywany obok odpowiedzi jako `checkpoint-N.<service>.ocsp` lub `.crl` i eksportowany wraz z nią. Nieudane pobranie nigdy nie wstrzymuje generowania sygnatury czasowej; rekord `anchor.completed` wymienia ją jako `unavailable` wraz z przyczyną.

`verify.py` sprawdza podpis odpowiedzi OCSP (przez wydawcę lub certyfikat respondenta, który wydawca przekazał do celów podpisywania OCSP), identyfikator certyfikatu i status, a także czy odpowiedź została wydana w momencie genTime lub później albo czy była wówczas nadal aktualna (nextUpdate). W przypadku listy CRL sprawdza podpis wydawcy, ten sam przedział czasowy oraz czy numer seryjny nie figuruje na liście. Następnie zgłasza komunikat `signing certificate not revoked as of <time> (OCSP|CRL)`, nieudaną weryfikację lub `revocation not checked (no OCSP/CRL in the archive)`. Certyfikat podpisujący unieważniony w momencie genTime lub wcześniej nie przechodzi weryfikacji; późniejsze unieważnienie jest sygnalizowane jako ostrzeżenie.

## Rejestry dowodów i przedłużanie ważności (RFC 4998)

Sygnatura czasowa zgodna z RFC 3161 zachowuje ważność tylko tak długo, jak długo ważny jest algorytm haszujący oraz klucz podpisujący i certyfikat agencji TSA; sprawa może jednak trwać dłużej niż te elementy. Tryb dowodowy przechowuje również rekord dowodowy zgodny z RFC 4998 (ERS) dla każdego zachowanego punktu kontrolnego i odnawia go.

Podczas każdego przebiegu weryfikacji punkty kontrolne bez zapisu trafiają do drzewa skrótów, a skonfigurowane moduły TSA są kolejno pytane o jeden znacznik czasu dla jego węzła głównego. Każdy punkt kontrolny otrzymuje `checkpoints/anchors/checkpoint-N.ers`: `EvidenceRecord` którego `ArchiveTimeStampSequence` zawiera jeden `ArchiveTimeStampChain` z `ArchiveTimeStamp` zawierający zredukowane drzewo skrótów dla tego punktu kontrolnego oraz token TSA. Rekord może zawierać skróty sąsiednich punktów kontrolnych; walidatory, takie jak EU DSS, ostrzegają przed tym. Eksport ASiC-E zawiera również `META-INF/evidencerecord.ers` wraz z `META-INF/ASiCEvidenceRecordManifest.xml`, czyli rekord dowodowy dla obiektów danych kontenera (ETSI EN 319 162-1). Eksport w formacie ZIP zawiera rekordy punktów kontrolnych w ramach `anchors/`.

Odnowienie odbywa się zgodnie z sekcją 5 dokumentu RFC 4998 i polega wyłącznie na dodaniu:

| Odnowienie | Kiedy | Co jest wybite |
| --- | --- | --- |
| Odnowienie znacznika czasu | Certyfikat podpisu najnowszego tokenu traci ważność za N miesięcy (domyślnie 6), jego skrót podpisu jest oznaczony jako słaby lub na żądanie | Suma kontrolna poprzedniego tokenu, ten sam algorytm; znacznik jest dodawany do ostatniego ogniwa łańcucha |
| Odświeżanie drzewa skrótów | Algorytm haszujący łańcucha jest oznaczony jako słaby lub na żądanie | `H(H(checkpoint) + H(previous ArchiveTimeStampSequence))` dzięki zastosowaniu silniejszego algorytmu (domyślnie SHA-512); dodawany jest nowy łańcuch |

Każde odnowienie trafia do nowego pliku, `checkpoint-N.renewal-K.ers`; wcześniejsze pliki i łańcuchy pozostają identyczne bajt po bajcie. Dowód sięga aż do pierwszego znacznika czasu tylko wtedy, gdy każde ogniwo jest sprawdzane w odpowiedniej kolejności, dlatego odnowienie należy przeprowadzić, dopóki najnowszy token jest nadal ważny: zanim wygaśnie jego certyfikat podpisu, znikną informacje o jego unieważnieniu lub zostanie złamany algorytm skrótu lub podpisu. Późniejsze odnowienie dodaje znacznik, ale nie rozszerza wcześniejszego dowodu.

Pętla tła w trybie dowodowym sprawdza politykę codziennie oraz na żądanie (`evidence_record.demand_renewal`). Każda próba jest rejestrowana w dzienniku jako `evidence_record.created` lub `evidence_record.renewed` wraz z usługą, czasem, algorytmem skrótu, korzeniem drzewa, zakresem punktów kontrolnych, `ok` oraz błędami; nieczytelne zapisy trafiają do `evidence_record.check_failed`. W przypadku niepowodzenia TSA następuje ponowna próba z opóźnieniem wynikającym ze stemplowania punktów kontrolnych, liczoną oddzielnie, podczas gdy próba jest podejmowana dla następnego TSA z listy. Polityka (`months_before_expiry`, `weak_algorithms`, `algorithm`, `stronger_algorithm`) jest ustawieniem profilu `evidence_record_policy`; panel nie ma jeszcze nad nim kontroli.

Kolektor przed zapisaniem każdego nowego rekordu porównuje go z jego punktem kontrolnym oraz podpisem TSA. `verify.py` sprawdza każdy rekord w eksporcie: drzewa skrótów, tokeny, kolejność łańcuchów i odnowień, a także zgłasza najwcześniejszy potwierdzony czas oraz stan najnowszego stempla. EU DSS odczytuje te same rekordy wraz z punktem kontrolnym jako dane oddzielne.

Rozporządzenie (UE) 2024/1183 (eIDAS 2.0) uzupełniło rozporządzenie (UE) nr 910/2014 o pojęcia kwalifikowanej archiwizacji elektronicznej i kwalifikowanych rejestrów elektronicznych. TgWitness zapisuje dane w standardowych formatach, ale nie jest usługą zaufania; jego archiwum i rejestr nie posiadają statusu kwalifikowanego. Kwalifikowany dostawca musiałby, między innymi:

- Archiwizacja (art. 45i i 45j): uprawniony dostawca usług zaufania przechowuje dane przez okres przechowywania określony przepisami prawa lub umową, w formie trwałej i czytelnej wykraczającej poza okres ważności technologicznej oraz zabezpieczonej przed utratą i zmianą, wraz z automatycznym raportem dotyczącym integralności przeznaczonym dla uprawnionych stron polegających na usłudze, od momentu rozpoczęcia przechowywania do momentu odzyskania danych. Art. 45i ust. 2 zakłada integralność i pochodzenie w przypadku takiej usługi.
- Rejestry (art. 45k i 45l): rejestr tworzony i zarządzany przez co najmniej jednego kwalifikowanego dostawcę usług powierniczych, który ustala pochodzenie zapisów, porządkuje je w sposób jednoznaczny i chronologiczny oraz sprawia, że późniejsze zmiany są natychmiast wykrywalne. Dziennik TgWitness jest połączony łańcuchem skrótów i podpisany własnym kluczem kolektora, co samo w sobie nie stanowi kwalifikowanego rejestru.
- Oba: status kwalifikowany przyznany przez organ nadzorczy oraz wpis na listę zaufanych podmiotów (art. 21 i 22), obowiązki określone w art. 24, ocena zgodności przeprowadzana co najmniej co 24 miesiące (art. 20) oraz normy odniesienia określone w aktach wykonawczych na podstawie art. 45j ust. 2 i art. 45l ust. 2.

Kwalifikowane znaczniki czasu pochodzące z kwalifikowanego systemu TSA (art. 41 i 42) zachowują swoje własne domniemanie dla każdego tokenu; odnowienie nie powoduje powstania takiego domniemania dla całego zapisu.

## Rejestr przekazania

Należy zarejestrować identyfikator sprawy, nadawcę i odbiorcę, czas przesłania w formacie UTC oraz jego źródło, cel, nazwy plików/wartości SHA-256, odcisk palca kolektora, zakres sekwencji, znane luki, wersję weryfikatora oraz wynik weryfikacji. Proszę podpisać i przechowywać ten zapis niezależnie, zgodnie z procedurami obowiązującymi w Państwa organizacji. System rejestracji dowodów obsługujący wielu użytkowników nie jest zaimplementowany w TgWitness.

## Sprawdzanie działania usługi na żywo, 9 listopada 2026 r.

Do każdej domyślnej usługi wysłano jedno żądanie zgodne z RFC 3161. Obie je zatwierdziły.

| Usługa | Odpowiedz | Jednostka podpisująca | Wynik weryfikacji |
| --- | --- | --- | --- |
| `http://tsa.belgium.be/connect` | Zatwierdzono, polityka 2.16.56.13.6.3.1.1000 | Jednostka znacznika czasu 202301 | Kwalifikowany znacznik czasu eIDAS |
| `https://freetsa.org/tsr` | Przyznano | FreeTSA | Sygnatura czasowa RFC 3161 |

Belgijski certyfikat podpisujący zawiera oświadczenie o zgodności qcStatements i odpowiada jednostce zarejestrowanej w weryfikatorze. Testy lokalne wykorzystują również syntetyczny certyfikat CA/TSA w celu sprawdzenia odrzucenia zmienionych danych, zmienionego nonce oraz nieprawidłowego certyfikatu CA.

10 listopada 2026 r. belgijski serwer OCSP, będący certyfikatem serwera delegowanego, odpowiedział „good” dla jednostki znacznika czasu 202301. Adres OCSP serwisu FreeTSA (port 2560) nie udzielił odpowiedzi w ciągu 40 sekund od hosta testowego; zamiast tego wykorzystano jego listę CRL (PEM, 1 KB).
