TgWitness / ドキュメント

テスト済みの内容 →

このページの一部は依然として英語のままです。翻訳後に英語の原文が変更されたためです。

参考文献 / 証拠

Telegram · 証拠の形式

署名付きZIPファイルの内容、記録の種類、処理の受領確認、ユーザープロフィール、オフサイトコピー、およびオフライン検証について。

TgWitness / ドキュメント

証拠と検証

TgWitnessは、アカウントから閲覧可能なTelegramの観測結果を署名付きジャーナルに保存します。 受信者は、保存された記録、添付ファイル、およびレポートを信頼できる コレクターキーに対して検証し、最後の記録に関する外部時刻を第三者から確認し、 ジャーナルを以前に保持していたチェックポイントと比較することができます。 このページでは、引き継ぎのために保持すべきフォーマット、チェック項目、および資料について説明します。

Windows ユーザーは、VERIFY.cmd から開始できます。このツールは、元の ZIP ファイルと独自に入手したキーのフィンガープリントの入力を求め、解説付きの 結果を表示し、検証記録を別途保存します。セットアップや信頼性の制限については、検証ランチャーおよび ポータブルランタイムを参照してください。

このページでは

署名とは#

資料 保護 保存すべき内容
運用上のイベントを含む、ジャーナルへのすべての記録 イベントごとにSHA-256チェーンとEd25519署名を付与します オリジナルのevents.jsonl(信頼できる鍵のフィンガープリント)および保持されたチェックポイント
証拠ZIPファイルの内容 manifest.sigは、コンテンツファイルのハッシュを一覧にした正規のマニフェストに署名します。 マニフェストおよび署名を含む完全なZIPファイル
保存された添付ファイル 署名付きmedia.savedイベント内のSHA-256およびバイト数;署名付きZIPマニフェスト内のファイルハッシュ 検証済みのZIPファイル内の元のバイトデータ
チェックポイント ジャーナルの長さ、先頭ハッシュ、公開鍵、および作成時刻に対するEd25519署名 変更の是非が争われた際に備えて保持された独立したコピー
実行記録 コレクターのバージョン、ソースファイルのハッシュ、および起動時の設定に関する署名付き記録。これらはprocess.startedにも含まれています。 選択した検証モードに関する領収書、関連する仕訳、および環境証拠
読みやすいレポート:report.htmlおよびその構成要素、report.json、report.pdf、chat.pdf ファイルごとにその内容に対してEd25519のシールが適用されます。PDFには、標準のPDF署名も付いています(参照。読み取り可能なレポート:)。 受信したファイルと信頼済み鍵のフィンガープリント、およびそれらが指すZIPファイル
スタンドアロン版 CSV 独立した暗号署名はありません。イベントのハッシュだけでは不十分です。 完全性チェックのためには、検証済みのZIPファイル内の正確なコピーをご使用ください。
ブラウザによって生成されたスクリーンショット、印刷物、またはPDF 派生作品にはTgWitnessの署名が含まれていません 検証済みの元のパッケージを保管し、派生版がどのように作成されたかを文書化してください。

コレクターは、あらゆるエクスポート形式を生成する前に、ジャーナルの署名を検証します。 読みやすい HTML および PDF レポートには独自のシールが付与されており、スタンドアロンの CSV ファイルは、 署名付き ZIP ファイルの一部としてチェックされます。添付ファイルのバイトデータとマニフェストを保持するために ZIP 形式を維持し、 以前の境界線に対してジャーナルを検証するための別のチェックポイントを設けてください。

フォーマットと検証パス#

取得モードと出力形式は、それぞれ異なる問いに応えるものです。モードは 収集および環境に関する証拠を提供し、各形式は、以下のチェックに基づき、 その記録の一部を保持または提示します。

出力 検証と利用
証拠 ZIP 正規化されたイベント、署名付きマニフェスト、カバレッジ、保管記録、添付ファイル、および利用可能な外部レシート。アーカイブとその選択された取得モードを確認してください。
ASiC-Eコンテナ ETSI ASiC-Eコンテナ(EN 319 162-1)として、mimetypeエントリとMETA-INF/ASiCManifest.xmlを含む証拠ZIPファイル。これは、ワークスペース独自の証明書を用いてレベルB-BでCAdES署名されており、タイムスタンプが有効な場合はレベルB-Tで署名される。 EU DSS などのバリデータは、形式と整合性をチェックし、証明書が自己発行であるため、信頼アンカーがないことを報告します。デフォルト設定の EU DSS 6.3 は、1000 ファイルを超えるコンテナを拒否します(「Too many files detected」)。 verify.pyは、Ed25519マニフェストおよびリストされたすべてのファイル、META-INF/ASiCManifest.xml内のSHA-256値、ならびに追加されたASiCManifestNNN.xmlまたはASiCEvidenceRecordManifest.xml内のSHA-256値をチェックし、これらいずれにも含まれていないMETA-INF/エントリがある場合は失敗します。CAdES署名はチェックせず、その旨を明示します。
HTMLおよびJSONレポート ソース参照付きの個別に封印されたビューは、ZIPマニフェストにも記載されています。それらの記録されたカウントは、ジャーナルイベントの種類を要約したものです。
PDFレポート Ed25519のシールに加え、バイト範囲「B-B」、またはタイムスタンプ機能が有効な場合は「B-T」に対して、PAdESベースラインPDF署名が付与されています。TgWitness検証ツールは、信頼されたEd25519鍵を使用します。閲覧者側の証明書信頼性の表示は、これとは別の検証です。
CSV ZIPマニフェストの対象となるスプレッドシートビュー。数式のエスケープ処理によりスプレッドシートの利用が保護され、元の署名付きテキストはジャーナルに残ります。
JSONL 署名付きイベントレコードには、添付ファイルへの参照が含まれます。証拠用ZIPファイルには、保存された添付ファイルのバイトデータも追加で含まれています。
チャットのエクスポートおよびデスクトップ対応ビュー 履歴の取得および利用可能な管理ログ記録、要求されたレンダリングおよび署名付きアーカイブ。ライブモニタリングの保存バージョンは、別の取得パスとなります。
メディアおよびハッシュのみのレコード 保存されたバイトは、SHA-256およびメッセージ参照と照合されます。ハッシュのみの取得では、ファイルのバイトとの後の比較のために、利用可能なハッシュメタデータが保持されます。
STIX/MISPおよび人物プロファイル ソースにリンクされた抽出された観測結果、アカウントID、および分析による一致。プロファイルの署名とレコードのハッシュは、元の証拠と照合可能です。アバターキャッシュの出所は別途ラベル付けされています。
引き継ぎ要約 署名付き開示ルール、変更されていないレコード、および元のハッシュ/署名を保持したマーク付き最小化レコード。非開示フィールドを必要とする比較には、保持されたオリジナルを使用してください。
ウィットネスおよびタイムレシート 以前のジャーナルの境界、連続性、および個々の検証済み時刻の主張。これらは、取得およびアーカイブのチェックに付随するものです。
パスワードで保護された配信 転送中に封入されたパッケージを保護します。.tgwpwは、認証付き最終レコードを含むAES-GCM認証付き暗号化を使用します。封入されたジャーナルは、その署名と取得レシートを保持します。

印刷物またはスクリーンショットは、署名付き資料の提示物です。そのレポート ID、鍵のフィンガープリント、およびQR参照情報は、検証のために元のファイルを見つけるのに役立ちます。 保管宣言には、指定された検査官および転送情報が記録されます。 検証結果および取得受領書は、個別の証拠として保持されます。

外部署名#

署名は、TgWitnessが決して保持しない鍵、例えば調査員の 適格電子署名や組織の印鑑などからも生成されることがあります。エクスポートに関しては、 パスワードなしの事前作成済みエクスポートに対する外部署名により、署名対象のバイトデータが渡されます。これは、 META-INF/ASiCManifestNNN.xml ASiC-Eコンテナの場合は各ファイルのSHA-256ハッシュを含むリスト、 あるいはZIPファイルの場合はエクスポートの manifest.json 。署名者は、CMS(CAdES)を .p7sを、コンテンツが分離された状態、または埋め込まれた状態で返します。

TgWitness は、署名が正確にそれらのバイトをカバーしていることを確認し、 署名者の証明書(RSA PKCS#1 v1.5、RSASSA-PSS、ECDSA、Ed25519、Ed448)を用いて検証を行います。 チェーンの 検証は、オペレーターが提供するルート証明書に対してのみ行われます。失効状況、信頼済み リスト、および適格ステータスは検証されません。パネルには、署名ごとに以下の状態が表示されます: 署名待ち、添付済み(未検証)、検証済み、アルゴリズムがサポートされていない、 署名が無効、署名されたバイトが一致しない、または証明書が指定された ルートにチェーンされていない。バイトが配布された後にエクスポート を変更すると、そのすべての署名の状態が「署名されたバイトが一致しない」に設定されます。

「署名付きでダウンロード」を選択すると、署名とそのマニフェストが META-INF ASiC-Eコンテナ内に配置します。ZIPファイルの場合は、変更されていないZIPファイルと、 .p7s ファイル、および SIGNATURES.txt を外部のZIPに格納します。無効な署名や、他のバイトの上に重ねられた署名は 除外されます。TgWitnessが検証できないアルゴリズムの署名が含まれている場合、 パネルにはその状態が表示されます。これは SIGNATURES.txt ZIPの場合と同様に、その状態がパネルに表示されます。

署名入りチャットの画像#

画像プレビュー内の署名付きZIPをダウンロードすると、PNG形式のページが保存され、 pages.sig.json さらに README.txt。各ページの末尾には、そのページに表示されているジャーナルレコード番号、チャット内容、 レンダリング時刻、ワークスペースキーのフィンガープリント、およびそれを検証するコマンドが記載されています。パネルは 各ページのSHA-256とレコード番号のみを送信し、サーバーはそれらのレコードが そのチャットに属することを確認した上で、ステートメントに署名し(tgwitness-image-attestation-v1)に ワークスペースキーで署名し、その署名処理をジャーナルに記録します。 export.image_attested.

python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip

検証者は署名を検証し、すべてのPNGを署名済みのページと照合し、 鍵のフィンガープリントを報告します。 --fingerprint 署名者を、送信者から独立して取得した フィンガープリントと比較します。 --evidence 同じワークスペースの署名付き証拠ZIPを読み込み、 画像のすべてのレコードが同じハッシュ値で存在することを要求します。ピクセルの変更、 記述の変更、または別の鍵が検出された場合、検証は失敗します。画像には、 TgWitness独自のレイアウトで保存されたレコードが表示されており、Telegramが誰かに表示した内容は表示されません。

チャットエクスポートの比較#

独立して保持されている署名者のフィンガープリントを用いて、署名済みのチャットエクスポート ZIP ファイルを 2 つ検証および比較してください:

python -m tgwitness.verify first.zip --compare second.zip \
  --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256

--require および --require-tier は、--compare と併用できません。各アーカイブの必要な プロファイルについては、それぞれの検証機能で確認してください。

両方のアーカイブに同じ数値のアカウントIDおよびチャットIDが記録されている場合、レコードは メッセージIDによってペアになります。「変更なし」とは、保存されたJSONレコード全体が一致することを意味します。 全文、作成者、日付、返信先、ネストされたメタデータ、および不明なフィールドがすべて 含まれます。JSONオブジェクトのキーの順序は重要ではありませんが、欠落しているフィールド、null値、値の型、 および配列の順序は重要です。300文字のプレビューは表示用のみです。 変更されたエントリは、 そのプレビューでは確認できない変更も含め、異なるトップレベルのchanged_fieldsとして指定されます。 メッセージIDが重複している場合、照合時に互いに上書きされるのではなく、拒否されます。

差異とは、表示名の変更、閲覧回数、コレクションの注釈、または その他の観測メタデータなどです。Telegramでの編集は独自の編集イベントとして表示され、各 アーカイブの検証結果により、そのアーカイブが完全であるかどうかが示されます。解析されていないレコードは 比較対象に残り、保存された表現に基づいて比較されます。

アカウントやチャットの識別子が異なる場合や欠落している場合、本ツールは送信者、全文、ファイルハッシュ、メディアタイプ、および5秒の 時間許容範囲を用いて候補となる 対応関係を見つけ出し、それらを「Unchanged(変更なし)」ではなく「Matched(一致)」として報告します。 解析されていない レコードは未一致のままとなります。ペアになったレコード間の相違点は、changedに一覧表示され、 コンテンツモードの場合も含まれます。--jsonオプションを指定すると、matchedは候補となるペアの数を、 unchangedは保存された完全なレコードが等しいペアの数をカウントします。 既存のchanged_fieldsおよび整数型のunchanged出力は、 以前の比較結果との互換性を維持しています。アーカイブ形式および署名検証については変更ありません。

調査の引き継ぎ#

  1. ケース参照番号、担当者、Telegramの数値アカウントID、選択された ソース、収集ポリシー、および収集期間をケースノートに記録してください。TgWitnessは 観察結果を保存し、 Case Boardにおけるソースにリンクされたメモや収集データをサポートします。移管および保管記録は、ケース 資料とともに保管してください。 実際の受入手順を用いて、意図した収集設定を確認してください。
  2. ワークスペースの公開鍵のフィンガープリントを、そのエクスポート内容を信頼する前に、 個別に保持しておくこと。エビデンスモードをオン(デフォルト)に保ち、チェックポイントが RFC 3161 および OpenTimestamps のレシートを受け取れるようにすること。収集中は、署名済みのチェックポイントをコレクターの外部に 保存すること。中断やアカウントの可視性の制限を記録すること。
  3. 署名付きZIPファイルをエクスポートし、署名付き実行レシートを保管してください。エクスポート対象のジャーナルの境界点、 またはその手前の地点でチェックポイントを使用してください。それより後のチェックポイントでは、 それ以前のエクスポートが「短すぎる」として正しく拒否される場合があります。エクスポートには、パネルフィルターの設定にかかわらず、 ワークスペースのジャーナル全体が含まれます。共有する前に内容を必ず確認してください。
  4. 受信者には、信頼できる検証ツールのコピー、 別途提供されたフィンガープリント、および個別に取得したタイムスタンプ認証機関のルート 証明書を使用して、ZIPファイルの検証を行わせてください。Python 環境が有効な信頼できるチェックアウト環境から:

    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence

    フィンガープリントと最後のレコードの検証済みタイムスタンプは、証拠としての 最低要件を満たしています。そうでない場合、--require evidenceはコード2で終了します。チェックポイントは、 コレクターの鍵で署名されているため、裏付けとなる検証です。出力は、両方の入力が 指定され、受け入れられた場合に、key_pinned: trueおよびcheckpoint_checked: trueを報告します。検証結果を保持してください。

    For a handover requiring the final exported record to be witnessed, use
    `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`.
    This refuses an export with an unwitnessed tail. Add
    `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the
    witness posts as external time. See the
    [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).
    
    1. アーカイブのSHA-256、エクスポート境界、転送日、送信者、および 受信者を保管記録に記録してください。元のパッケージはそのまま保持し、 コピーを基に作業を行ってください。アプリケーションのプライベートデータ ディレクトリ(アカウントセッションや署名用秘密鍵も含まれる)ではなく、証拠ファイルを共有してください。 転送には、パスワードで保護されたAES-256 ZIP、またはより強固な.tgwpw コンテナを選択してください。 ZIPはWinZipの低コストなパスワード導出方式を使用するため、長いランダムな パスフレーズを使用してください。.tgwpwはscryptとAES-256-GCMを使用し、スタンドアロンの 検証ツールであるunseal-passwordコマンドで開きます。パスワードは保存されず、 機密性の保護のみを目的としています。受信者は アーカイブを復号し、内部の署名付きエクスポートが変更されていないことを検証します。
    2. 証拠モード以外でチェックポイントにタイムスタンプを付与するには、 RFC 3161の手順に従い、リクエスト、チェックポイント、信頼された CA情報、および検証済みの認証機関の応答を保持してください。リクエストの準備だけでは タイムスタンプは取得できません。

.tgwpwについては、独自に入手した検証ツールを使用し、元の拡張子を保持した新しい出力ファイルを選択してください: python verify.py unseal-password export.tgwpw --out evidence.zip。 コマンドはパスワードの入力を求めますが、--password-stdinオプションを使用すると、自動化のために1行を読み取ります。 既存のファイルを上書きすることは決してなく、すべてのレコードの認証が完了した後にのみ平文を公開します。 その後、復号化されたファイルに対して通常の署名検証を実行してください。 このコンテナは scrypt (N=131072、r=8、p=1、16 バイトのソルト、約 128 MiB の RAM) および AES-256-GCM(1 MiB のレコードと認証済み最終レコード)を使用しています。暗号化された メタデータレコードには内部ファイル名が保存されているため、ダウンロードしたコンテナは名前を変更可能です。

検証が成功すると、信頼されたコレクター キーおよび保持された境界に対する完全性が確立されます。実施されたチェックに関する 信頼の前提条件および検証結果については、検証範囲を参照してください。

引き継ぎ要約#

署名付きZIPファイルには、ワークスペースのログ全体が含まれています。裁判所、弁護士、または虐待相談窓口が 一部のチャット、特定の期間、または特定の参加者だけが必要な場合、「エクスポート」→「引き渡し用抽出」により、選択された開示ルールに従って最小限の コピー(tgwitness-handover-v1)が作成されます。 オペレーターは目的を明記し、チャット、任意の期間(UTC)、 抽出対象となる人物、その他の人物への対応(表示、仮名 P01、 P02…、あるいは除外)の扱い、どのメッセージ本文を残すか、どの添付ファイルやプロフィール写真を含めるか、そして 本文中の電話番号やメールアドレスをマスキングするかどうかを指定します。 目的およびこれらのルールは、 署名付きマニフェストおよびレポートに記載されます。ジャーナルには、handover.exportedが、 それを作成したアクセス情報とファイルのSHA-256(内容そのものではありません)とともに記録されます。

verify.pyは、抽出データを2つの方法で検証します。変更なしと表示されたレコードは完全に検証されます。具体的には、 その内容とハッシュ値、Ed25519署名、および含まれる先行レコードへのリンクが照合されます。 縮小されたレコードには元のハッシュと署名が保持されるため、署名の検証は可能ですが、 非表示にされたフィールドはそこから再計算することはできません。レコードには非表示にされた項目が明記され、レポート でマークされます。 アカウント全体のサービス記録(開始・停止、カバレッジの空白期間、接続・ネットワーク・ストレージに関する通知、 スコープおよび設定の変更)には、その種類ごとに指定されたフィールドのみが保持されます。これらの記録に含まれるチャットリストは、選択された チャットに限定され、その合計数が再集計されます。また、選択範囲外のチャットにおけるライブプローブの空白期間がある場合、そのチャット、メッセージ 数、および証人アカウントは除外されます。選択されたプローブチャット内では、全員が公開されているか、または選択された人物のいずれかである場合を除き、 証人アカウントはその仮名に置き換えられます。 マニフェストには、ジャーナルの長さとヘッダー、およびその ヘッダーに対する収集者の署名が記載され、除外されたレコード数がカウントされます。coverage.jsonには、選択されたチャットが記述されています。新しい抽出データには、 proofs.jsonlも含まれます。これは、含まれるすべてのレコードおよびジャーナルのヘッダーについて、 レコードの元のハッシュから、署名付きマニフェストで指定されたジャーナルのルートまでのマークルパスです。 verify.pyは各 パスを検証するため、完全なジャーナルがなくても、すべてのレコードが同じ長さ・ヘッダーを持つ同一のジャーナルに属していることが確認できます。 100件のメッセージを含む抽出データの場合、ジャーナルのサイズにかかわらず、検証には約1秒しかかかりません。 --range=CHAT:FROM-TOを指定すると、そのチャットのFROMからTOまでのメッセージが抽出に含まれているか を追加で確認し、それらについてチェックしたレコード数を報告します。ファイル名内の 名前は検出されません。共有する前に最終的なファイルを確認してください。自由記述、ファイル名、および選択された 添付ファイルから、依然として個人を特定できる可能性があります。署名済みのZIPファイル全体は保管しておいてください。抽出は情報開示であり、代替物ではありません。

読みやすいレポート#

署名付き証拠、引き渡しデータ、およびチャットの ZIP ファイルには、読み取り可能な HTML および JSON 形式のレポートに加え、 必要なフォントが利用可能な場合は、選択されたレポート言語の PDF も含まれます。各 レポートはワークスペースの Ed25519 鍵で封印されており、個別に検証が可能です: python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]。

  • report.html / chat.html:シールステートメント(tgwitness-report-seal-v1)はファイルを閉じ、 それ以前のすべてのバイトのSHA-256に署名します。長いジャーナルやチャットは、 設定可能なサイズ(レポート設定、500~100,000レコード、デフォルトは5,000)の 部分に分割されます: records/records-0001.htmlまたはmessages/messages-0001.htmlは、それぞれその番号、範囲、 および合計が記載され、署名付きマニフェストにはSHA-256と共にリストされます。コレクターのハートビートの一連の記録は、 レポート設定で個別に表示するように指定されていない限り、1行として表示されます。
  • report.json(tgwitness-report-json-v1、キー format、report、seal):このシールは、report の正規な JSON である SHA-256 に署名するため、事実関係を各システムのシステムやスクリプトで読み取ることができ、 署名付きファイルの完全性を保ったまま、データ保護のための選択を行うことが可能になります。
  • report.pdf / chat.pdf: 印刷および保管用の正式な文書であり、同じ バイト位置に2回署名されており、署名値を除くファイル全体(/ByteRange)を除くファイル全体。標準的なPDF署名は PAdESベースライン(ETSI EN 319 142-1、 /SubFilter /ETSI.CAdES.detached:SHA-256および ECDSA P-256を用いたCMS、署名証明書v2、CMS署名時刻なし。主張される時刻は /M)で、レベル B-B、またはB-T。タイムスタンプ機能が有効な場合、CMS内にRFC 3161準拠の署名タイムスタンプが含まれ、Telegram外部からのリクエストに対しては タイムスタンプ認証機関がルート経由で応答する。ワークスペースのボールトに保管された 自己発行の文書署名証明書を使用し、そのサブジェクトシリアル 番号はEd25519キーのフィンガープリントである。 Ed25519 シールは、CMS 内で 未署名属性として 2.25.240684792623320047764573196045913242332 としてCMS内で伝送され、 証明書のSHA-256ハッシュを "content": "pdf-byte-range"で指定されるため、Ed25519キーが 証明書の正当性を保証します。この証明書は認定証明書ではありません。PDFリーダーでは、証明書が信頼されるようになるまで、署名は有効と表示されますが、 署名者は「不明」または「信頼できない」と表示されます。代わりにEd25519の フィンガープリントを確認してください。中国語、日本語、韓国語のPDFには、サーバー上(または TGWITNESS_FONT_DIR)にフォントが必要です。フォントがない場合、ZIPファイルにはHTMLおよびJSONレポートのみが 含まれます。
  • report.en.html、report.en.pdf / chat.en.html、chat.en.pdf:レポートの言語が英語でない場合の、同じレポートの英語の原本です。同じ方法で封印・署名され、署名付きマニフェストの report.original に記載されます。選択した言語のレポートは、英語の原本を認証翻訳または宣誓翻訳とともに提出するよう勧める注記で始まります。裁判所向けレポートの翻訳を参照してください。

チャンネルまたはスーパーグループ内では、Telegram がメッセージ1、2、3…を順に番号付けします。チャットのエクスポートには、 最初と最後の番号、存在するメッセージの数、および欠落している番号の連続範囲が message-ids.json 、マニフェスト、chat.json ヘッダーに一覧表示され、トランスクリプト内の 各欠落箇所がマークされます。 verify.py は、chat.json から番号を再カウントします。欠落した番号とは、Telegram が返さなかったメッセージ(エクスポート前に削除されたもの、またはそのアカウントからは表示されないもの)を指します。プライベートチャットや 基本グループでは、番号はアカウントのすべてのチャットで共有されるため、欠落はカウントされません。

履歴を読み込んだ後、エクスポート処理では、欠落しているすべての番号について、Telegramに再度番号ごとにリクエストを行います(channels.getMessages、最初のメッセージの下にある1,000件を含め最大10,000件まで、それ以上の場合はすべての空白部分に均等に分散して)Telegramに再リクエストします。結果は message-ids.json およびレポートに記録されます。空の応答は、再確認時点でその番号がこのアカウントから利用できないことを記録しますが、その原因は特定されません。再確認時に返されたメッセージはエクスポートに追加され、マークされます。 found_on_recheck.

監視ワークスペースで、チャットのメッセージが削除されたり、再確認時に欠落していたり、編集されたりしたことが検出された場合、チャットエクスポートには journal-changes.jsonl:それらのジャーナルレコード、保存されたすべてのバージョン、および通知を追加します。それぞれに、ジャーナルで受け取ったハッシュとEd25519署名が含まれます。 verify.py 各レコードのハッシュを再計算し、エクスポートキーに対して署名を検証し、その数を署名付きマニフェストと比較します。証拠エクスポートには、完全なハッシュチェーンが含まれます。レポートでは、これらのメッセージが「削除」および「以前のバージョン」の項目に一覧表示されます。

すべてのレポートは概要で始まります。1段落の後、資料が示す内容と記録に含まれるものが続きます。 ページ固有のシールスタンプは、ブラウザがページ自体ではなくシールの 署名を検証した際に琥珀色に変わります。ブラウザはページに独自のバイト列を付与することはありません。 それが緑色に変わるのは、 読者がページ末尾の検証欄にファイルをドロップし、すべてのバイトが一致した場合、かつ 表示されているページがそのファイルである場合に限られる。そうでない場合は赤色になる。

各レポートでは、プログラム名を正確に明記してください。具体的には、コレクターがチェックアウトから実行された際のgitコミット、または インストーラーが設定した TGWITNESS_COMMIT、およびそのソースファイルのSHA-256(source_tree_sha256、 パス → すべてのSHA-256値の正規化されたJSON .py, .js, .css, .html および .svg ファイルのSHA-256)を明記する。これらは、ファイルが変更されていない限り、そのコミットをチェックアウトすることで再現可能である。Telegram クライアントは、そのライブラリ、APIレイヤー、およびデータセンターとともに指定される。観測の開始時、およびチャットの エクスポートの開始・終了時、コレクターはTelegramに時刻(updates.getState、整数 秒)をTelegramに問い合わせ、Telegramの時刻からコレクターの時計の時刻を差し引いた値を、 往復通信による誤差を含めて記録します。レポートでは、これらの測定値が「Chain of custody」の下に表示されます。チャットのエクスポートでは、メッセージの日付とは別に、 履歴を読み込んだ時刻も記録されます。

オフラインレポートビューアおよびアーカイブガイド#

chat.htmlまたはreport.htmlを開く前に、ZIPファイルを完全に解凍してください。ビューアでは、サーバーを介さずに検索、 フィルタ、参加者、インジケーター、記録の詳細、およびJSON/CSVの選択が可能です。 viewer/とmedia/はレポートの隣に保管してください。選択内容は派生データです。verify.py SELECTION.json --evidence ARCHIVE.zipを使用して、署名付きアーカイブと比較してください。 検証ツールは、レポート ID、署名キー、アーカイブの境界、および選択されたすべての項目をチェックします。編集済み、 欠落、または重複している項目は失敗となります。選択に関する注記および作成時刻は、署名されていないメタデータとして残ります。

メッセージ番号の欠番は、フィルタリングされていない完全な昇順のチャットフィードにおいてのみ表示されます。 カテゴリを非表示にしたり、データチャンクの読み込みに失敗したりしても、省略された行がメッセージの欠落の 証拠となってはなりません。検索ハイライトは、HTMLによるエスケープ処理前のプレーンテキストに対して行われ、リテラルなマークアップは保持されます。

ブラウザは、マニフェストの署名、レポートIDおよびキー、ならびにリストされているすべてのファイルハッシュをチェックします。また、 不明確または形式不備のZIP構造、重複するファイル名、安全でないパスを拒否し、ファイルサイズは 256 MiB、宣言された総容量は4 GiBを上限とします。これより大きなアーカイブについては、スタンドアロンの検証ツールを使用してください。 このブラウザによるチェックは、ジャーナルチェーンやデータセマンティクスに関する検証ツールのチェックを補完するものです。

README.txtには、スタートガイド、ファイル一覧(言語対応済み)、検証手順、およびデータ 形式に関する注記がレポートの言語で記載されており、その後に完全な英語版ガイドが続きます。 SHA256SUMSは、 それ自体、manifest.json、およびmanifest.sigを除く、そこに記載されたファイルを網羅しています。署名付きマニフェストは SHA256SUMSも対象としています。元のZIPファイルは変更せず、作業用ファイルは 解凍したフォルダの外に保存してください。PDFのレポートには、セクションごとのブックマークと、後半のページにケース/レポートの識別情報が含まれています。

エクスポート時のチャット内容#

チャットのエクスポートには、エクスポート開始時点でTelegramがそのチャットについて記録した内容が含まれます:Telegram自身の ラベル(scam、fake、理由付きのrestricted、verified)、ユーザー名、説明、メンバー 数および管理者数、関連するディスカッション、コンテンツ保護、新規メンバーが過去の メッセージを閲覧できるかどうか、およびこのアカウントがどのメッセージから履歴を閲覧できるか(available_min_id)、 チャットが作成された場合の メッセージ1の日付、およびチャットの写真に関するSHA-256(media/に保存)。 また、エクスポート元アカウントのチャット内での位置情報(役割、参加日、招待者、および 管理者の場合はその権限)も記録されます。Telegramが拒否したリクエストについては、代わりにその名称が記載されます。

エクスポート元アカウントが管理者である場合、エクスポート処理はチャットの管理者ログ(Telegramは約 48時間保持)を読み取り、admin-log.jsonに書き込みます。これには、削除および編集の内容、 実行アカウント、およびソースアクションの日付が含まれます。これらのエントリは、ライブジャーナルの キャプチャされたバージョンおよび削除受信記録を補完するものです。

指標#

レポート一覧およびアーカイブには、indicators.csv 、indicators.stix.json (STIX 2.1 ) およびindicators.misp.json (MISP イベント)として、記録されたメッセージ内で不正利用対応窓口が対応可能な項目が記載されています: リンクおよびドメイン(テキストの背後に隠されているもの、ボタン内、リンクのプレビュー内を含む)、仮想通貨 アドレス、Telegram のユーザー名および招待リンク、電話番号、メールアドレス、保存された画像。 ビットコイン、ライトコイン、ドージコイン、TRONのアドレスは、base58チェックサムが有効な場合にのみリストされ、 segwitアドレスはbech32またはbech32mチェックサムが有効な場合、TONアドレスはCRCが 有効な場合にリストされます。EVMおよびSolanaアドレスは「未確認」としてマークされます。 画像にはSHA-256 と知覚的 ハッシュ(dHash、64ビット)が含まれており、再圧縮またはリサイズされたコピーでもほぼ変化しません。レポートは、 誤って開かれないようにインジケーターを記述します(hxxps[://]example[.]com )。ファイルは 元の値を保持します。 すべてのインジケーターは「不明」かつ「自動検出対象外」としてマークされます(STIX 、 indicator_types: unknown 、MISP 、to_ids: false 、自社組織への配布):リストに 掲載されていることは、そのメッセージに含まれていたことを示すものであり、悪意があることを示すものではありません。テキストに表示されているアドレスと 実際に開くアドレスが異なるリンクは、レポート内でマークされます。

PDFレポートの末尾には、検査官が手書きで署名する宣言文、公証人または 裁判所鑑定人向けのチェックリスト、およびレポートID、鍵のフィンガープリント、 そして権威あるデータのSHA-256が記載されたQRコード(1ページ目にも記載)が含まれており、これにより印刷物を元のアーカイブに遡って確認できるようになっています。

イベントの正規化#

ハッシュの入力は、正確に以下のフィールドで構成されています:

seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash

UTF-8 形式の Python 互換 JSON を使用してシリアライズし、オブジェクトのキーはソート済み、ASCII エスケープなし、無意味な空白なし、NaN/無限大なしとします:

json.dumps(value, ensure_ascii=False, sort_keys=True,
           separators=(",", ":"), allow_nan=False).encode("utf-8")

これらのバイトのSHA-256ハッシュがイベントハッシュとなります。署名は、 32バイトの生のハッシュ値に対してEd25519を適用し、その後Base64エンコードされたものです。最初のprevious_hashは64個のゼロで構成されます。 シーケンス番号は1から始まり、1ずつ増加します。運用上の イベントを含むすべてのイベントは、1つのチェーンを共有します。重複配信の抑制機能はありません。つまり、繰り返して 観測されたものは、個別の受信記録であり、個別のTelegramアクションの主張ではありません。

Telegramの生の日付はISO文字列です。バイナリフィールドは、 bytes_base64を含むオブジェクトになります。メッセージ本文、エンティティ、メディア記述子、返信メタデータ、リアクション、 およびサービスアクションは、指定されている場合、生のメッセージメタデータに保持されます。ライブ メッセージは、それを配信したTelegramの更新情報も transport_update; また、 そのアップデートが raw、その message フィールドは {"same_as": "raw"} となり、2つ目のコピーは生成されません。

observed_at は、コレクターがレコードを書き込んだ時点のUTC時刻です。 source_at は、 そのTelegramイベントによって提供された日付です。ライブ更新の処理中に書き込まれたレコードには、 payload.received_at、更新がコレクターに到達したUTC時刻、および payload.processing_delay_msが追加されます。ライブ編集では提供された編集日時が保持され、履歴 スナップショットではメッセージの日時に現在の観測時刻が加算され、通常の 削除通知では送信元の日時がNULLの状態で受信時刻が記録されます。管理ログ エントリでは、提供されたアクションの日時が別途保持されます。受信順序と送信元 イベントの順序は別々のタイムラインであり、時計による観測時刻と外部からの受信時刻を 比較することが可能です。

アクターのセマンティクス#

帰属情報はイベントの発生源に従います。message.new.actor_idおよび message.edited.payload.sender_idはメッセージの送信者を保持します。通常の message.deleted通知にはメッセージIDが含まれ、アクターフィールドはnullとなります。 利用可能な管理ログエントリには、指定されたアクション、アクター、日付が含まれます。 メンバーシップサービスのメッセージは送信者とアクションタイプを保持し、生の参加者更新情報は 指定されたactor_idを保持し、リアクションのスナップショットは指定された カウントと可視IDを保持します。これらの記録は、キャプチャされた バージョンおよびパネル操作のレシートと併せて参照してください。

プライベートチャットおよび通常のグループの削除通知には、メッセージIDのみが含まれます。 これらのチャットはアカウント全体で共通のIDシーケンスを共有しているため、IDは このアカウントの単一のメッセージを識別します。そのIDを持つメッセージが以前にこのジャーナルに保存されていた場合、 削除は、メソッド名を指定するpayload.chat_resolutionを持つmessage.deletedとして、 そのチャットに記録されます。一度も保存されたことのないIDは、deletion.unscopedとして保持されます。これは、 チャットとの関連付けが行われていない実際の削除通知です。 これは、 利用できないクエリ結果を記録するmessage.missing_on_recheckや、 保存されたメッセージIDの欠落とは異なります。チャンネルやスーパーグループはチャットごとにメッセージを番号付けしており、 この方法では照合されることはありません。削除されたメッセージが観測対象のアカウントによって送信された場合、 payload.deleted_message_was_outgoingはtrueとなりますが、削除者は依然として指定されません。

スコープ外の通知は、一致するチャットが 現在の観測スコープ外にあるか、一意の一致がない可能性があるため、独自のラベルを保持します。「不在の再確認」は、レポートの集計、フィルター、および ラベルにおいて、削除通知とは 別個の観測として扱われます。後の復旧により、現在の「欠落」状態はクリアされますが、 署名付き履歴内の以前の失敗したチェックは保持されます。削除通知は、引き続き 別個のイベントタイプとして扱われます。

1つの通知から同じチャットに紐づく複数のIDは、その数にかかわらず deletion.batchとしてグループ化され、メッセージIDはTelegramが 送信したままの形式で、またそのアカウントが送信したメッセージ数もそのまま反映されます。Telegramの通知には メッセージの一覧が表示されます。また、チャットの管理者ログには、そのアカウントが 閲覧できる場所に、対応した管理者の名前が記載されます。 リンク(message.deletion_attributed)は、どちらが先に到着したかによって作成されます。 削除通知が記録された時点で、削除通知よりも前に管理者ログのエントリを確認したポーリングが 照合されます。

対象範囲:連続性、欠落、および検出されなかったID#

署名付きZIPファイルにはすべてcoverage.jsonが含まれており、HTMLレポートは同じ要約で始まります。また、 verify.pyはファイルをそのまま信頼するのではなく、events.jsonlから要約を再計算します:

  • XからYまで継続的に観測されます。期間はobservation.startedで始まり、 一時停止、停止、Telegram接続の切断、サインアウト、正常な停止を伴わないプロセスの起動、 または観測中に3分以上記録がない場合に終了します (ハートビートは1分ごとに書き込まれるため、記録がない状態は、プロセスが停止、フリーズ、または コンピュータがスリープ状態になったことを意味します)。 [More tools] → [Parameters] でハートビート間隔が変更されると、各ハートビートが その変更を記録し、許容される無記録時間は3つの間隔分となり、3分を下回ることはありません。
  • 「ギャップ」には、各期間間の時間と理由が記載されています。最後の 記録時点で未解決のギャップは、not_resumed_by_last_record とマークされます。
  • メッセージ ID は観測対象外です。チャットごとにメッセージ数をカウントするチャンネルやスーパーグループの場合、 観測された ID の間に欠落している ID は範囲として一覧表示されます。これらは 「観測されなかった(削除された、未配信、または保存された履歴の範囲外)」として報告され、決して 「削除された」とは報告されません。プライベートチャットや通常のグループはアカウント全体で共通のシーケンスを共有するため、 そのようなチャット内の欠落は意味を持たず、そこには一覧表示されません。
  • チャット単位のデータ欠落通知(例えば、Telegramが特定の チャンネルにおいてデータ差分の復元を要求する場合など)は「メモ」としてカウントされ、全体的な記録範囲を中断することはありません。
  • Session records. Windows in which Telegram's update counter grew while no update reached this session (updates_diverted), this session left Telegram's session list while its connection kept working (session_revoked_externally), or a witness probe's answer arrived only from history (probe_ack_missed_live) are listed separately. The verifier also reports where the Telegram session key came from, other sessions signed in when observation started, sessions added during observation, Telegram security notices (777000), other sessions ended from the workspace, only-session periods, witness probe counts and phone call updates. See accounts. While strict chosen chats is on (scope.strict in observation.started), the session list (except while this is the only session, or when Telegram devices is on), security notices and phone call updates are not collected, so their absence says nothing, and a deletion is matched to a session check only if one ran in the 10 minutes before it.

更新シーケンス (pts)#

Telegramでは、メッセージ関連の更新情報を pts:アカウントごとに1つのシーケンス (プライベートチャットと基本グループをまとめて)と、各チャンネルまたはスーパーグループごとに1つのシーケンス。 コレクターは、欠落なく受信した各シーケンスを coverage.sequence レコードとして記録します。各レコードには、開始時刻と終了時刻 pts、各タイプの更新数、およびそれらが ライブでプッシュされたか、あるいは getDifference かによって返されたか。 getChannelDifferenceによって返されたかどうかの情報を含みます。区切りは coverage.gap レコードとして扱われ、 coverage.gap_closed 「 pts から、シーケンスが 再び完全になるまでの範囲を示します。

途切れることのない一連の記録から、Telegramがその一連の番号を付けたすべての更新が、 最初と最後の pts の間に、その連番の範囲に含まれるすべての更新が、この収集者のTelegramクライアントに届いたことを示しています。これは、 Telegramがこのアカウントに送信しなかったコンテンツや、最初に記録された pts以前の期間、あるいは収集者が記録しなかった連続区間については、何も示していません。 pts 記録された連続区間や差異のいずれも カバーしていない進捗は、途切れとして表示されます。

GET /api/continuity ある区間(since, until, chat_id)において、各 数列が連続しているかどうかを判定し、連続していない箇所とその理由を列挙する。 verify.py 「数列の連続性」の項にあるアーカイブの記録から、 同様の情報を出力する。

欠落しているメッセージ番号(gap_summary)#

For a reader's guide to this section and to observation periods and gaps, see Coverage and missing material.

プレビュー。 coverage.json → gap_summary Telegramが割り当てた番号のうち、この コレクターが検知しなかったものを計測します。Telegramは、チャンネルまたはスーパーグループごとに1回、また プライベートチャット、ボット、通常のグループを横断してアカウントごとに1回、メッセージに番号を割り当てます。2つの観測された メッセージの間に位置する番号は、観測されているか、欠落しているかのいずれかです。連続した範囲は、その範囲内で番号が割り当てられた すべてのメッセージが観測されたことを示す肯定的な記述となります。ギャップは、特定の主体や理由を示唆するものではありません。

分野 意味
status on、または「その他のツール」→「パラメータ」→「ギャップ分析」で無効化されている場合は off
parameters 結果を再現できるように、その結果を生み出したパラメータ
chats[] チャンネルまたはスーパーグループごとに1件のエントリとし、それぞれに個別の番号を付けること
account アカウント全体にわたるプライベートチャット、ボット、および通常のグループの履歴
status (シーケンスごと) applicable、または not_applicable で reason
observed_from, observed_to, span 最初に観測された番号、最後に観測された番号、および範囲のサイズ
observed, observed_without_content 観測値;削除記録または再確認記録からのみ判明している数値
missing, density, gap_ranges, largest_gap 観測されたことのない数値、範囲に占める割合、実行回数、最長の実行時間
clusters[] 記載漏れ: low, high, missing、および隣接する観測値 after / before およびその観測時刻
service_estimate 有効化されている場合のみ:観測された割合に基づいて、欠落している番号のうちサービスメッセージであるものと推定される数。決して以下から差し引かない: missing

有効性はジャーナルから導き出されるものであり、決して前提とされない:

  • チャンネルおよびスーパーグループは、チャット単位で計測され、選択したチャットのエクスポートデータにおいても同様です。 送信者が選択した記録に基づいて計測が行われます not_applicable.
  • アカウント全体のシーケンスは、 アカウント全体の収集が有効だった間に受信した最初のメッセージから最後のメッセージまでの間のみ測定され、プライベートチャット、ボット、通常の グループ、およびアカウント自身のメッセージがすべて含まれ、そのようなチャットは一切除外されません(scope.changed)。 「 deletion.unscoped 「count」と名付けられた数値は、内容なしで観測されたものとみなされます。選択したチャットのエクスポートや 引き渡しでは、これを測定することはできません。アカウント全体の収集が オフとオンに切り替えられた場合、その間に使用された数値にはギャップが生じるとの注記が表示されます。
  • サービスメッセージは固有の番号を持つジャーナル記録であるため、それ自体がギャップを埋めます。 オプションの推定値はあくまで文脈情報に過ぎません。

verify.py 再計算 gap_summary から events.jsonl 署名付き coverage.json メンバー内のパラメータ(古いアーカイブの場合はデフォルト値)を用いて再計算し、 カバレッジ概要にアカウント全体の行を出力します。アーカイブの get_capture_status(MCPおよびコマンドライン)は、あるアクセスが読み取れるチャットについて同じ測定値を返します。 ワークスペース全体をカバーするアクセスの場合のみ、アカウント全体のシーケンスが返されます。

1つのサービスメッセージに対する繰り返しの観測は1回としてカウントされ、アカウントサービスの推定値は 測定範囲内の数値のみを使用します。適用されるスコープは、アカウント全体の測定が有効になる前に、 アカウント自身のメッセージを明示的に保持しなければなりません。測定は その情報を含むレコードから開始されます。測定範囲は実行中の 観測をカバーし、その再開は記録されます。ライブアーカイブのクエリには、 データベーススキャンを含む時間制限があり、未完了の測定は「部分的」としてマークされます。

Telegramは、個別のメッセージIDシーケンスを文書化しています。 これらの番号は観測結果を記述するものであり、削除通知、再チェック、および管理ログ記録は、 Telegramが報告している場所に番号が存在しない理由を説明しています。

Telegramがアカウントの受け入れを停止すると、監視を終了するcoverage.gapレコードには cause(account_banned、account_frozen、account_deleted、session_duplicated、 session_revoked、session_expired、session_ended、またはnot_authorized)とTelegram エラーが含まれます。verify.pyは、その期間が終了する原因を指定します。

カバレッジは、記録された観測期間、中断、およびメッセージの結果を組み合わせたものです。 選択したチャット、期間、および添付ファイルポリシーと併せて評価し、 結果と記録されたギャップを再確認することで、アカウントの更新がどの程度完全に観測されたかがわかります。

プロデューサー#

証拠ZIPファイル、チャットエクスポート、ウィットネス・ジャーナル、および ユーザープロファイルファイルの署名付きマニフェストには、producer(ソフトウェア、バージョン、プロジェクト(PhishDestroy)、 ホームページ、ソースリポジトリ)が含まれています。HTMLレポートおよび検証ツールには、この署名付き プロデューサーレコードが表示されます。ソースファイルのハッシュ値により、記録されたソースツリーが特定され、 信頼できるチェックアウトとの比較が行われます。 実行の来歴は、 GitHubの取得証明または Intel TDX測定(有効になっている場合)によって個別に確認されます。プロデューサーフィールドが 存在する以前に作成されたアーカイブは引き続きサポートされており、レガシーレコードとして識別されます。

各observation.startedレコードには、観測を行ったTelegramクライアントの名称も記載されています。具体的には、そのapi_id (ハッシュ値は記載されません)、それが組み込みの公開ペアであるかオペレーター独自のアプリケーションであるか、 Telegramの接続リクエストで送信されたクライアントの説明、およびIPモードを含む接続 ルートの種類(プロキシアドレスやシークレットは含まれません)です。 レポートおよびcustody.jsonには、 記録された日時とともに、すべての異なるクライアントとルート、リストにないプロキシが応答しなかった時刻、 およびTelegramがサーバーのアドレスを検知した時刻が記載されています。これ以前に記録されたジャーナルにはその旨が記載されています。

人物プロフィール#

プロファイルファイル(tgwitness-dossier-v1、JSON)は、リクエストに応じて、 1つのチャットに関するジャーナルにすでに記録されているデータに基づいて生成されます。Telegramからデータを取得することはなく、プロファイルの内容が ジャーナルに書き込まれることもありません(プロファイルのオン/オフの切り替えはdossier.changedとして記録されます)。 メッセージが保存されているすべてのユーザーについて、名前とユーザー名の履歴、保存時点でのTelegramのフラグ (ボット、詐欺、偽アカウント、プレミアム、認証済み、制限付き、削除済み)、プロフィール 写真ID、ローカルのアバターキャッシュ内の類似アバターからのアバターのSHA-256および知覚ハッシュ(pHash、imagehash.phashと互換性あり)、 アクティビティ(最初のメッセージと最後のメッセージ、 メッセージ数、編集・削除されたシェア、UTC時間ごとのメッセージ)、誰が誰に返信したか、その人物が書き込みを行った 、その人物が書き込みを行った他のチャット、および言及されたウォレット(BTC、EVM、TRON、TON、LTC、 DOGE、XMR、SOL;Base58Checkアドレスはチェックサム検証済み)、電話番号、ユーザー名、 リンク(テキスト内に隠されたリンクを含む)などが含まれます。

各事実には、その出典となるジャーナル記録(seq)が記載されており、record_hashesには 参照された各記録のハッシュ値が格納されています。この記述は、ワークスペースキーを用いて署名されています:

python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip

署名を検証し、証拠エクスポート自体(署名、ハッシュチェーン、ファイル)を検証するとともに、 参照されているすべてのレコードが、同じワークスペースのそのエクスポート内に変更されずに存在することを確認します。アバターのハッシュは、ローカルキャッシュに由来するものとしてラベル付けされます (ジャーナルレコードではありません)。メンションはパターン一致であり、確認すべき手がかりです。 プロファイルはチャットごとに有効化され、パスワード付きのAES-256 ZIPとしてエクスポート可能で、 無効化された場合、またはチャットがソースから削除された場合に削除されます。

独立した証人#

ウィットネス・ジャーナル(tgwitness-witness-v1)およびそのチャンネル投稿は、 verify.py --witness … --channel … を使用した証拠エクスポートと照合されます。独立ウィットネスを参照してください。 公開アドレス https://t.me/s/… または https://telegram.me/s/… がある場合、検証者は Telegram から各投稿の日付を読み取り、エクスポートの先頭にある投稿の最も早い日付が 最後のレコードの外部時刻となります。その他のソースからの日付は、提供されたメタデータです。

マニフェストとチェックポイント#

manifest.json には、フォーマット、エクスポート日時、公開鍵、フィンガープリント、ジャーナルの 長さ、先頭ハッシュ、スコープ、プロデューサー、制限事項、および manifest.json と manifest.sig 自体を除く すべてのコンテンツメンバーの SHA-256 が含まれます。 manifest.sig は、正規化されたマニフェスト JSON に対する Base64 エンコードされた Ed25519 署名です。 検証ツールは、予期しないメンバーや欠落したメンバー、名前の重複、破損したファイル、 シーケンスやチェーンの破損、無効な署名、および指定されたチェックポイントとの不一致を拒否します。 アーカイブパスを抽出することはありません。宣言された非圧縮サイズの合計を4 GiBに制限します。 --max-gib Nオプションを使用すると、「More tools → Parameters」で制限値を引き上げることで、より大きなアーカイブを作成できます。

大規模なアーカイブは、複数のプロセスによって同時に検証されます。メンバーは並列でハッシュ化され、 最初の 5,000 レコードの検証後、各レコードの内容ハッシュと署名は ワーカープロセスによって検証される一方、メインプロセスはチェーン、カバレッジ、およびバインディングを 順に追跡します。 --jobs N はプロセス数を設定します。デフォルトでは auto はCPU 1つにつき1つ( 最大16)を使用し、 --jobs 1 すべてを1つのプロセス内に保持します。どちらの場合でも結果は同じであり、 変更は同じメッセージで拒否されます。保持された チェックポイントおよびタイムスタンプ・アンカーで指定された位置のハッシュは、その1回のパス中に保持されるため、各アンカーは ジャーナルを再度読み込むことなく比較されます。 32スレッドのコンピュータ上で、40万件のレコードを含む10.8 GBのアーカイブを処理した場合、 1つのプロセスでは58.9秒、4つのプロセスでは15.2秒、16つのプロセスでは8.4秒かかりました。レコードを 順序通りに1回走査することで、上限が設定されます。

インストール済みのTgWitnessのバージョン、またはレビュー済みのチェックアウトから検証を実行してください。 アーカイブに含まれるコピーはポータブルな使用に対応しています。実行する前に、そのコピーを 信頼できるインストール環境と照らし合わせて確認してください。

チェックポイントは、公開鍵、ジャーナルの長さ、ヘッダー ハッシュ、および作成時刻を含むステートメントに署名します。また、ワークスペースが 取得した最新のdrandラウンド(drand_anchor )も保持します。コレクターは、各定期的なチェックポイントの前に、ワークスペースの 外部ルートを経由してdrandリレーに問い合わせるため、IP隠し、プロキシ、および無効化された 外部ルートが適用され、チェックポイントの作成自体では外部への接続は一切行われません。 検証者は、 後のアーカイブに同じプレフィックスが含まれているかを確認できます。--checkpoint および--check-drand を使用すると、drandリレーと連携してそのラウンドを確認し、チェックポイントが そのラウンドの時刻より前に署名されていないことを報告します。このラウンドは保証レベルを変更しません。 チェックポイントを コレクターの外部に保持することで、後の検証ではアーカイブと、 それとは別に保持されている参照データを比較します。コレクターの鍵で署名されているため、 受信者がアーカイブよりも前に別のチャネルを通じて それを入手した場合にのみ、その記録がコレクターに紐付けられます。それ単体では、証拠としての最低要件を満たしません。

検証結果の読み取り#

検証ツールは、アーカイブの整合性、署名者のピンニング、および保証チェックについて 個別に報告します。有効な署名があるということは、そのバイトデータが署名されて以来 変更されていないことを示しています。オペレーターは、別の 通信経路を通じて、鍵のフィンガープリントを受信者に伝えます。 --fingerprint、アーカイブに破損がなければ、署名およびフォーマット チェックに合格し signer_pinned: false、最終行は EVIDENCE: minimum not met · missing: confirmed signer key.

固定された署名者と、証拠として最低限必要なものを要件とする自動ローカルアーカイブポリシーについては、 以下を参照してください:

python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence

受信者の信頼できるチャネルを通じて保持されたフィンガープリントを使用してください。信頼できる ウィットネスは、一貫性のある立会済みジャーナルを通じてコレクターをピン留めすることもできます。 --witness、--witness-fingerprint、および--require-witnessを指定してください。--strictは、 ピン留めされていない署名者に対してステータス2で終了します。また、--require-tierまたは--require evidenceの要件が満たされていない場合も ステータス2で終了します。--require evidenceには、--fingerprintおよび最後のレコードをカバーする 第三者からの外部時刻が必要です。 signer_pinned、requirements_met、および保証結果を確認してください。終了 コードのみを確認するのではなく。一方、Sealed acquisition は、その 証明検証ツールと承認済みポリシーを使用して、取得ダイジェストを認証します。

検証範囲#

検証では、アーカイブおよびその作成に使用された収集モードがチェックされます。 ケースに合致する信頼境界を持つモードを選択し、その検証用入力を保持してください。

収集モード 検証者が確認する内容 検証用入力データと信頼境界
ローカルワークスペース 署名、ハッシュチェーン、マニフェスト、および添付ファイルのバイトデータを記録する 受信者が保持するコレクターのフィンガープリントおよび第三者からの外部時刻:検証済みのRFC 3161またはOpenTimestampsのレシート、あるいはt.meから読み込まれたウィットネスの投稿。保持されているチェックポイントおよびウィットネスの記録は、検証を裏付けるものです。
独立したウィットネスを備えたローカルワークスペース アーカイブの整合性チェックに加え、ウィットネスが保持している以前のジャーナルプレフィックスとの整合性も確認する Witnessのフィンガープリントと記録。保管者の鍵管理記録が、Witness鍵を誰が保持しているかを示します。--channel https://t.me/s/…を使うと、Telegramが投稿に付けた日付が外部時刻になります
GitHub Actionsのキャプチャ アーカイブのダイジェスト、承認済みワークフローおよびコレクターのコミット、ホスト型ランナー、新しいセッション/キーの起源、および内部アーカイブの整合性に関する GitHub による証明 信頼できる検証者ポリシー、呼び出し元リポジトリ、および GitHub 認証バンドル。収集は固定されたワークフローの下で実行されます。
クラウド展開 プロバイダのライフサイクルおよびアクセス記録、ファイアウォールおよびCloudflareの状態、さらにコレクターの署名付き実行記録 プロバイダおよびCloudflareへの読み取り専用クエリ。個々のチェックの利用可否はプロバイダによって異なります。
Intel TDX 機密 VM 署名およびプラットフォームの状態を引用し、コレクターのステートメント、コンポーズ、OSの測定値と関連付ける Intelのトラストチェーンおよび想定される導入時の測定値。必要なすべてのTDXチェックの結果を保持すること。

「シールド取得」では、承認された収集者が、検証済みの環境内での認証済み Telegram接続を通じてデータを受信します。アテステーションによりアーカイブは その実行に紐付けられるため、検証の対象には取得プロセスだけでなく、その後のファイルの完全性も含まれます。 これは、承認されたコードおよび上記に記載されたプラットフォームの信頼チェーンに依存しています。 GitHubでのキャプチャ検証には、実行環境内で作成されたセッションが必要であり、 インポートされたセッションによるキャプチャは拒否されます。

実行レシートには、コレクターのバージョン、ファイルのハッシュ値、および起動時の設定が記録されます。GitHub の出所情報とTDX測定値により環境チェックが行われ、 検証レコードにはテスト対象の構成が特定されます。

メッセージの出所#

Telegramは、公式アプリを含むすべてのクライアントに対し、 MTProtoセッション内でメッセージを配信します。セッションの認証キーはTelegramの 固定サーバーキーに対してネゴシエーションされ、すべての更新データは そのキーの下で暗号化され、整合性チェックを経て受信されます。コレクターは、アカウントの認証済み セッションを通じてメッセージを受信し、各メッセージが到着するたびに、チャット、 メッセージ、送信者の識別子、およびTelegramが各メッセージに設定した日付を付記して、ジャーナルに記録します。GitHubでは ActionsによるキャプチャおよびIntel TDXのデプロイメントにおいて、アテステーションは、そのセッションと 署名キーを承認されたコレクターの実行に紐付けます。

ジャーナルには、認証キーの出所が記録されます。電話やQRコードによるログイン、 あるいはセッションファイルからの独立したログインでは、account.authorizedに key_origin: "created"が書き込まれます。インポートされた.session、TData、またはJSONキーでの収集では、 importedが書き込まれます。インポートされたキーは、その出所にかかわらず存在します。認証済みデプロイメントは インポートされたキーを拒否します。

レコードのTelegramにおける出所は、アカウントの認証済み接続、 ジャーナル内の接続およびキャプチャ記録、ジャーナルエントリと照合された キャプチャされたMTProtoフレーム(tgwitness/forensics/)、各 メッセージのTelegram日付、および認証済みキャプチャの場合は検証済みの実行環境に基づいています。 アーカイブ署名は、 後日の検証のためにその記録を保存します。保持されたチェックポイントは以前のジャーナルの 境界を固定し、カバレッジ記録は収集結果を示し、検証済みの外部タイムスタンプは コミットされたバイトを時間軸上に位置づけます。

ローカルワークスペースの場合、受信者は信頼できるコレクターまたはウィットネスの入力を提供します。 封印された取得の場合、信頼ポリシーおよびアテステーションにより、アーカイブのダイジェストが 承認されたコレクターの実行に紐付けられます。これらは異なる検証パスです。選択されたパスに対して 完了したチェックを報告してください。

添付ファイル#

ファイルは media/ ディレクトリ内で SHA-256 ハッシュによって識別されます。media.saved イベントは、ハッシュと バイト長を特定のメッセージイベントに関連付けます。生のファイル名はメタデータであり、決してローカル パスではありません。 メディアのバイトデータは非同期でダウンロードされるため、即時削除を行うと キャプチャできない場合があります。収集が無効化されている場合、サイズ超過またはサイズ不明のファイル、ダウンロードの失敗、 およびダウンロードの中断は、結果として表示されます。プロセスのクラッシュにより、 参照されていない部分的なファイルが残る場合がありますが、これらはエクスポートには含まれません。

ZIPエクスポート機能は、保存されたメディアをそのファイル名と照合して検証します。JSONL、CSV、およびHTML 形式でのエクスポートは、イベントの署名を検証しますが、メディアのバイナリデータは含まれません。派生レポートは 利便性を目的としたものであり、events.jsonlがイベントの正式な表現となります。

チャット全体のエクスポートでは、ワークスペースの添付ファイル設定に従って、添付ファイルが media/ ディレクトリ内に、SHA-256 という名前で保存されます。 chat.json内の各メッセージレコードには、ファイル名(file、 file_sha256)または欠落理由(file_status)が記載されており、読者がテキストの 周辺で確認した内容(テキスト内のリンク、転送元、ボットボタン、署名、閲覧回数、 自動削除タイマー)も併せて記録されます。verify.pyは、指定されたすべてのファイルが、そのハッシュに対応する署名付きマニフェスト内に 存在することを確認します。

永続的な収集と受領証の処理 (0.2)#

メディアジョブとそのメッセージイベントのコミットは、1つのトランザクションで行われます。 ジョブは 元のTLメッセージ記述子を保存します。署名付き観測データには、そのSHA-256、アカウント、 およびサイズポリシーが紐付けられます。復元時には、ダウンロード前にその紐付けが検証されます。現在のメッセージを取得することは決してなく、 新しい添付ファイルに静かに置き換えられます。中断されたジョブは 再試行されますが、恒久的な失敗は明示的な結果として残ります。

各ワークスペースには、独自のジャーナルと署名用IDがあります。process.startedイベントには、 実行ID、ローカルクロック、依存関係のバージョン、ソースファイルのハッシュ、初期アカウント/スコープ、 およびキャプチャ設定が含まれます。ハートビートには、実行ID、単調時間、およびキューの状態が含まれます。 実行レシートは、個別に署名されたステートメントとしてダウンロードすることも可能です。実行環境の検証には、 「検証範囲」で説明されている GitHub アテステーションまたは TDX チェックと 組み合わせて使用してください。

自動チェックポイントは、起動時、観測中の5分ごと ([その他のツール] → [パラメータ] → [署名付きチェックポイントの生成間隔])、および正常な停止時にローカルに保持されます。起動時の検証およびエクスポートでは、ジャーナルを 最新の保持済みローカルチェックポイントと比較します。これにより、チェックポイントが 残存している場合にデータベースのロールバックを検出できます。独立した保持により、その参照はワークスペース 外でも利用可能となり、検証済みの外部タイムスタンプによってさらに時間軸上の位置が固定されます。

再起動後、保存されていたTelegramの更新位置が再開されます(catch_up_from in observation.started)し、見逃された更新が要求されます。保存された位置は、処理が完了した更新のみを対象としているため、接続が切断されたりプロセスが停止したりした時点でまだ待機中だった更新は、再度要求されます。定期的な再確認により、 message.recovered 見逃されたメッセージを記録し、 message.missing_on_recheck Telegramが保存されたメッセージを返さなくなった場合も記録されます。後者は削除通知ではなく、削除者や時刻の指定もありません。

オフサイトでのコピーおよび復元(S3)#

オフサイトコピー([設定] → [通知とオフサイトコピー] → [オフサイトコピー]、または [その他のツール] → [エクストラ] → [証拠とバックアップ];デフォルトではオフ)は、ジャーナルセグメント、保存済みファイル、チェックポイント をタイムスタンプ付きで、および完了したチャットのエクスポートを、S3互換のストレージにアップロードします。これらは、 アップロード前にワークスペースのボールトに保管された鍵を用いてAES256-GCMで暗号化されます。バケットが対応している場合、 オブジェクトロックの保持期間が適用されます。 ダウンロードしたキーがなければ、このコピーを読み取ることはできません。復元および検証は python -m tgwitness.replica restore --key-file KEY.json --out DIR で行ってください。

復元には、空の通常のディレクトリが必要です。ダウンロードされたデータおよび復号化されたオブジェクトは、 ジャーナル全体および保持されているすべてのチェックポイントが検証されるまで、非公開の一時ストレージに保管されます。安全でないオブジェクト パス、不整合なセグメント範囲、およびチェックポイントよりも短いジャーナルは拒否されます。検証に失敗した場合、 復元されたファイルは公開されません。 保持チェックでは、返されたオブジェクトロック モードと日付を、アップロード時に送信された期限と比較します(丸め誤差は1秒)。期限切れ、 無効、または短縮された期限は、検証済みとはみなされません。ステータスには、そのアップロードパスにおいて保持情報が読み取られた サンプリングされたオブジェクトが報告されます。

ローカルメディアの欠落や破損は、そのパスのエラーとして報告され、メディアカーソルは その位置に留まるため、次のパスでファイルの再試行が行われます。その後のファイル、チェックポイント、およびエクスポートは 引き続きコピーされます。復元時には、 保存されたすべてのメディア参照について、復号化されたハッシュおよび記録されたサイズとの照合が行われます。 中断されたアップロードによる同一の重複する ジャーナルセグメントは重複排除され、競合する重複部分は拒否されます。 アップロード中に作成されたチェックポイントは、それに対応するジャーナル記録が コピーされるまで保留されるため、完了したパスでは、ジャーナルより先にチェックポイントが公開されることはありません。

ストリーミングによるスナップショットのエクスポート#

ストリーミング形式でのエクスポートでは、安定したSQLiteの読み取りスナップショットが使用されます。ダウンロードが完了した時点で、その先頭部分は 現在のライブジャーナルよりも古い場合があります。そのスナップショット後に作成された チェックポイントでは、アーカイブのサイズが実際より小さいと正しく報告されることがあります。比較する際は、エクスポートされたプレフィックス時点またはそれ以前のチェックポイントと 比較し、恣意的に後日のチェックポイントと比較しないようにしてください。

RFC 3161 に基づく準備および応答の検証 (0.2)#

エビデンスモードでは、各署名済みチェックポイントのSHA-256ハッシュのみを、リストされたRFC 3161 認証機関およびOpenTimestampsカレンダーへ、ワークスペース経由で送信し、MTProxyを経由することは決してありません。 タイムスタンプは、すべてのセットアップゴールでデフォルトで有効になっています。また、ケースのエビデンスにはdrandも記録されます。 回答は checkpoints/anchors/に保存され、 .tsr および .ots ファイルとして anchors/、 および verify.py (--tsa-ca がTSA署名を検証し、OpenTimestampsの証明は を使用して確認します ots upgrade を使用してOpenTimestampsの証明を確認し、 ots verify).

RFC 3161の権限が2回連続で失敗した場合、次の試行の前に待機します。待機時間は、最初は1インターバル、次に 2、4と続き、最大6時間まで、あるいはRetry-Afterで指定された時間(最大1日)までとなります。待機中の権限のみを 検出したパスはレコードを書き込みません。それ以外の場合は、anchor.completedがそれらを deferredの下にretry_atとともにリストします。それらが再度応答するまで、パネルにはタイムスタンプが「Degraded」として表示されます。

パネルは、正規化された checkpoint.json バイト、 SHA-256 メッセージインプリント、および timestamp.tsq 内のランダムなノンス、チェックサム、および指示を含むリクエストアーカイブを作成します。 ネットワークリクエストは行われません。このリクエストに対して権限機関が返すトークンは、タイムスタンプです。

python -m tgwitness.anchor verify は、OpenSSL を使わずに応答をチェックポイントのバイト列と元のリクエストに照らして確認します。信頼する CA ファイルは明示的に指定する必要があり、同梱の証明書が自動的に信頼されることはありません。CLI ではリクエストの確認は任意なので、リクエストを保存し、nonce を確認するには --request を指定してください。確認したかどうかは結果に示されます。コレクターのチェックポイント署名とジャーナルは、引き続き信頼するコレクターのフィンガープリントで別途検証する必要があります。

検証では、指定されたCAの信頼関係の下で、応答の署名、チェックポイントバイト、および(指定された場合は) 元のリクエストをチェックします。証拠モードで取得されたタイムスタンプについては、verify.py が保存された OCSP または CRL の証拠(署名証明書の失効)も検証します。 手順と検証結果を参照してください。

証拠モードにおけるオプションの記録:drandおよびTelegramデバイス#

タイムスタンプと同じパス上で、さらに2つのレコードを実行できます。どちらも、 証拠モードがオンの間のみ有効になります。事件の証拠として指定するとdrandがオンになり、それ以外の場合は両方ともオフの状態から始まります。これらを切り替えるには、 [その他のツール] → [エクストラ] → [証拠とバックアップ] → [その他の証人・オプション] から設定するか、 または "drand": true および "devices": true で POST /api/evidenceで切り替えることができます。一方に不具合があっても、 もう一方やタイムスタンプの実行は停止しません。パネルには、フォームの下にそれぞれの最新の結果が表示されます。

drand (beacon.drand )。各パスでは、League of Entropyの公開 ランダム性であるdrand quicknetの最新ラウンド(3秒ごとに1ラウンド)がジャーナルに書き込まれます:chain 、 round 、randomness 、signature 、round_time 、および応答したrelay 。検証済みの 予測不可能なラウンドは、後続のハッシュリンクされたデータに対する下限の時間基準を提供します。 後続のチェックポイントにおける検証済みのタイムスタンプは、時間的な上限の基準を提供します。これらのチェックにより リンクされたデータが範囲内に収められます。コレクターは、まず drand.cloudflare.com に問い合わせ、次にワークスペース経由で Protocol Labs のリレーに問い合わせを行います。1パスにつき1回のリクエストが行われます。

verify.py は、各ランダム値がその署名のSHA-256 であることと、ラウンド 時間が正しいことを確認し、ラウンド数、ラウンドがない最長の期間、およびコレクターのクロックがdrandより どれだけ遅れていたかを報告します。--check-drand は、CloudflareリレーおよびProtocol Labsリレーとのラウンドを比較します。比較対象は、すべてのラウンド、あるいは長いジャーナルから無作為に 抽出した100件のサンプルです。差異があるラウンドは検証に失敗します。

、Telegram、(account.devices)デバイス。各パスでは、 account.getAuthorizations を使用してアカウントのセッションを読み取り、Telegram が「設定」→「デバイス」に表示するリストを、前回のパス以降に変更された場合は 前回のパス以降に変更があった場合は、addedおよびremovedのセッション ハッシュを含む完全な情報を記録し、変更がない場合はその数とSHA-256のみを記録します。デバイスのモデル、プラットフォーム、アプリおよびバージョン、 作成日時と最終アクティビティ、国および地域は保持されますが、IPアドレスは保持されません。これは、 証拠のエクスポート後は管理下から外れるためです。 コレクター自身のセッションは常にアクティブであるため、 他のセッションのアクティビティのみが変更としてカウントされます。verify.pyは、リストが 記録された頻度、および新規および終了した各セッションを報告します。このセッションは、監視が実行されている間のみリストを読み取ります。

これらが示す内容:drandは公開時刻に基づいて記録を時系列順に並べ、デバイス リストはコレクターを介したTelegramの声明であり、他のすべての 記録と同様にコレクターによって署名されています。

Cloudflare Gateway ログ (cloudflare.gateway_dns)。 Cloudflare Gateway( Gateway DNS )を経由して解決されるサーバーの場合、各 コピーでは、前回のコピー以降に Gateway が記録した内容がコピーされます。最大 3 時間のウィンドウごとに 1 レコードで、from、until、location_id、設定されている場合はサーバーの address、および queries を [at, name, type, rcode, decision, colo] として、また記録がない場合も同様に扱います。 の下で設定します。Cloudflare Gatewayログ:アカウント、場所、オプションの住所、および読み取り専用トークン(Account Analytics Read;共有ロケーションのアドレスを1つ保持するためのZero Trust PII Read)。パネルは 保存前に1回のリクエストでこれらを確認します。トークンは暗号化されたまま維持され、ジャーナルには一切記録されません。 verify.pyには、ウィンドウ、最も多く検索された名前、およびコピーでカバーされていない時間が一覧表示されます。クエリ数とカウントが一致しないレコードは 失敗となります。 1秒間に1ページ以上の クエリを含むウィンドウは、そのページを保持し、残りは欠落していると報告します。このコピーは、 コレクターを経由したCloudflareの応答であり、コレクターによって署名されています。24時間以内であれば、 読み取り専用トークンを持つ誰でも、これをCloudflareと比較することができます。