TgWitness / ドキュメント

テスト済みの内容 →

参考文献 / 証拠

Telegram · タイムスタンプ

署名付きチェックポイントにおけるRFC 3161タイムスタンプ:認証機関に送信される内容と、応答の検証方法について。

TgWitness / ドキュメント · 証拠と検証

証拠と検証

TgWitnessは、RFC 3161リクエストを作成し、タイムスタンプ認証機関(TSA)からの応答を検証します。 この手動手順では、TSAの選択もデータの送信も行われませんが、証拠モードでは、 スケジュールに従ってその両方を実行します(証拠形式)。作成されたリクエストは、 まだタイムスタンプの証明とはなりません。

証拠が示すもの#

フローチャートアカウントに関する所見 → SHA-256チェーンおよびEd25519署名; SHA-256チェーンおよびEd25519署名 → 署名付きチェックポイント; 署名付きチェックポイント → 正確なバイト単位のハッシュとランダムなノンス; 正確なバイト単位のハッシュとランダムなノンス → RFC 3161 リクエスト; RFC 3161 リクエスト → 独立系TSA; 独立系TSA → 署名付きTSAの回答; 署名付きチェックポイント → データ、ノンス、および明示的なCAの信頼性を検証する; 署名付きTSAの回答 → データ、ノンス、および明示的なCAの信頼性を検証するアカウントに関する所見SHA-256チェーンおよびEd25519署名署名付きチェックポイント正確なバイト単位のハッシュとランダムなノンスRFC 3161 リクエスト独立系TSA署名付きTSAの回答データ、ノンス、および明示的なCAの信頼性を検証する
図表をテキストで記述
  1. アカウントに関する所見 → SHA-256チェーンおよびEd25519署名
  2. SHA-256チェーンおよびEd25519署名 → 署名付きチェックポイント
  3. 署名付きチェックポイント → 正確なバイト単位のハッシュとランダムなノンス
  4. 正確なバイト単位のハッシュとランダムなノンス → RFC 3161 リクエスト
  5. RFC 3161 リクエスト → 独立系TSA
  6. 独立系TSA → 署名付きTSAの回答
  7. 署名付きチェックポイント → データ、ノンス、および明示的なCAの信頼性を検証する
  8. 署名付きTSAの回答 → データ、ノンス、および明示的なCAの信頼性を検証する

コレクターの署名は、レコードをその鍵に紐付けます。信頼できるTSAの応答により、 特定のチェックポイントがTSAが指定した時刻までに存在していたことを立証できます。 その後、そのチェックポイントはジャーナルのプレフィックスを紐付けることができます。この上限時刻は、 コミットされたそのプレフィックスに適用されます。個々のTelegramアクションは、記録されたイベント時刻を維持します。

手順#

ジャーナル検証ツールは、chronology内に後退ステップや解析不能なobserved_at値が存在する場合、 それらを報告し、コマンド出力に警告を含めます。このツールは 署名付きタイムスタンプを保持し、その署名を検証します。後退ステップは 時計の補正に起因する可能性があるため、ホストの時計記録と照らし合わせて確認してください。 独立した時刻は、検証済みの外部タイムスタンプ、t.meの公開ページから読み込まれた ウィットネスの投稿、およびdrandのラウンドから得られます。--strictは、署名者のピンニングと サポートされる形式を制御します。

記録されたdrand値は、オフラインで構造的およびハッシュによる自己一貫性チェックを受けます。 --check-drandは、選択された記録ラウンドをHTTPSリレーの応答と比較します。 結果には、比較されたラウンド数と応答したリレーが示され、 比較されたラウンドは認証済みの下限時間を提供します。

  1. コレクターのキーフィンガープリントは、別の信頼できるチャネルを通じて保持してください。これにより、 検査対象のZIPファイルとは独立して、コレクターを識別できます。
  2. 「エクスポート」→「タイムスタンプリクエストの準備」で、選択したワークスペースの リクエストZIPをダウンロードしてください。checkpoint.json、timestamp.tsq、SHA256SUMS、および README.txtを解凍してください。チェックポイントのバイトは変更しないでください。
  3. 調査に適したTSAを選択してください。timestamp.tsqを、 文書化された方法に従って送信し、HTTPサービスの場合はapplication/timestamp-queryを使用してください。 元のバイナリ応答をtimestamp.tsrとして保存し、エンドポイント、取得日時、 およびリクエストの結果を記録してください。リクエストにはメッセージではなくハッシュとノンスが含まれていますが、 ネットワークメタデータからは依然としてリクエストの内容が判明します。
  4. 応答の内容とは関係なく、信頼できるルート証明書と、必要な 中間証明書を取得してください。応答に含まれているからといって、その証明書が 自動的に信頼できるものになるわけではありません。
  5. 信頼できる TgWitness インストール環境から、以下を確認してください:
python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem

必要に応じて --intermediates tsa-intermediates.pem を追加します。OpenSSL は不要です。署名、署名証明書の参照、証明書チェーンは、verify.py --tsa-ca と同じコードである cryptography ライブラリにより Python で確認されます。openssl ts -verify は、希望する専門家向けの独立した二次確認として残ります。

  1. チェックポイント後に、そのプレフィックスが含まれるよう、署名付きジャーナルのZIPファイルをエクスポートしてください。 独立して確認済みのフィンガープリントを使用して検証してください:
python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json

これは、エクスポートにタイムスタンプ付きのプレフィックスが含まれていることを示しています。verify.pyは、 証拠モードで保存されているZIPファイルからのみタイムスタンプ付きレシートを読み込みます。手動による 応答はステップ5でチェックされ、このチェックポイントまでのレコードを対象とします。

  1. ZIPファイル、チェックポイント、リクエスト、レスポンス、証明書チェーン、検証 結果、およびコレクター外での引き継ぎ記録を保存してください。受信時に再度検証を行ってください。

保存されたチェックポイントからリクエストを作成するには:

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

この処理により、JSONが正規化され、対応するチェックポイントがアーカイブに含められます。 入力ファイルの空白文字が異なっていても、 TSAの検証には、そのアーカイブに含まれるチェックポイントのバイトデータを使用してください。

検証の範囲#

確認 現在の動作
データ チェックポイントの正確なバイト列の SHA-256 ハッシュ値が、レスポンスと一致する必要があります。
ご依頼 --request を使用することで、元のクエリとノンスが検証されます
TSA署名 署名、署名証明書、および明示した CA までの証明書チェーンは、タイムスタンプの時刻で確認されます
コレクターの署名 固定鍵を用いて、ジャーナル検証者によって別途検証されています
失効 エビデンスモードは、verify.pyが検証するOCSP/CRLエビデンスを保存します。
投稿予定 エビデンスモード:すべてのセットアップ目標で有効化される

--request は技術的には任意ですが、省略すると元の nonce を検証できません。この完全な手順では、結果の request_checked が true である必要があります。チェーン内の各証明書はタイムスタンプの時刻に有効でなければならず、署名証明書はタイムスタンプ専用でなければなりません。

TSAの応答は、送信されたチェックポイントのバイト列を、その指定された時刻に紐付けます。 その結果を、選択されたモードの取得記録および環境検証と照合してください。 証拠モードには、ベルギー政府の認定TSAが含まれます (http://tsa.belgium.be/connect;RFC 3161の応答には署名が付与されているため、プレーンHTTPでは その有効性が損なわれることはない)が含まれます。そのプロバイダのルート証明書を--tsa-caに渡すと、verify.pyは 認定されたeIDASタイムスタンプとそのタイムスタンプ単位を報告します。規則(EU)第910/2014号、 第41条(2)は、その時刻の正確性および紐付けられたデータの完全性を推定しています。

署名証明書の失効#

各応答の直後、証拠モードはTSA署名 証明書の失効証拠を取得します。これは、証明書のAIA OCSPアドレスからのOCSP応答、あるいはその配布ポイントからのCRL (最大4 MiB)です。これは応答の隣に checkpoint-N.<service>.ocspまたは.crlとして保存され、応答とともにエクスポートされます。取得に失敗しても タイムスタンプの生成は遅延しません。anchor.completedレコードには、その理由とともにunavailableとして記載されます。

verify.pyは、OCSP応答の署名(発行者によるもの、または発行者がOCSP署名目的で付与したレスポンダー証明書によるもの )、証明書ID、ステータス、および 応答がgenTime以降に発行されたか、その時点でまだ有効であったか(nextUpdate)を確認します。CRLについては、 発行者の署名、同じ時間枠、およびシリアル番号がリストにないことを確認します。 その後、signing certificate not revoked as of <time> (OCSP|CRL)、検証の失敗、 または revocation not checked (no OCSP/CRL in the archive) を報告します。genTime 時点または それ以前に失効した署名証明書は検証に失敗し、それ以降の失効は警告として表示されます。

証拠記録および更新 (RFC 4998)#

RFC 3161 タイムスタンプの有効期間は、そのハッシュアルゴリズムおよび TSA の署名鍵と 証明書の有効期間に限定されますが、事件の処理期間がそれらよりも長引く場合もあります。エビデンスモードでは、保持されている各チェックポイントについて RFC 4998 エビデンスレコード (ERS)を保持し、これを更新します。

各エビデンスパスにおいて、記録のないチェックポイントはハッシュツリーに入れられ、設定されたTSAに対して そのルートのタイムスタンプを1つ取得できるよう順に問い合わせが行われます。各チェックポイントには checkpoints/anchors/checkpoint-N.ers: EvidenceRecord その ArchiveTimeStampSequence には 1つの ArchiveTimeStampChain そのチェックポイントに対応する縮小ハッシュツリーとTSAトークンを含む ArchiveTimeStamp その チェックポイントの縮小ハッシュツリーとTSAトークンを含む値を受け取ります。レコードには隣接するチェックポイントのハッシュが記載される場合があり、EU DSSなどの バリデータはこれについて警告を発します。ASiC-Eエクスポートには、 META-INF/evidencerecord.ers とともに META-INF/ASiCEvidenceRecordManifest.xml、コンテナのデータオブジェクトに関する証拠レコード (ETSI EN 319 162-1)を含みます。ZIPエクスポートは、チェックポイントレコードを anchors/.

更新はRFC 4998の第5節に従い、以下の内容のみを追加します:

更新 いつ 何が刻印されているか
タイムスタンプの更新 最新のトークンの署名証明書の有効期限がNか月以内(デフォルトは6か月)に切れる場合、その署名ハッシュが「脆弱」とマークされている場合、またはリクエストがあった場合 前のトークンのハッシュ(同じアルゴリズム)。このスタンプは最後のチェーンに追加される。
ハッシュツリーの更新 このチェーンのハッシュアルゴリズムは「脆弱」と評価されているか、またはリクエストに応じて評価される H(H(checkpoint) + H(previous ArchiveTimeStampSequence)) より強力なアルゴリズム(デフォルトはSHA-512)を使用し、新しいチェーンが追加されます

更新のたびに新しいファイルが作成されますが、 checkpoint-N.renewal-K.ers; それ以前のファイルやチェーンはバイト単位で そのまま維持されます。証明が最初のタイムスタンプまで遡れるのは、すべてのリンクが順序通りに検証された場合のみです。 したがって、最新のトークンがまだ有効である間に更新を行ってください。つまり、その署名証明書の有効期限が切れる前、 失効情報が消える前、あるいはそのハッシュや署名アルゴリズムが破られる前です。後の更新では タイムスタンプが追加されますが、それ以前の証明は延長されません。

エビデンスモードのバックグラウンドループは、ポリシーを毎日、および要求に応じて確認します (evidence_record.demand_renewal)。各試行は evidence_record.created または evidence_record.renewed として記録され、サービス、時刻、ハッシュアルゴリズム、ツリーのルート、チェックポイントの範囲、 ok およびエラーが記録されます。読み取り不可能なレコードは evidence_record.check_failedに送られます。失敗したTSAについては、 チェックポイント・スタンピングのバックオフを適用して再試行され、その回数は個別にカウントされると同時に、リスト上の次のTSAが試行されます。 ポリシー(months_before_expiry, weak_algorithms, algorithm, stronger_algorithm)は プロファイル設定 evidence_record_policyであり、パネル側ではまだこれを制御できません。

コレクターは、新しいレコードを書き込む前に、そのチェックポイントおよびTSAの署名と照合します。 verify.py エクスポート内のすべてのレコード(ハッシュツリー、トークン、チェーンおよび更新の順序)を チェックし、証明された最も早い時刻と最新のスタンプの状態を報告します。EU DSSは、チェックポイントを含む同じ レコードを、切り離されたデータとして読み取ります。

規則(EU)2024/1183(eIDAS 2.0)により、規則(EU)第910/2014号に「適格電子アーカイブ」および「適格電子 台帳」が追加されました。TgWitnessは記録を標準形式で書き込みますが、 信頼サービスではありません。そのアーカイブおよびジャーナルには適格なステータスはありません。適格プロバイダーには、 とりわけ以下の要件が求められます:

  • アーカイブ(第45i条および第45j条):適格なトラストサービス提供者は、データを 法的または契約上の保存期間にわたって、技術的な有効期間を超えて耐久性があり判読可能な状態で 保持し、紛失や改ざんから保護するとともに、保存開始から検索に至るまで、 権限を有する依拠当事者向けに自動化された完全性レポートを提供しなければならない。第45i条(2)は、 このようなサービスについて、完全性および出所を推定する。
  • 台帳(第45k条および第45l条):1つ以上の適格なトラスト サービスプロバイダーによって作成・管理される台帳であり、記録の起源を確立し、それらを一意かつ 時系列順に並べ、事後の変更を即座に検知できるようにするものである。TgWitnessジャーナルは ハッシュチェーン化されており、コレクター自身の鍵で署名されているが、それだけでは適格な台帳とはみなされない。
  • 両方:監督機関による認定ステータスおよび信頼リストへの登録(第21条および 第22条)、第24条に定める義務、少なくとも24か月ごとに実施される適合性評価(第20条) 、ならびに第45j条第2項および第45l条第2項に基づく実施規則の参照基準。

適格なTSA(第41条および第42条)による適格なタイムスタンプは、トークンごとに独自の推定を維持する。 更新を行っても、記録全体に対する推定が生じることはない。

引き継ぎ記録#

ケース識別子、送信者および受信者、UTC 送信時刻とその送信元、 目的、ファイル名/SHA-256 値、コレクターのフィンガープリント、シーケンス範囲、既知の 欠落箇所、検証ツールのバージョン、および検証結果を記録します。 この記録に署名し、 組織のプロセスに従って独立して保管してください。TgWitnessには、 マルチユーザー対応の保管記録システムは実装されていません。

ライブサービスチェック、9年11月2026日#

各デフォルトサービスに対して1件のRFC3161リクエストが送信されました。両サービスともこれを承認しました。

サービス 返信 署名単位 検証結果
http://tsa.belgium.be/connect 承認済み、ポリシー 2.16.56.13.6.3.1.1000 タイムスタンプ ユニット202301 eIDAS認定タイムスタンプ
https://freetsa.org/tsr 承認済み FreeTSA RFC 3161 タイムスタンプ

ベルギーの署名証明書にはqcStatements準拠声明が含まれており、 検証ツールに記録された単位と一致しています。ローカルテストでは、合成CA/TSAを使用して、 変更されたデータ、変更されたノンス、および不正なCAの拒否を確認します。

10年11月2026日、委任されたレスポンダー証明書であるベルギーのOCSPレスポンダーは、 タイムスタンプユニット202301に対して「good」と応答した。FreeTSAのOCSPアドレス(ポート2560)は、テストホストからのリクエストに対して 40秒以内に応答しなかったため、代わりにそのCRL(PEM、1 KB)が使用された。