TgWitness / Dokumentacja

Co zostało przetestowane →

Odniesienie / Dowody

Telegram · Sygnatury czasowe

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 / Dokumentacja · Dowody i weryfikacja

Dowody i weryfikacja

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). Przygotowane żądanie nie stanowi jeszcze dowodu w postaci znacznika czasu.

Co potwierdza ten dowód#

Schemat blokowyUwagi 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 Ed25519Podpisany punktkontrolnySkrót z dokładnościądo bajta oraz losowynonceŻądanie zgodne z RFC3161Niezależna agencja TSAPodpisana odpowiedźTSAWeryfikacja 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).