# TgWitness · 日本語 > Documentation edition: 日本語. Project version: `0.9.3`. Source branch: `main`. This index links the Markdown editions of the public pages. The complete handbook is built from the same page content, including source URLs. Sections without a translation appear in English. - [Project context, installation, measured scale and verification](https://phishdestroy.io/tgwitness/docs/reference/overview/index.md) - [English project summary](https://phishdestroy.io/tgwitness/llms.txt) - [Complete handbook · 日本語](https://phishdestroy.io/tgwitness/ja/llms-full.txt) - [Complete handbook as Markdown · 日本語](https://phishdestroy.github.io/TgWitness/ja/llms-full.md) - [Source code and release history](https://github.com/phishdestroy/TgWitness) - [Collection modes and evidence levels](https://phishdestroy.io/tgwitness/ja/guides/modes.md) - [Published checks and measurements](https://phishdestroy.io/tgwitness/docs/validation/index.md) ## Complete documentation map ### Guides - [アーカイブの操作](https://phishdestroy.io/tgwitness/ja/docs/archive/index.md): 履歴の読み込み、保存された記録の検索、AIソースの確認、およびツールの連携が可能です。 - [GitHub Actionsのキャプチャ](https://phishdestroy.io/tgwitness/ja/docs/capture/index.md): 一時的な GitHub ランナーで Takeout,通常 API によるエクスポート,またはチャットログを選択します. - [専用アカウント](https://phishdestroy.io/tgwitness/ja/docs/dedicated-account/index.md): 収集用に別のTelegramアカウントを用意してください。 - [数分で始められます](https://phishdestroy.io/tgwitness/ja/docs/start/index.md): コマンド1つでインストールし、Telegramアカウントを接続して、Windows、Linux、macOSで検証可能なアーカイブをエクスポートできます。 - [アカウントを連携する](https://phishdestroy.io/tgwitness/ja/docs/accounts/index.md): QRコード、電話番号、またはセッションのインポートにより、Telegramを接続してください。ソースを選択し、新しいメッセージがジャーナルに正常に反映されることを確認してください。 - [プロキシを選択してください](https://phishdestroy.io/tgwitness/ja/docs/proxies/index.md): MTProxyの自動ルーティングを維持するか、独自のプロキシをご利用ください。IPモード、フォールバックルール、および外部リクエストのルーティングを選択してください。 - [エクスポートと検証](https://phishdestroy.io/tgwitness/ja/docs/exports/index.md): キャプチャしたTelegramの履歴をエクスポートし、署名を検証し、ジャーナルを独立した証人が保持しているチェックポイントと比較することができます。 - [証拠の仕組みをご覧ください](https://phishdestroy.io/tgwitness/ja/docs/concepts/index.md): メッセージの取得からチェックポイントまでの流れを追跡します。サンプルレコードを変更し、そのSHA-256チェーンを再計算して、保持されているチェックポイントが何を検出するかを確認してください。 - [すべてのチャットを横断的に調査する](https://phishdestroy.io/tgwitness/ja/docs/cases/index.md): チャンネル、グループ、プライベートチャット、ボットを横断して、Telegramの調査をエンドツーエンドで実施します。アカウント全体のキャプチャ、履歴、参加者、リンク、ファイル、タイムライン、および検証済みの証拠を網羅します。 - [Case Boardの作成](https://phishdestroy.io/tgwitness/ja/docs/case-board/index.md): 保存された観察結果、正確なハイライト、アクションスライスをプライベートボードに収集し、チームと議論して、収集結果を提示してください。 - [レポートの作成](https://phishdestroy.io/tgwitness/ja/docs/reports/index.md): レポートデータ、8種類のデザインから1つ、および内容を選択し、プレビューを行った後、HTML、署名付きPDF、または完全な証拠パッケージとしてエクスポートします。 - [共有用コピーを作成してください](https://phishdestroy.io/tgwitness/ja/docs/handover/index.md): 受信者が受け取ることができる記録とフィールドを選択し、完成したコピーを確認して、署名済みのマニフェストおよびソースジャーナルの境界を検証してください。 - [アカウントグループの管理](https://phishdestroy.io/tgwitness/ja/docs/groups/index.md): グループワークスペースを比較し、ソースを検索し、監視期間を確認し、アカウントごとの例外設定を適用して共有設定を適用します。 - [セキュリティを確保してください](https://phishdestroy.io/tgwitness/ja/docs/security/index.md): セッション、鍵、証拠データの保存場所、端末から送信される情報、保護対象の範囲、およびインストールのセキュリティ強化方法についてご確認ください。 - [事例を共有する](https://phishdestroy.io/tgwitness/ja/docs/access/index.md): レビュー担当者やアナリストに対し、個別の権限、セッション制限、および取り消し可能なトークンを設定して、選択されたアカウントやチャットへのアクセス権を付与します。 - [Witnessボットの設定](https://phishdestroy.io/tgwitness/ja/docs/witness/index.md): 署名済みのジャーナルのチェックポイントを、個別のウィットネス、独自の鍵、および読み取り専用コレクターアクセス権を設定して、Telegramチャンネルに公開できます。 - [ゼロトラストが選ばれる理由:テイラー・ウェッシング、ツールハイデ博士、シェリンスキー博士](https://phishdestroy.io/tgwitness/ja/docs/signed-export/index.md): ゼロトラストの事例研究:テイラー・ウェッシング法律事務所のパトリック・ツールハイデ博士とトビアス・シェリンスキー博士が署名したGDPRへの回答書。同事務所の内部文書と照合され、欺瞞や疑念の余地を一切残さない検証可能なモデルに基づいて作成されたものである。 - [稼働を継続してください](https://phishdestroy.io/tgwitness/ja/docs/server/index.md): TgWitnessは、永続的なストレージ、プライベートパネルへのアクセス、バックアップ機能、および再起動後のチェック機能を備えたサーバー上で実行してください。 - [何が問題だったのかを確認する](https://phishdestroy.io/tgwitness/ja/docs/troubleshooting/index.md): 各問題に応じた適切なシグナルを使用して、パネルへのアクセス状況、Telegramとの接続状況、メッセージの欠落、FloodWait、およびWitnessのステータスを確認してください。 ### Reference - [シークレットチャット:設定と記録](https://phishdestroy.io/tgwitness/ja/docs/reference/secret-chats/index.md): シークレットチャットのプロトコル拡張をインストールし、アカウントごとに有効にして、TgWitness が作成または承諾したチャットを記録します。 - [TgWitness:開始、規模、および証拠](https://phishdestroy.io/tgwitness/ja/docs/reference/overview/index.md): 1つのコマンドでインストールするか、GitHub Actionsでキャプチャしてください。調査オプション、公開されている規模、およびアーカイブが何を検証するのかを理解してください。 - [ソース履歴を読み込む](https://phishdestroy.io/tgwitness/ja/docs/reference/history/index.md): 有効化されたソースから過去のメッセージを読み込み、一時停止や再開を行い、署名付きの進捗レポートを検証します。 - [アーカイブ分析](https://phishdestroy.io/tgwitness/ja/docs/reference/analysis/index.md): 保存されたメッセージを検索し、AIの入力内容を検証し、出典情報を記載した分析レポートを管理できます。 - [コマンドライン](https://phishdestroy.io/tgwitness/ja/docs/reference/cli/index.md): スクリプトやエージェントからメッセージを検索、コンテキストの読み取り、アクティビティの集計、保存済みメッセージのエクスポートが可能で、--json 出力、安定した終了コード、スコープ付きの読み取り専用トークンをサポートしています。 - [全文検索](https://phishdestroy.io/tgwitness/ja/docs/reference/search/index.md): 保存されたメッセージを、単語の形態、完全なフレーズ、ドメイン、@ユーザー名で検索し、署名付きジャーナルに紐付けられたインデックスを用いて、最も一致度の高いものから順に表示します。 - [読み取り専用 MCP](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/index.md): MCPクライアントを、有効期限付きかつ取り消し可能なアクセス権限で、選択したワークスペースやチャットに接続します。 - [ローカルでのOCRおよび文字起こし](https://phishdestroy.io/tgwitness/ja/docs/reference/media-analysis/index.md): ローカルワーカーを使用してキャプチャされた画像や音声を認識し、抽出されたテキストを元のファイルと関連付けます。 - [送信されるWebhook](https://phishdestroy.io/tgwitness/ja/docs/reference/webhooks/index.md): HMAC署名、再送信、配信ステータスを付加して、指定されたイベントをHTTPS受信先に送信します。 - [オペレーターの非互換性に関する通知](https://phishdestroy.io/tgwitness/ja/docs/reference/notice/index.md): Taylor Wessing に関する当社の運営者通知およびその出典記録。 - [ライセンスに関する説明とアーキテクチャ上の非互換性の通知](https://phishdestroy.io/tgwitness/ja/docs/reference/license/index.md): TgWitnessは、すべての人に対してMITライセンスで提供されており、その理由として、Taylor Wessingのワークフローとはアーキテクチャ的に互換性がないことが挙げられます。 - [クイックスタート](https://phishdestroy.io/tgwitness/ja/docs/reference/quickstart/index.md): TgWitnessのインストールおよび起動方法のすべて:Windowsパッケージ、Python、Docker、および初期チェックを含む統合デモ。 - [アカウントとセッション形式](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/index.md): 電話番号、QRコード、または認証キーでログインし、Telethon、Pyrogram、またはTelegram Desktopのセッションをインポートして、複数のアカウントを運用できます。 - [アクセスと権限](https://phishdestroy.io/tgwitness/ja/docs/reference/access/index.md): アカウントやチャットへのアクセス範囲を限定し、権限を選択し、セッションやIPアドレスを制限し、アクセス権を取り消すことができます。 - [接続、プロキシ、およびデータ保護](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/index.md): 認証、自動プロキシプール、IPモード、フォールバックポリシー、外部リクエスト、およびシークレットストレージ。 - [導入](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/index.md): TgWitnessは、Windows、Linux、macOS、またはDocker上で、HTTPS経由でサービスとして実行でき、バックアップや更新機能も備えています。 - [収集の仕組み](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/index.md): 記録範囲、リアルタイム更新、再確認、添付ファイル、自身の操作、および「ギャップ」の意味について、記録ごとに解説しています。 - [ワークフローと操作方法](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/index.md): パネルの日常的な運用:モード、監視カテゴリ、パラメータ、通知、エクスポート、バックアップ、および容量について。 - [調査モード](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/index.md): チャンネル、グループ、プライベートチャット、ボットにまたがるアカウント全体の調査について、調査範囲の設定から検証済みのケースパッケージの作成までを網羅しています。 - [Case Board の参照](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/index.md): ブックマーク、正確なハイライト、アクションスライス、ディスカッション、アクセス範囲の制限、および Case Board で使用される署名付き注釈履歴。 - [レポートの設定と検証](https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/index.md): レポートフィルター、8種類のデザイン、コンテンツのプリセット、保存された変更履歴、および署名付きエクスポートに含まれる評価。 - [機能と対象範囲](https://phishdestroy.io/tgwitness/ja/docs/reference/features/index.md): TgWitnessの現在の収集モデル、マルチアカウントワークフロー、エクスポート機能、および運用上の制限事項。 - [証拠の仕組み](https://phishdestroy.io/tgwitness/ja/docs/reference/how-it-works/index.md): ハッシュチェーン、署名、チェックポイント、およびウィットネスについて、検証者が使用する正確な数式を用いて解説しています。 - [証拠の形式](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/index.md): 署名付きZIPファイルの内容、記録の種類、処理の受領確認、ユーザープロフィール、オフサイトコピー、およびオフライン検証について。 - [独立した証人](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/index.md): 独自の鍵とボットを使用してWitnessを実行し、署名済みのチェックポイントをチャンネルに公開し、エクスポートしたデータと照合してください。 - [タイムスタンプ](https://phishdestroy.io/tgwitness/ja/docs/reference/timestamp/index.md): 署名付きチェックポイントにおけるRFC 3161タイムスタンプ:認証機関に送信される内容と、応答の検証方法について。 - [裁判所向けレポートの翻訳](https://phishdestroy.io/tgwitness/ja/docs/reference/translation/index.md): どのファイルが原本か、認証翻訳とともに何を提出するか、翻訳者が保持する用語。 - [セキュリティおよびデータ取り扱い](https://phishdestroy.io/tgwitness/ja/docs/reference/security/index.md): 脅威モデル、アクセスモデル、保存中の機密情報、ネットワークへの露出、セッションのインポート、および脆弱性の報告方法について。 - [アーキテクチャ](https://phishdestroy.io/tgwitness/ja/docs/reference/architecture/index.md): コレクター、パネル、ジャーナル、ワーカー、ウィットネスの各コンポーネントと、それら間でデータがどのようにやり取りされるかについて解説します。 - [テスト済みの内容](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/index.md): Telegramのライブテスト、自動チェック、ブラウザチェック、および次回の検証実行について。 - [変更履歴](https://phishdestroy.io/tgwitness/ja/docs/reference/changelog/index.md): バージョンごとのすべての変更点(まだリリースされていない変更も含む)を掲載しています。 - [パネルガイド](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/index.md): パネルのすべての画面:チャット、ジャーナル、ソース、エクスポート、エクストラ、保護モード、コードチェック。 - [初期設定と設定](https://phishdestroy.io/tgwitness/ja/docs/reference/settings/index.md): セットアップウィザード、目標、インターフェースレベル、接続ルート、およびアカウントグループで共有される設定。 - [インストール、検証、および更新](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/index.md): 1つのコマンドでインストール、署名とハッシュの確認、更新、およびアンインストールが可能です。 - [保存と復元](https://phishdestroy.io/tgwitness/ja/docs/reference/storage/index.md): バックアップ、古いファイルのクラウドへの移動、Object Lock によるデータの複製、および新しいマシンでの復元。 - [アカウントのエクスポート](https://phishdestroy.io/tgwitness/ja/docs/reference/account-export/index.md): アカウントが現在閲覧可能な内容をエクスポートします:スコープ、再開可能なジョブ、署名付きアーカイブ、および最小化された共有コピー。 - [公開ショーケース](https://phishdestroy.io/tgwitness/ja/docs/reference/showcase/index.md): 選択した公開チャンネルの保存済みメッセージや署名付きスナップショットを、有効期限付きかつ取り消し可能なリンクを通じて公開します。 - [高信頼性の導入](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/index.md): Hetzner または Phala Cloud 上の 24 時間 365 日稼働のシールドサーバー、Gateway DNS、および第三者が再現可能な検証手順。 --- # Telegram · 数分で始められます Canonical page: https://phishdestroy.io/tgwitness/ja/docs/start/ コマンド1つでインストールし、Telegramアカウントを接続して、Windows、Linux、macOSで検証可能なアーカイブをエクスポートできます。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 1つのコマンドでインストールし、Telegramアカウントを連携させ、保存対象を選択してください。 ## お使いのコンピュータにインストールしてください インストーラーにはPythonと依存関係が含まれています。まずはチャットのエクスポートから始め、必要に応じて監視・調査ツールを追加してください。 ### Linux / macOS ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` ### Windows · PowerShell / CMD ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Ubuntu サーバー:root 権限で実行してください。デスクトップ:通常のユーザーとして実行してください。 インストーラーに表示されるパネルアドレスを開き、そのアクセスキーを使用してください。その後、Telegramアカウントを連携させてください。パネルキーとTelegramの認証情報は別物です。 [インストール、署名、および更新](https://phishdestroy.io/tgwitness/docs/reference/installation/) では、ダウンロードしたビルド、ローカルアクセス、およびサーバーオプションについて説明しています。[ソースコードおよび Docker の手順](https://phishdestroy.io/tgwitness/docs/reference/quickstart/) は引き続き利用可能です。 ## 最初のタスクを選択してください 1. [電話番号、QRコード、またはサポートされているセッションインポート機能を使用して、アカウント](https://phishdestroy.io/tgwitness/ja/docs/accounts/) を接続します。 2. チャット、フォルダ、またはアカウントの範囲を選択してください。 3. [選択した履歴](https://phishdestroy.io/tgwitness/docs/reference/account-export/)をエクスポートするか、今後の変更を記録するために監視を開始します。 4. [アーカイブ](https://phishdestroy.io/tgwitness/ja/docs/exports/) を、別途信頼されているキーフィンガープリントと照合して検証します。 ## 一時的な GitHub Runner を使用してください [「GitHub Actionsのキャプチャ」](https://phishdestroy.io/tgwitness/docs/capture/)では、フォーク、認証、スコープ、アーカイブパスワードの設定手順を順を追って説明しています。実行後は、暗号化された結果とそのワークフローの来歴をダウンロードしてください。このワークフローには、常設のコレクターサーバーは必要ありません。 ## アカウントなしでサイトをご覧いただけます [ブラウザデモ](https://phishdestroy.github.io/TgWitness/demo/?lang=ja)を開き、架空のメッセージを確認したり、編集内容を比較したり、エクスポートされたデータを検証したりしてから、インストールを行ってください。 ![TgWitnessの会話画面とメッセージ例](https://phishdestroy.io/tgwitness/assets/chats-dark.png?v=684f81f890cc) ワークスペースの例です。ご自身のジャーナルは別途開始されます。 ## 調査を継続する 進行中の作業については、各ケースに必要なソース、ファイルポリシー、検索、レポート、および共有権限を追加してください。[「開始、スケーリング、および証拠」](https://phishdestroy.io/tgwitness/docs/reference/overview/)では、選択肢と公表された測定値について説明しています。 サーバーへのインストールについては、「[Keep it running」](https://phishdestroy.io/tgwitness/ja/docs/server/)の手順に従ってください。 --- # 別のアカウントを使用してください。メインのアカウントは絶対に使用しないでください。 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/dedicated-account/ 収集用に別のTelegramアカウントを用意してください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) アカウントを連携する前に必ずお読みください メインアカウントを使用しないようお勧めするのは、冗談ではありません。これは現実です。 メインアカウント - ご自身のアプリのハッシュ:99%がログアウト済み - 信頼度が低いという理由だけで利用停止処分が下されるケースは頻繁にあります - これを使用するのは、実に愚かな考えです パブリックペア上の追加アカウント - これらのペアを通じて登録されたアカウントは100万件を超えています - このペアは5年以上稼働しています - これらを通じて、あなたの情報は誰にも見られることはありません 01 ## メインアカウントではなく、こちらをご利用ください これは正確な情報です。これらの問題の落とし穴がどこにあるか、私たちは正確に把握しています。 1. ### ご自身のアプリのハッシュ:99%がログアウト済み アクセス権のないアカウントから my.telegram.org にログインしてアプリハッシュを取得し、そのアプリハッシュを介してリクエストを行うと、そのアカウントがログアウトされる確率は 99% になります。ご自身で確認してみてください。 2. ### 信頼度が低いという理由だけで利用停止処分が下されるケースは頻繁にあります アカウントが凍結されるのは、単にTelegramがそのアカウントを信頼していないためであり、そのような凍結は頻繁に発生しています。この点についてもご自身で確認できます。ご自身のアカウントを使用するのは、実に愚かな考えです。 3. ### コピーされたセッションキーは失効させることができます インポートした TData/セッションキーを Telegram Desktop と TgWitness で同時に実行すると、`AUTH_KEY_DUPLICATED` が発生する可能性があります。Telegram はその認証を無効にするため、両方のコピーで新たにログインする必要があります。専用のアカウントを作成しても、これを防ぐことはできません。 元のクライアントを完全に終了させ、インポートしたセッションを使用している間は閉じたままにしておいてください。並行して使用する場合は、電話またはQRコードでTgWitnessにサインインして別の認証を作成してください。他の個別に認証されたクライアントは、サインインしたままにしておくことができます。 [セッションインポートに関する警告をお読みください](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=ja#session-warning) Telegramのドキュメント - [ログアウト時のエラー:AUTH_KEY_UNREGISTERED、SESSION_REVOKED](https://core.telegram.org/api/errors) - [独自のアプリハッシュの作成:api_idの取得](https://core.telegram.org/api/obtaining_api_id) 02 ## TgWitnessがパブリックなアプリハッシュ/アプリIDのペアを通じて機能する理由 そのため、私たちはTgWitnessをパブリックなアプリハッシュ/アプリIDのペアに基づいて構築しました。私たちの考えでは、これらを使用することで利用停止処分を受ける可能性は低くなります。100万以上のTelegramアカウントがこれらのペアを通じて登録されており、多くの異なるプログラムがこれらを通じて動作しています。 私たちの考えでは、これは個人のアプリハッシュを直接扱うよりも優れています。これらのペアは、確実に5年以上も稼働し続けているからです。 ### ご自身で作成した新しいペア my.telegram.org上のアカウントから作成されました。 - 約99%のアカウントがログアウトしました - 1つの新しいアプリケーションにつき、1つのアカウント ### プールの公開鍵ペア 多くのプログラムで使用されているのと同じペアです。 - 登録アカウント数は100万件を超えています - さまざまなプログラム - 5年以上の実務経験 ### なぜ、これらのペアを通じてあなたの情報は誰にも見られないのか - #### このペアは名前であり、鍵ではありません Telegramは、プログラムが接続する際やログインコードを要求する際に、API IDとAPIハッシュを求めます。これらはアプリケーションを識別するものであり、いかなるアカウントへのアクセス権も付与しません。Telethonのドキュメントには、1組のペアでどの電話番号でも利用可能であると記載されています。 - #### セッションキーは、サーバーの外に出ることはありません ログインすると、TgWitnessとTelegram間のディフィー・ヘルマン交換によって認証キーが生成されますが、キー自体は決して送信されません。Telegramのドキュメントによると、認証後、キーはユーザーに関連付けられ、このキーを使用したすべての呼び出しはそのユーザーとして実行されます。同じ鍵ペアを持つ他のプログラムは独自のキーを持っており、あなたのキーを使用することはできません。 - #### 通信はお客様の鍵で暗号化されます すべてのリクエストと応答は、APIハッシュではなく、セッションの認証キーを使用して暗号化されます。APIハッシュを知っていても、何も復号化することはできません。 - #### ペアの所有者には何も表示されません Telegramには、API IDごとにアカウント、セッション、メッセージを一覧表示する機能はありません。ペアの所有者は、my.telegram.org上で自身のアプリ設定のみを確認できます。 - #### どのアプリであるかは、ご自身のアカウントでのみ確認できます ご自身のアカウントの「設定」→「デバイス」には、各セッションのアプリ名とAPI ID、デバイス、IPアドレス、および日付が一覧表示されます。この一覧は、ご本人以外には表示されません。 Telegramのドキュメント - [ユーザー認証:鍵がユーザーそのものとなります](https://core.telegram.org/api/auth) - [auth.sendCode: api_id, api_hash](https://core.telegram.org/method/auth.sendCode) - [initConnection](https://core.telegram.org/method/initConnection) - [認証キーの作成](https://core.telegram.org/mtproto/auth_key) - [MTProto暗号化](https://core.telegram.org/mtproto/description) - [account.getAuthorizations](https://core.telegram.org/method/account.getAuthorizations) - [セッション記録に含まれる内容](https://core.telegram.org/constructor/authorization) - [api_id の取得](https://core.telegram.org/api/obtaining_api_id) - [Telegramアプリのオープンソースコード](https://telegram.org/apps#source-code) ライブラリおよびディスカッション - [Telethon:ログイン](https://docs.telethon.dev/en/stable/basic/signing-in.html) - [opentele:公式アプリAPI](https://opentele.readthedocs.io/en/latest/documentation/authorization/api/) - [opentele: TelegramClient](https://opentele.readthedocs.io/en/latest/documentation/telethon/telegramclient/) - [Stack Overflow:api_hashは秘密にしておくべきでしょうか?](https://stackoverflow.com/questions/49490818/should-telegram-api-hash-be-kept-secret) ### 他のプログラムにおける同様のペア 7 公式のTelegramアプリは公開されており、多くの独立したプログラムやライブラリに組み込まれています: - [opentelePython · src/api.py](https://github.com/anmv/opentele/blob/4df17bd8c443d6452afc5a2d29ec7922fad1a5c3/src/api.py#L575) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [opentele2Rust · opentele2-core/src/api.rs](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/api.rs#L641) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [GrampoPython · Grampo/ut/api.py](https://github.com/abbas-bachari/Grampo/blob/00aa662d853c4ac2180432371c5e0d9444bbfe9e/Grampo/ut/api.py#L526) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [tgmanagePython · api/schemas/api_app.py](https://github.com/xdsnich/tgmanage/blob/f67c46be0ab234bd04526a8663d3936bd98a8597/api/schemas/api_app.py#L47) - Android 6 - iOS 8 - Desktop 2040 - macOS 2834 - Telegram X 21724 - Web K 2496 - [LyChatBotTDLib · helpers/tdlib/index.js](https://github.com/LyoSU/LyChatBot/blob/fac0ae5d5f2cddb8a26312014f51c0f6f40ec191/helpers/tdlib/index.js#L11) - macOS 2834 - [hsadasdPython · config.py](https://github.com/herobrinovaleksandr-png/hsadasd/blob/6842c74895038c16e219324fcd07dbe8153f37f0/config.py#L68) - Desktop 2040 - Desktop 17349 - Telegram X 21724 - macOS 2834 - iOS 10840 - Web 2496 - +4 - [blb.teamblb.team/threads/…294](https://blb.team/threads/app-hash-app-id-ofitsial-nykh-kliyentov.294/) - Android 4 · 5 · 6 - iOS 8 - Desktop 2040 - Desktop 17349 - macOS 2834 - Telegram X 21724 アカウント登録用に公開された、公式アプリペアのフォーラム一覧 03 ## 追加アカウントを作成する方法 Telegramアカウントには、ログインコードを受信するための電話番号が必要です。アカウントの有効期間に応じて選択してください。 - 最適な選択 ### プリペイドSIMまたはeSIM ******** 最後 残高を常に補充しておいてください ご注意ください 最も信頼性が高いのは、Telegramが実際の携帯電話番号を最優先で受け入れる点です。通信事業者が回収した番号は、他の誰かに割り当てられます。 - ### 仮想番号アプリ ******** 最後 このアプリは数を保持していますが ご注意ください Telegramは、仮想番号の割り当てを拒否したり、認証コードを送信しなかったり、新規アカウントの利用を直ちに制限したりする場合があります。また、一部のアプリでは、使用されていない番号を回収することがあります。 - ### レンタル番号 ******** 最後 レンタル期間 ご注意ください 終了すると、その番号は次の顧客に割り当てられます。 - ### 1回限りの有効化 ******** 最後 1つのコード ご注意ください その番号は直ちにプールに戻され、多くの場合、過去の所有者の履歴が付随しています。何よりも先に、クラウドのパスワードを設定してください。 後でその番号を所有する人は誰でも、ログインコードをリクエストできます。クラウドパスワード(2段階認証)があれば、その人がログインするのを防ぐことができます。それがなければ、そのアカウントは番号の次の所有者に帰属することになります。 Telegramのドキュメント - [スパムに関するFAQ:仮想番号と以前の所有者](https://telegram.org/faq_spam) - [2段階認証](https://core.telegram.org/api/srp) ### レンタルされた+888番号(Fragment) 一部のマーケットプレイスやサービスでは、Fragment を通じて Telegram の公式 +888 番号を一時的にレンタルできるサービスを提供しています。 おおよその価格:1日あたり20米ドルです。 - Telegram Web または Telegram Desktop で直接アカウントを登録することができます。 - 該当の番号でアカウントを削除し、新しいアカウントを作成しても構いません。 - これらのアカウントは一般的に不正防止チェックの対象となる頻度が低いですが、免責や特別な特権が与えられるわけではありません。 この番号はあなたのものではありません。レンタル期間が終了すると、所有者がその番号を取り戻すことができます。直ちにクラウドパスワードを設定し、このアカウントを長期的に使用するものとして扱わないでください。 ご自身で+888の番号を所有するか、ご自身が管理するプリペイドSIMカードを使用することが、より確実です。 ### マーケットプレイスで販売されている既製アカウント 一部のマーケットプレイス(例えば G2G や Z2U など)では、新規、古くなったもの、またはセッションファイル付きの既製の Telegram アカウントが販売されています。 - [G2G:Telegramアカウントの掲載情報](https://www.g2g.com/uk/categories/telegram-accounts) - [Z2U:Telegramアカウント一覧](https://www.z2u.com/telegram/accounts-5-15140) 絶対にメインアカウントを使用しないでください!この方法で作成した専用アカウントであっても、メインのTelegramアカウントをTgWitnessに登録するよりも安全です。 #### 購入前の注意事項 - これはTelegramの利用規約に違反します。 - 多くのアカウントは一括登録(自動登録)されているか、または履歴が不明です。 - 一部の販売者には、依然として復旧用のアクセス権限が残っている場合があります。 - こうした市場からのアカウントは、後日、利用停止や制限を受けることが頻繁にあります。 - スティーラー、フィッシングツール、または明らかに盗まれたアカウントを公然と販売しているマーケットプレイスは避けてください。 - フィッシングツール、情報窃取ツール、盗まれたセッションやアカウントを公然と販売しているプラットフォームからアカウント(自動登録と宣伝されているものであっても)を購入することは、Telegramの利用規約に違反するだけでなく、ほとんどの国の法律にも違反します。これにより、後日、証拠が無効となる可能性があります。慎重に選択してください。 #### このオプションをご利用になる場合 1. このアカウントは使い捨てとして扱ってください。 2. その他のすべてのセッションを終了し、クラウドパスワードを設定し、直ちに復旧方法を変更してください。 3. 異なるプロバイダーのアカウント、またはご自身で登録したアカウントを2~3つご使用ください。 **プレミアム、削除、および7日間の猶予期間** アカウントが「Premium」の場合、電話番号へのアクセス権を持つ人物であっても、そのアカウントを即座に削除することはできません。通知が届き、削除されるまでに7日間の猶予があります。 これは、あなたの調査が当該アカウントに依存しているため重要です。代替案を準備する時間はあります。 **新規アカウントおよびAPI認証情報** SMSサービスから受け取った番号を使用してご自身で新規登録したアカウントから独自のapi_id/api_hashを取得・使用した場合、最初のAPIリクエストまたはセッション認証の際に、そのアカウントはログアウトされてしまいます。調査を計画する際は、この点にご留意ください。 04 ## アカウントの作成 番号から、最初に記録されたチャットまで。 1. ### 番号を取得する アカウントを長期的に維持する必要がある場合はプリペイドSIMまたはeSIMを、短期的な作業の場合はレンタルまたは1回限りのアクティベーションをご利用ください。サービスの一覧は以下の通りです。 2. ### メインアカウントとは別に登録してください 登録は、メインアカウントとは別のデバイス、エミュレーター、または電話プロファイル上の公式Telegramアプリで行ってください。 3. ### クラウドパスワードでロックしてください すぐに、他の場所では使用していないクラウドパスワードと復旧用メールアドレスを設定してください。 4. ### プライバシー設定を閉じる 電話番号 「**誰もいない**」、「番号で私を検索」、「**私の連絡先**」、「最終アクセス日時」、「プロフィール写真」、「自己紹介」は、「**誰もいない」**または「**私の連絡先**」とし、連絡先の同期をオフにしてください。 5. ### 自己破壊を防ぐようにしてください アカウントの自動削除期間を最長に設定してください。そうすれば、TgWitnessの稼働を停止しても、アカウントを失うことはありません。 6. ### 中立的な印象を与えるようにしてください 他のアカウントからの名前、写真、ユーザー名、プロフィール、および個人の連絡先は一切使用しないでください。 7. ### しばらく待機してください 最初は1日に数件のチャットに参加するようにしてください。急いで参加しようとする新規アカウントは、最初に制限されます。 8. ### ボットとは一切情報を共有しないでください ボットに対しては、決して「電話番号を共有」や「位置情報を共有」を押さないでください。リンクやミニアプリは、そのデバイス上のVPNまたはプロキシ経由で開いてください。 9. ### TgWitnessに接続してください 独自のワークスペースで、「**アカウント」→「QRコード」**から接続し、次に「**ソース」→「調査モード」**を押してください。アプリは操作を行う場所であり、TgWitnessは記録を保管する場所です。 Telegramのドキュメント - [2段階認証](https://core.telegram.org/api/srp) - [プライバシー設定](https://core.telegram.org/api/privacy) - [アカウントの自動削除](https://core.telegram.org/method/account.setAccountTTL) 05 ## サービス番号 開始時のオプションとして、国、価格、およびTelegramが電話番号の変更を頻繁に受け入れるかどうかを確認してください。お支払い前に必ずご確認ください。 ### プリペイドSIMおよびeSIM 11 - [SMARTYsmarty.co.uk](https://smarty.co.uk) - UK - SIM - [VOXIvoxi.co.uk](https://www.voxi.co.uk) - UK - SIM - [iD Mobileidmobile.co.uk](https://www.idmobile.co.uk) - UK - SIM - [Threethree.co.uk](https://www.three.co.uk) - UK - SIM - [Asda Mobilemobile.asda.com](https://mobile.asda.com) - UK - SIM - [Ultra Mobileultramobile.com](https://www.ultramobile.com) - US - プリペイド PayGoプラン、非常に安価です - [US Mobileusmobile.com](https://www.usmobile.com) - US - プリペイド - [Mint Mobilemintmobile.com](https://www.mintmobile.com) - US - プリペイド - [Tracfonetracfone.com](https://www.tracfone.com) - US - プリペイド - [eSIM Plusesimplus.me](https://esimplus.me) - eSIM - [Numero eSIMnumeroesim.com](https://numeroesim.com) - eSIM ### 仮想番号アプリ 20 - [Google Voicevoice.google.com](https://voice.google.com) - US 米国限定;登録には米国の電話番号が必要です - [TextNowtextnow.com](https://www.textnow.com) - US - CA その番号は、使用しない場合、取り消されます - [TextFreetextfree.us](https://www.textfree.us) - US - [2ndLine2ndline.co](https://www.2ndline.co) - US - CA - [Talkatonetalkatone.com](https://www.talkatone.com) - US - [TextMego-text.me](https://go-text.me) - US - CA - その他の国 - [textPlustextplus.com](https://textplus.com) [Google Play](https://play.google.com/store/apps/details?id=com.gogii.textplus) - [FreeToneGoogle Play](https://play.google.com/store/apps/details?id=com.textmeinc.freetone) - US [TextMe Up · textmeup.com](https://www.textmeup.com) - [Nextplusnextplus.me](https://nextplus.me) - US - [Dingtonedingtone.me](https://www.dingtone.me) - US - CA - [Burnerburnerapp.com](https://www.burnerapp.com) - US - CA - 有料 試用期間中 - [Hushedhushed.com](https://hushed.com) - 多くの国では - 有料 安価 - [Sidelinesideline.com](https://www.sideline.com) - US - [MySudomysudo.com](https://mysudo.com) - US - CA - UK - [2NumberGoogle Play](https://play.google.com/store/apps/details?id=com.bpmobile.second.phone) [App Store](https://apps.apple.com/app/id1216135390) - [SLYNUMBERslynumber.com](https://slynumber.com) [Google Play](https://play.google.com/store/apps/details?id=com.dev.slynumber) - [Phonerphonerapp.com](https://phonerapp.com) - [Onoffonoff.app](https://www.onoff.app) - EU アプリ内の欧州の携帯電話番号 - [Sonetelsonetel.com](https://sonetel.com) - 多くの国では - フリーナンバー - [Zadarmazadarma.com](https://zadarma.com) - 多くの国では 仮想番号 ### レンタルおよびアクティベーションの数 12 レンタルでは、番号が数週間または数ヶ月間有効です。1回限りのアクティベーションでは、1つのコードが発行されます。登録後すぐにクラウドパスワードを設定してください。 - [OnlineSimonlinesim.io](https://onlinesim.io) - レンタル - 有効化 - [SMSPVAsmspva.com](https://smspva.com) - レンタル - 有効化 - [5SIM5sim.net](https://5sim.net) - レンタル - 有効化 - [SMSPoolsmspool.net](https://www.smspool.net) - レンタル - ワンタイム - [VAK-SMSvak-sms.com](https://vak-sms.com) - レンタル - 有効化 - [TextVerifiedtextverified.com](https://www.textverified.com) - レンタル - 有効化 - [JuicySMSjuicysms.com](https://juicysms.com) - レンタル - 有効化 - [365SMS365sms.org](https://365sms.org) - レンタル - 有効化 - [SIMSMSsimsms.org](https://simsms.org) - レンタル - 有効化 - [GrizzlySMSgrizzlysms.com](https://grizzlysms.com) - ワンタイム - [SMS-MANsms-man.com](https://sms-man.com) - ワンタイム - [Tiger SMStiger-sms.com](https://tiger-sms.com) - ワンタイム --- # Telegram · アカウントを連携する Canonical page: https://phishdestroy.io/tgwitness/ja/docs/accounts/ QRコード、電話番号、またはセッションのインポートにより、Telegramを接続してください。ソースを選択し、新しいメッセージがジャーナルに正常に反映されることを確認してください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 1 ワークスペース = 1 アカウントと、そのジャーナルと鍵。 ## ログイン方法をお選びください **アカウント** → ワークスペースを追加 → 接続設定。この用途には別のアカウントを使ってください。 - **QR コード:**Telegram の「デバイス」画面でスキャンし、確認します。 - **電話番号:**番号、コード、2 段階認証があればそのパスワード。 - **セッションのインポート:**自分のセッションファイル、または Telegram Desktop のデータ。 組み込みの API プロファイル、または独自の API ID とハッシュを使います。これはアプリを識別するだけで、ログインさせたり何かを隠したりはしません。 **まずプロキシが必要ですか?** ログインする前に、[接続経路を選択してテスト](https://phishdestroy.io/tgwitness/ja/docs/proxies/)することができます。各アカウントには独自の経路が割り当てられています。 ## 監視対象を選択してください 1. 必要なチャット、グループ、チャンネルを選びます。 2. メディアを含む収集設定を確認します。 3. 起動し、接続と最近のアクティビティを確認します。 アカウントにアクセス権が必要です。管理者とメンバーでは見えるものが違い、ジャーナルにはこのアカウントが受け取ったものが表示されます。 アカウント全体なら、**ソース → 観察範囲 → 調査モード**を確認して**範囲を保存**します。詳しい手順:[アカウント全体の調査](https://phishdestroy.io/tgwitness/ja/docs/cases/)。 ## パス全体をご確認ください テストグループで、別のアカウントからメッセージを送り、編集し、削除します。3 つともジャーナルに表示されるはずです。その後[エクスポートして検証](https://phishdestroy.io/tgwitness/ja/docs/exports/)します。 「接続済み」は接続が機能しているという意味です。テストメッセージが記録されれば、イベントが実際に届いています。 ## 別のアカウントを追加する **アカウント**で新しいワークスペースを作り、同じ手順を行います。後でエクスポートを区別できるよう、各アカウントの鍵のフィンガープリントを控えておいてください。 --- # Telegram · プロキシを選択してください Canonical page: https://phishdestroy.io/tgwitness/ja/docs/proxies/ MTProxyの自動ルーティングを維持するか、独自のプロキシをご利用ください。IPモード、フォールバックルール、および外部リクエストのルーティングを選択してください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) アカウントをオンラインに保ち、サーバーの IP を見せてよいかどうかは自分で決めます。 ## まずIPモードを選択してください 01**アドレスを非表示にする** プロキシのみ。使えるものがなければ待機します。 02**最終手段としてのダイレクトメッセージ** 一定時間後に直接接続し、使えるプロキシが見つかれば戻ります。 03**トンネルまたはVPNを経由したサーバー** 直接接続で構いません。VPN の設定や確認は行いません。 ルートによって接続方法が決定されます。IPモードによって、直接接続が許可されるかどうかが決まります。 ## ルートはプールに任せておきましょう 1. **アカウント → 設定 → 接続設定**。 2. IP モードと**自動 MTProxy**、または固定ルートを選びます。 3. 保存し、**Telegram 接続テスト**を行います(ログイン前でも使えます)。 4. 収集を開始し、自分宛てにテストメッセージを送ります。 新しいワークスペースは自動 MTProxy と**アドレスを非表示**で始まります。プールは 4 つの公開リストを取得し、サーバーを確認して、良いものを残し、使えなくなったものを入れ替えます。 ## ご自身のプロキシをご利用ください SOCKS5、HTTP CONNECT、Telegram のプロキシリンク、または運営者のカタログ。切り替える前に観察を一時停止してください。Fake TLS のシークレット(`ee`…)は使えません。 **ローテーション、共有、再試行の設定** **パラメータ → 自動 MTProxy**:失敗のしきい値、クールダウン、ローテーション、プロキシあたりのアカウント数。上限 1 は、共有せずに待機するという意味です。異なるプロキシでも出口 IP が同じことはあります。 ## Telegramと外部からのリクエストを分離する MTProxy が運ぶのは Telegram だけです。タイムスタンプ、通知、コピー、コードチェックは、別の SOCKS5/HTTP プロキシ、アカウントの SOCKS5/HTTP ルート、またはモードが許せば直接接続を通ります。オフにすることもできます。 `TGWITNESS_PROXY_FEED_PROXY` はリストのダウンロードに使うルートを設定します。[証人](https://phishdestroy.io/tgwitness/ja/docs/witness/)には独自の設定があります。どれもブラウザーやシステムのネットワークには影響しません。 詳しくは:[モードと既定値](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/#ip-modes)、[ルートを変更できる人](https://phishdestroy.io/tgwitness/ja/docs/access/)。 --- # Telegram · エクスポートと検証 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/exports/ キャプチャしたTelegramの履歴をエクスポートし、署名を検証し、ジャーナルを独立した証人が保持しているチェックポイントと比較することができます。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 相手が自分であなたのワークスペースと照合できるファイルを渡します。 参照情報を保持する署名付きZIPファイルをエクスポート受信者が検証します 署名やチェックポイントは初めてですか?[サンプルの記録を変更して](https://phishdestroy.io/tgwitness/ja/docs/concepts/#chain)、どの確認が検出するかを見てください。 収集者とは別の場所にコピーを保管したいですか? [S3の設定](https://phishdestroy.io/tgwitness/ja/docs/exports/#s3)、[オブジェクトロック](https://phishdestroy.io/tgwitness/ja/docs/exports/#s3-retention)、または[検証済み復元](https://phishdestroy.io/tgwitness/ja/docs/exports/#s3-restore)をご覧ください。 ## 信頼できる参考資料としてご利用ください ワークスペースの鍵のフィンガープリントを、コレクター以外の場所に記録しておいてください。収集中は、チェックポイントにRFC 3161およびOpenTimestampsのタイムスタンプが付与されるよう証拠モードを有効にするか、パブリックチャンネルに投稿する[ウィットネス](https://phishdestroy.io/tgwitness/ja/docs/witness/)を実行してください。署名付きチェックポイントも別の場所に保管してください。受信者は、それらを用いて鍵、時刻、および以前のジャーナル状態を検証します。 ## 署名付きZIPファイルをダウンロードする **エクスポート** → 署名付き証拠 ZIP。ジャーナル全体と署名付きのファイルマニフェストが含まれます。読みやすいレポートは [Report studio](https://phishdestroy.io/tgwitness/ja/docs/reports/) で整えるか、選んだデータだけを[引き渡し用抽出](https://phishdestroy.io/tgwitness/ja/docs/handover/)として送ります。 HTML、PDF、JSON のレポートにはそれぞれ封印があります。CSV は作業用のコピーにすぎません。完全性が必要なら、検証済み ZIP 内の CSV を使ってください。 ## 信頼できるTgWitnessのコピーで検証してください プロジェクトの環境で、自分のフィンガープリントとパスを使って: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence ``` パスが成功すると、`key_pinned: true`および`checkpoint_checked: true`が表示されます。`--require evidence`を実行する際は、最終レコードのサードパーティによる時刻(チェック済みのタイムスタンプなど)も必要です。チェックポイントは自身の鍵で署名されているため、それだけでは不十分です。その出力をアーカイブの横に保管しておいてください。チェックポイントは、エクスポートの終了時点かそれ以前に存在している必要があります。 ## 検証結果を使用する - **ファイル:**マニフェストがハッシュを、署名がジャーナルを結び付けます。どんな変更も表に出ます。 - **同一性:**保管しておいたフィンガープリントが、想定どおりの鍵であることを証明します。 - **以前の状態:**チェックポイントが、引き渡し前に保存したジャーナルの先頭部分とエクスポートを比べます。 - **カバレッジ:**欠落、取得結果、送信 → 編集 → 削除のテストが、この構成で実際に記録できたものを示します。 詳細:[検証で証明できること](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope)。 ## S3 オフサイトコピーの設定 ワークスペースの**エクスポート → オフサイトコピー**。AWS S3 と S3 互換ストレージで使えます。ジャーナルのセグメント、保存したファイル、タイムスタンプ付きのチェックポイント、完了したチャットエクスポートをコピーし、それぞれコレクターを出る前に `AES-256-GCM` で暗号化します。 オンラインデモではこれらの操作が表示されますが、アップロードは無効です。本物の認証情報は自分のインストールでだけ入力してください。 [![オフサイトコピーに関する完全な説明パネル:エンドポイント、リージョン、バケット、アクセスキー、スケジュール、オブジェクトロック、および復旧キーの設定](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4)](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4) 高度なオプションを展開した完全なパネルです。ストレージの認証情報は表示されていません。 | 分野 | 入力内容 | | --- | --- | | エンドポイント | ストレージの URL。バケットのパスや認証情報は含めません。例:`https://s3.example.invalid`。 | | 地域 | プロバイダーの要件に合わせます。既定は `us-east-1`。 | | バケット | 書き込める既存のバケット。例:`example-case-backup`。 | | バケット内のフォルダ | プレフィックス。既定は `tgwitness`。その上にワークスペースごとのプレフィックスが付きます。 | | アクセスキーID / シークレットアクセスキー | 両方そろえて入力し、Vault に保存されます。後で両方を空欄にすれば、そのまま維持されます。 | | パス形式のアドレス | オン:`endpoint/bucket`。オフ:`bucket.endpoint`。プロバイダーによります。 | | コピー間隔 | 1〜1,440 分、既定は 5。アプリが動いている間だけです。 | | オブジェクトロックの保持期間 | バケットが Object Lock に対応していれば、日数とモード。0 はバケットの既定値を維持します。 | 1. バケットを作成し、**オフサイトコピーを保持する**のチェックを外したまま保存先と認証情報を入力して、**オフサイトコピーを保存**を押します。 2. **接続テスト**は暗号化したテストオブジェクトをアップロードします。 3. **暗号化キーのダウンロード**を行い、コレクターから離れた場所に保管します。鍵がなければ復元できません。 4. **オフサイトコピーを保持する**にチェックを入れて保存し、**今すぐコピー**するか、スケジュールに任せます。 ## 保存状況とコピー進捗の確認 **詳細オプション**で保持日数と `GOVERNANCE` または `COMPLIANCE` を選びます。TgWitness はアップロードしたオブジェクトから保持設定を読み戻し、確認済み、未設定、確認失敗のいずれかを知らせます。 パネルには前回の実行、オブジェクト数、バイト数、コピー済みのジャーナルの境界、エラーが表示されます。ローカルファイルがない場合は報告され、次回再試行されます。残りはコピーを続けます。 アップロードは直接接続、SOCKS5、HTTP のいずれかを通ります。MTProxy のみのルートでは、コピーはエラーのまま待機します。 ## 復元キーは別の場所に保管してください 鍵の JSON には、復号キー、保存先、プレフィックス、鍵のフィンガープリントが入っています。復元にはこれと、読み取り権限のあるストレージの認証情報が必要です。 エンドポイント、バケット、プレフィックスを変えた場合は、鍵をもう一度ダウンロードしてください。新しい保存先で新たなコピーが始まり、古いチャットエクスポートは元の場所に残ります。 ## 別のマシンでの復元と検証 信頼できる TgWitness のインストール、鍵の JSON、読み取り専用のストレージ認証情報、空のフォルダーが必要です: ### Windows PowerShell ``` $env:TGWITNESS_S3_ACCESS_KEY = 'YOUR_READ_ACCESS_KEY' $env:TGWITNESS_S3_SECRET_KEY = 'YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` ### Linux / macOS ``` export TGWITNESS_S3_ACCESS_KEY='YOUR_READ_ACCESS_KEY' export TGWITNESS_S3_SECRET_KEY='YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` まず非公開の一時フォルダーですべてを確認します:ジャーナル全体、チェックポイント、ファイルのハッシュとサイズ。危険なパス、矛盾するセグメント、チェックポイントより短いジャーナルは失敗となり、その場合は何も書き出されません。 成功すると `events.jsonl`、`media/`、`checkpoints/`、`exports/` が得られます。コマンドの JSON 出力も一緒に保管し、自分で保管したチェックポイントや証人の記録と比べてください。 --- # Telegram · GitHub Actionsのキャプチャ Canonical page: https://phishdestroy.io/tgwitness/ja/docs/capture/ 一時的な GitHub ランナーで Takeout,通常 API によるエクスポート,またはチャットログを選択します. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 一時的な GitHub ランナーで Takeout,通常 API によるエクスポート,またはチャットログを選択します. JavaScriptを有効にして、鍵を生成し、アーカイブを復号してください。 **完全な参照情報** [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [独立したキャプチャ](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md) ![独立したキャプチャ](https://phishdestroy.io/tgwitness/assets/chapter-capture.svg?v=c979502bc92b) **`main` からプレビューが可能です。**フォークでは、 `phishdestroy/TgWitness`から起動します。このワークフローは、新しく作成されたTelegramセッションを使用して、アカウント、選択されたチャット、または1つの チャットのイベントジャーナルをエクスポートし、証拠となる ZIPファイルまたはマルチパートマニフェストを認証し、 受信者側で暗号化されたハンドオフのみをアップロードします。通常の管理パネルは公開されません。 「 `client=official_web` を選択すると、Telegram Webのコントロールと動画を保護した状態で、[公式クライアントのウィットネス](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md)が実行されます。これには独自のアップストリームプロキシが必要であり、1つのレンダリング済みチャットを監視します。デフォルトでは `client=api` 設定では、後述するフルアカウントのエクスポートモードが維持されます。 検証担当者は、アーカイブを、そのGitHub認証情報、承認済みの ワークフローおよびコレクターのコミット、ならびに署名済みのジャーナルと添付ファイルのハッシュと照合して確認します。 収集プロセスでは、固定化されたアップストリームコードと新しいストレージが使用されます。レビュー担当者は、 そのコードを検査し、記録された実行内容と照らし合わせて、提供されたアーカイブを検証することができます。 **このページでは** - [ユーザーフロー](https://phishdestroy.io/tgwitness/ja/docs/capture/#user-flow) - [セッションの所要時間](https://phishdestroy.io/tgwitness/ja/docs/capture/#session-time-budget) - [このモード、または永続的なワークスペースを選択してください](https://phishdestroy.io/tgwitness/ja/docs/capture/#choose-this-mode-or-a-persistent-workspace) - [何が公的なもので、何が私的なままであるべきか](https://phishdestroy.io/tgwitness/ja/docs/capture/#what-is-public-and-what-must-stay-private) - [トラブルシューティング](https://phishdestroy.io/tgwitness/ja/docs/capture/#troubleshooting) - [ローカルでの復号と検証](https://phishdestroy.io/tgwitness/ja/docs/capture/#local-decryption-and-verification) - [フォークがキャプチャ処理の外にどのように保持されるか](https://phishdestroy.io/tgwitness/ja/docs/capture/#how-the-fork-is-kept-outside-the-capture-process) - [暗号によるハンドオフ](https://phishdestroy.io/tgwitness/ja/docs/capture/#cryptographic-handoff) - [範囲と妥当性確認](https://phishdestroy.io/tgwitness/ja/docs/capture/#scope-and-validation) - [メンテナーによるリリース手順](https://phishdestroy.io/tgwitness/ja/docs/capture/#maintainer-release-sequence) ## ユーザー ヘルパーが5つの段階について説明し、サンプルデータを使ってメッセージまたはコレクターの 置換を試すことができます。**「キャプチャを開始」をクリックすると、**ウィザードが開きます。 1. プロジェクトのホームページ、 ワークスペースのログイン画面、または**「エクスポート」→「キャプチャヘルパーを開く」**から、「**GitHub Actions キャプチャ(プレビュー)」**を選択してください。また、 最新のブラウザで、[公式のヘルパー](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) または信頼できるチェックアウトから ``tgwitness/static/capture.html`` を開くこともできます。 このヘルパーは、キーや ファイルの処理のためにネットワークリクエストを行いません。このヘルパーはサイトのインターフェース言語に対応しており、 一時的な収集パネルは英語とロシア語に対応しており、 ブラウザの言語がこれらいずれかである場合は、その言語で表示されます。 2. 鍵を生成し、**sealed-key.json を**保存してください。これが唯一の 秘密鍵(復号用)です。別途表示される公開受**信**者値をコピーしてください。 秘密鍵を紛失すると、接続とアーカイブの両方にアクセスできなくなります。 保存したことを確認してから、次のステップに進んでください。すでに 配信ファイルをお持ちの場合は、保存した鍵を読み込み、**「すでにアーカイブがあります」**を選択してください。 3. TgWitnessをフォークし、そのフォークで「Actions」を有効にして、「**Sealed chat capture」**を実行します。 公開受信者を貼り付け、30分、60分、または120分のいずれかを選択します。ワークフローの入力、コミット、イシュー、またはログには、 電話番号、ログインコード、Telegramのパスワード、秘密鍵、セッションを 絶対に記載しないでください。 4. 実行中に、Artifactsから**sealed-connectionを**ダウンロードし、解凍してください。 保存した秘密鍵を使用して、 `connection.tgwsealed` 保存済みの秘密鍵を使用して、helperに読み込みます。 生成されたリンクのURLフラグメントには、ランダムなアクセスシークレットが含まれています。 このリンクは他人に知られないようにしてください。パネルはフラグメントを削除し、シークレットを このタブのセッションストレージに保存します。HTTPアクセスログには記録されません。 5. 接続リンクを開きます。QRコード、または電話番号と ログインコードを使用してサインインします。Telegramから求められた場合は、二段階認証のパスワードを入力してください。 通常のワークスペースと同様に、デフォルトでは組み込みのAPI認証情報プールが使用されます。 必要に応じて「カスタム認証情報」セクションを展開し、両方を `api_id` および `api_hash` [my.telegram.org/apps からの両方の値を入力できます](https://my.telegram.org/apps)。組み込みプールを使用する場合は、両方の フィールドを空のままにしてください。不完全または形式が正しくないペアは拒否されます。 セッションのインポートは許可されていません。エクスポートモードとスコープを選択してください。接続 リンクにはアクセスシークレットが含まれています。これを秘密にしておいてください。 6. 「**Telegram Takeout**」、「**通常のTelegram API」**、または「**チャットイベントログ」**のいずれかを選択してください。 アカウントのエクスポートを行う場合は、アクセス可能なすべてのチャットを選択するか、1つ以上の チャットを読み込んで選択し、日付、チャットの種類、アカウントのカテゴリ、および添付ファイルのルールを設定してください。 設定とサイズを確認し、必要に応じて独立した レビュー担当者のために設定 JSON を保存してから、**「キャプチャ開始」**を押してください。開始後は設定を変更できません。 再開は、このランナーが存在している間のみ可能です。早期終了の場合、取得済みの データは保持され、欠落部分が記録されます。開始後に期限が切れた場合は、明示的に 不完全なアーカイブが生成されます。開始前の期限切れやキャンセルの場合、アーカイブは生成されません。 7. **sealed-result** が届くのを待ち、ダウンロードして解凍し、 `delivery.tgwsealed` 。これにより、 `delivery.zip`が送信され、そこには `evidence.zip`, `attestation.jsonl`と手順が含まれています。ブラウザでの復号は 256 MiBに制限されています。これより大きなパッケージの場合は、以下のローカルストリーミングコマンドを使用してください。 大きな結果には、 `delivery-NNNNNN.tgwsealed` パーツが含まれており、メインのファイルには `delivery.tgwsealed` には `evidence.parts.json` と認証情報が含まれます。 すべてのパーツをダウンロードし、以下に説明する通りローカルで組み立ててください。 8. 権限の取り消しが 確認されなかった場合や、ランナーが強制終了された場合は、Telegramの「設定」→「デバイス」で一時セッションを終了してください。正常に完了した場合はログアウトが要求され、 実行記録には権限の取り消しが確認されたかどうかが記録されます。 リポジトリには、パブリッシュされた「pinned source」および「reusable-workflow」の コミットが含まれている必要があります。ローカルブランチだけでは、他の GitHub リポジトリから呼び出すことはできません。 ## セッション時間の予算 回収の前に、 **所要時間とサイズを計算する** メッセージ数と限定されたサンプルから、選択された履歴とファイルを 推定します。表示には、サインインにすでに費やした時間、 推定収集時間、およびパッケージ作成のための予備時間が含まれます。ファイルの場合、初期の推定値は 1 MiB/s および 2 倍の時間マージンを使用しますが、進行状況に応じて、その仮定は測定された 転送レートに置き換えられます。使用方法 **メッセージのみ** または、見積もり時間が残り時間を超える場合は、選択するチャットの数を減らしてください。 Telegramで報告された「Takeout」の待機時間は予算に加算されます。コレクターは、 残りの時間がパッケージングに必要となった時点で収集を停止し、収集済みのデータを保持した上で、 部分的な結果としてマークします。したがって、120分のセッションでは、 アーカイブの作成前に期限を待つのではなく、残りの収集ウィンドウを活用します。画面上では、 フルサイズでサンプリングできなかった選択項目が識別されます。 ## このモードまたは永続的なワークスペースを選択してください | 撮影モード | 設定可能な範囲 | 違い | | --- | --- | --- | | 「Telegram Takeout」、デフォルト設定 | 利用可能なすべてのクラウドチャット、または選択したチャット、日付、アカウントカテゴリ、メディアポリシー、およびJSON/HTMLビュー | Telegramの公式エクスポート機能を使用します。承認や待機が必要になる場合があります。Takeoutは、Telegramが許可している場合、残りのチャンネルやグループを列挙し、追加の個人データを要求することができます。 | | 通常のTelegram API | 通常のAPIを通じて利用可能なメソッドに従い、アカウントの範囲および出力の選択肢は同じです。 | Takeoutは初期化されません。そのため、左チャンネルやスーパーグループの列挙、およびTakeout限定の個人データの取得はできません。連絡先には、保存されている電話の連絡先リスト全体ではなく、Telegramユーザーのみが含まれます。レート制限は引き続き適用されます。 | | チャットイベントの記録 | 選択したチャット1件、添付ファイルのポリシー、およびオプションのアバター | この実行中に確認された履歴や変更点を記録します。勘定科目、日付フィルター、およびデスクトップ対応の表示形式は適用されません。 | 3つのモードすべてで、GitHubによる認証と暗号化された配信が共通して行われます。Takeoutは 取得方法を選択し、通常のAPIアクセスに無断で置き換えられることはありません。 TgWitnessは、取得したレコードからJSON/HTMLビューを生成し、 エクスポート時に選択された取得方法を保持します。 [公式のTakeout API](https://core.telegram.org/api/takeout)をご覧ください。 デフォルトでは、「Takeout」が使用され、アーカイブされたチャットを含むすべてのアクセス可能なチャットタイプ、すべての日付、 アカウントプロフィールおよび連絡先、互換性のあるJSONおよびHTML、ならびにファイルのダウンロードが対象となります。 初期のメディア容量上限は4 GiBで、ファイルの種類ごとに上限が表示されます。これより大きなファイルや ダウンロード容量上限を超えた場合は、利用可能な場合に限りサーバー上のハッシュが使用されます。収集を行う前に、これらの 制限を確認してください。ハッシュからはファイルを復元することはできません。オプションの写真、 ストーリー、セッションのメタデータ、およびその他の個人データについては、別途選択が可能です。 テイクアウトには、既存のTelegramセッションでの承認が必要になる場合があります。Telegramが 遅延時間を設定しており、新しいログインやランナーでもこれを回避することはできません。キャプチャの最大処理時間は ログインと承認を含めて120分であるため、大規模なアカウントや承認の待ち時間が長い 場合、処理が完了しない可能性があります。永続的なローカルエクスポートを使用すれば同じセッションを再開できますが、 GitHubの認証情報は引き継がれません。 ### 設定に同意し、確認する その後 **設定とサイズを確認してください**, を使用する **検証用の設定を保存する**. 同意 その結果、 `sealed-export-settings.json` 収集前にレビュー担当者と確認を行う。 変更を行うと、保存済みの評価は無効となる。収集担当者は有効な 設定とそのSHA-256に署名し、アカウントエクスポートの受領書には同じオプションが明記される。 検証担当者は、実際のモード、選択内容、および完全性を報告し、 ジャーナルとネストされたアカウントエクスポートとの間に不一致がある場合はこれを却下する。 ``` python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete ``` `--expected-selection` 別の転送方法、チャット範囲、フィルター、または 添付ファイルポリシーを拒否します。 `--require-complete` アカウントのエクスポートおよび「完了」として記録されたチャット ジャーナルのみを受け入れます。これらのフラグが指定されていない場合でも、検証では出所と 完全性をチェックすると同時に、記録された設定と不備を報告します。実行前に想定される 選択内容について合意し、それをアーカイブとは別に保管してください。範囲と取得間隔によって、実行中にキャプチャされるデータが特定されます。 以前のバージョンと比較する際は、保持されている以前の観測結果を使用してください。 | 要件 | モード | | --- | --- | | 期間限定のセッション中に、アクセス可能なアカウントデータまたは選択したチャットをエクスポートし、外部機関による認証を受けたアーカイブをレビュー担当者に提供します | GitHub Actions のキャプチャ(プレビュー) | | 複数のチャットを継続的に監視し、アカウントを管理し、増え続けるアーカイブを検索・閲覧する | ローカルまたはDockerのワークスペース | これにより、新しいログイン情報を使用して別のキャプチャが開始されます。既存の ローカルジャーナルのアップロード、現在開いているワークスペースのエクスポート、およびTelegramセッションの再利用は行われません。 未完了のクラウドキャプチャは、そのランナーが破棄された後、再開することはできません。新しい ワークフローが開始されると、新しいキャプチャが開始されます。 ワークスペースの**「エクスポート」→「キャプチャヘルパーを開く」**を選択すると、パネル内で完全なウィザードが 開きます。スタンドアロンページでも、同じウィザード、コントロール、テーマが使用されます。 どちらの場合も、鍵と復号処理はブラウザ内で行われます。GitHubワークフローの起動と 一時的なTelegramパネルは別々のタブで開かれますが、ウィザードが 戻るタイミングを案内します。ワークスペースをロックすると、ウィザードのメモリ内の鍵がクリアされます。保存された鍵 ファイルはデバイスに残ります。 ## 「公」とは何か、そして「として守らなければならないものとは何か# コレクションは、GitHubがホストする標準的なランナー上で実行されます。承認済みのコレクターであるGitHub、 依存関係、ヘルパーページ、ブラウザ、およびHTTPSトンネルは、 この設定において信頼できる要素です。一時的なホストはTelegramのセッションと 平文メッセージを処理し、配信される成果物は受信者向けに暗号化されます。 プロジェクトのコードをフォークして、自分のリポジトリにコピーします。これにより、 **ではない** Telegramアカウントを エクスポートします。受信者のワークフロー入力は公開鍵です。 保持 `sealed-key.json`、Telegramの認証情報、ログインコード、2FAパスワード、および コミット、ワークフローの入力データ、公開ログから抽出した復号済みの接続URL。 このワークフローは、1日分の暗号化された接続/結果アーティファクトを公開します。 両方を期限内にダウンロードしてください。GitHub Actionsの利用状況、アカウントの制限、および課金 が適用されます。パブリックフォークであっても、無制限の無料コンピューティングが保証されるわけではありません。ヘルパーには、支払い情報や GitHubアクセストークンは入力されません。 秘密の復号鍵は、お使いのブラウザまたはファイル内に保存されます。Telegramのセッションデータ および平文の観測データは、必然的に一時的な収集場所に存在します。 GitHubおよびHTTPSトンネルは、引き続き信頼できるインフラストラクチャとして機能します。認証プロセスにより、 アーカイブのダイジェストおよびワークフローの識別情報が公開される場合がありますが、アーカイブの内容自体は 認証対象には含まれません。認証のタイムスタンプは、メッセージのタイムスタンプとは異なります。 ## | 症状 | 次のステップ | | --- | --- | | **「ワークフローを実行しない」**ボタン | 独自のフォークを作成し、「Actions」を有効にして、アップストリームと同期させてください `main`。承認済みのアップストリームのピンを編集して、失敗を回避しようとしないでください。 | | いいえ `sealed-connection` アーティファクト | ジョブが開始され、起動/アップロードステップが完了したかどうかを確認してください。キュー、ランナー、イメージのダウンロード、トンネル、またはリポジトリポリシーの不具合により、起動が妨げられる場合があります。 | | 接続を開くことができません | この実行用に保存されたキーを読み込み、ダウンロードしたアーティファクトを解凍して、 `connection.tgwsealed`を選択します。ランナーは引き続きアクティブである必要があります。 | | 歴史は一時停止している | パネルの状態を確認し、セッションがアクティブな間は「再開」を使用するか、すでに収集したデータで終了してください。Telegramの制限やアクセスできないコンテンツにより、データに欠落が生じる可能性があります。 | | いいえ `sealed-result` | 収集開始前にキャンセルまたは有効期限が切れた場合、アーカイブは生成されません。その場合、実行は**「アーカイブなし」**という通知で終了します。収集、認証、またはパッケージングのいずれかのステップで失敗した場合も、配信は行われません。失敗したステップには、個人情報を含まない形で、監督者が指定した理由が表示されます。認証情報を投稿せずにこれを確認してください。 | | ブラウザでは、大容量のアーカイブを復号できません | 256 MiBを超えるパッケージについては、以下のストリーミングCLIを使用してください。秘密鍵が間違っていたり紛失したりすると、結果を復号化できません。 | | 検証の結果、署名者が拒否されました | 信頼できる最新のTgWitnessインストール環境と、正確な呼び出し元を使用してください `OWNER/REPOSITORY`。アーカイブに同梱されている代替ポリシーは受け入れないでください。 | | Telegramには依然として一時的なセッションが表示されている | 「設定」→「デバイス」で終了してください。ログアウトに失敗する場合があり、ワークフローが強制終了されるとクリーンアップが実行されない可能性があります。 | このプレビューを信頼する前に、ご自身で制御できる小規模なチャットで試してみてください。メッセージと 添付ファイルを作成し、それらを収集して、結果を復号化し、検証ツールを実行し、 カバレッジやメディアの結果を確認した上で、Telegramセッションの失効を確認してください。自動 チェックでは、合成されたTelegramクライアントと、別途用意された実際のGitHub証明書 テストが使用されています。現在のリビジョンでは、実アカウントでの実行は記録されていません。 ## ローカルでの復号と 実行ファイルではなく、独立した信頼できるインストール元からのツールを使用してください。 出所不明の証拠アーカイブから提供された実行ファイルは使用しないでください: ``` 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 ``` 複数パートに分かれた配信の場合、まずメインパッケージを復号し、その抽出された マニフェストを各暗号化パートの横に置いておき、次に以下のコマンドを実行してください: ``` 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 ``` マニフェストは認証対象であり、すべてのパーツおよび結合されたZIPファイルを結びつけます。 `--max-gib` を使用して、 大容量のアーカイブに対して適切な非圧縮検証上限を設定してください。デフォルトは4 GiBです。Expected-selectionおよびcomplete-scopeチェックは、 マルチパート配信でも機能します。 Python 3.11 以降、プロジェクトの依存関係、および `--signer-digest` および `--deny-self-hosted-runners` に対応した最新のGitHub CLIが必要です。また、CLI用の鍵生成ツールも 利用可能です: `python -m tgwitness.sealed_crypto keygen sealed-key.json`. 検証ツールは `tgwitness/sealed_policy.json` を信頼できるインストール元から取得します。 呼び出し元のリポジトリ、アップストリーム署名者のワークフロー、承認済み署名者の コミット、ホスト型ランナーの要件、完全なZIPダイジェスト、内部ジャーナルおよび 添付ファイルの整合性、最新のアカウントキーの由来、および期待されるコレクターのコミットを検証します。 すべてのデータが保存されたと暗黙的に扱うのではなく、履歴とメディアの結果を表示します。 承認済みリリースリストが空の場合、処理は失敗(closed)となります。ポリシーの更新は明示的な 信頼判断であり、アーカイブ自身が提案したポリシーを自動的に受け入れることは決してありません。 オフラインで利用する場合は、事前に信頼できる環境から信頼できるルートを入手してください: ``` 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 ``` この証明のタイムスタンプは、アーカイブの信頼性を示すものです。これは、 メッセージのタイムスタンプやコレクターのシステム時刻の真正性を保証するものではありません。 [GitHubの検証オプションを](https://cli.github.com/manual/gh_attestation_verify)参照してください。 ## フォークがキャプチャ処理の外に保持される仕組み caller には、完全なコミット SHA における上流の再利用可能なワークフローへの ジョブレベルの参照が含まれています。そのワークフローは、**固定されたコレクター SHA において 上流リポジトリを**明示的にチェックアウトします。再利用可能なワークフロー内のデフォルトの `actions/checkout` は呼び出し元をチェックアウトすることになるため、意図的に使用されていません。 このワークフローでは、呼び出し元のキャッシュの復元、呼び出し元のアーティファクトの使用、 呼び出し元のファイルの実行、およびソース/イメージのURL、シェルコマンド、準備済みのZIPファイル、 署名対象のハッシュの受け入れは行われません。指定された範囲内の公開受信者とセッション期間のみを受け入れます。 アクション、Python ベースイメージ、および cloudflared は不変のダイジェストによって固定されており、 Python の依存関係には既存のハッシュロックされた要件が使用されます。イメージは キャッシュを使用せずに、信頼できるソースからビルドされます。 コレクターは、読み取り専用のイメージ、Linux キャパビリティの削除、リソース制限、およびDockerソケットやGitHubトークンの環境設定なしの状態で、非rootユーザーとして実行されます。 マウントされるのは、新しい設定ディレクトリ、ワークスペース、および出力ディレクトリのみです。 制限されたFastAPIアプリケーションは、ログイン、ダイアログ、設定可能なアカウントまたはチャットコレクション、 ステータス、再開、終了、およびキャンセルを公開しています。平文でのダウンロードルート、 一般的な管理ルート、インポートルート、および署名エンドポイントは存在しません。 スーパーバイザーは、アテスト処理が 最終的に修正された `evidence.zip` 、あるいは `evidence.parts.json`を読み込む前に、スーパーバイザーがネットワークに接続されたコンテナを停止します。パッケージング用コンテナにはネットワーク接続がありません。 アップロード手順では、 `connection.tgwsealed` および `delivery*.tgwsealed`のみを指定しています; 平文の証拠やTelegramの認証情報は、アーティファクトとしてアップロードされません。 クリーンアップによりプライベートディレクトリとコンテナが削除され、GitHubはジョブ終了後に ホスト型ランナーVMを破棄します。アーティファクトの保持期間は1日間です。有効期限が切れる前にダウンロードしてください。 フォークの所有者は、呼び出し元を置き換えたり、別の署名付きファイルを作成したりすることができます。 厳格な検証ツールは、その結果として生じる**異なる署名者のワークフロー/ダイジェストを**拒否しなければなりません。 この仕組みは、承認済みコードに悪用可能なバグが存在しないこと、 およびGitHubのランナーと署名インフラの完全性に依然として依存しています。 ## 暗号化 各受信者キーはRSA-3072(RSA-4096のインポートも受け入れられます)で、指数は65537です。 各エンベロープには、新規に生成されたランダムなAES-256キーと96ビットのノンスが使用されます。 RSA-OAEP( SHA-256/MGF1-SHA256)がAES鍵をラップします。128ビットのタグを持つAES-GCMが、 プレフィックス全体とペイロードの認証を行います。受信者の公開鍵はbase64エンコードされたDER SPKI形式であり、 秘密鍵ファイルにはbase64エンコードされたDER PKCS8が含まれています。 エンベロープバイトは `TGWSEAL1\n`、ビッグエンディアンの uint32 形式の JSON ヘッダー長、 ヘッダー、暗号文、および 16 バイトの GCM タグで構成されます。ヘッダーには正確に `algorithm`, `key`で構成され、 `nonce`で構成され、アルゴリズムは `RSA-OAEP-256+A256GCM`です。ヘッダーに至るまでの完全なプレフィックス は、GCMの追加認証データです。ヘッダーのサイズは 8192バイトに制限されています。CLIは最大8 GiBのペイロードをストリーム送信し、 要求された出力を書き込む前に認証を行います。また、既存の宛先の上書きは拒否します。 これは、標準的な暗号プリミティブを包み込むプロジェクト固有のエンベロープであり、 SHA-256 および AES-256-GCM を用いた RSA-OAEP であり、OpenSSL およびすべての主要な 暗号ライブラリで利用可能です。 元の証拠バイトは、証拠と 認証情報を暗号化された外側のパッケージに格納**する前に**認証されます。これにより、アーカイブのハッシュと、その同じアーカイブ内に含まれる証明書との間の循環依存関係が 回避されます。 公開リポジトリの場合、認証メタデータ(リポジトリ、ワークフロー、コミット、 アーティファクト名、ダイジェスト)は公開されます。公開メタデータには、チャット名を絶対に記載しないでください。 ## 範囲と このモードでは、署名付きジャーナルおよびアカウントエクスポートエンジンが使用されます。シークレットチャット、 収集以前の削除済み履歴、およびアカウントからアクセスできないデータは 除外されます。プライベートクラウドチャットは、選択された場合に対象となります。チャットピッカーは 20,000件のダイアログまでが上限となり、アカウントエクスポートは独自のインベントリを検出します。欠落データ、失敗したファイル、および未完了の タスクは記録されます。添付ファイルの制限およびランナーのディスク容量・時間制限は引き続き適用されます。 大容量の配信では、固定の4 GiBという配信上限の代わりに、暗号化されたパーツが使用されます。 完了とは、凍結された選択済みタスクが終了したことを意味し、過去のすべての Telegramレコードがアーカイブに存在することを意味するものではありません。チャットジャーナルはリアルタイムの 更新も追跡できますが、いずれのモードもアトミックなスナップショットではありません。生成されたスクリーンショットや画面 録画は、このモードの対象外です。 テストの対象には、合成された新規ログイン、スコープの分離、メディア、キャンセル、 期限前の部分的な完了、ログアウト失敗、禁止されたAPIパスおよびフィールド、 プリロードされたワークスペースの拒否、不正なキーおよび改ざんによる拒否、必須の検証者 フラグ、およびブラウザとPython間の暗号化相互運用性が含まれます。ブラウザの受入 テストでは、明示的にラベル付けされた模擬アテステーションを使用しており、実際のSigstoreテストではありません。 実際のホスト型ランナー、Docker、GitHubによるアテステーション、およびTelegramでの実稼働受入 テストについては、ローカルでの合成チェックとは別に報告する必要があります。 [GitHub Actionsの利用規約では](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#actions) 、 ホスト型ランナーの使用をソフトウェアプロジェクトのライフサイクル内に限定しています。フォークを行っても これらの制限は解除されません。このプレビュー版を、制限のない 無料の本番環境ホスティングとして宣伝してはなりません。[Cloudflare Quick Tunnelsも](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) 、テストおよび開発を目的としています。helper/workflowsは、 この機能を評価するのに適していますが、本番サービスとしての適格性は、引き続き別途の デプロイ要件となります。 ## メンテナーのリリース 1. コレクター、スーパーバイザー、コンテナの定義、およびテストをコミットし、レビューを行う。 2. そのコレクターのコミットを `sealed-collector.yml`にピン留めし、その後、 再利用可能なワークフローをコミットまたはレビューしてください。呼び出し元のSHAからチェックアウトを黙って導出することは絶対に避けてください。 3. 再利用可能なワークフローのコミットを `sealed-witness.yml` にピン留めし、その ワークフロー/コレクターのSHAペアを `sealed_policy.json` に追加してください。 4. 参照されているすべてのコミットとヘルパーを公開し、その後、独立したフォーク および実際のGitHub証明書でテストを行ってください。参照が再生成され、再度公開されるまでは、 これらのピンによって参照されているコミットをスクイーズして削除しないでください。 呼び出し元リポジトリとアップストリームの署名者の違いについては、[再利用可能なワークフローおよび認証情報を](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) 参照してください。 --- # Telegram · すべてのチャットを横断的に調査する Canonical page: https://phishdestroy.io/tgwitness/ja/docs/cases/ チャンネル、グループ、プライベートチャット、ボットを横断して、Telegramの調査をエンドツーエンドで実施します。アカウント全体のキャプチャ、履歴、参加者、リンク、ファイル、タイムライン、および検証済みの証拠を網羅します。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) チャンネル、グループ、個人チャット、ボットにまたがる 1 つのケース:収集し、点と点をつなぎ、時系列を再構成して、引き渡します。 架空のインシデントを最初から最後まで。収集、検索、人物プロフィールで記録を見つけ、[Case Board](https://phishdestroy.io/tgwitness/ja/docs/case-board/) で整理し、[Report studio](https://phishdestroy.io/tgwitness/ja/docs/reports/) で提示します。 実例/支払い先が変更されたケース ### 1件のインシデント。4つの会話。再構築すべき痕跡。 チャンネルの投稿がボットを指しています。グループでは新しい支払いリンクが話題になり、ボットもそれを表示します。投稿が編集され、個人チャットでリンクが繰り返され、グループのメッセージが消えます。 各バージョンは誰が投稿したのでしょうか?そのリンクはどこに表示されましたか?どのファイルが保存されましたか?何が、いつ変更されましたか? 履歴の読み込み、AI、MCP、OCR、webhook:[アーカイブを活用する](https://phishdestroy.io/tgwitness/ja/docs/archive/)。 ## 1. アカウント全体を網羅するように設定する アカウント全体の範囲は専用アカウントでのみ使います。メインのアカウントでは、選んだチャットかフォルダーにします。 1. 専用のワークスペースで[アカウントを接続](https://phishdestroy.io/tgwitness/ja/docs/accounts/)します。ケース番号、アカウント ID、ワークスペース、鍵のフィンガープリントを控えます。 2. **ソース → 観察範囲 → 調査モード**:**アカウント全体**、4 種類すべてのソース、**自身のアクション**。新しいチャットごとにプロフィールと**最新200件の表示可能なメッセージ**が保存されます。**範囲を保存**して確認します。 3. **チャットを読み込む**を実行し、アカウントのチャット一覧と比べます。上限は 1,000 件の会話です(**パラメータ → アカウントの一覧から読み込むチャット**で最大 20,000)。それを超えるチャットは、動きがあった時点で表示されます。 4. **記録設定** → **表示されているすべてのアクティビティ**を選び、添付ファイルの上限とディスク容量を確認します。開始したら、メッセージ、編集、削除を 1 つずつ試します。 チャンネルグループプライベートチャットボット 1つのアカウント/1つの署名鍵**選択されたアカウントの公開アクティビティすべて → 1つのジャーナル** メッセージ・編集・削除通知・表示されたリアクション・メンバーシップのイベント・自身のアクション 「アカウント全体」とは、このアカウントが開けるすべてのチャットから除外分を引いたものです。シークレットチャットは Secret Chats モジュールが記録します。新しいチャットは現れた時点で加わり、古い履歴は必要に応じて読み込みます。 ## 2. 履歴を取得し、ファイルを保存する Case Board のコレクションを作り、重要なものをブックマークします。ソース台帳を付けてください:チャット ID、タイトル、アカウント、役割、ライブ記録の開始、履歴の結果、メディアの結果、欠落。 | 要件 | パネルでの操作 | 提供内容 | | --- | --- | --- | | 有効化されたチャット全体の履歴 | 出典 → 履歴をすべて読み込む | 利用可能な過去のメッセージはワークスペースのジャーナルに記録され、一時停止・再開機能や署名付きの進捗レポートが利用可能です。[履歴ガイド](https://phishdestroy.io/tgwitness/ja/docs/reference/history/)。 | | ジャーナル内の既存のチャット履歴 | ソース → 記録設定 → 履歴スナップショット | 最近のメッセージを署名付き記録として保存します。既定は 500 件、**パラメータ → 最大履歴スナップショット**で最大 10,000 件。 | | 1つのチャットにおける、現在表示されている履歴のすべて | チャット全体のエクスポート → チャット全体をエクスポート、または チャット → チャットをエクスポート | `chat.json` と `chat.html` を含む別の署名付きバンドルを、チャットごとに 1 つ作ります。 | | 新しいチャットが表示された際の状況 | 監視範囲 → 新しいチャットやボットが出現したとき | プロフィールと最大 1,000 件の最近のメッセージ(調査モードでは 200 件)。既存のチャットには適用されません。 | | 添付ファイルのバイト数 | 表示可能な添付ファイルのダウンロード + ファイル種別ごとの制限 | SHA-256 とサイズ付きの `media.saved` を探してください。キュー待ち、スキップ、失敗は保存されていないという意味です。 | チャットのエクスポートは、ジャーナルや人物プロフィールには入りません。TgWitness 内で古い履歴を検索するには、**全履歴を読み込む**かスナップショットを使ってください。 ここでは:チャンネル、グループ、ボットとのチャット、個人チャット、それに請求書ファイルとそのハッシュ。記録開始前に削除されたものは失われています。 ## 3. 展開する会話と自身の行動を記録する 動かし続けてください。注目のチャットにはスターを付けて優先し、**記録設定 → 再確認**で再確認を調整し、`recheck.completed`、FloodWait、メディアの結果に注意します。 **チャット → プロフィール → プロフィールを今すぐ保存**で、チャットの説明、ボットのコマンド、その他のメタデータを保存します。 **事件調査の一環として、ボットをフォローするか、招待を受け入れること** 1. **チャット → Telegram リンクを開く**では、まずプレビューを保存します。リンクとプレビューは署名付き記録になります。 2. 必要なら、**参加 / 開いて観察**でチャットに参加するか、開始パラメータ付きでボットを起動します。 3. 操作を記録に残すには、パネルから返信するか**ボタンを押す**を使います。`interaction.requested` と `interaction.result` が、ボットの応答と一緒に記録されます。 これらは実際の操作です。別のアプリで押したボタンは見えず、見えるのはボットの返信だけです。Web アプリ、支払い、電話番号/位置情報は対象外です。 ## 4. チャット間の人物、リンク、ファイルを追跡する 1. **ジャーナル**、**すべてのソース**で、フレーズ、ドメイン、ユーザー名を検索します。ヒットを開いて**ボードへ**送ります。 2. **チャット → ユーザー → プロフィールを表示**で人物を選びます:名前の履歴、返信、アクティビティ、**関連項目…**、リンク、ウォレット、電話番号。引用された記録を開きます。 3. 同じ数値のユーザー ID を他のチャットでも追います。一致する名前、ウォレット、アバターは、数値 ID と照合すべき手がかりです。 4. ファイルのハッシュを比べます。SHA-256 が同じ = バイトが同じ。 ケースマップ / 参照先を追跡する架空の事例・実際のグラフではありません チャンネル / お知らせ**原文 → 編集後の翻訳文** 記録 #101、#188 メッセージ #84 · 送信者不明 グループ / 運用**ユーザー71001が新しいリンクを投稿しました** 記録 #146 · メッセージ #309 保存済みファイル受領確認 #151 BOT / 注文に関する会話**そのリンク先へ移動するボタンがあります** 記録 #173 · メッセージ #12 「戻る」ボタンのメタデータ 非公開 / フォローアップ**ユーザー71001が宛先を繰り返し入力しています** 記録 #205 · メッセージ #922 保存済みファイル受領証 #209 4つのチャットから、それぞれ異なる観察結果が得られています。すべての接続についてソース記録を追跡してください。チャンネルの投稿には送信者の情報が記載されていません。 数値 ID およびレコード参照番号は、この手順説明のために架空のものであり、実際のものとは異なります。この説明図は、検索結果、プロフィール、および調査済みレコードをどのように関連付けるかを示しています。「Case Board」には、対応するカードとソース参照が保存されます。 | 接続 | 補足情報 | 維持すべき結論 | | --- | --- | --- | | 同じTelegramアカウント | グループ #146 およびプライベートチャット #205 のユーザー ID 71001 | 両方のチャットで送信者 ID が同じです。 | | 繰り返し先 | #146の`pay.example.invalid/new`、ボタンのメタデータ #173、編集された投稿 #188 および #205 | 同じリンクが 4 か所にあります。 | | 同じファイルのバイト数 | 完了したメディア受信記録 #151 および #209 における SHA-256 値が完全に一致しています。 | 2 つのファイルはバイト単位で同一です。 | プロフィールの対象は*このワークスペース*で何かを書いた人だけで、メンバー一覧ではありません。事実ごとの引用数:**パラメータ → 事実ごとの引用記録数**。 ## 5. 時系列を再構築し、欠落部分を明記する **チャット**で版を確認し、次に**ジャーナル**で**すべてのソース** + **編集**、**削除**、**カバレッジ**を選びます。時系列には 2 つの時刻を書きます:Telegram の日付と、観察された時刻です。 1. 09:00 · #101**キャプチャされたチャンネルの投稿** 元のリンク先はそのまま維持されています。 2. 09:12 · #146 / #151**グループが別のリンクを紹介しています** ユーザー71001が投稿し、添付ファイルのダウンロードが完了しました。 3. 09:16 · #173**ボットは同じ宛先を表示します** 保存されたキーボードのメタデータには、そのリンクが含まれています。 4. 09:20 · #188**チャンネルの告知の変更点** 元の記録と編集後の記録の両方が残されます。 5. 09:24 · #205 / #209**非公開のフォローアップでも同様の内容が繰り返されています** 保存された添付ファイルのSHA-256ハッシュ値は、#151と同じです。 6. 09:28 · #231**グループ削除の通知が届きました** 以前の指摘は依然として当てはまります。削除者や正確な削除時刻は提供されていません。 観察時間や参照情報の例を示しています。これらのエントリの間には、その他のジャーナル記録が存在します。 ジャーナルの順序は届いた順で、起きた順とは限りません。ライブの記録、スナップショット、復元したメッセージ、削除、「再確認で見つからない」は分けておき、欠落はすべて不明として印を付けてください。 ## 6. 他の収集用アカウントにも適用する アカウントごとに 1 つのワークスペースで、同じ手順です。それぞれの役割とフィンガープリントを控えます。メッセージ番号はアカウントごとなので、必ずワークスペースとチャットを明記してください。 [アカウントグループ](https://phishdestroy.io/tgwitness/ja/docs/groups/)は状態を表示し、設定を共有し、全員をまとめてエクスポートします。それぞれが自分のジャーナルと鍵を持ちます。アカウントをまたぐ時系列は、メモの中で自分で組み立てます。 長いケースですか?[独立した証人](https://phishdestroy.io/tgwitness/ja/docs/witness/)を加え、各アカウントが実際に何を記録しているかを試してください。 ## 7. 検証可能なケースパッケージの提出 各ワークスペースの署名付き ZIP(常にジャーナル全体で、フィルターは関係しません)、それに人物プロフィール、チャットエクスポート、ファイル。 ``` CASE-001/ # assembled by the analyst case-notes.md # question, findings, alternative explanations sources.csv # every chat, role, acquisition result and gap timeline.csv # account + chat + message + seq + both times workspace-A/ evidence.zip # complete signed observation journal retained-checkpoint.json profiles-operations.json # separately signed people profiles history-channel.zip # signed current-history export history-group.zip verification.txt workspace-B/ # separate journal and trusted fingerprint witness/ # retained checks, journal and signed posts SHA256SUMS # hashes of the delivered files ``` フィンガープリントは別経路で送ります。それぞれを自分のワークスペースと照合して検証します: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` チェックポイントはコレクターキーで署名されているため、それだけでは証拠としての最低要件を満たしません。`--require evidence`を使用するには、最後のレコードをカバーする検証済みのタイムスタンプまたはウィットネス投稿も必要です。 検証ツールの出力、原本、カバレッジ、引き渡しの記録を調査結果と一緒に保管します。まとめは Report studio で書きます。相手に必要な量が少なければ、[最小化した引き渡し](https://phishdestroy.io/tgwitness/ja/docs/handover/)を作ってください。 --- # Telegram · Case Boardの作成 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/case-board/ 保存された観察結果、正確なハイライト、アクションスライスをプライベートボードに収集し、チームと議論して、収集結果を提示してください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 保存したメッセージを、チームで一緒に取り組むケースに変えます。 ブックマーク、正確な引用、スライス、議論。それぞれが元の記録にリンクしています。変更はすべて署名付きの改訂になります。 ## メッセージからケースカードへ 1. **調査 → Case Board**(標準またはエキスパートモード)。ケース用のコレクションを作ります。 2. **ジャーナル**やチャットで**ボードへ**(または **B**)を押します。カードは受信箱に入るので、タイトルを付けて移動します。 3. メッセージの文字を選択し、**ハイライト → ボード**で正確な引用と版を保存します。なぜ重要かを書き添えます。 4. 議論し、ステータスを付け、必要なときはいつでも元の記録に戻ります。**プレゼンテーション**でチームに順を追って見せます。 ### 変更された支払いリンクを1つ追跡してください 合成例・ローカルな図解 1. **キャプチャ。**保存済みの観察記録 #142 およびそのメッセージバージョンを開きます。 2. **ブックマーク。**引用文、出典情報、およびご質問をカードに保存してください。 3. **レビュー。**チームコメントを追加し、カードを「レビュー」に移動してください。 4. **現在形を使用してください。**収集手順を順を追って説明し、引用されたソースのコンテキストを開いてください。 #### 保存された観察記録 #142 「新しい支払いリンクをご利用ください。」 運用チャット・メッセージ 38・確認時刻 09:12 UTC #### カード:宛先を変更 > 新しい支払いリンクをご利用ください。 質問:以前のバージョンにはどの宛先が表示されていましたか? #### チームによるレビュー アナリスト:観察事項#101と比較してください。 ステータス:レビュー済み・修正内容を反映 #### 原文の文脈 カード → 保存されたバージョン → 以前の観察記録 注釈とTelegramの監視記録は、それぞれ個別に識別可能です。 ## 有用な範囲を一度保存する 2 つのメッセージを Shift+クリックして**その間のスライス**、**時間でスライス**を使うか、現在のジャーナルのフィルターを保存します。**ブックマーク以降に追加されたレコードを表示**で、後から届いたものが見えます。 時間のスライスは観察時刻を使い、メッセージ ID のスライスはそのメッセージの変化を追います。 ## 各同僚に適切な役割を割り当てる **レビュー担当者**は閲覧、**アナリスト**はカードとコメントを追加、**オペレーター**はさらにコレクションと決定を管理します。チャットの権限はカードにも適用されます。 ## この作業を成果物としてまとめ上げてください スライスは署名付き JSON または CSV でエクスポートできます。レポートにはブックマーク、スライス、コメントを入れられ、[Report studio](https://phishdestroy.io/tgwitness/ja/docs/reports/) で設定します。限られた相手には[引き渡し](https://phishdestroy.io/tgwitness/ja/docs/handover/)を使ってください。 詳細:[Case Board リファレンス](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/)。 --- # Telegram · レポートの作成 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reports/ レポートデータ、8種類のデザインから1つ、および内容を選択し、プレビューを行った後、HTML、署名付きPDF、または完全な証拠パッケージとしてエクスポートします。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 読み手をケースの問いから保存された記録へまっすぐ導きます。 Report studio は、選んだデータ、変更履歴、グラフ、あなたの調査結果をまとめます。8 つのデザイン、HTML とネイティブ PDF。HTML、PDF、JSON のレポートはすべてあなたの鍵で封印されます。 ## 3つのステップでレポートを作成する 1. **エクスポート → 設定とプレビュー → データ**:ワークスペース全体、またはチャット、作成者、日付(UTC、TgWitness が記録を見た時刻)、記録の種類を選びます。 2. **デザインとコンテンツ**:デザインと中身を選びます:グラフ、参加者、トランスクリプト、変更、Case Board の項目、ケースの詳細、メモ。 3. **プレビュー**:件数、アクティビティ、サンプル、欠けている ID の範囲を確認します。保存してから、必要な形式をダウンロードします。 ### 保存された資料を、読者が理解しやすいように整理してください 合成例・概略レイアウトであり、生成されたレポートではありません 1. **[選択]。**本案件の対象となるチャットを2つと、観察期間を選択してください。 2. **文章を作成してください。**レイアウトを選択し、質問に答えるセクションを選んでください。 3. **プレビュー。**選択された件数と、保存された「変更前」および「変更後」のテキストを確認してください。 4. **検証を行ってください。**最終ファイルを生成し、その署名を信頼できるワークスペースのフィンガープリントと照合して確認してください。 #### 主な留意点 チャット 2件・観察日 1日 メッセージ、編集、削除通知 #### レポートの構成 ##### 支払先が変更されました 事案の質問 → 調査範囲 → 調査結果 → 記録の参照情報 **メッセージの文脈** 観察事項 #142:「新しい支払いリンクをご利用ください。」 **保存された変更** 変更前:old.example.invalid → 変更後:new.example.invalid #### 選択内容を確認する 18件の指摘 · 2件の編集を保存 送信日時、編集日時、閲覧日時にはそれぞれ個別のラベルが付けられています。 #### 最終成果物 署名付きPDF + 署名付きJSON、または署名付きZIPファイルとその読み取り可能なレポート 受信者はファイルと信頼できるフィンガープリントを確認します。 ## 読み方のスタイルを選択してください **Classic, Editorial, Briefing, Analytics, Technical, Overview, Reading series, and Ledger & margin**:同じ記録で、見た目が違います。切り替えても選択とメモは保持されます。25 言語のどれでも使えます。 PDF は同梱のフォントで作成され、ブラウザーは不要です。中国語、日本語、韓国語にはサーバー上に Noto Sans CJK などのフォント(システム全体または `TGWITNESS_FONT_DIR`)が必要で、ない場合は HTML と JSON のみになります。 ## 変更内容をその文脈とともに読み取る 編集は前後を、削除は最後に保存された版を表示します。返信、転送、リアクション、ボタン、添付ファイルは参照を保ちます。 デザインのプレビューは最初の 50,000 件の記録を使い、データのプレビューはすべてを正確に数えます。最終的なページレイアウトは PDF を作成して確認してください。 ## 受信者向けの文言は慎重に選定してください フィルターはレポートの形を決めるだけで、証拠 ZIP には引き続きジャーナル全体とファイルが入ります。相手に渡す量を減らすなら、[最小化した引き渡し](https://phishdestroy.io/tgwitness/ja/docs/handover/)を使ってください。詳しくは:[レポートの内容](https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/)、[エクスポートの検証](https://phishdestroy.io/tgwitness/ja/docs/exports/)。 --- # Telegram · 共有用コピーを作成してください Canonical page: https://phishdestroy.io/tgwitness/ja/docs/handover/ 受信者が受け取ることができる記録とフィールドを選択し、完成したコピーを確認して、署名済みのマニフェストおよびソースジャーナルの境界を検証してください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 必要なものだけを共有し、原本には手を付けません。 引き渡しは別の署名付き抽出です:チャットと人物を選び、身元や本文を隠し、ファイルとチームのメモを選びます。マニフェストに、残したもの、削ったもの、除いたものが記録されます。 ## 受信者向けの抜粋を作成する 1. **エクスポート → 引き渡し用抽出**:目的を書き、チャットと期間を選び、名前を出す人物が必要なら**選択したチャットの人物を読み込む**を使います。 2. それ以外の人:仮名、除外、または記録どおり。本文とファイルは別々のスイッチで、電話番号とメールはマスクできます。 3. Case Board:なし、ブックマークとスライス、またはコメント付きのカード。チームの名前は別名に置き換えられます。 4. **引き渡し用抽出をダウンロード**し、開いて検証し、送る前に目を通します。 ### 原本1部、共有用コピー1部 合成例・イメージ図(参考用) 1. **選択してください。**ケースチャットを含め、抜粋の対象となる人物を特定してください。 2. **最小化。**共有コピーに他の参加者がどのように表示されるかを選択してください。 3. **確認。**生成されたアーカイブのレポートと記録を、送信する前に開いて**確認してください**。 4. **共有してください。**校正済みの原稿を納品し、その信頼できるフィンガープリントを別途お知らせください。 #### 元の観察事項 Nora · ユーザー 71002 「修正後のリンクを受け取りました。」 ソースジャーナルには、この保存された観察記録が保持されます。 #### 受取人用コピー 記録どおりに表示:Nora · ユーザー 71002 · 「修正されたリンクを受け取りました。」 仮名:P01 · 「修正後のリンクを受け取りました。」 省略:この参加者のメッセージは本文から除外されています。 #### 実際のファイルを確認してください report.html および records.jsonl をお読みください。 ID、テキスト、添付ファイル、および任意のチームコメントを確認してください。 #### 署名付き抜粋 選択 + ファイルハッシュ + 署名付きマニフェスト ソースジャーナルの境界にリンクされた別のパッケージ ## 各操作を組み合わせて使用してください | 制御 | 翻訳文への影響 | | --- | --- | | 人物 | 選んだ人物は名前のまま、他の人は仮名になるか除外されます。 | | テキスト | すべての本文、選んだ人物とあなたのアカウントの本文のみ、またはなし。 | | ファイル | 選んだ人物とあなたのアカウントのファイル、表示されているすべてのファイル、またはなし。 | | ケースボード | なし、ブックマークとスライス、または議論付きのカード。 | 本文とファイルも読んでください:仮名にしても、メッセージや添付ファイルの中に書かれた名前は消えません。選んだファイルが見つからない場合は、復元するか添付ファイルを除外してください。 ## 翻訳文は、独立して検証可能であるようにしてください。 ``` python -m tgwitness.verify handover.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` 元のアーカイブとチェックポイントは自分で保管してください。相手はワークスペース全体を受け取らなくても自分のコピーを検証できます。デザイン:[Report studio](https://phishdestroy.io/tgwitness/ja/docs/reports/)。信頼できる照合先:[エクスポートの検証](https://phishdestroy.io/tgwitness/ja/docs/exports/)。 --- # Telegram · アカウントグループの管理 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/groups/ グループワークスペースを比較し、ソースを検索し、監視期間を確認し、アカウントごとの例外設定を適用して共有設定を適用します。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 複数のアカウントをまとめて動かし、それぞれが自分の記録と鍵を持ち続けます。 グループは、接続状態、開始/一時停止、共有設定、エクスポートを 1 つの画面にまとめます。複数のアカウントで同じケースに取り組むときに便利です。 ## グループの概要を開く **アカウント**でグループを開きます。各アカウントの状態、ルート、遅延、最後に保存したメッセージが表示されます。**注意が必要**には問題のあるものが並び、**修正**でそこへ直接移動できます。 **すべて開始** / **すべて一時停止**は実行前に確認します。**グループ設定**は共有されますが、アカウント独自の値は置き換えるまで残ります。 ### グループ全体での経路変更を確認する 合成例・説明用のチェック項目と結果 1. **[選択]。**グループを選択し、どのアカウントが変更されるかを確認してください。 2. **準備。**分離しておく必要がある場合は、アカウント固有の経路を維持してください。 3. **確認。**提案された接続をテストし、測定結果を確認してください。 4. **適用してください。**保存前に再確認し、各アカウントの結果を精査してください。 #### ケースチーム チャンネルコレクター · グループコレクター · 参照アカウント 3つの独立したワークスペース #### 選定済みの内容 2つのアカウントが提案された手順に従います。 参照アカウントは独自の経路を維持します。 #### 準備確認事項 チャンネルコレクター:Telegram転送時間 84 ms グループコレクター:Telegram転送 91 ms これらの数値は、例示のための架空の測定値です。 #### アプリケーションの結果 チャンネルコレクター:保存済み、監視再開。 グループコレクター:再確認に失敗したため、以前の設定が復元されました。 参照アカウント:独自のルートが維持されています。 ## レビュー工程を追加してプロセスを変更する 1. **グループルートの変更**で種類と設定を選びます。 2. **選択内容の確認**:どのアカウントが変わり、どれが独自のルートを持つかを確認します。 3. **準備して確認**で新しい Telegram 接続をテストし、可能なら出口 IP も確認します。 4. **確認済みの接続を適用**し、それぞれの結果を見ます。動作中のアカウントは再開し、停止中のものは停止したままです。 遅延は Telegram 接続の確立にかかった時間で、出口 IP は確認時にルートが示したものです。結果はアカウントごとに異なることがあります。 ## 重複するアクセス権を使用する **複数のアカウントが閲覧できるチャット**には、共有のソースとそのカバレッジが並びます。チャンネルとスーパーグループは**… アカウントでエクスポート**で複数のアカウントから同時にエクスポートできます。個人チャットと通常のグループはできません。メッセージ番号がアカウントごとだからです。 ## グループをパッケージとしてエクスポートする **グループのエクスポート**では、各アカウントの署名付きエクスポートとその署名付き一覧を 1 つの ZIP にまとめます。それぞれが検証用に自分のフィンガープリントを保ちます。統合した時系列は自分で組み立てます。 次は:[レポート](https://phishdestroy.io/tgwitness/ja/docs/reports/)、[Case Board](https://phishdestroy.io/tgwitness/ja/docs/case-board/)、[エクスポートの検証](https://phishdestroy.io/tgwitness/ja/docs/exports/)。 --- # Telegram · 証拠の仕組みをご覧ください Canonical page: https://phishdestroy.io/tgwitness/ja/docs/concepts/ メッセージの取得からチェックポイントまでの流れを追跡します。サンプルレコードを変更し、そのSHA-256チェーンを再計算して、保持されているチェックポイントが何を検出するかを確認してください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) メッセージは変わります。あなたが見たものの記録は変わるべきではなく、誰でもそれを確認できるべきです。 以下は小さな実験が 2 つです。メッセージは架空で、すべてブラウザー内で動き、Telegram には何も送られません。 ## チャットのエクスポートから検証可能な記録へ [Telegram Desktop のエクスポート](https://telegram.org/blog/export-and-more)は、今見えている履歴を HTML または JSON で保存します。TgWitness はそこに、変更を記録し続けるジャーナル、すべての記録への署名、他の人が照合できるチェックポイントを加えます。 | タスク | Telegram Desktopからのエクスポート | TgWitness | | --- | --- | --- | | 保存された会話を読む | HTML または JSON(選択されたメディアを含む) | 保存されたチャット、検索可能なログ、オフラインレポート | | 経時的な変化を追跡する | エクスポート時に利用可能な履歴 | 旧版、後の編集、削除をすべて保持 | | 引き渡し後のファイルを確認してください | 標準の HTML/JSON エクスポートファイルには署名がありません | 署名付きマニフェスト、署名付き記録、封印されたレポートを、信頼できる鍵で確認 | | 以前の保存状態と比較する | 参照用コピーまたはハッシュ値を別途保管してください | 署名付きチェックポイント、独立したウィットネス、およびオプションの外部タイムスタンプ | この比較は 2026 年 11 月 2 日時点の [Telegram Desktop のエクスポートコード](https://github.com/telegramdesktop/tdesktop/tree/768d47cda6c7f447c10a25d1f363279493a90ed7/Telegram/SourceFiles/export/output)に基づいています。 ## 1つのメッセージ、3つの観察点 新しいメッセージ、編集、削除は 3 つの別々の記録になります。編集は最初の記録を上書きせず、削除も消しません。 01 / メッセージの経路説明用のシーケンス Telegram delivers an update to the collector, which appends a journal record. · Telegram · コレクター · ジャーナル · 更新 → · 追加 → 現在のチャット画面 メッセージ #42 メッセージが削除されました そのメッセージはチャット画面から消えました。 観察記録 3件の記録 1. 01 `message.new` 10:00に集合してください。 ✓ 2. 02 `message.edited` 11:00にお会いしましょう ✓ 3. 03 `message.deleted` #42 に関する削除通知 ✓ 記録された3つの観察事項はすべて、ジャーナルに残ります。 すでに選択済みのソースに対する簡略化された手順です。運用記録も実際のジャーナルと共有されます。記録内容は、アカウントが閲覧できる範囲およびTelegramが配信する内容によって異なります。 ## 記録を変更する。ハッシュを追跡する。 どの記録にも直前の記録のハッシュが入っています。別の場所に保管したチェックポイントが、ジャーナルの長さと最後のハッシュを固定します。 02 / HASH-CHAIN SANDBOX実際の SHA-256 · 記録例 記録 01**メッセージを受信しました**`h₁ = SHA-256(e₁)`64個のゼロへのリンク RECORD 02**11:00にお会いしましょう**`h₂ = SHA-256(e₂)`h₁を含みます RECORD 03**削除が確認されました**`h₃ = SHA-256(e₃)`h₂を含みます 他所に保存済み**3件の記録 · ヘッダー `h₃`**この固定境界を、提供されたジャーナルと比較してください。 イベントを変更すると、そのハッシュが変更されます。チェーンを再構築すると、その先頭が変更されます。末尾を削除すると、残されたチェックポイントよりも短くなります。 **記録 2 および完全なハッシュを確認してください** これは、この例でハッシュ化された正確な UTF-8 JSON です。値は架空のものであり、9 つのフィールドとシリアライゼーションはジャーナルのフォーマットと一致しています。 ``` ``` 保存された記録 2 のハッシュ `` レコード2のハッシュを再計算しました `` このサンドボックスでは、署名ではなくハッシュを計算します。実際の検証ツールでは、各イベントの Ed25519 署名、シーケンス、およびリンクもチェックされます。ハッシュを再構築するだけでは、信頼された鍵の下で有効な署名を作成することはできません。 ## 実際のルールを数行でまとめると HASH + 署名 h0 = 064 hi = hex(SHA-256(C(ei))) σi = Ed25519.Sign(sk, unhex(hi)) **C** は 9 つのイベント項目を UTF-8 JSON にしたものです:キーはソート済み、余分な空白なし、ASCII エスケープなし、NaN/無限大なし。`previous_hash` は hi−1、h0 は 64 個のゼロで、署名はダイジェストの生の 32 バイトを対象とします。 項目:`seq`、`observed_at`、`source_at`、`kind`、`chat_id`、`message_id`、`actor_id`、`payload`、`previous_hash`。完全な仕様:[イベントのエンコード](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#event-canonicalization)。 保持されたチェックポイント Nexport ≥ Ncheckpoint hexport[Ncheckpoint] = Hcheckpoint 固定した鍵でチェックポイントの署名を確認し、それからジャーナルと比べます。後のエクスポートは長くなってもかまいませんが、チェックポイントの位置で一致していなければなりません。 ## 3つの質問、3つの異なる確認手順 [01 / 完全性**この記録は変更されましたか?** 信頼できる鍵でハッシュと署名を確認します。](https://phishdestroy.io/tgwitness/ja/docs/exports/)[02 / 継続性**以前にはどのような内容が記載されていましたか?** エクスポートを、証人が保管したチェックポイントと比べます。](https://phishdestroy.io/tgwitness/ja/docs/witness/)[03 / 提供**これらのテストイベントは届きましたか?** テストメッセージを送信・編集・削除し、各アカウントが何を記録したかを見ます。](https://phishdestroy.io/tgwitness/ja/docs/cases/) 署名は「変更されたか」、チェックポイントは「以前のものと一致するか」、テストメッセージは「すべて記録できたか」に答えます。[検証で証明できること。](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope) 次は:開始からケースパッケージまでの[アカウント全体の調査](https://phishdestroy.io/tgwitness/ja/docs/cases/)。 [エクスポート・クリニック:制御されたデスクトップ実験をご覧ください](https://phishdestroy.io/tgwitness/ja/docs/export-clinic/). 2分間の動画、元の録画データ、および7組のテスト用エクスポートデータを比較してください。ローカルでの修正内容が開示されています。 --- # Telegram · セキュリティを確保してください Canonical page: https://phishdestroy.io/tgwitness/ja/docs/security/ セッション、鍵、証拠データの保存場所、端末から送信される情報、保護対象の範囲、およびインストールのセキュリティ強化方法についてご確認ください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 何があなたのマシンから出ていくか、各シークレットで何が開けられるか、保護が及ぶ範囲とあなたの責任の範囲。 **127.0.0.1**デフォルトのパネルアドレス **256ビット**ランダムなパネルトークン **0**CDN、アナリティクス、またはリモートフォント **Ed25519**すべての記録に署名が付与されます ## すべての情報が集約されている場所 コレクター、パネル、すべての記録はあなたのマシンに留まります。既定で接続するのは Telegram だけで、それ以外はすべて個別のスイッチです。 06 / マシンから何が残るのかインストール方法 お使いのコンピュータまたはサーバー **パネル**127.0.0.1:8787 · ベアラー・トークン **コレクター**ワークスペースごとに1つのTelegramクライアント データディレクトリ **ジャーナル**SQLite · ハッシュチェーン方式 · 署名付き **メディア**SHA-256 に基づいて命名されたファイル **Vault**Fernet · セッション、APIペア、署名鍵、プロキシ - **Telegram**常に・お客様のルートを通じて アカウントのMTProto接続方法:ダイレクト、SOCKS5、HTTP、またはMTProxyです。「IP非表示モード」は、正常に動作するプロキシを待機します。ダイレクトへのフォールバックには、それを明示的に許可するモードが必要です。 - **外部サイト用コピー**オプション・デフォルトではオフ ジャーナル、ファイル、チェックポイントは、S3互換のストレージにアップロードされる前にAES-GCMで暗号化されます。鍵はユーザーが管理します。添付ファイルの名前は、内容ハッシュではなく、鍵付きハッシュによって付けられます。 - **通知**オプション・デフォルトではオフ チャットタイトル付きの課題と変更点の一覧。メッセージの抜粋は、有効に設定した場合にのみ送信されます。 - **タイムスタンプの信頼性**オプション・デフォルトではオフ 署名付きチェックポイントの SHA-256 ハッシュと、ランダムなノンスのみが含まれます。メッセージやチャット名は一切含まれません。 - **ウィットネス**オプション・デフォルトではオフ 読み取り専用トークンを使用して、署名付きチェックポイントとキャプチャカウンターを取得します。会話の内容を読み取ったり、設定を変更したりすることはできません。 デフォルト設定:Telegramへの接続のみがこのマシンから行われます。 保存先はワークスペースごとに設定可能です。 ## それぞれの秘密が解き明かすもの | シークレット | 保存場所 | このツールがもたらす可能性 | 万が一情報が漏洩した場合 | | --- | --- | --- | --- | | **パネルトークン** | データディレクトリの `panel-token.txt`。ブラウザーはタブごとに保持します | すべてのワークスペースのすべて | TgWitness を停止し、`panel-token.txt` を削除して、再起動します:新しいものが作られます | | **Telegramのセッション** | Vault、暗号化済み(`credentials.enc`) | Telegramアカウント自体 | Telegramの「*設定」→「デバイス」*からセッションを終了してください。 | | **署名鍵** | Vault、暗号化済み(`signing.enc`) | あなたのフィンガープリントで記録に署名すること | 別の場所に保管したチェックポイント、証人、タイムスタンプが、以前に存在したものを引き続き示します | | **Vaultキー** | データの隣にある `vault.key`、または外部のマスターキー | Vault | セッションと署名鍵も漏れたと考えてください | | **Witnessトークン** | witnessホストについて | 読み取り専用:チェックポイントと稼働状態 | 証人のページで削除し、新しく作ります | | **外部サイト用コピー用キー** | Vault:復元のために一度ダウンロードしてください | オフサイトコピー | バケットも手に入れた人は復号できます:コピーは漏えいしたものとして扱ってください | ## 保護の対象となる範囲 ### 掲載済み - 記録の変更、削除、並べ替え:ハッシュチェーンか署名が壊れます。 - 別の場所にチェックポイントを保管した後で、ジャーナルが切り詰められたり作り直されたりした場合:チェックポイントが一致しなくなります。 - トークンの推測:256 ビットの乱数、定数時間の比較、1 分間に 15 回失敗するとそのアドレスはブロックされます。 - 悪意のあるチャット内容:本文は常にテキストのままで HTML にはなりません。添付ファイルはファイルとしてダウンロードされ、パネルは他のサイトから何も読み込みません。 - 外部の Vault キーを使っている状態でデータディレクトリが盗まれた場合:セッションと鍵は暗号化されたままです。 ### ご判断にお任せいたします - メインのトークンは何でもできます。他の人には範囲を限ったアクセスを渡し、メインのトークンは自分だけで持ってください。 - フィンガープリントとチェックポイントは別の場所に保管してください。 - ディスクを暗号化し、権限を絞ってください。 - localhost 以外での平文の HTTP はトークンを漏らします。HTTPS か SSH トンネルを使ってください。 - カバレッジに欠落がないか確認し、自分のアカウントとソースで配信をテストしてください。 権限、有効期限、セッション制限を付けて[ケースへのアクセスを共有](https://phishdestroy.io/tgwitness/ja/docs/access/)します。 ## インストールのセキュリティ強化 8件中0件完了 1. **専用の Telegram アカウントを使ってください**。メインのアカウントは使わないでください。 2. **パネルは 127.0.0.1 に固定してください。**リモートアクセスは HTTPS(同梱の Caddy)か SSH トンネルだけにします。 3. **データディレクトリのあるディスクを暗号化してください**。 4. **データディレクトリへのアクセスを**サービスアカウントに限定してください(Unix では 0700、Windows ではフォルダーの権限)。 5. **サーバーでは Vault キーを別の場所に置いてください**:初回起動前に `TGWITNESS_VAULT_KEY_FILE` を設定します。 6. **フィンガープリントとチェックポイントを保存してください**。保存先は別のシステムにし、証人は別のホストで動かします。 7. `data/`、セッション、`panel-token.txt`、またはVaultキーをGitHubやチャットに**アップロードしないでください**。 8. リバースプロキシでは、`Authorization`ヘッダーやリクエスト本文を**ログに記録しないでください**。 **データを失うことなく、パネルトークンを変更することはできますか?** はい、トークンで開けるのはパネルだけです。TgWitness を停止し、`panel-token.txt` を削除して、再起動します。ジャーナル、セッション、鍵は残ります。`TGWITNESS_TOKEN` が設定されている場合は、ファイルよりその値が優先されます。 ## 脆弱性を報告する GitHub の **Security → Report a vulnerability** を使ってください。バージョン、影響、架空のデータでの最小の再現手順を添えます。認証情報、アカウントのフォルダー、本物の証拠は絶対に送らないでください。非公開の報告が無効なら、エクスプロイトの詳細は書かずに、非公開の連絡手段を求める issue を開いてください。 --- # Telegram · Witnessボットの設定 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/witness/ 署名済みのジャーナルのチェックポイントを、個別のウィットネス、独自の鍵、および読み取り専用コレクターアクセス権を設定して、Telegramチャンネルに公開できます。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 別のプロセスがジャーナルを確認し、署名付きのチェックポイントをチャンネルに投稿します。 ## 2つのホスト、2つの署名鍵 ホスト / コレクター**アカウント + ジャーナル** Telegramセッションコレクターの署名鍵 読み取り専用チェックポイントのエンドポイント ← 署名付きの回答をリクエスト → HOST B / WITNESS**検証+保存** 固定されたコレクターのフィンガープリント 個別のWitness署名鍵 独自のジャーナル + ボットトークン ウィットネス → Telegram Bot API →**あなたのチャンネル · 署名付き TGW1 投稿** Witnessは自身で検証を行います。コレクターへのアクセスは読み取り専用です。ボットによる公開には、Witnessの接続とトークンが使用されます。Witnessにはアカウントセッションは付与されません。 03 / チェックポイントの決定事項参考となる回答例 最終承認日**120件の記録**`head 9c7d…` 次の回答**128件の記録**`head a4f2…` 承認済み:カウントが増加し、署名が検証され、鍵が一致しました。Witnessはこの新しい境界を保持します。 すべての回答例は、有効な署名と固定鍵が存在することを前提としています。ここでのハッシュ値は、説明のための省略形です。古いプレフィックス全体が変更されていないことを確認するには、エクスポートを保持しているチェックポイントと比較してください。 ## ボットとチャンネルの準備 BotFather でボットを作り、チャンネルへの投稿を許可します。証人は別の場所で動かしてください。別のホスト、できれば別の人が管理するホストの方が、コレクターの隣で動く 2 つ目のプロセスよりずっと価値があります。 ## 「Extras」の3つの手順 1. **読み取り専用アクセス。****追加情報 → 独立した証人**でトークンを作り、ファイルを保存します。読むのはチェックポイントと稼働状態だけです。 2. **チャンネルと間隔。**Telegram チャンネルまたは Discord の webhook と、証人から届くコレクターのアドレス。設定ファイルを保存します。 3. **起動。**`witness.json`、`witness-token.txt`、`bot-token.txt` を証人のホストにまとめて置き、次を実行します: ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json ``` チャンネルに最初の署名付き投稿が出るのを待ち、証人のフィンガープリントを安全な場所に保存します。 Discord を使う場合は、webhook の URL を `discord-webhook.txt` として保存します。1 つの証人は 1 か所に投稿します。長い確認結果は Discord ではファイルとして届きます。 ## 公開頻度を選択してください 確認のたびに投稿すると、外部に安定した記録が残ります:5 分ごとなら、ワークスペースあたり 1 日約 288 件の投稿です。詳細設定では、変化や問題があったときだけ投稿したり、プロキシや独自の Bot API を使ったりできます。 **このボットは実際には何を証明するのでしょうか?** コレクターに署名付きチェックポイントを要求し、想定した鍵で確認して、見逃した応答や拒否された応答も含めて自分の署名付きジャーナルに記録します。 確認するのはジャーナルの状態で、Telegram 自体を見ているわけではありません。そのためには、管理された配信テストを行ってください。 ## 後で証拠を確認してください 証人のジャーナル、投稿、フィンガープリントを保管してください。コレクターのエクスポートとの[照合方法](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/#verify)。 --- # ゼロトラストが選ばれる理由:テイラー・ウェッシング、ツールハイデ博士、シェリンスキー博士 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/signed-export/ ゼロトラストの事例研究:テイラー・ウェッシング法律事務所のパトリック・ツールハイデ博士とトビアス・シェリンスキー博士が署名したGDPRへの回答書。同事務所の内部文書と照合され、欺瞞や疑念の余地を一切残さない検証可能なモデルに基づいて作成されたものである。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) **実例紹介**実際の文書・実際の署名・以下に掲載されたハッシュ値・オフラインでも再現可能な集計結果 ゼロトラストが必要な理由を示す事例研究。GDPR第15条に基づく個人の自己データ開示請求に対し、大手国際法律事務所のパートナーらが「適格な署名」を用いて回答した事例である。その回答に含まれるあらゆる保証――署名、肩書き、「1か月にわたる手作業による審査」、第三者保護、「どの裁判所も同意するだろう」といった主張――は、すべて「信頼」に基づいて受け入れるしかなかった。 提出されたファイルと照合したところ、そのいずれもが事実とは異なっていた。このページでは、信頼がもたらした結果と、検証可能なモデルであれば欺瞞や疑念の余地を一切残さなかったであろうことを示している。 2025年8月15日 · 手紙[トビアス・シェリンスキー博士](https://www.taylorwessing.com/en/people/germany/hamburg/dr-tobias-schelinski)テイラー・ウェッシング パートナー・情報技術法専門弁護士 2025年10月1日 · 書簡および別紙1[パトリック・ツールハイデ博士(法学修士)](https://www.taylorwessing.com/de/people/germany/hamburg/patrick-vincent-zurheide)Salary Partner、テイラー・ウェッシング、2025年より・IT、データ保護、テクノロジー関連訴訟 職務内容は、同社のリンク先プロフィールから引用したものです。このページでは、Steamアカウントのブロックが正当だったかどうかについては言及していません。ここでは、提出されたファイルの内容と、それについて署名入り書簡に何が記されているかを示しています。すべての数値は、ファイルと照らし合わせて確認することができます。 **830ページ**2通目の手紙の添付資料に **36秒**その添付ファイルの作成から最終更新まで **905,672**黒い四角形の下に表示される文字 **署名2件**2通の手紙(それぞれ1通ずつ)の中で述べられていた **要するに、**署名はファイルの送信者が誰であるかを示すものです。そのファイルが完全であるか、正確であるか、あるいは真実であるかについては判断できません。それを確認できるのはバイト単位のチェックのみであり、そのチェックは誰でも再現可能です。 ## ゼロトラスト:送信者ではなくファイルを確認する ゼロトラストとは、誰の信頼も必要としないことを意味します。企業であれ、肩書きであれ、署名であれ、そして私たちでさえも例外ではありません。アクセス要求に対する応答は、それ自体が正当性を証明しなければなりません。それは3つの質問に答えなければなりませんが、署名ではそのいずれにも答えられません。 **原稿は完成しましたか?**依頼者は、自分に帰属するものをすべて受け取っていますか?また、不足しているものはすべて把握され、説明されていますか? **その文章は変更されていませんか?**各レコードは当初の記録そのものでしょうか。また、その後の変更は反映されるのでしょうか。 **何が「隠されている」かを決めたのは誰なのか?**その源泉徴収は、決定権限を持つ者によって決定されたものなのか、また、事後に誰かがそれを確認することはできるのか。 EUにおける法的紛争のほとんどは、秘密保持契約(NDA)に基づく和解、非公開の書類、公表されることのない判決などにより、表に出ることなく幕を閉じます。私たちとしては、それ自体に異論はありません。しかし、この件は異なります。おそらく、この件で起きたことが珍しいからというわけではないでしょう。秘密保持契約も裁判所の判決もないため、最初から最後まで読み通すことができます。非常にシンプルな法律であるGDPR、本人による自身のデータ開示請求、実際に提供された内容、そして誰でも削除できる黒い四角形――それだけです。 この調査のユニークな点は、誰が、どのように回答したかという点にある。トビアス・シェリンスキー博士とパトリック・ツールハイデ博士は、テイラー・ウェッシングのパートナーであり、同事務所自身の表現によれば [「欧州の法律サービス業界を牽引する大手」](https://www.businesswire.com/news/home/20251217415857/en/Taylor-Wessing-Diversifies-Its-International-Strategy)。両者とも博士号を取得しており、一人はIT法の認定専門弁護士、もう一人はアバディーン大学で法学修士号を取得している。彼らは、合法的な情報開示請求の処理を106日間も怠った。その過程で、通報されたアカウント所有者に、1,800人以上の他者の苦情内容やログイン情報を、誰でも削除可能な黒い四角形で隠した状態で提供してしまった。その中には未成年者も含まれている可能性がある。 **PhishDestroyの見解。**ログイン情報、すなわちユーザー名は極めて個人的なデータである。これは複数のサービスで再利用されており、長年にわたって使用されてきたアカウントは、ほとんどの場合、それを通じて特定可能な実在の人物と結びついている。 目に見える50の断片だけを見れば、どの裁判所も確かに誤解してしまう可能性があると考えます。しかし、全体像を見れば、このページのタイムラインと計算結果から、GDPRに基づく請求が処理されていなかったことは明らかです。署名がないことや、名前のスペルミスがあっても、その事実は変わりません。 ## 信頼がもたらしたもの、そしてそのモデルがとったであろう行動 回答に含まれる各保証事項は、以下に、提出されたファイルおよび本ページで提案されている検証可能なモデルと照らし合わせて示されています。各行に関する根拠は、さらに下部に記載されています。 **署名** „Dieses Schreiben ist qualifiziert elektronisch signiert“ 手紙の差出人が記載されています。その下には、黒い四角形の下に905,672文字が読み取れる状態で残っています。 [証拠](https://phishdestroy.io/tgwitness/ja/docs/signed-export/#signature) この企業は、非公開にされた各フィールドのソルト付きハッシュに署名します。検証されるのは内容であり、送信者ではありません。 **選定** 依頼者が何を読めるかは、弁護士が決定します。 50件の苦情が閲覧可能な状態で残っており、そのすべてがブロックおよび要請の後に提出されたものである。そのうち43件は “Suspected Hijacker”. 1,944件が処理済み。 [証拠](https://phishdestroy.io/tgwitness/ja/docs/signed-export/#convenient) コピーの作成時に規則が宣言・署名され、非公開とされた記録がすべて集計され、その選択内容が当局によって審査される。 **「1か月間の手作業による審査」** „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ 36秒で作成された830ページに及ぶファイル。その最初の読み取れる行には同性愛者への差別的な言葉が記されており、読み取れる状態で残された苦情は、そのファイル自体によって矛盾している。 [証拠](https://phishdestroy.io/tgwitness/ja/docs/signed-export/#refuted) 努力について誰が何と言おうと、それは何の意味もありません。ファイルそのものがすべてを物語っており、誰でもその中に矛盾を見つけることができるのです。 **第三者の権利** „soweit keine Rechte Dritter entgegenstehen“ その他1,800人以上のログイン情報や苦情の文章が、誰でも削除できる黒い四角い枠の中に表示されている。 [証拠](https://phishdestroy.io/tgwitness/ja/docs/signed-export/#under) 他者のデータは、依頼者のコピーには一切含まれません。そのデータは、当局の鍵によって暗号化された状態で転送されます。 **データのコピー** „Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ 支払い情報、サポートチケット、およびそのブロックに関連する記録は欠落しています。苦情の内容だけが完全に記載されています。 [証拠](https://phishdestroy.io/tgwitness/ja/docs/signed-export/#inventory) 署名済みの積荷目録には、含まれている品目が記載され、含まれていない品目の数も明記されています。見落としは一切許されません。 **「あらゆる裁判所」** „Aus unserer Erfahrung wird jedes Gericht …“ 50個の断片だけでは誤解を招く恐れがあります。ファイル全体を見ると、そのリクエストは処理されなかったことがわかります。 [証拠](https://phishdestroy.io/tgwitness/ja/docs/signed-export/#authority) 裁判所または規制当局は、原本の全ページを開き、各欄の内容を、当該企業が署名した内容と照合して確認する。 **すべての行は同じ形式になっています。**信じざるを得なかった保証、それと矛盾するファイル、そしてその保証を不要にしていたはずの確認。このモデルには、欺く要素も疑う要素もありません。依頼者は自分に属する情報のみを確認でき、当局はその他の情報を確認でき、すべてのフィールドは企業が署名した内容に紐付けられています。[モデルをご覧ください](https://phishdestroy.io/tgwitness/ja/docs/signed-export/#sealed)。 ## 証拠を一つずつ見ていく 上記の比較の各行は、以下のファイルに基づいています。署名入りの手紙2通と「Anlage 1」です。ページ番号はPDFのページ順に従っており、すべての図はオフラインでも再現可能です。 ### そのテキストは黒い四角形の下に残っていた。 これが、その分野の第一人者から寄せられた、単純な情報公開請求に対する回答の様相です。黒い四角で隠された部分には、ファイル内の元のテキストが残されていました。そのため、表示されたままの50件の説明と、隠された1,944件の両方を読み比べることが可能になりました。 その手紙納品されたファイル 「苦情の詳細にかかわらず」 この数字だけでも、Steam利用規約への違反が繰り返されていることを示していると言われている。 シェリンスキー博士 · 2025年8月15日 · 2ページ „Unabhängig von den Einzelheiten der Beschwerden …“ **50**説明文は表示されたまま **2025年8月~9月** **2021年2月から2025年7月までの**間に 掲載された**1,944件の解説** 表示されている50件の説明のうち、43件にラベルが付いています “Suspected Hijacker”. 対象となった1,944件の記述のうち、269件にそのラベルが付いています。 付録1、444~620ページ。さらに1件のレコードの説明欄が空欄となっている:提供された表の行数は50 + 1,944 + 1 = 1,995行である。 ### 弁護士にとって扱いやすい50件の苦情 10月の通知書には、アカウントが凍結された理由が明記されています。その理由は、 „Used for Hijacking“ (ズルハイデ博士、8ページ)。申立人が閲覧を許可された50件の苦情のうち、43件は次のように同じ内容を述べている: “Suspected Hijacker”. これら50件のすべては、アカウントが永久にブロックされた数か月後、アクセス要求が行われた後、そして同じファイルに記録されている最後のログインの後で提出されたものである。 別紙1の1ページ目には、次のように記載されている。 `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)`。このアカウントは2025年5月7日に利用停止処分を受けた。2025年5月9日、Steamサポートが最初のチケットに回答した。それによると、利用停止は誤りではなく恒久的な措置であり、チケットはクローズされた。その後、2025年6月17日にアカウントへのアクセス再開要請が行われた。 書簡の内容によれば、その時点で第三者が当該アカウントを保有していた。シェリンスキー博士は、2025年5月3日以降に第三者からアカウントを取得したと記しており(p. 2)、ツールハイデ博士は、5月3日以降に第三者が当該アカウントを通じて支払いを行い、最後の支払いは2025年7月30日であったと述べている(pp. 1–2)。提出された苦情一覧表には、次のように記録されている: **53**2024年8月 **54**9月 **70**10月 **79**11月 **82**12月 **92**2025年1月 **32**2月 **35**3月 **20**4月 **12**5月*ブロック日:5月 7日 最終ログイン日:5月23日* **1**ジュン **7**7月 **47**8月 **3**9月 黒い四角形の下にある苦情文苦情の内容はそのまま読み取れるように残されている 別紙1に記載された月ごとの苦情件数(2024年8月から2025年9月まで)。ファイルのテキストレイヤーから集計したもので、全履歴は[「ご自身で確認」](https://phishdestroy.io/tgwitness/ja/docs/signed-export/#verify)の下に記載されています。5月7日の利用停止および5月23日の最終ログイン以降、6月は1件、7月は7件、8月は47件の苦情がありました。 1. 2025年5月3日**この日付より、書簡の記載に基づき、第三者**その報告は「第三者から入手した」ものである:シェリンスキー博士、p. 2 ・「第三者による支払い」:ツールハイデ博士、p. 1 2. 2025年5月7日**アカウントが利用停止になりました**Steam 3. 2025年5月9日**エラーではありません。恒久的な状態です。チケットはクローズされました。**Steamサポート、最初のチケット 4. 2025年5月23日**最終ログイン日時**別紙1、1ページ 5. 2025年6月17日**アクセス依頼**ツールハイデ博士、p. 1 6. 2025年7月29日**締め切りは、「もしあるとすれば」という条件付きで始まる**シェリンスキー博士、p. 1 7. 2025年7月30日**前回の「第三者による支払い」;ここからは、データは請求者にのみ帰属する**ツールハイデ博士、2ページ 8. 2025年8月**47件の苦情、すべて閲覧可能**付録1、444~448ページ 9. 2025年8月15日**取り下げ:「詳細にかかわらず」1,938件の苦情**シェリンスキー博士、2ページ 10. 2025年9月**苦情3件、内容を確認可能**付録1、444ページ 11. 2025年9月29日**「報告日」**別紙1、1ページ 12. 2025年10月1日**答え:「1か月分」、データは「手作業」で整理された**ツールハイデ博士、p. 1 ズルハイデ博士は、1か月間の全期間を使用する必要があり、データの手作業によるクリーニングが必要だったと記している: „musste leider die volle Monatsfrist ausgeschöpft werden … manuell die Daten bereinigt werden mussten“ (p. 1)。判読可能な苦情のうち3件は2025年9月付であり、報告書自体は9月29日付けである。これらは答弁書の提出直前の数週間に提出されたものだが、彼の説明によれば、その間はデータの整理が行われていたという。 > “This account just started acting shady overnight” > > Suspected Hijacker ・2025年8月・446ページ > “Suddenly messaging people weird links probably stolen” > > Suspected Hijacker ・2025年8月・448ページ > “Friend warned me to report this one” > > Suspected Hijacker ・2025年8月・446ページ > “Everyone in voice chat agrees it's a stolen account” > > Suspected Hijacker ・2025年8月・446ページ #### そのファイル自体がそれらの主張と矛盾している 50件のうち、いくつかは「Anlage 1」が自己検証できると主張しています。このファイルには、アカウントのログイン履歴とセキュリティ履歴が記録されています。両方が含まれており、セキュリティ履歴は黒い四角形の下に表示されています。 左から読み取り可能 · Suspected Hijacker ・2025年8月・446ページ > “My friend can't log in, says someone changed the password” セキュリティの沿革 · 830ページ · 黒い四角形の下**最後のパスワード変更日:2024年7月** 同じファイルが示すように、これは所有者によって作成されたものではありません。2025年にはパスワードの変更はありません。 「Left」誌掲載 · 2025年8月 · 446、448ページ > “This account just started acting shady overnight” > “Suddenly messaging people weird links probably stolen” ログイン履歴 · pp. 1–119**最終ログイン日:2025年5月23日** ログイン履歴は2025年5月で終了しています。6月、7月、8月、9月にはログイン記録が1件もありません。このアカウントは2025年5月7日から利用停止となっていましたが、5月9日にSteamサポートから、この利用停止が恒久的なものだと通知がありました。 左から読む · 2025年8月 · pp. 445, 448 > “Real person probably got locked out” > “My friend said they can't get into this account anymore” セキュリティの歴史 · 830ページ**2025年にはセキュリティ上の変更はありません** セキュリティ履歴に記録されている最新の変更は、2024年7月のパスワードリセットです。 **PhishDestroyによる校閲。**444ページにある中傷的な表現は翻訳が必要でした。これらの苦情は英語で書かれており、それに対する回答も同じファイル内にあります。1か月かけて手作業で校閲を行った結果、読みやすい状態に仕上げ、それらと矛盾する一文を四角で囲みました。 #### 『フィフティ』の読み方 書式だけでは、誰が苦情を書いたかを証明することはできません。それはまさに、裁判所が苦情を有効とみなす前に検討する点そのものです。 | 確認 | 左から読み取り可能 · 50 | 覆い隠された · 1,944 | | --- | --- | --- | | 期間 | 2025年8月~9月 | 2021年2月~2025年7月 | | “Suspected Hijacker” カテゴリ | 50件中**86%43件** | **13.**8% 1,944件中269件 | | 説明文にキリル文字が含まれています | 50**のうち4%2** | **55.4% 1**,944件中1,077件 | | 記者用ログイン:ラテン文字+3~5桁の数字 | 50件中**62%31件** | **21.**6% 1,944件中420件 | キリル文字:その文字体系の文字が少なくとも1文字含まれていること。ログイン形式:ラテン文字の後に3~5桁の数字が続くもので、それ以外は含まれないこと。表示されている50件のテキスト以外のものを含め、1,995件の記者ログイン情報のすべてが対象となっており、引き続き抽出可能です。ここでは、いかなる記者のログイン情報も掲載していません。9件の記録において、4つの判読可能なテキストが単語単位で完全に重複しています; “Acting way off pretty sure someone else is using it” 3回登場する(446、447ページ)。 シェリンスキー博士 · 2025年8月15日 · 2ページ > „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ 「苦情の具体的な内容はどうであれ、その数だけでも……ということがわかる」 **その内容は、本当に裁判所にとって無関係なのでしょうか?** ズールハイデ博士 · 2025年10月1日 · 9ページ > „Aus unserer Erfahrung wird jedes Gericht die Sperrung … als rechtmäßig qualifizieren.“ 「これまでの経験上、どの裁判所もこの差し止め命令を……合法であると認定するでしょう。」 **彼の経験は、あらゆる裁判所を網羅しているのでしょうか?また、このようにデータが処理された場合、すべての裁判所がそれに同意するでしょうか?** この2つの質問はPhishDestroyによるものです。私たちは、裁判所がブロックについてどのように判断すべきかについては言及しません。私たちが言いたいのは、裁判所は、数えるよう求められたものを正しく読み取れるべきだということです。 ### 黒い四角形によって視界から隠されているもの この2通の手紙は、同じ苦情について2つの異なる方法で扱っている。シェリンスキー博士は、それらのすべてを依頼者の不利に数え上げ、 „1.938 Mal“、その詳細にかかわらず(2025年8月15日、2ページ)。その後、ツールハイデ博士は2025年7月30日を区切りとして設定した。その日以降のみ „können wir … davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen“ (2025年10月1日、2ページ)。黒い四角形はその線に沿って配置されています。2025年7月23日までの苦情文(その直前のもの)はすべて隠されており、8月以降のものはすべて読み取れるようになっています。 **PhishDestroyの読書。** 2025年7月30日以前は、苦情件数は申立人に対して単なる数値として扱われ、申立人自身のデータではないとして、申立人への開示は差し控えられる。10月の書簡そのものは、以下の点から論じている。 „zwischen 2019 und 2023“ (7ページ)。 別紙1 · 444ページ · 最初に読み取れる行 Offensive Avatar2025年9月`p***r` 同性愛者に対する差別的な言葉(ここでは伏せ字にしています)。これは、1か月にわたる手動による審査を経て、依頼者が最初に目にする項目です。 #### 長方形のの下には何があるのでしょうか 1,148件の苦情のうち、表の半数以上が以下として提出されています。 “Offensive Profile”。読み取れるものは一つも残っていなかった。1,147件はテキストが覆われており、1件はテキスト自体が存在しない。ログインせずに長方形の隙間から読み取ると、覆われた説明文は常に同じテーマに立ち返っている: | テーマ | 対象 | 読みやすい | | --- | --- | --- | | ナチ、ナチズム | **110** | 0 | | 憎悪、ヘイトスピーチ | **108** | 0 | | 人種差別 | **99** | 0 | | ウクライナ、ウクライナ人 | **90** | 0 | | 反ロシア感情 | **84** | 0 | | 国家やロシア人を侮辱すること | **65** | 0 | | プロパガンダ | **64** | 0 | | ウクライナ人に対する人種差別的な蔑称 | **50** | 0 | | 政治 | **46** | 0 | 対象となった1,944件の記述のうち615件が、これらのテーマの少なくとも1つに触れているが、読み取れる50件のうち、これらに触れているものは1件もない。長いテキストも繰り返し見られる。8語以上のテキスト18件が、48行にわたり一字一句同じ形で現れている。そのうち2件は、それぞれ4回ずつ繰り返されている: > “I made this account to report this user because he has stolen my account” > > カバー付き・4列 > “I created this account in order to expose this user because he robbed my account.” > > カバー付き・4列 50の読み取り可能なテキスト(448ページ)のうちの1つは、他のユーザー名を記載したSteamのプロフィールページを貼り付けたものです。ここではその内容を掲載しません。各記者のログイン情報は長方形で覆われており、そのページは読み取れる状態のまま残されていました。 ### 陳述書および提出された記録 以下の各記述は、署名入りの手紙から引用したものです。各記録は、彼らが提出した書類の中に含まれています。 シェリンスキー博士 · 2ページ ### 毎年「数百」 „In jedem Jahr, bis ins Jahr 2025 hinein, gab es demnach hunderte Beschwerden.“ **2021: 25 · 2022: 122** 添付の苦情表に記載されている年間集計値です。月ごとの集計値の全データは、「[ご自身で確認してください」](https://phishdestroy.io/tgwitness/ja/docs/signed-export/#verify)の項目に記載されています。 ツールハイデ博士 · 1ページ ### その月全体、手作業で洗浄済み „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ **36秒** 「Anlage 1」は19:58:05に作成され、19:58:41に最終更新されました。ページ数は830ページです。このページで最初に確認できる問題となる記述は、同性愛者に対する差別的な表現です。 シェリンスキー博士 · 3ページ ### 第三者の権利の保護 „soweit keine Rechte Dritter entgegenstehen“ **残り905,672文字** テキストは、その上に重なっている1,044個の黒い長方形のすぐ下でも、依然として読み取ることができる。これらの長方形は、当該アカウント自身のセキュリティ履歴も覆い隠している(830ページ)。 ツールハイデ博士・7ページ ### 「2019年から2023年の間」 „Über einen Zeitraum von mehreren Jahren, zwischen 2019 und 2023 …“ **2020年8月に作成** 別紙1の1ページ目に、当該口座の開設時期(2020年8月)が記載されています。 ツールハイデ博士 · 9ページ ### どの裁判所も同意するだろう „jedes Gericht … als rechtmäßig qualifizieren“ **予報** この文章は、どの裁判所もSteamアカウントの凍結を合法であると判断するだろうと述べている。しかし、具体的な裁判所の名称も、判決の引用も一切ない。 ### 署名からわかること、わからないこと 適格電子署名は、送信者に関する強力な証拠となります。ただし、内容に関する証拠ではありません。この2つの点は、別々に確認する必要があります。 ### ✓署名特徴が見られる - その文書に署名したのは誰か - 署名されたバイトは、署名されて以来変更されていないこと ### 署名は表示されません - エクスポートが完了しました - その編集によって何かが削除されたということ - そこに含まれる記述が真実であること - 署名する前に、誰かがそれを読んでくれることを願っています 3つのチェック · 文書番号 42603633 · 別紙1オフライン 01 · 送信者**適格電子署名**`„qualifiziert elektronisch signiert“`同社は9ページで次のように表明している。 02 · 誠実さ**別紙1のSHA-256**`2bb927e2…4ff7d6af`記録されたハッシュと一致します。 03 · 目次**別紙1のテキストレイヤー**`pdftotext Anlage1.pdf -`1,044個の矩形の下で、905,672文字が読み取れる。 送信者:宣言済み。完全性:一致。内容:不整合。署名は最初の質問には回答したが、それ以外の質問には一切回答しなかった。 チェック02と03には、ファイルと標準的なツールさえあれば十分です。チェック01では、誰が送信したかがわかります。送信された内容については、02と03でのみ確認できます。 文書番号 42603633 · 1ページ1ページに2つの綴り `Dr. Patrick Zurheide, LL.M. (Aberdeen)`署名者 `p.zurheode@*****wessing.com`レターヘッド `p.zurheide@*****wessing.com`公的記録 タイトルの綴りは正しい。レターヘッドに記載されている署名者の氏名は間違っている。6ページには „Die Antwortet lautet ja, in den dort genannten Grenzen.“ セクション1.5と1.6の末尾で、一字一句同じ表現が2回使われています。3ページ目では、データを „Anbei übersenden wie Ihnen …“. ### そのエクスポートが対応することを意図していたリクエスト 署名の裏には、自身のデータに関する1件の請求が隠されている。これを規定する法律は簡潔なものだ。 規則(EU)2016/679 · 公式テキスト 第15条第1項 「データ主体は、自己に関する個人データが処理されているか否かについて、管理者に確認を求める権利を有し、処理されている場合には、当該個人データへのアクセス権を有する……」 第15条第3項 「管理者は、処理の対象となっている個人データの写しを提供しなければならない。」 第12条第3項 「…不当な遅延なく、いかなる場合でも請求を受領してから1か月以内に。必要に応じて、その期間はさらに2か月延長することができる……」 出典:[EUR-Lex](https://eur-lex.europa.eu/eli/reg/2016/679/oj) 手紙の執筆者たちはこの法則を知っている。ズールハイデ博士の手紙は、この法則を冒頭に掲げている: „nachfolgend erteilen wir Namens und in Vollmacht unserer Mandantin Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ (p. 1)。第三者の権利に関する言及が1か所(シェリンスキー博士、p. 3)あるのを除けば、いずれの書簡も、管理者がアクセスを制限することを認める規定――第12条(5)、第23条、あるいはドイツのBDSG――を引用していない。その代わりに、この要請に対して寄せられた回答は以下の通りである: 1. 2025年8月15日 · シェリンスキー博士 · 1ページ**締め切りは、「もしあるとすれば」** „Die Frist nach Art. 15 DSGVO hat, wenn überhaupt, erst … am 29. Juli 2025 begonnen“ 2. 2025年8月15日 · シェリンスキー博士 · 2ページ**アカウントが停止されました** „Hiermit kündigen wir daher Namens und in Vollmacht der Valve Corporation … mit sofortiger Wirkung.“ 3. 2025年8月15日 · シェリンスキー博士 · 2ページ**数による証明:詳細にかかわらず、苦情は1,938件** „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ 4. 2025年10月1日 · ツールハイデ博士 · 2ページ**2025年7月30日までのデータに絞り込みました** „… können wir erst ab diesem Zeitpunkt davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen.“ 5. 2025年10月1日 · ツールハイデ博士 · 8ページ**残りは、ある条件付きで** „Gerne beauskunften wir die restlichen (bzw. noch weitere) personenbezogene Daten, sobald Ihr Mandant uns nachvollziehbar darstellen kann …“ 6. 2025年10月1日 · ツールハイデ博士 · 8ページ**「共犯者」** „… dass Ihr Mandant bzw. dessen Komplizen seine Phishing-Angriffe … in verschleierter Form fortsetzen will“ 7. 2025年10月1日 · ツールハイデ博士 · 9ページ**4つの刑事法令** „… §§ 263, 263a, 202a, 303a StGB) einer strafrechtlichen Verfolgung zuzuführen.“ **これらはいずれも第15条に規定されている条件ではない。**アクセス権は、契約の終了、裁判所に関する予測、あるいは刑事法令によって消滅することはない。請求から106日後、その内容は請求書に記された通りそのままだった。 **PhishDestroyの解釈。**医師たちは1ページ目でその法律を引用しておきながら、その後はそのような法律が存在しないかのように記述している。 ### その手紙には、Valveがどのような処理を行っているかが記載されている。一方、そのファイルにはその大部分が記載されていない。 2~6ページにおいて、10月の書簡では、Valveが処理する個人データについて説明するために、Steamのプライバシーポリシーが引用されています。同書簡で挙げられている各カテゴリーについて、以下に「Anlage 1」との対照表を示します。「Anlage 1」は、アカウント、プロフィール、名前の履歴、ログイン情報、プロダクトキー、プレイ時間、電話番号、苦情、チャット、Steam Guard登録デバイス、フレンド、セキュリティ設定の変更の12のセクションで構成されています。 | データ | その手紙に名前が挙げられていた | 別紙1において | | --- | --- | --- | | 取引と支払い | „Transaktions- und Zahlungsdaten“ · p. 2 „… Transaktionsdaten … für einen Zeitraum von bis zu zehn (10) Jahren aufbewahren muss“ · p. 6 | **不在** | | 工芸品・コミュニティマーケット | „… Konsistenz des Gameplays oder Steam-Community-Marktes …“ · p. 6 | **不在** | | 実績、ゲームの進行状況、ゲーム内アイテム | „Ihre erspielten Errungenschaften … Ihren Spielfortschritt … Ihre im Spiel erhaltenen Gegenstände“ · p. 4 | **不在** | | ゲームの所有権 | „… mindestens Ihr Eigentum am fraglichen Spiel“ · p. 4 | **不在**・遊び時間、および1日のみにおける100回のキー操作 | | レベル、バッジ、トレーディングカード | „Daten über die Nutzung des Steam-Clients und der Steam-Websites“ · p. 3 · items and market · pp. 4, 6 | **不在** | | 投稿、コメント、フォロー | „… veröffentlichen, kommentieren oder denen Benutzer folgen“ · p. 3 „Message Boards, Foren und/oder Chatbereiche“ · p. 5 | **不在** | | チャット | „Informationen, die Benutzer im Chat gesendet haben“ · p. 3 | 2件、掲載済み | | サポートチケット | „… wenn Benutzer Informationen oder Support von Valve anfordern“ · p. 3 | **欠席**・ブロックが確定した2025年5月のチケットを含む | | 連携済みのサードパーティアカウント | „… mit dem Konto eines Drittanbieters zu verknüpfen“ · p. 5 | **不在** | | ブロックの裏にある記録 | „Zum Entdecken von Verstößen erforderliche Informationen“ · p. 3 „… nach einer manuellen Prüfung durch einen Mitarbeiter der Valve Corporation“ · p. 7 | **不在** · レビュー記録なし、デバイスとの連携なし、フィッシングの報告なし | **その書簡にはデータについて記載されていますが、添付ファイルにはそのデータは含まれていません。**両弁護士の所有権に関する結論の根拠は支払いにありますが、このファイルでは、まさにその「支払いの種類」という項目が省略されています。 #### そのファイルにはどのような内容が収録されており、どの期間のものが含まれているか 期間は、ファイル内の日付(黒い四角で囲まれた日付も含む)に基づいて算出されます。 | セクション | 別紙1において | ファイル内の期間 | | --- | --- | --- | | 基本アカウント情報・メールアドレス、国、ユーザー名、Steam ID | 読みやすい | 現在の状況 | | ログイン | 日付と種類は判読可能。時刻、IPアドレス、ハードウェアIDは隠されている。 | 2023年10月 – 2025年5月 · アカウントは2020年8月から存在しています | | 遊びの時間 | ゲームの読み取りが可能;最終使用日時が記録されている | 2020年12月 – 2025年5月 | | チャット | 2件、掲載済み | 2025年9月のみ | | 当該アカウントに対する苦情 | 1,995 行 · 50 件の説明文が閲覧可能 | 2021年2月 – 2025年9月 | | 友達とブロック | 5,789 行 · 対象範囲 | 2021年2月 – 2025年9月 | | Steam Guard対応デバイス・登録済み電話番号・セキュリティ設定の変更 | 対象 | セキュリティログ:2020年8月~2024年7月 · 4行 | | プロダクトキーのアクティベーション | 対象となるキー | 100行、日付は1つ:2025年3月13日 | **苦情の内容だけが完全に記載されているようです。**それ以外の情報はほとんどありません。ログイン記録は2023年10月から、フレンドリストは2021年2月から、プロダクトキーは特定の一日分のみであり、Valveストアのカテゴリー全体が欠落しています。この書簡の判断の根拠となっている「支払い」や「ブロック措置の背景となる記録」といったカテゴリーは、ファイルに全く含まれていません。 フレンドリストには5,789件のレコードが含まれており、内訳は「ブロック済みユーザー」4,410件、「フレンド」1,182件、「招待者」200件で、日付は2021年2月24日から2025年9月28日までとなっています。そのうち74件は、最後のログイン日以降の日付となっています。このファイルからは、これが現在の接続リストなのか、削除されたものを含む完全な履歴なのかを判断することはできません。 第15条(1)項に対する回答からは、さらに3つの疑問が生じます。データの受領者(c項)およびデータの出所(g項)については、本件に関する具体的な記載はなく、一般的な方針文言としてのみ記載されています。保存期間(d項)については、具体的な内容は示されず、単に方針からの引用にとどまっています。また、この書簡ではデータが送付されています。 „als Anlage 1 und 2“ (p. 3);ここでは、Anlage 1 のみを取り上げる。 ### Valveはすでに、そのアカウントの所有者が誰であるかを確認済みでした このアカウントは、ゲームを公開するためにSteamworksパートナーとして登録されました。その手続きには、Steam Direct手数料100米ドル、税務に関する質問への回答、支払先銀行口座情報の登録、およびValve自身による本人確認が含まれます。これらはすべて、Valveが処理する個人データです。GDPR第15条は、プライバシーポリシーに記載されているものだけでなく、処理されるあらゆる種類の個人データを対象としています。しかし、そのいずれもが別紙1には記載されていません。 シェリンスキー博士 · 1ページ ### 「所有権を証明するものは何一つない」 „… kein einziger Beleg für die Inhaberschaft (Verfügungsbefugnis) Ihres Mandanten für den Account …“ **Valveによる本人確認済み** パートナーの本人確認、その関連書類、および100米ドルの支払いは、当該書簡で言及されている顧客が保管しています。 シェリンスキー博士 · 3ページ ### 申請者からの証明の提出を求める „… gefälschten ‚Utility Bill‘ …“ · „… tatsächlich alleiniger Inhaber des Accounts …“ **請求者への証拠開示は差し控えた** 申請者には所有権の証明が求められている一方で、Valve自身が確認した所有権記録は、申請者が入手したコピーからは除外されている。 ## そのモデル:誰も単独で決定することはなく、何も交換することはできない これは、ある特定のソフトウェアの問題ではありません。誰が決定権を持つかという問題なのです。このケースでは、2人の弁護士が、どの50件の苦情が重要で、残りのものは重要ではないかを決定しました。裁判所も規制当局も関与していません。 隠しておくべきものもある。記者のログイン情報は他者のデータだからだ。問題は、誰がそれを決定するのか、そしてその決定を後から誰かが確認できるのかということだ。黒い四角形ではどちらの疑問にも答えられず、誰でもそれを削除できてしまう。一方、2つの標準的なツールなら、この両方の疑問に答えることができる。1つは、要求者のコピーに塩付きハッシュを保存すること、もう1つは、監督当局や裁判所の公開鍵で封印された原本を保管することだ。 「SALTED COMMITMENT」・保留フィールド1つにつき1つ c = SHA-256(salt ‖ value) ソルトは16バイトのランダムなバイト列であり、フィールドごとに新たに生成されます。リクエスト送信側のコピーには `c` その値の代わりに、企業の署名の下に記入されます。その値とその塩は、OpenPGP または X25519 と AES-GCM を用いて、認証局の公開鍵で暗号化された封筒に入れて送信されます。認証局の秘密鍵がなければ誰もそれを開封することはできず、企業も署名したコミットメントを破ることなく値を置き換えることはできません。 1. ステップ 1 · 依頼者**原稿と封筒を手渡す** 誓約が記載された署名済みの写しと封印された封筒は、監督当局または裁判所に提出される。 2. ステップ 2 · 権限**封筒を開き、再計算します** 検査官は、当局の秘密鍵を用いて復号し、各フィールドについて SHA-256(ソルト ‖ 値) を再計算します。各結果は、当該企業が署名したコミットメントと一致していなければなりません。 3. ステップ3 · 独立した機関**何が実際に保護されていたのかを決定する** 企業ではなく、当局が、非開示とされたすべての情報(ここでは1,944件の苦情内容とセキュリティ履歴)を精査し、第三者の権利を保護するために非開示が必要だったかどうかを判断する。 別紙1・514ページ・1行、非表示にする2つの方法ライブ · ブラウザ上で 納品時の状態・黒い長方形画像の重ね合わせのみ Aspose.PDF for .NET 20.8 · page 514テキストレイヤー + 長方形 記者:[ログイン・本サイトでは再掲載されていません] 日付: 2024-03-28 種類: Offensive Profile 本文: русофоб 上に黒い四角形が描画されます。その下のテキストはファイルに残ります。 依頼者用コピー · 塩漬けのコミットメント当事務所による署名 c = SHA-256(salt ‖ value)当局の指示により封印済み 記者: [非公開・確約] 日付: 2024-03-28 種類: Offensive Profile 本文: [withheld · commitment] エンベロープ · RSA-OAEP-256 + AES-256-GCM当局の公開鍵について コピーにはコミットメントが含まれています。値とソルトはエンベロープ内にあります。 1. **1** 依頼者がコピーと封筒を手渡す 2. **2** 当局はそれを開き、すべてのコミットメントを再計算する 3. **3** どの情報を非公開とするかは当局が決定する どちらのパネルも、同じ2つのフィールドを非表示にしています。生のバイトデータを読み取り、その後、権限チェックを実行してください。 左:納品時のAnlage 1の1行。514ページの黒い長方形の下に苦情の本文があり、報告者のログインIDは省略され、その欄にはプレースホルダーが入っています。右:ソルト付きコミットメントが追加された同じ行で、その値は当局の鍵によって封印されています。このデモでは、鍵ペアはブラウザ内で生成され、エンベロープはTgWitnessが封印された配信に使用するものです。ステップ3の決定は一例です。 **誰も一人で決めることはない**依然として、当社がどの情報を伏せるべきかを提案しています。その内容については、全体像を把握しており、かつ紛争に関与していない人物が確認を行います。 **何も漏れない**要求者は他者のデータを一切閲覧できません。ソルトがあることで、コミットメントを推測する意味がなくなります。ソルトがなければ、単語リストをハッシュ処理するだけで、たった1語の苦情を見つけ出せてしまうからです。 **交換できるものはありません**すべての値は、企業が署名した契約内容と一致していなければなりません。記載内容が異なる場合や記載がない場合は、チェックに失敗します。 **そのサインには意味がある**約束事項に対する適格な署名により、企業はカバーレターだけでなく、あらゆる隠れた価値についても責任を負うことになる。 **肩書きは重要ではない**その確認は算術的なものです。必要なのは、コピーと封筒、そして当局の鍵であり、誰かの言葉ではありません。 これらには新たなインフラは一切必要ありません。ドイツの監督当局はすでにOpenPGP鍵を公開しています。連邦データ保護委員は[各部署ごとに1つずつ鍵を掲載しており](https://www.bfdi.bund.de/DE/Service/Kontakt/Schluessel/Schluessel-node.html)、バーデン=ヴュルテンベルク州情報自由局(LfDI)は、[暗号化された電子メール用の公開鍵を提供しています](https://www.baden-wuerttemberg.datenschutz.de/kontaktdaten-des-verantwortlichen/)。また、ドイツの裁判所はすでにEGVPを通じて書類の提出を受けており、その[エンドツーエンド暗号化はOSCIプロトコルに基づいています](https://egvp.justiz.de/behoerdenpostfach/Informationsmaterial_fuer_Behoerden_zu_BeBPo_und_eEB_V1_3_2.pdf)。 **PhishDestroyの立場。**誰が弁護士に、何が重要で何が重要でないかを決める権利を与えたというのか?弁護士がそのような判断を下すべきではない。すべての資料を提出すべきである。誰でも削除できる黒い四角で隠された形ではなく、裁判所や規制当局の鍵でしか開けられないように封印された状態で提出すべきだ。そうすれば、「誤り」や「誤解」が生じる余地も、都合の良い部分だけを見せかける余地もなくなる。 ## 「正直なモデル」:完全なデータ、明示されたルール、権限を持つ鍵 申請者は、争点となっていない事項についてはすべて、即座に受け取ります。差し控えられた事項については、図面では明示されず、黙って隠されることもありません。それらは、完全な状態で署名され、決定権限を持つ当局の鍵で暗号化されて送付されます。 | 質問 | 何が起きたのか | 「オネスト」モデル | | --- | --- | --- | | 何が差し引かれるかを決めるのは誰か | 紛争当事者の代理人 | コピーが作成された際に宣言・署名された規則。当局がこれを審査する。 | | 依頼者が受け取るもの | 選択された行;カテゴリ全体が存在しない;その背後にあるレコードがないカットオフ | 争いのない記録はすべて、直ちに | | 第三者のデータ | 絵で埋め尽くされていて、まだファイルの中にある | 依頼者の写しからは削除したが、原本には権威情報として残した | | 非公開部分 | 数も内容も不明 | 署名付きマニフェストに含まれている;全体が当局の鍵で暗号化されたオリジナル | | そのコピーがどのように選ばれたかの根拠 | 編集作業が失敗したために存在しているに過ぎない | 組み込み:ルール、カウント、元のデータのハッシュ | | 係争中の地域 | その手紙によって決定された:「どの裁判所も同意するだろう」 | 規制当局または裁判所が、誰がそれらを開封できるかを決定する | | 時間 | 106日 | 輸出および配送 | | 弁護士の役割 | 適用範囲、立証責任、および評決を定める | 法廷で争点を主張する。依頼者のデータは編集しない。 | 監督当局も信頼を必要としません。GDPR第58条第1項(e)は、すでに監督当局に対し、管理者が処理するすべての個人データへのアクセス権を付与しています。このモデルでは、受け取り時に検証可能な形式でのみ、そのデータが引き渡されるだけです。 **書簡に記載された理由、すなわち所有権に関する疑義、第三者による支払い、苦情、フィッシングの疑いなどは、第15条が遵守されなかった理由を説明するものである。これらは同条の要件を満たしていない。**根拠が何であれ、結果は同じである。すなわち、請求者は自身のデータを受け取ることができず、図面に基づいて他人のデータが提供され、その選定内容は偶然にのみ確認できた。データへのアクセスは、データ主体の権利であり、他者の紛争における交渉材料ではない。 ## TgWitnessが原本を保管し、コピーの検証を可能にする仕組み TgWitnessは、会話を証拠としてエクスポートします。その設計は、この事例から得られた教訓に基づいています。すなわち、エクスポートされたデータは、それを提供した相手という理由だけで信頼されるべきではないということです。元のキャプチャされたログは保持されます。共有用コピーには、選択されたレコードとフィールド、開示ルール、および除外されたレコードの数が、署名付きマニフェストに記録されます。ゼロトラストの原則は、私たち自身を含め、すべての人に適用されます。 保存 ### 原本を保管してください キャプチャされたジャーナル全体とその署名を保持してください。後日の置換や切り捨てがないか確認できるよう、チェックポイントを別途保管しておいてください。 保護する ### 配信内容を暗号化する 受信者の鍵でアーカイブを暗号化するか、パスワードで配信を保護します。復号には、対応する鍵またはパスワードが必要です。 開示 ### 欠落している箇所を挙げてください 署名付きマニフェストに目的と規則を記載する。最小化されたレコードにマークを付け、除外されたレコードの数を数え、元のジャーナルへのリンクを保持する。 TgWitnessは、上記のデモで使用されたエンベロープを用いて、受信者キー向けの完全なオリジナルデータをすでに封印しており、開示によって非公開とされる部分を明示しています。検証者は、レコードの署名と、共有コピーとソースジャーナルとのリンクを確認します。非公開とされたコンテンツを元のハッシュ値と照合するには、保持されている完全なオリジナルデータが必要です。この事例で提唱されているのは、権限者に対するフィールドごとのソルト付きコミットメントです。 | 別紙1において | TgWitnessの特集 | 小切手の記録 | | --- | --- | --- | | 黒い四角形の下にあるテキスト | 非公開フィールドは共有用コピーから削除され、オリジナルは別途保持される | 明示的な除外項目と元のレコードのハッシュ値 | | 表示されている説明:50件、対象件数:1,944件 | 署名付き開示規則および除外記録の数 | 選定された範囲とその出典誌の参照情報 | | PDFの添付ファイル | 取得したアーカイブの暗号化配信 | 認証付き復号;アーカイブの署名とハッシュ | | 以下のSHA-256で識別されるファイル | ハッシュ値、署名、および保持されているチェックポイントの記録 | 以前に保存したジャーナルとの比較 | ### このソフトウェアが保証するように設計されていること **データの完全性**すべてのレコードはハッシュ化されてチェーンに組み込まれ、Ed25519で署名されます。検証者はすべてのレコードを再計算するため、変更があればすぐに判明します。 **配送状況の確認が可能**アーカイブは受信者向けに暗号化された状態で送信されます。大容量のアーカイブは、署名付きマニフェスト付きの暗号化されたパーツに分割され、ローカルで組み立てられ、検証されます。 **他人のデータは非公開のままです**共有コピーは、ルールに従って情報を非表示にし、非表示にした項目を明示します。パネル内でマスクされた値を表示する操作は、監査の対象となります。 **失敗の余地はない**検証は算術的なものです。ファイル、信頼できる鍵のフィンガープリント、そして保存されたチェックポイントがあれば十分です。誰かの言葉など必要ありません。 **操作の余地はない**編集や削除は新しいレコードとなり、短縮されたジャーナルは保持されたチェックポイントに対して不整合となり、開示は、完全でない限り決して完全であるとは見なされない。 名前のスペルミスがあっても、ソフトウェアによって署名されたデータは変わりません。期限を1ヶ月過ぎても、元の記録は変わりません。いかなる変更もチェーンを断ち切ることになり、検証ツールはその旨を通知します。以下の両方を試してみてください。 SHA-256 · ブラウザ上でどちらかの行を編集してください 署名済み・レターヘッド付き`86582990a7b364adbd83071c9edb4774ed6e8ea50b80dca1ae426c3fa679a1d6` 公的記録`17fae25500c51998112b146c76b21b04bf3d4034407f2f958bced7d6d6e928ba` **1**文字の違い64桁の16進数のうち**60**桁が異なる256ビットのうち**128ビットが**異なる 1文字の違い。2つの無関係な指紋。 あるハッシュ関数が、署名処理では見落とされていた1文字に気づきました。タイトルは単なるバイト数の増加に過ぎません。それはフィンガープリントを変えるだけで、事実そのものを変えることはありません。 サイン入り日記・簡略版参考となる記録 レコード 1**17.06.2025 · access request**`adc396074b0f04…`= 保存されたハッシュ レコード 2**01.10.2025 · letterhead p.zurheode**`0b8eda5c2f43ae…`= 保存されたハッシュ レコード 3**01.10.2025 · Anlage 1 · 830 pages**`dbe2eef85bfb5a…`= 保存されたハッシュ 各レコードには、その前のレコードの「指紋」が格納されています。レコード2を変更すると、そのハッシュ値が変化し、レコード3とのリンクが切断されます。 簡単に言うと、各フィンガープリントは、直前のフィンガープリントとテキストの1行をカバーしています。TgWitnessは、9つの標準的なイベントフィールド(そのうちの1つは直前のハッシュ)のハッシュ値を算出し、各ダイジェストにEd25519で署名します。[チェックポイントを含む完全なチェーンをご覧ください](https://phishdestroy.io/tgwitness/ja/docs/concepts/)。 [TgWitnessのコピー共有の仕組み](https://phishdestroy.io/tgwitness/ja/docs/handover/) · [封がされた封筒](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md#cryptographic-handoff) · [実装および検証の範囲](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) ## ご自身で確認してください ファイル保管元の規制当局、裁判所、監査機関は、このページに記載されているすべての確認作業をオフラインで再現することができます。掲載されるのは集計結果のみです。報告者のログイン情報、アカウント識別子、プロフィールデータはここに公開されません。 **すべての月:2021年~2025年** | 年 | 1月 | 2月 | 3月 | 4月 | 5月 | ジュン | 7月 | 8月 | 9月 | 10月 | 11月 | 12月 | 合計 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 2021 | 0 | 2 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 0 | 1 | 20 | **25** | | 2022 | 10 | 7 | 43 | 9 | 2 | 7 | 2 | 11 | 7 | 6 | 5 | 13 | **122** | | 2023 | 111 | 48 | 156 | 59 | 52 | 53 | 66 | 52 | 73 | 44 | 53 | 58 | **825** | | 2024 | 69 | 58 | 111 | 36 | 33 | 46 | 83 | 53 | 54 | 70 | 79 | 82 | **774** | | 2025 | 92 | 32 | 35 | 20 | 12 | 1 | 7 | 47 | 3 | — | — | — | **249** | 0 は、このエクスポートにその月の記録がないことを意味します。— は、2025年9月のカットオフ日以降であることを示します。合計:**1,995件**。 **提供された表に含まれるすべてのレポートカテゴリ** | 記録されたレポートの種類 | すべての記録 | わかりやすい説明 | 対象となる説明 | | --- | --- | --- | --- | | Offensive Profile | 1,148 | 0 | 1,147 | | Suspected Hijacker | 312 | 43 | 269 | | 不正行為 | 290 | 2 | 288 | | Offensive Persona Name | 87 | 1 | 86 | | Offensive Avatar | 57 | 3 | 54 | | ハラスメント | 46 | 1 | 45 | | スパム | 37 | 0 | 37 | | なりすまし | 16 | 0 | 16 | | 自動モデレーション | 1 | 0 | 1 | | 貿易詐欺 | 1 | 0 | 1 | その Offensive Profile 合計には、記述が空の1件も含まれています。合計:1,995件、読み取り可能な記述50件、対象となる記述1,944件、記述が空の1件。 **ログイン履歴とセキュリティ履歴** 別紙1、1ページ: `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)` そして `Date of Report: 09-29-2025`. 1~119ページに掲載されているログイン履歴は、最新のログインから順に表示されています。最新の記録は2025年5月のもので、それより後の記録はありません。 830ページの「セキュリティ履歴」は、黒い四角で隠されています。最後のパスワード変更は2024年7月であり、2025年には変更の記録はありません。これらの行に記載されている日付、住所、識別子は掲載されていません。 ``` pdftotext -f 1 -l 1 Anlage1.pdf - # last logon, date of report pdftotext -f 830 -l 830 Anlage1.pdf - # security history ``` **PDFのメタデータと署名宣言** PDFのメタデータ:作成者 `Aspose.PDF for .NET 20.8`; 作成日時:2025年10月1日 19:58:05;更新日時:19:58:41(いずれもUTC+02:00)。これら2つのタイムスタンプは **36秒の間隔**. どちらの手紙も、最終ページに条件付き電子署名が記載されています: „Dieses Schreiben ist qualifiziert elektronisch signiert“. 署名の検証は、ここで示した内容や黒塗り処理のチェックとは別のチェックです。 **カウント値を再現し、ソースのハッシュ値を比較する** 集計スクリプトは、以下の「Anlage 1」のハッシュに固定されています。このスクリプトは、444~620ページにあるテーブルの行を再構築し、ページ境界をまたいで続く118個のセルを結合します。可視性は、不透明な黒い長方形との単語ボックスの交差によって判定され、1つの空欄の記述は別途記録されます。 キリル文字のカウントには U+0400~U+052F が使用されます。ログイン形式の比較には、文字列全体を対象とするパターンが使用されます。 `[A-Za-z]+[0-9]{3,5}`. 繰り返し回数は、抽出後の空白が正規化された後にカウントされます。対象となる記述における単語数は、いずれの場合も単語の語幹と一致しています。これらは記述的な測定値であり、共同執筆や不正行為を自動的に特定するものではありません。 JSON内のオプションの言語推定では、ローカルでLingua 2.2.0を使用しています。短文や曖昧なテキストについては、言語が割り当てられません。905,672文字のチェックでは、バウンディングボックスが黒い長方形と1回交差するスペース以外の各文字をカウントしており、1,329個の黒い長方形のうち1,044個がそのようなテキストと重なっています。 [集計数 · JSON](https://phishdestroy.io/tgwitness/assets/signed-export-statistics.json?v=b84f21c8824d) · [ローカル集計スクリプト · Python](https://phishdestroy.github.io/TgWitness/assets/signed-export-audit.py) ``` python signed-export-audit.py Anlage1.pdf --output counts.json sha256sum Anlage1.pdf pdfinfo Anlage1.pdf | grep -E "Producer|CreationDate|ModDate" pdftotext -layout Anlage1.pdf - | less ``` このスクリプトには、PyMuPDF と lingua-language-detector が必要です。ネットワークへのリクエストは一切行わず、個々のテキストやログイン情報ではなく、集計結果を出力します。 | ファイル | SHA-256 | | --- | --- | | 文書番号 42603633(ズルハイデ博士) | `de0fdcf6bfaccedc98d1670438bc7ca3330479096875e716dbb9678922b43ab9` | | 文書番号 42282474(シェリンスキー博士) | `b48e09c28ee40a46f1d404041751f718fb185d1eb774ddabb4373fdd53bbe2f1` | | 別紙1 | `2bb927e2c42fdc2e3ad089ae302dd887c343f6798aba00fcfac279224ff7d6af` | **あらゆる輸出に関する教訓だ。**弁護士は輸出書類に署名することができる。その署名は、誰が送ったかを示すものであり、その内容に真実があるかどうかを示すものではない。真実とは、誰でも繰り返し確認できる検証に耐えうるものである。 ## 当社の立場 **PhishDestroyの立場です。**私たちは法律と裁判所を尊重します。法律は真実の敵ではありません。法律に従うことを避けるためにそれを曲解する者は、裁判所の味方ではなく、博士号という肩書きが裁判所に対する権威となることはありません。 博士号は歴史的な事実であり、狭い理論分野における一つの研究を一度公の場で発表したに過ぎない。それだけで誰かがIT弁護士になれるわけではない。 私たちの知る限り、このタイトルには、これらの誤りを説明できる要素は一切見当たらない。シグネチャの下に記された引数でも、名前の綴り間違いでも、そして、その手紙自体が保護すると主張していたデータの漏洩でも、いずれも説明にはならない。 その後、両署名者は第17条に基づき、検索結果からの削除請求を提出した([事業者向け通知](https://phishdestroy.io/tgwitness/ja/docs/reference/notice/)を参照)。「忘れられる権利」は、専門家の業務上の過失を帳消しにしてはならない。そもそも、電子署名付きで送付される文書を誰かがチェックしているのだろうか? これらの書簡は、公的な重要性を帯びた文書というよりは、友人へのメールのように読めてしまう。 ゼロトラスト、すべての人に向けて。お金は良いものです。しかし、自国の法律を金のために売り渡すことは、私たちの見解では、そのお金を最も有効に活用しているとは言えません。とはいえ、私たちは専門家ではありません。 PhishDestroyは本紛争の当事者ではなく、Steamアカウントのブロックが正当であったかどうかについては言及していません。本ページではデータ主体は特定されておらず、アカウント識別子、ログイン情報、IPアドレス、および個人データは掲載されていません。苦情の文面は、報告者のログイン情報を除いて引用されており、ファイルのテキストレイヤーに残されている黒い四角で覆われた部分も含みます。書簡:文書番号 42282474、 2025年8月15日(3ページ);文書番号 42603633、2025年10月1日(9ページ)。添付資料:Anlage 1(830ページ)。ページ参照はPDFのページ順に従う。ドイツ語の引用文の英語訳は当方によるものである。[関連事件ファイル](https://phishdestroy.io/steam_dossier/taylor_wessing) · [106日間にわたるGDPRファイル](https://github.com/phishdestroy/TgWitness/blob/main/docs/TAYLOR-WESSING-GDPR-FILE.md)。 --- # Telegram · アーカイブの操作 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/archive/ 履歴の読み込み、保存された記録の検索、AIソースの確認、およびツールの連携が可能です。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) メッセージを見つけ、出典を確認し、証拠を構築する。 01**履歴を取り込む** 有効なソースの過去のメッセージをワークスペースに取り込みます。 02**情報源を参照** 検索し、各ヒットの元になった保存済みメッセージを開きます。 03**引き継ぎ内容を明確にする** 分析は 1 つのファイルに、署名付きの証拠はその隣に置きます。 記録されたデータ、認識されたテキスト、および分析者の結論は、それぞれ明確に区別されています。 ## 過去のメッセージを読み込む 1. **ソース → 対象範囲のチャット**:有効なチャットを確認し、観察を開始します。 2. **全履歴を読み込む**。その時点のソース一覧がそのまま使われます。 3. **履歴の一時停止** / **履歴の再開**はいつでも可能です。再起動後は手動で再開してください。 4. ソースごとの結果とダウンロードキューを確認し、署名付きの進捗レポートをエクスポートと一緒に保管します。 これはワークスペースを埋めるためのものです。単一チャットの HTML/JSON エクスポートは別物です。[詳細](https://phishdestroy.io/tgwitness/ja/docs/reference/history/)。 ## まずは検索し、その後AIの利用を判断する 1. **ジャーナル**はローカルで検索し、ソースと時間で絞り込めます。 2. フレーズやドメインを検索し、記録とその版を開きます。 3. AI を使う場合は、管理者が**連携機能**でプロバイダーを設定します。その後**アーカイブに問い合わせる**でチャットと期間を選び、**モデルに送信されるデータ**を見て、外に出すべきでないもののチェックを外します。 4. 引用を確認し、回答をレポートとして保存し、メモを加えます。 検索に AI は不要です。レポートは署名付きジャーナルとは別に、出典と改訂を保持します。[プロバイダーの設定](https://phishdestroy.io/tgwitness/ja/docs/reference/analysis/)。 ## 必要な接続方法を選択してください | タスク | 開く | セットアップ | | --- | --- | --- | | 選んだチャットを AI クライアントに読ませる | **連携機能 → MCP** | [MCP をインストールし、範囲限定トークンを作って接続する](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/) | | 保存されたメディア内のテキストを認識する | `media.saved`レコード → **添付ファイルを認識** | [ローカルの Docker ワーカーを設定する](https://phishdestroy.io/tgwitness/ja/docs/reference/media-analysis/) | | イベントを n8n または SIEM に送信する | **連携機能 → 送信用ウェブフック** | [受信先を追加し、HMAC を確認し、ID の重複を除く](https://phishdestroy.io/tgwitness/ja/docs/reference/webhooks/) | **どのアクセストークンをどこに設定すればよいですか?** パネルへのアクセスは人のためのものです。MCP には専用の読み取り専用トークン、webhook には専用の HMAC シークレットがあります。どれも Telegram セッションは不要です。 [パネルのアクセス権を共有](https://phishdestroy.io/tgwitness/ja/docs/access/)するか、[MCPクライアントを設定してください](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/)。 ## 情報源と結論を提示する レポートは署名付き ZIP の隣に置いてください。レポートはあなたによるソースの読み解きで、受け取った人が検証するのは ZIP です。 [エクスポートと検証](https://phishdestroy.io/tgwitness/ja/docs/exports/) · [調査の全過程を網羅する](https://phishdestroy.io/tgwitness/ja/docs/cases/) --- # Telegram · 事例を共有する Canonical page: https://phishdestroy.io/tgwitness/ja/docs/access/ レビュー担当者やアナリストに対し、個別の権限、セッション制限、および取り消し可能なトークンを設定して、選択されたアカウントやチャットへのアクセス権を付与します。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 必要なケースを共有し、それ以外の情報は管理下に置いておきましょう。 01**証拠を選択してください** ワークスペース全体、または個別のチャット。 02**操作を選択してください** 閲覧、エクスポート、または必要な操作だけ。 03**制限を設定する** 必要に応じて有効期限、セッション制限、IP ルールを付けた個人用トークン。 収集範囲によって、何が記録されるかが決まります。アクセス範囲によって、ユーザーが何を閲覧・操作できるかが決まります。 ## アクセス権を付与する 1. 管理者として**アクセス**を開きます。 2. 名前を付け、ワークスペースとチャットを選びます。 3. レビュー担当者には**表示**だけで十分です。ダウンロードが必要なら**エクスポート**を加えます。 4. 制限を設定し、「**アクセスを作成」**をクリックしてください。 5. トークンをコピーし(表示は 1 回だけ)、パネルのアドレスと一緒に非公開で送ります。 6. まず別のブラウザーセッションで、相手に何が見えるかを確認します。 ## まず、彼らが遂行すべき業務から始めましょう | 人物 | アクセス | 結果 | | --- | --- | --- | | レビュー担当者 | 選択されたチャット;閲覧専用 | チャットを閲覧するだけで、何も変更できません。 | | アナリスト | 選択したチャット:表示およびエクスポート | ケースに必要なものを閲覧し、ダウンロードします。 | | オペレーター | 選択されたワークスペース全体、ソースおよび収集内容 | 観察対象を決め、コレクターを開始・停止します。 | これは例にすぎず、固定の役割ではありません。チャットに限ったアクセスには、アカウント設定やジャーナル全体のエクスポートは付きません。全ワークスペースへのアクセスには、後から追加したアカウントも含まれます。 ## いつでも考えを変えることができます アクセスはいつでも編集でき、次のリクエストから適用されます。1 つのセッションを終了することも、すべて取り消すこともできます。ダウンロード済みのファイルは取り戻せません。収集は続きます。 **セッションおよびIPアドレスの制限** 同時セッション数とログイン数の制限、終了日の設定、IP やサブネットの許可、最初のログイン IP への固定ができます。有効期限は非アクティブな時間で数え、開いているパネルはアクティブとみなされます。プロキシの背後では、アプリがどのクライアント IP を見ているかを確認してください。 **メインキーとアクティビティログ** メインのトークンは管理者が持ちます。発行したアクセスでは、他の人のアクセスを管理したり管理コンソールを開いたりできません。アクセスの変更とセッションは、トークンを含めずにジャーナルへ署名付きで記録されます。サーバーの管理者は引き続きすべてを見られます。 7 つの権限とセッションのルールすべて:[アクセスのリファレンス](https://phishdestroy.io/tgwitness/ja/docs/reference/access/)。 --- # Telegram · 稼働を継続してください Canonical page: https://phishdestroy.io/tgwitness/ja/docs/server/ TgWitnessは、永続的なストレージ、プライベートパネルへのアクセス、バックアップ機能、および再起動後のチェック機能を備えたサーバー上で実行してください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) コレクターを動かし続け、再起動してもデータを安全に保ちます。 ## 起動方法を選択してください ネイティブ:[ランチャー](https://phishdestroy.io/tgwitness/ja/docs/start/)と [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) のサービステンプレート。Docker の場合は、プロジェクトのフォルダーで: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` パネルは localhost:8787 で待ち受けます。ローカルか SSH トンネル経由で開き、2 つ目のコマンドで得たトークンを使います。 ## データディレクトリ全体を保持してください ネイティブ:`data/live`。Docker:`tgwitness-data` ボリューム。ジャーナル、セッション、鍵はひとまとまりです。署名付きエクスポートは証拠であって、バックアップではありません。 1. まず収集を停止します。 2. データディレクトリ全体を、ホスト以外の安全な場所にコピーします。 3. 信頼する前に、別のインストールで復元を試します。 ## 再起動後にご確認ください ワークスペースと鍵、接続、ソース、新しいメッセージが届いているかを確認します。TgWitness が取り戻すのは Telegram にまだ残っているものだけで、停止中に起きたすべてではありません。 コンテナーが「healthy」なのは Web サーバーが応答しているという意味です。収集が動いているかは、テストメッセージと証人でわかります。 ## 意図した内容のみを公開してください HTTPS、ボリューム、更新、復元はデプロイのリファレンスにあります。実際にテストした内容:[検証記録](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/)。 --- # Telegram · 何が問題だったのかを確認する Canonical page: https://phishdestroy.io/tgwitness/ja/docs/troubleshooting/ 各問題に応じた適切なシグナルを使用して、パネルへのアクセス状況、Telegramとの接続状況、メッセージの欠落、FloodWait、およびWitnessのステータスを確認してください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 症状から始め、1 つずつ確認してください。 ## パネルからトークンの入力が求められます 求められているのは、ランチャーが表示したファイルにあるパネルトークンです。Docker:`docker compose exec tgwitness cat /data/panel-token.txt`。Telegram のコードでも、ボットのトークンでも、証人のトークンでもありません。 ## Telegramは接続されません 接続チェックを実行します。公開プロキシなら別のものを選んで保存します。プロキシの種類とシークレットの形式を確認します。リストを更新しただけではルートは切り替わりません。 ## 接続されていますが、新しいメッセージはありません 1. 観察は正しいワークスペースで動いていますか? 2. ソースは選択されていて、そのアカウントから見えていますか? 3. テストグループで固有のメッセージを送り、それを検索します。 4. ジャーナルで中断や Telegram のエラーを探します。 静かなチャットは単に新しいものがないだけです。完全性が重要なら、管理された配信テストを行ってください。 ## 再起動後のFloodWaitまたは間隔 FloodWait は Telegram からの「ゆっくり」という合図です。過ぎるのを待って負荷を下げてください。再接続しても効果はありません。再起動後、TgWitness は Telegram にまだ残っているものを取り戻します。残りは欠落なので、書き留めてください。 ## ボットは設定済みですが、何も投稿していません 証人は動いていますか、ボットはチャンネルに投稿できますか、コレクターと Bot API に届きますか?証人のジャーナルで失敗した投稿を探してください。コレクター側にポーリングがあっても、投稿が送られたとは限りません。 ## GitHubトークンの連携機能はどこにありますか? **計画中。**「Extras」セクションでは、提案されているフォークおよびビルド検証のワークフローについて説明しています。現在、GitHubトークン入力フォームや、稼働中のインストール環境がリポジトリと一致していることを自動的に確認する機能はありません。[現在の機能状況](https://phishdestroy.io/tgwitness/ja/docs/reference/features/)については、こちらをご覧ください。 バグを報告する場合は、バージョン、OS、手順、個人情報を伏せたエラーを添えてください。セッション、トークン、個人的なメッセージ、データディレクトリを公開の issue に載せないでください。 --- # Export Clinic Canonical page: https://phishdestroy.io/tgwitness/ja/docs/export-clinic/ Telegram Desktopでのエクスポートに関する制御された実験をご覧いただき、7つのテスト会話比較を行い、元の記録データと対応するファイルを確認してください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) チャットには「FAIL」と表示されています。エクスポートされたページには「PASS」と表示されています。この変化を観察し、ファイルを比較して、なぜそうなったのかを確認してください。 この実験では、テスト用アカウントとスクリプトによる会話を使用しています。Telegram Desktopは公式サイトからダウンロードし、その実行ファイルには一切手を加えていません。また、ローカルのヘルパーが、特定のエクスポートファイルを意図的に変更しました。 ダウンロード、サインイン、エクスポートの手順を確認し、Telegramの会話内容と変更されたHTMLおよびJSONを比較してください。この実験は、通常のエクスポートデータがどこで変更される可能性があるか、そして収集プロセスの記録がなぜ重要なのかを示しています。 **1:59.7** 短縮版映像**6:08.8** 完全版ソース録音**7つの**テスト会話 ## 実験をご覧ください [映画をダウンロードする](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) 1:59.7 · セットアップと繰り返される手順は2倍~15倍速で再生され、ラベルが付けられています。サインイン、最初のエクスポート、および選択された比較処理は、元の速度で実行されます。音声はありません。 [オリジナルのMKVファイルをダウンロード ↗](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) ## テストのエクスポートデータを比較する これらの抜粋は、保存・修正されたJSONファイルからのものです。会話の種類を選択し、メッセージを比較した後、対応するエクスポートデータをすべてダウンロードして、HTML、JSON、および含まれている画像を自分で確認してください。 ### エクスポート・クリニック | PDFチェック 5件のメッセージ · 2件の変更 **地域変更前**元のバイトを保持 ドキュメントチェック/合成テスト 結果:不合格 黒い四角形の下に、非表示のテキストが選択可能な状態のまま残っています。 これはデモ用PDFに対するスクリプトによる結果であり、サードパーティのドキュメントを検査したものではありません。 d58d19814e1e07d5… **ローカル変更後**意図的に変更されたバイト 文書チェック/合成テスト 結果:合格 機密性の高いテキストはすべて完全に削除されました。 これは、意図的に置き換えられたデモ用の結果です。 83a0a37eb7110d51… result.json · メッセージ 1216 台本に基づいたシーンの内容です。ボットによる判定は、実際の第三者文書を検証したものではありません。 メッセージ 1/2 を変更しました **このエクスポートに含まれる画像を比較してください** ![ローカル変更前の画像](https://phishdestroy.io/tgwitness/ja/docs/export-clinic/) BEFORE · 保持された画像バイト ![意図的に加工された画像](https://phishdestroy.io/tgwitness/ja/docs/export-clinic/) AFTER · 意図的に差し替えた画像 このボットのエクスポートには添付ファイルは含まれていませんでした。このアーカイブでは、その制限が維持されています。 JavaScriptが無効になっています。デフォルトのボット比較機能およびすべてのダウンロード機能は引き続きご利用いただけます。ペアになったアーカイブをダウンロードして、残りの6つの会話内容をご確認ください。 ## この比較が示すこと Telegramの[通常のエクスポート機能](https://telegram.org/blog/export-and-more)では、チャット履歴や選択したメディアがローカルファイルとして保存されます。ここでは、書き込み権限を持つヘルパーがそれらのファイルを変更している間も、公式クライアントには元の会話内容が引き続き表示されます。対応するファイルを確認することで、各変更点を検証することができます。 1. **公式クライアント:**ダウンロード、ログインして、テスト用の会話を確認してください。 2. **ネイティブエクスポート:**クライアント側がHTML、JSON、および選択された画像を書き出します。 3. **明らかになった介入:**現地の協力者が、意図的に特定のファイルを変更した。 4. **比較:**会話と変更後のエクスポートが並べて表示されます。 ### データを収集した時点で記録する 署名のタイミングは重要です。すでに改変されたエクスポートに署名すると、その改変されたバージョンが固定されてしまいます。TgWitnessはTelegramに接続し、アカウントに配信されたコンテンツを記録するとともに、収集時にジャーナルエントリに署名してリンク付けを行います。受信者は、保存された記録やファイルを、それらの署名および独自に保持されているチェックポイントと照合して確認することができます。 外部で記録された収集プロセスについては、[GitHub Actionsが、](https://phishdestroy.io/tgwitness/ja/docs/capture/)新しいTelegramセッションを使用して、固定されたTgWitnessコレクターを実行します。GitHubは、その結果として生成されたアーカイブを認証します。検証では、承認済みのワークフローとコレクターのバージョン、アーカイブのダイジェスト、ジャーナル、および添付ファイルがチェックされます。 [TgWitnessアーカイブの検証](https://phishdestroy.io/tgwitness/ja/docs/exports/#verify) · [符号付きレコードを変更してみてください](https://phishdestroy.io/tgwitness/ja/docs/concepts/#chain) · [GitHubのキャプチャを実行する](https://phishdestroy.io/tgwitness/ja/docs/capture/) ## 法科学ツールが実際にどのような認証を行っているか 「Export Clinic」は、ある特定の事例を示しています。そこから浮かび上がるパターンは、Telegramに限ったものではありません。 私たちが検討した手続きの圧倒的多数において――裁判所の提出書類、事件に関する議論、公表された分析などを通じて――「デジタル証拠」は一貫した形式をとっています。すなわち、Telegramのエクスポートデータ(HTMLまたはJSONファイル、場合によってはモニターの画面録画、あるいはプロフィールページを閲覧しているiPhoneの動画)に、専門家の署名が添付されているというものです。通常、これが証拠の連鎖のすべてとなります。 Telegramのエクスポート機能は、個人データのポータビリティを実現するためのスナップショットを提供します。TgWitnessは、取得記録、保存された観察内容や変更履歴、ファイルのハッシュ値、収集者の署名、および選択したモードで利用可能な外部検証記録を追加します。これらを組み合わせることで、受信者は保存された資料と、その記録された文脈、日時、収集条件とを照合することが可能になります。 ### ツール自体は正直だ。問題は、人々がそれによって何が証明されると思い込んでいるかということだ。 当社はUFED Cellebrite社と直接提携してきました。これは非常に優れたソフトウェアです。デバイスからデータを抽出し、SHA-256ハッシュを算出し、署名付きレポートを作成する際、このソフトウェアが正確に証明しているのは、ただ一つのことだけです: *これらのバイトは抽出時点でこのデバイス上に存在しており、転送中に変更は一切加えられていません。* それは事実だ。それは有用だ。それが、それが証明していることのすべてだ。 法執行機関がその端末に触れる前に、そこに何が保存されていたかについては何も語っていない。そのデータが過去の事実を反映しているかどうかも、何も語っていない。このツールは正確である。しかし、このツールは証人ではない。 Telegramのチャットエクスポートを扱うために特別に開発されたツール――ビューア、アーカイバ、法廷提出用ラッパーなど――をそれぞれ用意し、あらかじめ用意したエクスポートファイルで各ツールをテストして、比較表を作成することもできたでしょう。しかし、そうはしません。重要なのは、どのツールが何を捕捉できるかということではないからです。どのツールもそれを成し遂げることはできません。それらは、エクスポートに含まれる内容を処理するだけです。エクスポートがツールに届く前に構成されていたのであれば、ツールはその構成を忠実に報告するだけです。 暗号署名は、*署名時点以降のデータの*完全性を保証するものです。それ以前の状況については何ら言及しません。もし入力が抽出前に作成されていた場合、そのレポートは暗号的には完璧ですが、事実としては誤りとなります。このツールは、どちらの結果についても同じように報告します。 ### 説明責任のギャップ ある管轄区域を想像してみてください。そこでは、鑑識用機器が公募入札を通じて調達され、その機種、構成、調達スケジュールが公的記録として公開されています。また、機器に最新のファームウェアを搭載することを義務付ける法律はなく、専門家証人は、法廷において自らの結論について個人的な刑事責任を負うこともありません。 米国や英国では、法科学鑑定人は、証拠に関して行うあらゆる行為について、個人として法的責任を負うことになっています。証拠の連鎖を機能させているのは、ソフトウェアではなく、この責任感なのです。この責任感がなくなれば、正義の実現に役立つはずのツールが、ライセンス保有者が都合の良いと思うあらゆる目的に利用されることになってしまいます。 **発作前状態の技術的構築** 対象者が発作の発生を十分な余裕を持って(7日間あれば十分すぎるほどだ)予知した場合、パニックに陥ることは逆効果であるだけでなく、一部の法域ではそれ自体が犯罪とみなされることもある。技術的なアクセス手段とリソースを備えた準備万端の対象者は、別の行動をとる。すなわち、デバイスの状態を構築するのである。 **ファームウェアの提供期間。**サムスンの最上位機種「Galaxy S Ultra」や「Z Fold」は、Knoxによる保護機能を備え、ブートローダーがロックされています。セキュリティパッチのリリースから、特定の地域の端末で利用可能になるまでの期間は、通常1か月にも及びます。発売されたばかりのモデルについては、最初の3~4か月間の提供期間はさらに長くなります。私たちが知る限り、個人の端末に最新のファームウェアをインストールすることを法的に義務付けている管轄区域はありません。 **サービスレベルツール。**市販のメンテナンス用ソフトウェアは、この時間帯にデバイスへの低レベルアクセスを可能にしつつ、フォレンジック調査員が注目するようなKnoxの改ざんインジケーターをトリガーすることはありません。 **タイムラインの構築。**デバイスの完全なバックアップをエミュレータに展開し、スクリプトによる時間操作とネットワークの隔離を行うことで、通話、メッセージ、アプリケーションの動作、GPS座標など、目的のイベントのタイムラインを構築することができます。 **携帯電話の電波にさらされない場所。**携帯電話基地局の課金記録は独立して検証可能であるため、それらには手を触れないでください。その代わりに、公衆Wi-Fiアクセスポイントへの接続記録がログとして残されます。公共インフラのMACアドレスは、大手テクノロジー企業によって体系的に収集・配布されています。公開されているデータから、任意の期間にわたる連続した地理的連鎖を構築することが可能です。 **アカウントの切り替え。**サムスンのアカウントを完全に削除するには、約7日かかります。新しいアカウントを作成し、用意しておいたバックアップを復元します。システムの整合性に問題はなく、ブートローダーには手を加えず、改ざんフラグも発動しません。 **具体的にはTelegramについてです。**特定のデバイスファミリーでは、アプリケーションのデータベースやキャッシュ(会話履歴、メディア、通知のメタデータ、アクティビティパターンなど)を、従来のルート権限を取得することなく、OSの機能レベルで置き換えることが可能です。専門家が生のダンプデータをすべて詳細に分析すれば、異常を検出できる可能性はあります。しかし、その分析はコストがかかり、時間もかかる上、私たちの経験上、通常の訴訟手続きでは実質的に依頼されることがありません。 ### 「ゴミを入れれば、ゴミが出る」 署名付きレポートでは、抽出されたバイトがその取得データに紐付けられます。それ以前のデバイスの履歴については、その期間の記録を用いて評価されます。 その後に続く一連のプロセス――専門家証人がツールの出力を読み取り、分析報告書を作成し、結論に署名する――も、個々の段階において同様に正確である。この一連のプロセスに関わる誰も嘘をついてはいない。また、この一連のプロセスに関わる誰も、歴史的真実を立証しようとしているわけではない。各参加者は、前の段階から受け取った情報を正確に報告しているに過ぎない。 博士号は、過去に完了した研究の記録に過ぎません。それは現在の能力を証明するものではなく、数学的に検証不可能な主張を真実にすることもできません。私たちは、別の基準を提案します: **タイトルではなく、計算結果を信じてください。** ### 証拠に対するゼロトラスト 情報セキュリティにおいて、「ゼロトラスト」とは、立場や資格の如何にかかわらず、デフォルトではいかなる主体も信頼せず、あらゆる主張を個別に検証しなければならないことを意味します。私たちは、この同じ原則をデジタル証拠にも適用することを提案します。信頼は脆弱性です。主張が個別に、かつ数学的に検証できない場合、それは「信頼に基づく主張」となります。そして、信頼は誤って置かれたり、金で買われたり、強要されたりする可能性があるのです。 特にTelegramの証拠データのエクスポートに関しては、私たちを信用してはいけません。Telegramも、分析担当者も、専門家証人も信用してはいけません。計算結果を自分で確認してください。 実際の運用では、TgWitnessの証明はSLSA v1レベル3モデルを参照しています。これは、GitHub Actionsのインフラストラクチャによって署名されたビルドの来歴であり、特定のコミットハッシュおよびワークフローの実行に紐付けられています。この証明は、収集に関与した個々の主体を信頼することなく、独立して検証することが可能です。これにより、信頼に関する仮定がすべて取り除かれるわけではありませんが、どの仮定が残っているか、そしてそれらが具体的にどのようなものかを正確に記録しています。 **専門家証人と金銭的インセンティブについて** 紛争の当事者の一方を代理する弁護士が、同じ訴訟手続きにおいて中立的な第三者の専門家としても振る舞い、その報酬が依頼人の勝敗に左右される――これは構造的な矛盾である。我々は特定の個人を非難しているわけではない。我々が問いたいのは、なぜこのような構造が容認されているのか、そしてなぜそれがほとんど検証されないのか、ということである。 よくある反論は、「*嘘をついた場合、彼らにはどれほどのコストがかかるのか」*というものです。データ消去権や「忘れられる権利」が認められている法域では、専門家の偽証を追及するための実質的なコストは、多くの場合、ごくわずかです。専門家の結論が誤っているとの懸念を表明した人に対しては、その懸念を止めるよう求める法的通知が届く傾向があります。この手続きは、懸念を表明した人にとっては費用がかかりますが、専門家にとってはそうではありません。 すべての専門家証人が不誠実だと言っているわけではありません。「嘘をつくには代償が大きすぎる」というのは、証明の基準ではなく、信頼の基準であるということです。そして、信頼とは弱点なのです。 TgWitnessの認証に異議を申し立てようとする者は、暗号署名を破り、GitHubの署名インフラストラクチャを説得して、実行したことのない内容を遡及的に認証させ、かつ不変のコミット履歴に対して――しかも証人の立ち会いのもとで――それを実行しなければならない。もしそのような能力が存在し、単にPDFソフトウェアの操作が難しいため隠されていただけであるならば、その実証を心から歓迎する。 私たちは、自社のツールが優れていると主張しているわけではありません。当社には商用製品はなく、その開発にも関心はありません。私たちが注目したのは、フォレンジックソフトウェアの出力が「歴史的真実」そのものであり、専門家の「見解」が「証拠」に等しいという、広く浸透している前提です。この前提は、それが最も重要となる法廷の審理において、技術的なレベルで疑問視されることはほとんどありません。この実験は、制御されたデータポイントの一つに過ぎません。数学には、肩書きに対する偏見などありません。 ## 資料をダウンロードする 動画とZIPファイルは[phishdestroy.io](https://phishdestroy.io/)で公開されています。確認したいファイルを選択してください。どちらのZIPファイルにも、選択されたテストデータとドキュメントが含まれています。変更ツール、ソースコード、設定、認証情報、およびセッションは含まれていません。 ### エクスポート前/エクスポート後 7つのテスト用会話データ:HTML、JSON、埋め込み画像、および標準ビューアのアセット。ファイルマニフェストと、選択された変更台帳が含まれています。 [エクスポートのテスト · ZIP · 3.0 MB ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-paired-files.zip) 動画なし。編集ツールなし。 ### 動画+テスト用エクスポート オリジナルの完全な録音データ、2分間の動画、ペアでエクスポートされたファイル、説明、メタデータの確認、編集マップ、およびチェックサム。 [動画+テスト用エクスポートファイル · ZIP · 46.9 MB ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-review-package.zip) より小さなZIPファイルが含まれています。修正ツールは含まれていません。 **46.9 MBのZIPファイルには、具体的に何が含まれているのでしょうか?** - `video/ExportClinic_2026-11-03_12-50-40.mkv` — 未編集の完全版録音、6分08.8秒。 - `video/export-clinic-2min.mp4` — 短縮版映像、1分59.7秒。 - `data/export-clinic-paired-files.zip` — このネストされたZIPファイルを解凍して、 `before/` および `modified/` フォルダを確認してください。 - `description/article-en.md` — 説明と制限。 - `verification/` — 地図の編集、メタデータの確認、パッケージのレビューに関する4つのJSON/Markdownファイル。 - `README.md` および `SHA256SUMS.txt` — 実行手順やファイルのチェックサムの確認。 外側のZIPファイルには10個のファイルが含まれています。元のMKVファイルにはすでに録画全体が含まれているため、個別のフルMP4ファイルは省略されています。各エクスポートされたチャット内の標準的な `js/script.js` エクスポートされた各チャット内には、Telegramの未変更のHTMLビューア資産が含まれています。 ### 個々の動画ファイル - [オリジナルMKV · 6:08.8 · 29.6 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) — ソース映像とバイト単位で同一の記録。 - [MP4ファイルを開く · 6:08.8 · 29.9 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-full.mp4) — 動画の再エンコードを行わず、ブラウザで再生しやすい形式に変換したものです。 - [圧縮されたMP4を開く · 1:59.7 · 14.3 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) — 再生速度の変更箇所にはラベルが付いています。 [チェックサムのダウンロード](https://phishdestroy.io/tgwitness/assets/export-clinic/SHA256SUMS.txt)[動画編集マップ](https://phishdestroy.io/tgwitness/assets/export-clinic/recording-manifest.json?v=42fbcde007f1)[ペアファイルのマニフェスト](https://phishdestroy.io/tgwitness/assets/export-clinic/review-file-manifest.json?v=c725b2ecbe50)[メタデータの確認](https://phishdestroy.io/tgwitness/assets/export-clinic/original-metadata-notes.md)[最新の説明および検証ガイド](https://phishdestroy.io/tgwitness/assets/export-clinic/article-en.md) ダウンロード可能なレビュー用ZIPファイルには、元のREADMEファイルと記事がそのまま含まれています。現在の説明には、TgWitnessの収集および検証ガイドが含まれています。 **「変更前」の状態の構築方法:**これは、変更前のフォルダ構造を再構築したものです。変更されたファイルは、保存されていたバックアップからバイト単位で復元され、記録されていたハッシュ値と照合されました。変更されていないビューア用アセットは、キャプチャされたエクスポートデータからコピーされました。ファイルマニフェストには、提供されたバージョンが記載されています。 7件の会話全体で、45件のメッセージ記録があり、そのうち17件の記録と32個のファイルが異なっています。各バージョンには340個のファイルが含まれています。記録されたエクスポートデータではPDF添付ファイルは選択されていなかったため、これらのアーカイブには含まれていません。 ## 実験の詳細 **どこで変更が行われたのですか?** あるローカルのヘルパーが、Telegram Desktopによって書き出されたファイルを変更しました。公式クライアントの実行ファイルや、Telegram上で表示される会話の内容には変更はありませんでした。比較結果では、変更前のメッセージと、変更後のエクスポートデータが並べて表示されています。 **これらはアカウントデータの完全なエクスポートですか?** いいえ。この資料には、当社が保有する7つのテスト会話(個人的なチャット、ボット、非公開グループ、非公開および公開のスーパーグループ、非公開および公開のチャンネル)が収録されています。これには45件のメッセージ記録が含まれています。これとは無関係のチャット、連絡先、アカウント全体のアーカイブは含まれていません。 **PDFの添付ファイルは含まれていますか?** いいえ。記録されたエクスポート設定では、ファイルの添付は除外されていました。テストメッセージや画像にはPDFについて言及されていますが、これらのアーカイブにはそのPDFは含まれていません。この区別は、ファイルおよび説明文にも反映されています。 **このパッケージには改造ツールは含まれていますか?** 実行ファイル、ヘルパーソース、変換設定、セッションデータ、認証情報、および完全な動作ログは一切含まれていません。ペアになったエクスポートファイル内にある小さなJavaScriptファイルは、Telegramの変更されていない標準のHTMLビューア資産であり、両バージョンで同一であることが確認されています。 **ダウンロードしたファイルを確認するにはどうすればよいですか?** 各ファイルのSHA-256を算出し、公開されているチェックサムと比較してください。値が一致すれば、公開されているバイトデータが取得できていることが確認できます。ファイルマニフェストには両方のエクスポートバージョンが記載されており、ビデオ編集マップには短縮版映画の内容が記載されています。録画時間はホストのクロックに基づいています。 **TgWitnessは、どのようにして記録の検証を可能にしているのでしょうか?** コレクターは、Telegramからデータを受信する際にエントリに署名を行います。アーカイブには、ジャーナル、ファイルのハッシュ、および検証データが含まれます。キーのフィンガープリントとチェックポイントを別々に保存し、受信者のコピーをそれらと照合して確認してください。GitHubキャプチャでは、承認済みの収集ワークフローとその出力結果の検証が行われます。[検証手順に従ってください ↗](https://phishdestroy.io/tgwitness/ja/docs/exports/) この実験のために、7つの会話が用意されました。録音データ、ペア化されたエクスポートデータ、および変更台帳には、前述のローカルファイルの変更内容が記録されています。 対照群を用いたローカルファイル実験 · 2026年11月3日 SHA-256の完全なハッシュ値がコピーされました --- # 56 329メッセージ。 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/validation/ 2回の測定実行で56,329件のTelegramメッセージをエクスポートしました。メッセージ数、収集速度、エクスポート時間、および署名付きアーカイブを比較してください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) TGWITNESS / 実際の輸出実績 取得済み。エクスポート済み。 Telegramのエクスポートデータ2件。収集からアーカイブ完成までの所要時間を記載しています。ワークスペースを確認し、数値を精査して、サンプルをダウンロードしてください。 [デモを体験する](https://phishdestroy.github.io/TgWitness/demo/?lang=en)[エクスポートのサンプルをダウンロード](https://phishdestroy.github.io/TgWitness/demo/downloads/tgwitness-demo.zip) インタラクティブなデモとサンプルでは、架空のメッセージが使用されています。以下の測定値は、実際のエクスポート実行から得られたものです。 TGW / 001 記録されたスナップショット・ライブ監視ではありません 確認日時: 2026-11-06 18:37:38 UTC 検証済みの改訂版 [92e539af](https://github.com/phishdestroy/TgWitness/commit/92e539af40d8368d198ff5e040f1d876f2c1310e) テキスト+メタデータ・署名付きアーカイブ **56 329**エクスポートされたメッセージ **160.531**メッセージ/秒 · 最高のコレクションラン **2**署名付きエクスポート実行 **3**検査対象のサーバー サーバー AWARP · 2 アカウント **27 030**エクスポートされたメッセージ **142.983**メッセージ数/秒 店頭受け取りのみ 189.043 s エクスポートを完了する 211.647 s サーバー BWARP · 2 アカウント **29 299**エクスポートされたメッセージ **160.531**メッセージ数/秒 店頭受け取りのみ 182.513 s エクスポートを完了する 206.650 s 01 / ## 実際の輸出額に基づいて測定された。 サーバーごとに1件の新規エクスポートを行い、各サーバーで2つのアカウントを使用します。テキストとメタデータはWARP経由で送信し、添付ファイルは除外します。 メッセージ数/秒 サーバー A**142.983 メッセージ数/秒** サーバー B**160.531 メッセージ数/秒** サーバー C 測定されていない — メッセージ ÷ 収集時間。準備、選別、梱包はこの時間枠には含まれません。 メッセージ数 ÷ 準備や梱包を含む、測定された総輸出所要時間。 サーバーCの収集ベンチマーク受領書がありません。 どちらの実行でも、再利用されたレコードや重複するIDは確認されませんでした。サーバーAでは、バックグラウンドで保護されたソースの読み取りも実行されていました。FloodWaitによる一時停止は適切に処理されました:A・4回、B・3回。 **正確な測定値とアーカイブのハッシュ値** | サーバー | メッセージ | 店頭受け取りのみ | エクスポートを完了する | | --- | --- | --- | --- | | サーバー A | 27 030 | 189.043 s **142.983 メッセージ数/秒** | 211.647 s **127.713 メッセージ数/秒** | | 2026-11-06T18:26:51.500Z → 2026-11-06T18:30:23.228Z SHA-256 `20e507fc68446680ed002fd486d0968a944ec0c71e02f937331ae2b19ab4cd66` | | | | | サーバー B | 29 299 | 182.513 s **160.531 メッセージ数/秒** | 206.650 s **141.781 メッセージ数/秒** | | 2026-11-06T18:25:40.419Z → 2026-11-06T18:29:07.173Z SHA-256 `824601b502762efaabb8ff9afdb1e8d7fff189862ef2cbc4d8d26d0d68c83e4c` | | | | 両方のアーカイブは、固定されたコレクターキーを使用して検証に合格しました。 02 / ## 3つすべてについて、その範囲が明確に示されています。 すべてのサーバーにおいて、ジャーナルの整合性、ファイルのアクセス権限、ストレージ、ネットワーク経路、および実行中のプロセスが点検されました。 A 検査済み ### サーバー A 収集とエクスポート 8 vCPU · 16 GiB · Ubuntu 24.04 確認済みのジャーナル 21 ジャーナルのイベント 4 517 チェックポイント 147 新しいコレクションのベンチマーク、アーカイブの検証、およびバックアップの整合性チェック。 B 検査済み ### サーバー B 収集とエクスポート 8 vCPU · 16 GiB · Ubuntu 24.04 確認済みのジャーナル 21 ジャーナルのイベント 1 993 チェックポイント 147 新しいコレクションのベンチマーク、アーカイブの検証、およびバックアップの整合性チェック。 C 検査済み ### サーバー C パネルとネストされたVM 8 vCPU · 32 GiB · Ubuntu 24.04 確認済みのジャーナル 14 ジャーナルのイベント 7 185 チェックポイント 973 パネルの認証、ループバックバインディング、およびネストされたVMの検査を実施しました。このサーバーではコレクションのベンチマークは実施していません。 **試験結果、範囲および技術的注記** 03 / ## パスとギャップが並んでいる。 pytestの各テストケースごとの最新の結果(再実行分を含む)。スタンドアロンのブラウザおよびエビデンススイートについては、以下で個別に集計されており、pytestの合計には加算されていません。 **1 585**合格 **3**失敗しました **37**スキップしました 3つのキャプチャブラウザテストにはChromiumのサンドボックスが必要ですが、これらのコンテナではそれが提供されていないため、サンドボックスは有効なままとなります。37件のプラットフォームスキップは、合格件数とは別にカウントされます。 - ブラウザスイート**102 可決された** - インターフェーススイート**66 可決された** - 証拠一式**15 可決された** - ウェブサイト・スイート**9 可決された** - その他のスイートルーム**13 可決された** 04 / ## 本スナップショットの範囲。 1. 01 ### ブラウザのサンドボックス 3つのブラウザチェックは、Chromiumサンドボックスが導入された環境を待っています。 2. 02 ### バックアップの更新日 42のバックアップジャーナルと51,285個のファイルが整合性チェックに合格しました。スナップショット時点では、最新のバックアップはライブ収集より3,507イベント遅れていました。 3. 03 ### ネットワークのカバー範囲 40のルートのうち24が条件を満たしました。残りの16のアカウントは、直接接続に切り替わるのではなく、接続が切断されたままでした。 4. 04 ### 自由時間 保存されていた証人ジャーナルは整合性チェックに合格しました。その最後のイベントは、11月6日 07:27(UTC)に発生しました。 5. 05 ### セキュリティ対策 セキュリティモデルには、鍵の保護、アカウントの保護、耐久性のあるストレージ、およびアクセス制御について記載されています。本監査で明らかになった課題は、署名済みの報告書に記載されています。 6. 06 ### 検査済みのサーバー このページでは、調査対象となった3台のサーバーについて取り上げます。 7. 07 ### 測定された作業負荷 2つの公開ソース、2回の個別実行、添付ファイルのダウンロードを含まないテキストおよびメタデータ。サーバーCは、収集レートの測定を行わずに実行されました。各数値は、それぞれ記録されたワークロードに適用されます。 05 / ## 古い記録で、その数字にさかのぼることができる。 メンテナンス担当者による測定結果で、監査用鍵で署名されています。JSONには集計データのみが含まれています。ソースおよびアカウントの識別情報、メッセージの内容、認証情報、および非公開アーカイブは公開されていません。 1. ソースのリビジョンを固定し、インストールされたリリースを確認してください。 2. 再利用されたレコードを一切含めない状態で、新しいワークスペースに集約します。 3. 測定値の収集間隔と完全エクスポート間隔を別々に設定してください。 4. アーカイブを固定鍵と照合して検証し、そのSHA-256ダイジェストを保持する。 テスト済みリリース `92e539af40d8-83e41104669e` [データをダウンロードする ↓](https://phishdestroy.io/tgwitness/validation/snapshot.json) SIGNED AUDIT / ENGLISH ### Check the numbers. The English report includes the measured results, open findings and a reproducible signature check. [Read the report ↗](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md)[Signed statement ↓](https://phishdestroy.io/tgwitness/validation/audit/PROOF.json)[Measurements CSV ↓](https://phishdestroy.github.io/TgWitness/validation/audit/MEASUREMENTS.csv)[Python verifier ↓](https://phishdestroy.github.io/TgWitness/validation/audit/VERIFY.py)[File checksums ↓](https://phishdestroy.io/tgwitness/validation/audit/SHA256SUMS.txt) The signature binds the report and its measurements to the audit key; a change to any signed file fails VERIFY.py. The report records the completed audit at 19:08 UTC; the infrastructure snapshot above was taken earlier. **領収書の要約** これらのハッシュ値は、測定結果の署名付き受領証のうち保存されているものを識別するものです。非公開の原本は、管理者が保管しています。 - benchmark-1.json`66cdf2db25901ee1f780a0e2d14b9b84888dbe525bff73bae19819b217f95d0c` - benchmark-2.json`ad2978fe2a7563476da43293eaaf5f498ee12522f0ea3e401bc43205c64874d1` - test-totals.json`922cf87d9320b149f2fc6791fc05f98335ec0952f9258e6eaeff179aeef33bb1` - infra-summary.json`325d390ef752b15f44203f97348863e24f0f631fe88998d5e1f398a5311a9339` 各図には、改訂版、作業負荷、および環境が明記されています。測定が行われていない項目は「データなし」と表示されます。 --- # TgWitness: Telegram Export, OSINT & Verification Canonical page: https://phishdestroy.io/tgwitness/docs/reference/overview/ Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads with their methods and revisions. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/llms.txt) 1つのコマンドでインストールするか、GitHub Actionsでキャプチャしてください。調査オプション、公開されている規模、およびアーカイブが何を検証するのかを理解してください。 TgWitnessは、オープンソースのTelegramエクスポートツールおよび調査ワークスペースです。1つのコマンドで インストールし、アカウントを連携させ、チャットを選択して、署名付き アーカイブをエクスポートします。また、GitHub Actionsでの一時的なデータ収集や、保存された編集履歴、削除記録の監視、検索、レポート機能を活用した継続的な 調査にも対応しています。 ## 手元にあるタスクから始めてください | あなたのタスク | 最短経路 | 納品内容 | | --- | --- | --- | | 会話またはアカウントを保存する | インストール、アカウントの連携、エクスポート範囲の選択 | 選択された履歴、収集結果、および検証資料を含む署名付きアーカイブ | | 一時的なランナーで収集する | GitHub Actions を使用してキャプチャを行い、新しいセッションの認証を行い、スコープを選択してください | GitHubワークフローの来歴が記録された暗号化アーカイブ | | 経時的な変更を追跡する | 選択したチャットに対して監視を継続する | 保存されたバージョン、削除通知、添付ファイル、および記録されたカバレッジ | | 調査を行い、その結果を共有する | アーカイブを検索し、ケースボードを使用し、レポートや共有用コピーを設定してください | 出典が明記された調査結果と、受信者に適した検証可能な引き継ぎ | ### 1つのコマンドでインストール インストーラーには、Python および依存関係が含まれています。ソースコードのチェックアウト、Docker、AI プロバイダー、および独立したウィットネスはオプションであり、セットアップの前提条件ではありません。 Linux / macOS: ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` Windows(PowerShell またはコマンドプロンプト): ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` パネルを開き、Telegramアカウントを連携させ、収集範囲を選択してください。 インストールだけでは収集は開始されません。[インストールガイド](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/) では、ローカルアクセス、サーバー、更新、およびダウンロードしたビルドの確認について説明しています。 一時的なランナーを使用する場合は、[GitHub Actionsのキャプチャ手順](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)に従ってください。この ワークフローには、GitHubのフォーク、認証、およびアーカイブのパスワードが必要です。キャプチャ ページでは、これらの手順と、実行前のセッション時間制限について説明しています。生成された アーカイブとその検証用資料をダウンロードし、保管してください。 ## タスクに応じて追加の設定が必要になる場合があります 単一のチャットをエクスポートするには、アカウントと選択した範囲が必要です。継続的な監視、 複数のアカウント、プロキシ、添付ファイルポリシー、レポートの設計、レビュー担当者のアクセス権、 外部タイムスタンプ、およびオフサイトストレージは、それぞれ異なる調査および 引き継ぎの要件に対応しています。該当する場合は、これらの機能を設定してください。 適用範囲、権限、および共有コピーの最小化により、オペレーターは何を 収集し、開示するかを選択できます。管轄権に関するガイダンスとレポート設定には、 選択された手順と準備ステップが記録されます。[アカウントのエクスポート](https://phishdestroy.io/tgwitness/ja/docs/reference/account-export/)、[アクセス](https://phishdestroy.io/tgwitness/ja/docs/reference/access/)、および [レポート設定を](https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/)参照してください。 このアプリケーションは、選択したコンピュータまたはサーバー上で実行されます。基本的な収集には、 GPUやLLMは必要ありません。オプションのOCR、文字起こし、AI分析には、 それぞれ独自のリソース要件があります。メッセージレート、添付ファイル、 保持される履歴、および同時接続アカウント数に応じて、デプロイメントの規模を決定してください。 ## 誰の役に立つにせよ、記録は残しておくべきです その目的は、 どの立場を支持するかにかかわらず、観察された資料、文脈、および変更点を保存することにあります。証拠は、収集者自身の 出来事に関する説明に異を唱える場合もあります。他の人が同じ資料を評価できるよう、 元の観察内容、網羅されていない部分、および分析上の結論が 識別できるようにしてください。 そのロジックは、アカウント上で可視化された観測 → 署名付きジャーナル → エクスポート → 受信者による 検証、という流れです。保存された編集によりバージョンが追加されます。削除された観測については、以前に キャプチャされた内容が保持されます。カバレッジ記録は、既知の中断を明らかにします。レポートおよび AI 分析は保存されたソースを参照します。解釈は、単に署名付きレポートに表示されたという理由だけで、ソース 観測となるわけではありません。 | 検証チェック | 受信者が確認できること | | --- | --- | | ファイルのハッシュ、署名、およびジャーナルチェーン | 提供されたレコードおよびファイルは、想定されるキーおよびジャーナルの境界と一致しています。 | | 別途保持されるチェックポイントまたはウィットネス | このアーカイブは、以前に保持されていたジャーナルの状態と一致しています | | 検証済みの外部タイムスタンプ | 参照されたバイトは、記載された信頼前提の下で、タイムスタンプ時点において存在していました。 | | GitHub キャプチャの認証 | アーカイブは、承認済みのワークフロー、コレクターのリビジョン、および記録されたダイジェストと一致しています。 | | Intel TDX アテステーション | 引用、プラットフォームの状態、予想されるOS/アプリケーションの測定値、最新性、およびコレクターの識別情報は、設定されたチェックに合格しています。 | 認証済み取得において、承認されたコレクターの認証済みTelegram接続 および出力は、検証済みの実行環境に紐付けられます。アーカイブには キャプチャされたコンテンツとコンテキストが保持され、レポートや分析ではそれらの記録が参照されます。 [信頼ガイド](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md)および[証拠フォーマット](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/)に記載されている、モード固有の検証手順と信頼できる入力を使用してください。 ## 公表されたスケールおよび測定されたパフォーマンス 以下の結果は、異なるワークロードおよび日付に関するものです。カウントは 互換性がないことに注意してください。ジャーナルイベントは、必ずしも一意のTelegramメッセージとは限りません。 | 日付 | 作業量 | 公開された結果 | 測定対象 | | --- | --- | --- | --- | | 1年11月2026日 | サーバーの稼働、10個のワークスペースデータベース | 1,610,818件のログレコード、900,232件の新規メッセージイベント、80,683件の編集イベント、400,536件の削除イベント | 保存されたジャーナルの読み取り専用インベントリ | | 5年11月2026日 | 200のチャットに含まれる1,000,000件以上の合成メッセージを検索 | インデックスの構築に71秒を要し、クエリごとの検索時間の中央値は9~190ミリ秒でした。 | ローカル検索ベンチマーク | | 6年11月2026日 | 2つの最新の実際のTelegramエクスポートデータ | 27,030件および29,299件のメッセージ;両実行を合わせて56,329件 | WARP経由の実行ごとに2つのアカウント(テキストおよびメタデータ)、添付ファイルのダウンロードはなし | | 6年11月2026日 | 準備およびパッケージングを含む、同じ2つのエクスポート | 127.713および141.781メッセージ/秒 | 完全エクスポート率を測定。両方のアーカイブについて、固定鍵を用いて検証済み | [検証記録](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/) には、サーバーのインベントリ、リアルタイムの 収集チェック、および検索測定結果が含まれます。[パフォーマンスのエクスポートには](https://phishdestroy.io/tgwitness/docs/validation/) 、2つの実際の実行結果、ハードウェア、実行時間、アーカイブのハッシュ、および署名付き 測定ファイルが公開され、それぞれに記録されたリビジョンと条件が付与されます。 [パブリック履歴の検証](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md)結果には、 50件のソース入力リストおよび 40のアカウントワークスペースにまたがる、**3,598,381件のレコードを含む48の検証済みアーカイブ**も記録されています。8つのアカウントからなるソースAは、待機時間を含め**1,117.082秒で768,007件の履歴 レコード**を取得しました。**これは1秒あたり687.512レコードに相当し**、 添付ファイルのダウンロードは無効化されていました。 検証を含む試行全体には 1,574.920秒を要しました。これらの測定結果は、上記の 小規模な新規エクスポートの例と併せて、当該ワークロードを説明するものです。 ### テストの履歴と期間 TgWitnessは約6か月間にわたり開発およびテストが行われました。 コレクター、署名付きジャーナル、および検証ツールが最初に開発され、その後、これらを基盤としてウェブパネルとアドオンモジュールが構築されました。このリポジトリは、公開を目的として2026年10月29日に新規に作成され、既存のコードを基に開始されたため、その作成日はプロジェクトの年齢([開発履歴](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history))とは異なります。 累積実行ワークロードは、過去の実行、失敗、修正、および繰り返し検証を含め、1億件規模です。それぞれ独自のリビジョン、方法、結果を持つ選択された実行については、[日付付きの公開測定](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements)結果に記録されています。 ## 機能の状態を正確に読み取る 各ワークフローについて、その実装、公開済みビルド、および記録された テストと照らし合わせて評価してください。ソースは現在「プレビュー」とラベル付けされています。このリリースラベルは、 機能するコレクション、エクスポート、独立した検証、および公開済みのスケーリング 測定値と共存しています。プレビュー機能と検証済みのワークフローが同じ アプリケーション内に共存する場合があります。評価の根拠となる具体的な機能と証拠について記述してください。 [現在の機能](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md)、[特徴、制限](https://phishdestroy.io/tgwitness/ja/docs/reference/features/)、 [検証](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/)、[および変更履歴を](https://phishdestroy.io/tgwitness/ja/docs/reference/changelog/)併せて記載してください。 結果を引用する際は、テスト対象となったリビジョンを明記してください。11月6日の測定 スナップショットには、失敗したテストやスキップされたテストも記録されていますが、これらは「合格」とはみなされません。 ## 人間およびAIツールが読み取れる形式 このウェブサイトでは、簡潔な`llms.txt`、完全な英語版マニュアルである `llms-full.txt`および`llms-full.md`、ならびに各ページのMarkdown版が提供されています。これらは ドキュメント形式であり、TgWitnessを実行するためのAI要件ではありません。 オプションの [MCP](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/) [およびコマンドラインアクセスにより](https://phishdestroy.io/tgwitness/ja/docs/reference/cli/)、承認されたツールは 選択された保存済みレコードを読み取ることができます。メッセージの内容は、依然として信頼できない入力として扱われます。要約では、 出典を明記し、観察された事実と推論を区別し、不確実性を保持する必要があります。 全文検索、OCR、および AI 出力は、元の署名付き観察結果を変更することはありません。 --- # Telegram · クイックスタート Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/quickstart/ TgWitnessのインストールおよび起動方法のすべて:Windowsパッケージ、Python、Docker、および初期チェックを含む統合デモ。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) TgWitnessのインストールおよび起動方法のすべて:Windowsパッケージ、Python、Docker、および初期チェックを含む統合デモ。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![はじめに](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) **英語** · [Русский](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/QUICKSTART.md) · [ウクライナ語](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/QUICKSTART.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/QUICKSTART.md) · [ポルトガル語(ブラジル)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/QUICKSTART.md) · [Türkçe](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/QUICKSTART.md) · [アラビア語](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/QUICKSTART.md) · [فارسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/QUICKSTART.md) · [ウルドゥー語](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/QUICKSTART.md) · [ヒンディー語](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/QUICKSTART.md) · [インドネシア語](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/QUICKSTART.md) · [Tiếng Việt](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/QUICKSTART.md) · [簡体字中国語](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/QUICKSTART.md) TgWitnessは、ご自身のアカウントがアクセス可能なTelegramのグループやチャンネルを監視するためのスタンドアロン型アプリケーションです。 独自のデータディレクトリを使用して、ローカル上で動作します。 **初めてのご利用ですか?**アカウントを連携する前に、[デモをご覧ください](https://phishdestroy.io/tgwitness/ja/docs/reference/quickstart/#explore-the-interface)。 プロキシ、ウィットネス、エクスポート、またはサーバー設定に関する[ガイドをお選びください](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)。 [GitHub Actions キャプチャ(プレビュー)は、](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)ローカルインストールではなく、ご自身の GitHub フォーク上でキャプチャを実行します。 ## インストールと起動 ガイド付きインストーラーには独自のPythonが含まれており、インストール前にパッケージのハッシュ値とリリース 署名を検証します。再度実行すると、既存のインストールが更新されます。 **Linux / macOS:** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` **Windows(PowerShell または コマンドプロンプト):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Ubuntuサーバーでは、root権限で実行してバックグラウンドサービスをインストールしてください。デスクトップでは、 通常のユーザーとして実行してください。Ubuntuでは、インストーラーがパネルのアドレスとアクセスキーを表示します。 macOSおよびWindowsでは、ブラウザでローカルパネルが開きます。以下の「**Telegramに接続**」の項目に進んでください。 「[インストール、検証、および更新](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/)」では、サーバーへのアクセス方法、 実行前のスクリプトの確認、更新、および削除について説明しています。 ### その他のメソッド GitHubのリリース、ソースコード、およびDockerは、インストーラーの代替手段となります。ポータブル 版は、リリースビルドが公開された後にダウンロード可能になります: | ホスト | インストールは不要です | 出典:Python 3.11 以上 | Docker:Engine/Desktop(Compose 2.20 以降) | | --- | --- | --- | --- | | Windows | GitHub Releases から「`TgWitness--windows-amd64-portable.zip`」を抽出し、「`TgWitness.cmd`」をダブルクリックしてください。 | `Start.cmd` をダブルクリックしてください | `scripts\Docker.cmd` をダブルクリックしてください | | Linux / macOS | — | `sh start.sh` | `sh scripts/docker-start.sh` | ソースコードからの実行方法については、[現在の `main` をダウンロードして展開する](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip)か、リポジトリをクローンしてください: ``` git clone https://github.com/phishdestroy/TgWitness.git cd TgWitness ``` `Start.cmd` は、適切な Python が見つからない場合、現在の Windows ユーザー向けに Python 3.12 のインストール(winget、または署名済みの python.org インストーラー経由)を提案します。`start.sh` は、Python が不足している場合、お使いの Linux ディストリビューションまたは macOS 向けの正確なインストールコマンドを表示します。ソースからの初回起動時には、`.venv` が作成され、依存関係が自動的にインストールされます。 Dockerがアプリケーションをビルドし、バックグラウンドで起動します。ホスト側のPythonは 不要です。`scripts\Docker.cmd`および`scripts/docker-start.sh`は、 コンテナが正常に動作している際に、パネルアドレスとトークンを表示します。サポートされているすべてのホストにおける対応するDockerコマンドは以下の通りです: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` **http://127.0.0.1:8787** を開いてください。Docker ヘルパーまたは 2 番目の Docker コマンドによって出力されたトークンを使用するか、ポータブル版またはソースからのインストールの場合は **data/live/panel-token.txt を**参照してください。以下の 「**Telegram を接続**」に進んでください。 ネイティブインストールとDockerインストールでは、それぞれ別々のストレージを使用します。 Dockerを起動しても、既存のネイティブジャーナルはインポートされません。 サーバーの[デプロイメント](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/)には、HTTPSの自動設定、再起動、 公開画像、アップデート、およびバックアップが含まれます。 ## インターフェースをご覧ください 1. ポータブルパッケージ内の**「TgWitness-Demo.cmd** 」、Windowsのソース フォルダ内の「**scripts\Demo.cmd** 」、またはLinux/macOS上の「`sh start.sh --demo` 」を実行してください。ソースから起動すると、まず「`.venv` 」が作成され、依存関係がインストールされます。 2. **http://127.0.0.1:8787** を開いてください。 3. ローカルデモでは、サンプルジャーナルが自動的に開かれます。ローカルから直接アクセスする場合、トークンのコピーは必要ありません。 デモ用のメッセージは架空のものです。デモモードでは、実際のTelegramアカウントに接続することはできません。 ## Telegramに接続する > [!警告] **専用のアカウントを使用してください。**Telegramは、クライアントの種類にかかわらず、 過剰と判断したリクエスト量に対してアカウントを制限または永久停止する可能性があります。個人用や重要なアカウントではなく、 観測用に用意したアカウントを接続し、専用のアカウント上でAPI ID / ハッシュを 作成してください。 1. ネイティブのデモが実行中の場合は、それを停止し、**Start.cmd** または `sh start.sh` を実行してください。 そうでない場合は、上記で起動したライブインストールをそのまま実行し続けてください。 2. パネルトークンを使用してサインインしてください。[初回セットアップ](https://phishdestroy.io/tgwitness/ja/docs/reference/settings/)時に新しいワークスペースが開きます。 「**ダウンロードのみ」**、「**チャットをフォロー」**、または**「事件の証拠」**のいずれかを選択してください。 3. 接続チェックを確認してください。必要に応じて独自のプロキシを設定してください。接続 設定はセットアップ後も利用可能です。 4. **Connect Telegram** で、電話番号、QR コード、アカウントファイル(TData、 `.session`、StringSession、アカウントJSON)または完全な認証キーを選択してください。要求されたら、Telegramの確認、コード、および2段階認証のパスワードを入力してください。 5. 表示されたアカウントを確認し、チャットを選択して設定内容を確認してください。最終画面から 操作を完了してください。**「Just download」**の場合、**「Start export」**を選択すると、1回限りの エクスポートが開始され、進行状況を確認するために「Exports」画面が開きます。継続的な監視機能は有効になりません。 セットアップ後、「**Chats → Choose」**で選択中のチャットを変更できます。**「Settings」**では コレクションとファイルを管理します。**「More tools → Sources」**では、詳細なソースリストを 「Standard」または「Expert」レベルで表示します。[パネルガイドでは、](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/)6つの主要な セクションとそのコンテキストに応じた操作方法について説明しています。 **API ID + ハッシュは**任意です。ワークスペースは、保存またはインポートされたペア、 あるいは組み込みプール内の有効なペアを使用します。独自のアプリを使用する場合は、 `API ID:API Hash` ペアを貼り付けてください。「**Authキー**」には、512文字の16進数 文字列をすべて貼り付け、提供されたDC IDを選択してください。「ユーザーID」は任意であり、入力された場合はチェックされます。 API認証情報はアプリケーションを識別するものであり、それ自体ではアカウントへのアクセス権を付与するものではありません。 非公開グループでは公開ユーザー名は必要ありませんが、アカウントにはアクセス権が必要です。 既存のアカウントについては、「[アカウントとセッション形式](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/)」を参照してください。 このパネルでは、Telethon StringSession、Telethon/Pyrogram SQLite、単一アカウントの TData ZIP、およびサポートされているアカウント JSON に対応しています。セッションとその対応する JSON を一緒に選択し、 **「ファイルを確認」**を押してから、**「アカウントに接続**」を押してください。QR ログインも、 同じオプションの API 設定で利用可能です。 TDLib、ボットセッション、およびCSV/JSON形式の アカウント一覧はサポートされていません。 複数のアカウントを扱う場合は、**アカウント → アカウントのインポート**を使用し、サポートされているセッションファイルを選択してください。付随する JSON ファイルはベース名(拡張子を除いたファイル名)でペアリングされ、インポートされた各アカウントには専用のワークスペースが割り当てられます。[一括インポートとアカウントグループ](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#bulk-import-and-account-groups)を参照してください。 別のアカウントを追加するには、アカウント選択ボタンの横にある**「+」**を押すか、 **[アカウント] → [アカウントを追加]** を使用してください。ワークスペースごとに、 セッション、ジャーナル、キー、ソース、キューが個別に管理されます。ビューを切り替えても、他のコレクターは実行されたままになります。 このインストール環境では、同じ Telegram アカウントを 2 つのワークスペースに割り当てることはできません。 ワークスペースの数に制限はありません。ワークスペースは 1 つのプロセスを共有するため、収容能力はマシンの性能に依存します。 ライブパネルトークンは、Telegramの認証情報および保存された データへのアクセスを保護するものであり、Telegram APIの認証情報とは別物です。明示的に起動され、 直接アクセスされたローカルデモのみが自動的に登録されます。リモートまたはプロキシ経由のデモでは、引き続き `data/demo/panel-token.txt`が使用されます。 ## 確認とエクスポート - **ジャーナル:**情報源やイベントの種類ごとに記録を検索・フィルタリングできます。 - イベントを選択すると、その元の記録、出典、および保存されたバージョンを確認できます。 - 編集の詳細には、変更前後の利用可能なコンテンツが表示されます。削除の詳細には、 最後にキャプチャされたコンテンツ(存在する場合)が表示されます。身元不明の行為者は、引き続き不明のままとなります。 - **エクスポート形式:**署名付きZIP、JSONL、CSV、およびオフライン用HTML。 - **チャットの完全エクスポート**(**「チャット」→「チャットをエクスポート」**、または**「エクスポート」→「1つのチャットをキャプチャまたはエクスポート」**):1つのチャットの表示可能な 履歴全体を、`chat.json`(Telegramエクスポート形式)と読み取り可能な `chat.html`を含む署名付きバンドルとしてダウンロードします。プライベートチャットは、そのアカウントがメンバーである場合に機能します。これは現在の スナップショットであり、削除されたメッセージや以前に編集されたメッセージの再構築ではありません。 `python verify.py chat-export.zip --fingerprint TRUSTED_SHA256` を使用してコピーを検証してください。 - **チェックポイントの保存:**署名付きジャーナルの境界をコレクターの外側に保持してください。 - **署名付き実行レシートをダウンロード:**コレクターのプログラムおよびバージョンの記録を保存します。 - **タイムスタンプのリクエストの準備:**タイムスタンプ認証機関へのオフラインリクエストを準備します。 [TIMESTAMP.](https://phishdestroy.io/tgwitness/ja/docs/reference/timestamp/)mdの手順に従って、応答を取得し、検証してください。 - **ジャーナルの検証:**イベントの署名とチェーンリンクを確認してください。ZIP形式でのエクスポートでは、メディアファイルもチェックされます。 対応しているブラウザでは、大容量のエクスポートデータを指定したファイルに直接保存できます。その他のブラウザでは、 最大 128 MiB までバッファリングされます。サーバーが稼働している間、ストリーミング CLI を使用すれば、 レスポンス全体をバッファリングすることなく、より大容量のダウンロードが可能です: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` 別のワークスペースを使用する場合は、**「Exports」→「Workspace ID」**から`--profile ID`を追加してください。 リモートサーバーを使用する場合は、`--url https://your-server`を追加してください。デフォルトの転送制限は 5 GiBです。`--max-mib`で変更できます。 署名付きZIPコンテンツには、デフォルトで4 GiBの 非圧縮検証制限が別途設定されています(**「その他のツール」→「パラメータ」**で上限を引き上げることができます。このようなアーカイブの検証には `verify.py --max-gib N` を使用してください)。検証には、信頼できる検証ツールのコピー、 独立して保持されている鍵のフィンガープリント、および証拠としての最低限の要件として、タイムスタンプ 認証機関のルート証明書(`--tsa-ca`)を使用してください。 ## インストール方法をご確認ください ``` python start.py --setup-only python start.py --check python start.py --check --json ``` `--check`は、ローカルの依存関係、署名機能のサポート状況、ストレージ、鍵の設定、および リスニングアドレスを調査します。何もインストールせず、Telegramにも接続しません。ポートが 使用中の場合は、別のインスタンスが実行されている可能性があります。別の`--port`を使用するか、まずそれを停止してください。 ランチャーは`.venv`にインストールされます。補助的な`python -m tgwitness...`コマンドは、 その環境がすでに有効化されていない限り、Windowsでは`.venv\Scripts\python.exe`を、Linux/macOSでは`.venv/bin/python`を 使用する必要があります。 ## セッション、保護、および運用 閉じた一貫性のあるTelethon SQLite `.session`は、 `python -m tgwitness.sessions account.session --out account.tgwitness-session` を使用してローカルで変換し、その後 「**その他のツール」→「アカウント」→「ファイル**」で読み込むことができます。ファイルの直接インポートやQRコードによるログインも利用可能です。ログイン形式、SOCKS5、 HTTP CONNECT、MTProxy、および外部マスターキーについては [、CONNECTION-SECURITY.mdを](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/)参照してください。 **「一時停止」を選択すると、**収集が停止します。**「ロック」を選択**しても、ブラウザへのアクセスが遮断されるだけです。 タブを閉じても、収集プロセスは実行されたままになります。プロセスを停止すると収集が中断されますが、 履歴のスナップショットでは、見逃された編集や削除のすべてを復元することはできません。 イベントポリシー、添付ファイルのキュー、 アカウントの隔離、および再起動時の動作について、[収集の仕組み](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/)をご確認ください。 セッションとシークレットは暗号化されています。メッセージの内容、メディア、およびエクスポートには、 暗号化されたディスクまたはボリュームが必要です。信頼できる鍵を用いてジャーナルの署名を検証し、チェックポイントを別途保持してください。 選択した収集モードについて、キャプチャ記録、外部タイムレシート、および環境認証情報を 確認してください。 バックアップ/復元については [OPERATIONS.md](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/)、ホスティングについては [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/)、 サービスの例については [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) をご参照ください。インストールされた パネルには、`/guide.html` にオフライン設定ガイドも含まれています。 実際の検証状況および残された課題については、 [VERIFICATION.md](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/) および [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md) に記載されています。 --- # インストール、検証、および更新 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/installation/ 1つのコマンドでインストール、署名とハッシュの確認、更新、およびアンインストールが可能です。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 1つのコマンドでインストール、署名とハッシュの確認、更新、およびアンインストールが可能です。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [はじめに](https://phishdestroy.io/tgwitness/ja/docs/reference/quickstart/) ![はじめに](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [プロジェクト](https://github.com/phishdestroy/TgWitness/blob/main/README.md) · [クイックスタート](https://phishdestroy.io/tgwitness/ja/docs/reference/quickstart/) · [デプロイ](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/) **このページでは** - [1つのコマンドでインストール](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/#install-with-one-command) - [すべてが動作する場所](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/#where-everything-runs) - [全文検索の設定](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/#full-text-search-settings) - [コマンドラインからのアクセス](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/#command-line-access) - [実行前に確認してください](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/#verify-before-running) - [既存のインストールを更新する](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/#update-an-existing-installation) - [Ubuntuでの日常的なコマンド](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/#everyday-commands-on-ubuntu) - [TgWitness を削除](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/#remove-tgwitness) ## 1つのコマンドでインストール 本プロジェクトの公式ダウンロードサービスである`get.destroy.tools`では、ガイド付き インストーラーとその署名付きリリースファイルを提供しています。これにはプライベートなPythonランタイムが含まれており、 インストール前にパッケージのハッシュ値とリリース署名を検証します。各リリースでは エントリスクリプト、ハッシュ値、署名、ビルド情報がまとめて更新され、 各ビルドには不変のリリースURLが割り当てられます。 簡単なセットアップにはガイド付きインストーラーを選択するか、 [GitHubのリリース、ソースコード、またはDocker](https://phishdestroy.io/tgwitness/ja/docs/reference/quickstart/) を使用してください。これらは、同じオープンソースプロジェクトでサポートされているインストール パスです。実行前に 特定のビルドの承認を必要とするデプロイメントの場合は、[「実行前に検証](https://phishdestroy.io/tgwitness/ja/docs/reference/installation/#verify-before-running) 」機能を使用し、独立して保持されたリリースキーのフィンガープリントと、ビルドの不変 URLを活用してください。ダウンロードサービスを更新しても、インストール済みのパネルは自動的に更新されません。 **Linux / macOS (Bash):** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` Ubuntu サーバーでは、root 権限で実行してバックグラウンドサービスをインストールしてください。デスクトップ環境では、 通常のユーザーとして実行してください。 **Windows(PowerShell または コマンドプロンプト):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Windows では管理者権限は必要ありません。PowerShell の子プロセスは、 ターミナルを結果が表示されたまま開いた状態に保ちます。Python および依存関係はインストール先に残ります。 Ubuntu では、**「このコンピュータ**」、「**一時的な HTTPS リンク**」、または「**独自のドメイン**」を選択してください。 インストーラーがパネルのアドレスとアクセスキーを表示します。一時的なリンクを使用する場合は、 その HTTPS アドレスをブラウザで開き、キーを入力してください。リモート サーバーへのローカルアクセスを行う場合は、お使いのコンピュータから SSH フォワードを使用してください(`ssh -L 8787:127.0.0.1:8787 user@server`) を使用して `http://127.0.0.1:8787`。macOSおよびWindowsでは、ローカルパネルが ブラウザで開きます。ターミナルは実行したままにしておいてください。 パネルで Telegram にログインし、収集対象を選択してください。インストールしただけでは Telegram の収集は開始されません。 ## すべてが動作する場所 `get.destroy.tools` は、**静的ファイルのダウンロードを提供する Cloudflare Worker** です。 TgWitnessパネル、Telegram セッション、ユーザー証拠データベースは一切含まれていません。また、 プロジェクト用 VPS にはルーティングされません。アプリケーションは、コマンドを実行したマシン上で動作します。 | インストール | プログラム | データ | | --- | --- | --- | | Ubuntu(root権限) | `/opt/tgwitness` | システムサービス: `/var/lib/tgwitness-`; 正確なパスについては `tgwitness paths` を指定して正確なパスを指定してください。 | | Linux / macOS ユーザー | `~/.local/share/tgwitness` | `data/live` そのインストール環境下で。 | | Windowsユーザー | `%LOCALAPPDATA%\TgWitness` | `data\live` そのインストール環境下で。 | 設定 `TGWITNESS_INSTALL_DIR` を選択して別のフォルダを指定します。インストールされたバージョンとデータは 別々に管理されます。インストーラーは、アカウント、メッセージ、鍵を ダウンロードサイトにアップロードすることはありません。Cloudflareトンネルを選択すると、パネルのトラフィックは Cloudflareを経由して送信されます。独自のドメインを使用する場合は、自身のサーバーを指すように設定します。 `TGWITNESS_TRUSTED_PROXIES`が設定されている場合、パネルは信頼されたプロキシからの単一の`X-Forwarded-Proto: https`を受け入れ、セキュアダウンロードクッキーを設定します。 すべてのインストールには、ローカルの パス、コマンド、リポジトリへのリンクが記載された **START-HERE.html** および **START-HERE.txt** が含まれています。 `tgwitness guide` を実行してガイドを開きます。 Windowsでは、 `& "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide` を使用してください。 ## 全文検索の設定 [全文検索](https://phishdestroy.io/tgwitness/ja/docs/reference/search/)(プレビュー版)は設定が不要です。インデックスは更新後に バックグラウンドで構築されます。 | 変数またはコマンド | 効果 | | --- | --- | | `TGWITNESS_FULLTEXT=disk` | デフォルト:インデックスは各ワークスペースの `search/fulltext.sqlite3` 各ワークスペースの | | `TGWITNESS_FULLTEXT=memory` | インデックスファイルは存在せず、起動のたびにインデックスが再構築されます。 | | `TGWITNESS_FULLTEXT=off` | 索引は作成せず、完全一致検索のみとする | | `tgwitness index status` | すべてのワークスペースの状態をインデックス化 | | `tgwitness stop`, `tgwitness index rebuild`, `tgwitness start` | 署名付きジャーナルからすべてのインデックスを再構築する | 「**ジャーナル**」**→「フィルター」→**「**検索インデックス**」で管理者が選択した設定は、 そのワークスペースの変数を上書きします。コマンドは、それを実行しているインストール環境の データディレクトリを検索します。それ以外の場所では、 `--data-dir` からパスを追加してください `tgwitness paths`. 完全なウクライナ語辞書(GPL-3.0データ)を使用するには、 `pymorphy3-dicts-uk` を インストール先の Python 環境にインストールしてください。 ## コマンドラインからのアクセス [コマンドライン](https://phishdestroy.io/tgwitness/ja/docs/reference/cli/)(プレビュー版)は、スクリプトやエージェントをアーカイブから読み込みます。 | 変数 | 効果 | | --- | --- | | `TGWITNESS_URL` | パネル発表の `tgwitness search`, `context`, `messages`, `stats` および `export`; デフォルト `http://127.0.0.1:8787` が設定されている場合 | | `TGWITNESS_MCP_TOKEN` | アーカイブ接続トークンは、「**その他のツール」→「統合」→「MCP」**から取得し、MCPクライアントと共有されます。`--token-file`を指定すると、代わりにファイルから読み込まれます。 | | `TGWITNESS_DATA` | URLやトークンが指定されていない場合は、データディレクトリから直接読み込む `--data-dir`、URL、またはトークンが指定されていない場合、データディレクトリから直接読み込みます | ## 実行前に確認してください インストーラは、プロジェクトのリリース用公開鍵を埋め込み、アプリケーションパッケージおよび依存関係ロックファイルのSHA-256およびRSA 署名を検証してからインストールを行います。 BashとPowerShellのいずれも、必要な検証に失敗すると処理を停止します。初期スクリプトは HTTPS経由で配信され、独自の分離署名が付与されています。以下のコマンドを使用すれば、 実行前にそのスクリプトの検証を行うことも可能です。 公開リリースキーは [release-signing.pub](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/release-signing.pub) です。 その SHA-256 は以下の通りです: ``` 039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d ``` 信頼できるリポジトリのリビジョンからこのフィンガープリントを保持してください。 同じダウンロードサーバーからのチェックサムにより不一致が検出されます。独立して信頼されている公開鍵が、 リリースの署名を認証するものです。 以下の検証用ダウンロードには、新しい空のディレクトリを使用してください。 **Linux / macOS — 新しい空のダウンロードディレクトリで実行してください**(curl および OpenSSL が必要です): ``` curl -fSLO https://get.destroy.tools/install.sh && curl -fSLO https://get.destroy.tools/install.sh.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh && bash install.sh ``` `&&` ダウンロード、鍵のフィンガープリント、または署名の 検証に失敗した場合、チェーンは実行前に停止します。スクリプトのダウンロードと 署名の検証の間に公開が行われた場合は、両方を再度ダウンロードしてください。古いインストーラーは、不変のパッケージURLを維持します。 **Windows — 実行する前に、SHA-256を確認してください:** ``` Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing Get-FileHash .\install.ps1 -Algorithm SHA256 Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt ``` ハッシュ値を `install.ps1` 行と照合してください。独立した署名検証を行うには、 OpenSSL(例:Git Bashから)と、上記の同じ公開鍵フィンガープリントを使用してください: ``` curl -fSLO https://get.destroy.tools/install.ps1 && curl -fSLO https://get.destroy.tools/install.ps1.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 && powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1 ``` Windows へのインストール時、.NET によってパッケージの署名が検証されるため、 OpenSSL は必要ありません。これらは Authenticode ではなく、分離型 RSA-3072 / SHA-256 署名です。 [マニフェスト](https://get.destroy.tools/manifest.json)には、ソフトウェアのバージョン、 正確な Git コミット、不変のリリース ID、および各アーティファクトの SHA-256 が記録されています。このページには、 対応するソースへのリンクが掲載されています。マニフェストとチェックサム一覧にも、分離型 署名が付いています(`manifest.json.sig` および `SHA256SUMS.txt.sig`). ## 既存のインストールを更新する **新しい公開版がダウンロードサイトを更新します。インストール済みのプログラムは、 インストーラーを再度実行すると更新されます。**無人更新機能や、 実行中のコレクションの自動再起動機能はありません。現在のインストーラーチャネルは**プレビュー版**であり、 公開済みで検証済みのビルドに基づいています。 `main`公開・検証済みのビルドに準拠しており、そのコミットは、直近の 番号付きGitHubリリースよりも新しい場合があります。ページのバージョンは `pyproject.toml`から取得されます。そのコミット およびビルドIDにより、同じプレビューバージョン内での更新が区別されます。 その特定のコミットがアプリケーションおよび セキュリティチェックに合格し、署名付きパッケージがUbuntuおよびWindows上で 認証、インストール、検証された後、公開が自動的に行われます。インストーラを変更するプルリクエストについても、サイトのローカルコピーに対して`install.sh` および`install.ps1`を2回実行します。チェックの実行中、 またはチェックが失敗した場合は、同じコマンドが引き続き、以前に検証済みのビルドをインストールします。 ビルドマニフェストには、現在利用可能なコミットが表示されます。プレビューの更新間では、 バージョン番号のみが同じままの場合があります。 以前と同じインストールフォルダとOSユーザーを使用してください。コレクションを停止した状態で、データ ディレクトリ全体をバックアップしてください。 `tgwitness paths` これを識別します。署名付きエクスポート は、完全なインストールバックアップではありません。 **Ubuntuへのルートインストールは `/opt/tgwitness`:** ``` curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start ``` インストールが正常に完了したら: ``` /opt/tgwitness/bin/tgwitness restart /opt/tgwitness/bin/tgwitness status /opt/tgwitness/bin/tgwitness open ``` Linux/macOSユーザーによるインストールでは、元の `TGWITNESS_INSTALL_DIR` 、または デフォルト設定を使用し、最初のインストールコマンドを再度実行してください。更新を行う前にフォアグラウンドの パネルを閉じ、更新後に再度起動してください。設定済みのLinuxユーザー サービスについては、その `tgwitness restart` コマンドを実行してください。 **Windows:**実行中のパネルを閉じ、Windows インストールコマンドを再度実行し、 その後、 `bin\tgwitness.cmd` 同じインストール環境で起動してください。インストーラーはデータ、 セッション、アクセス設定、署名鍵を保持します。新しい環境がチェックに合格した後にのみ ランチャーが切り替わります。インストールに失敗した場合は、以前の ランチャーがそのまま残ります。ストレージ形式の変更に備えて、アップグレード前のバックアップを保管しておいてください。 ## Ubuntuでの日常的なコマンド | コマンド | 結果 | | --- | --- | | `tgwitness open` | 現在のパネルURLとアクセスキー。 | | `tgwitness paths` | プログラム、データ、およびガイドの正確なパス。 | | `tgwitness guide --print` | オフラインでの操作手順。 | | `tgwitness status` / `tgwitness logs` | 可用性/サービスログ。 | | `tgwitness stop` / `tgwitness start` | サービスの停止/再開;データを保持します。 | | `tgwitness token rotate` | 管理者キーを更新し、ブラウザのセッションを終了してください。 | | `tgwitness tunnel off` | パブリック・クイックトンネルを無効にし、ローカルパネルは維持します。 | | `tgwitness tunnel on` / `tgwitness tunnel restart` | クイックトンネルリンクを作成する/そのアドレスを変更する。 | 同僚用トークン、セッション、IP制限については[「アクセス」](https://phishdestroy.io/tgwitness/ja/docs/reference/access/) を、 GitHubからCloudflareへのリリースワークフローについては「[インストーラーの公開](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/README.md#automatic-publication-from-github) 」を参照してください。 ## TgWitness を削除 アンインストーラーはありません。パネルを停止し、そのフォルダを削除してください。data フォルダを削除すると、ジャーナル、署名鍵、Telegramのセッション、および保存されたファイルが完全に消去されます。 その前に: 1. 必要なデータをエクスポートし(**[エクスポート] → [署名済みZIPをダウンロード]**)、署名鍵の フィンガープリントとチェックポイントは、このマシン以外の場所に保管してください。ワークスペース自体を保持するには、 データの収集を停止した状態で、データフォルダ全体をコピーしてください。 2. **「More tools」→「Extras」→「Server 24/7」**の下で作成されたサーバーは、「**Your servers**」から、または `python -m tgwitness.cloud destroy` コマンドで削除してください。プロバイダーは、削除されるまでこれらのサーバーに対して課金を行います。 3. Telegramの**「設定」→「デバイス」**から、各アカウントのセッションを終了してください。ファイルを削除しても、 Telegram側でのセッションはログアウトされません。 **Ubuntuへのルートインストール。**データフォルダに注意し、サービスを停止してから、 サービス、フォルダ、およびショートカットを削除してください: ``` /opt/tgwitness/bin/tgwitness paths /opt/tgwitness/bin/tgwitness stop systemctl list-unit-files 'tgwitness-*' systemctl disable tgwitness- rm /etc/systemd/system/tgwitness-.service systemctl daemon-reload rm -rf /opt/tgwitness /var/lib/tgwitness- /usr/local/bin/tgwitness ``` **Linux または macOS ユーザー向けのインストール手順。**パネルを閉じます。設定済みの Linux ユーザーサービスは 次のコマンドで停止します `systemctl --user disable --now tgwitness-`で停止されます。その単位は `~/.config/systemd/user/`です。その後、 `~/.local/share/tgwitness` (またはご使用の `TGWITNESS_INSTALL_DIR`)と `~/.local/bin/tgwitness` ショートカットを削除してください。 **Windows。**パネルを閉じ、 `%LOCALAPPDATA%\TgWitness` (または `TGWITNESS_INSTALL_DIR`)を削除してください。インストーラーは、サービス、スケジュールされたタスク、ショートカットを追加しません。 --- # Telegram · 初期設定と設定 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/settings/ セットアップウィザード、目標、インターフェースレベル、接続ルート、およびアカウントグループで共有される設定。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) Translation coverage: this edition includes material from the English original. セットアップウィザード、目標、インターフェースレベル、接続ルート、およびアカウントグループで共有される設定。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [はじめに](https://phishdestroy.io/tgwitness/ja/docs/reference/quickstart/) ![はじめに](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [アカウント](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/) · [接続](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/) · [アクセス](https://phishdestroy.io/tgwitness/ja/docs/reference/access/) 新しいワークスペースが開きます `/first-run`。最初の画面では、どのような操作を行うか尋ねられます:**「ダウンロードのみ**」、「**チャットをフォロー」**、または「**事件の証拠」**のいずれかを選択してください。この選択により、目的とインターフェースのレベルが設定されます。「ダウンロードのみ」の場合は「シンプル」、他の2つの場合は「標準」となります。レベルによって、各フォームに表示されるフィールド数が決まります。すべてのページはメニュー内に表示されたままになります。 同じ画面にある**その他のオプション**では、レベル、テーマ、タイムゾーンを明示的に設定できます。言語一覧はウィザードのヘッダーにあります。次の画面では、接続、Telegram、チャットについて設定します。自動チェックの動作中は接続経路が折りたたまれた状態ですが、チェックに失敗すると展開されます。 5段階の進行状況バーは、完了した段階に戻ることができます。各回答は変更されるたびにサーバーに保存されるため、ページを再読み込みしても同じステップから続行できます。最後の画面には回答が一覧表示され、任意の回答に戻ることができます。 言語、IANA タイムゾーン、テーマ、およびレベルは、オペレーターごとおよびワークスペースごとに保存されます。 デフォルト設定は、ブラウザの言語、デバイスのタイムゾーン、システムのテーマ、および 「シンプル」インターフェースです。言語を変更しても、パネルのセッションは維持されます。署名済み ジャーナル内の時刻は決して変更されません。 `/settings` はウィザードと同じ記録を編集します。検索は主なフィールド、パラメータ、拡張フォームを対象とし、非表示のフィールドもレベルを変えずに開けます。レベルは表示内容を変えるだけで、権限はサーバーが独自に確認します。設定がすべて選択中のレベルより上にあるセクションは、それでも設定を表示します。収集の設定と最初の接続はワークスペース管理者が担当します。 設定ページはリストです。上部のアカウントカードは**Telegramアカウント**を開きます。その下の各行は、セクション名と使用中の値を示します。**アカウント**には**どのチャット?**と**接続**、**記録**には**目的**、**記録とファイル**、**記録の保護**、**通知と外部コピー**、**パネル**には**言語、時刻、外観**、そして**その他のツール**にはエキスパート向けページがあります。リストの横のカードは、推奨値が有効かどうかを主な値と**直前の変更を元に戻す**とともに示し、**最近の変更点**は最近の編集を一覧表示します。 A section opens in a window over the list and has its own address, such as `/settings/connection`. The back arrow, the close button, Escape, a click outside the window and the browser's Back button return to the list. **Which chats?** is kept with **Save chat selection**; closing with unsaved changes asks first. Saving keeps the source types, excluded chats, own actions and new-chat settings of **More tools → Sources → Scope**; a chat chosen here is taken off the excluded chats and recorded as a hand-picked source. Every change shows **Undo** for 20 seconds, and each entry in **Recent changes** can be undone later. An undo brings back only the settings that entry changed, custom file limits included. When a later change touched the same settings, the undo is refused and nothing changes. An undo is a new `settings.changed` record in the journal. | レベル | フィールド | サイドバー | | --- | --- | --- | | シンプル | 必要最小限のみ | ホーム、チャット、ジャーナル、エクスポート、アカウント、設定 | | 標準 | 説明付きの共通設定 | 「その他のツール」の下に、「ケースボード」、「ソース」、「アクセス」、「ドキュメント」を追加します。 | | エキスパート | すべてのフィールド、制限、および技術的な詳細 | また、「その他のツール」の下に、「システムマップ」、「ネットワークトポロジー」、「エクストラ」、「アーカイブへの問い合わせ」、「パラメータ」、「アカウント」、「システムログ」、「統合」を追加します。 | セクション名はすべてのレベルで統一されています。レベルを変更するには、 サイドバーの下部にある「外観」を開いてください。[パネル](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/)ガイドには各セクションの説明が記載されています。 ## 目標 | 目標 | コレクション | ファイル | 外部サービス | サーバーアドレス | | --- | --- | --- | --- | --- | | ダウンロードのみ | 1回限りのエクスポートは最終設定画面から開始されます。継続的な収集はオフのままとなります。 | 最大20 MBまでの写真 | タイムスタンプ | 自動 | | チャットをフォローする | 継続的 | 写真および動画:最大60秒/20 MB | タイムスタンプと問題通知 | 自動 | | 事件の証拠 | 継続的 | 1 GB までのすべてのファイル | タイムスタンプ、drand、通知 | いいえ、非表示にする | 証拠として、オフサイトコピー、ウィットネスボット、およびコードチェックの利用が推奨されます。 ストレージおよび通知先アドレスには、まず宛先を設定する必要があります。外部サービスと連携する機能では、 Telegram外へのリクエストを許可するよう求められます。これを無効にすると、 タイムスタンプ、通知、およびオフサイトコピーも同時に無効になります。 目標を変更すると、まずその差異が表示され、手動での変更内容は保持されます。目標と 異なるフィールドには**「Changed by you」**とマークされ、元に戻すことができます。 設定のリビジョン機能により、別のタブで行われた変更が、レビュー済みの差異に上書きされるのを 防ぎます。 ## 接続 ここでルートが選択されるまでは、新しいワークスペースでは**「自動 MTProxy · 公開リスト**」が使用され、 「**アドレスを非表示にする**([接続のセキュリティ](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/))」が有効になります。 以下の「**自動**」の選択は、別の設定手順となります。 **Automaticは**、まずWARP、次に公開MTProxyサーバー、その次に直接接続を試みます。 直接接続は、サーバーのアドレスを表示できる場合にのみ行われます。AutomaticとWARPは、 ハッシュ検証済みのコンポーネントをインストールし、Cloudflareにサーバーを登録することができます。その同意がない場合、 AutomaticはWARPをスキップします。WARPは、既存のwgcf/wireproxyマネージャーとローカルのSOCKS5 ポートを使用します。システムのルーティングテーブルは変更されません。 **一括インポートでは**、セッションがTelegramに到達する前にルート(WARP(デフォルト)、 パブリックMTProxy、またはダイレクト)を指定します。セッションチェックでも同様のルートが使用され、 インポートされた各アカウントは、初回ログイン前に独自のWARPトンネルを取得します。 独自のプロキシは `tg://proxy`, `socks5://`, `http://` および `https://`を受け付けます。HTTPS プロキシへの認証情報の送信前には、そのプロキシの証明書が検証されます。 接続チェックの有効期間は5分間であり、ルート、ポリシー、および ウィザードでの回答に紐付けられています。これらいずれかを変更した場合は、新たなチェックが必要となります。**「チェックせずに続行」**も利用可能ですが、これはTelegramへのサインインに代わるものではありません。選択されたルートは バックグラウンドで再チェックされ、接続が切断された後は「Automatic」がチェーンを再度実行します。 パブリックプロキシから応答がない場合、カウントが赤色に変わり、WARPおよび再チェック アクションが実行されます。 ## アカウントグループ グループ内のアカウントは設定を共有します。**「アカウント」→「グループと共有 設定」→「共有設定」**、または各アカウントの「設定」ページにある「**グループ設定」**を開いてください。 グループでは、目標、保存されたファイル、タイムスタンプ、drand、問題通知、 オフサイトコピー、Telegram外のリクエスト、IPモード、記録対象、再確認 スケジュール、通知ルール、レポート設定、パラメータ、接続経路を共有します。 通知先、プロキシの認証情報、ログイン情報はアカウントごとに管理され、 収集の開始や一時停止も同様にアカウントごとに設定されます。 - すべてのメンバーがこのグループをフォローしています。「設定」では、値に 🔗 **グループから** または ✏️ **独自の値** を指定するとマークされ、**グループの値に戻す** を指定すると元に戻ります。 - 変更操作では、影響を受けるアカウントの一覧が表示され(**3つのアカウントのうち2つに適用**)、 各アカウントごとに確認を求められた後、そのアカウントの値が上書きされます。チェックボックスがオフのアカウントは、元の値が保持されます。 - グループで共有されていないパラメータは、**この値を共有する** を押すまで **共有されないもの:各アカウントは独自の値を保持します** のままになります。 - **あるアカウントの設定をコピーすると、**選択したアカウントの値がグループの設定として適用されます。 - グループに移動されたアカウントには、「**グループの設定を採用しますか?」**と尋ねられます。採用しない場合は、 ✏️のマークが付いたまま、自身の設定が維持されます。後から追加されたアカウントは、最初からグループの設定が適用されます。 - 監視用アカウントは、一時停止されるまでIPモードを維持します。 各変更は、メインワークスペースおよびその変更が及ぶすべての メンバーの署名付きジャーナルに記録されます。グループを削除しても、そのグループに属するアカウントとその現在の値は保持されます。 グループページには `/groups/` には、メンバー、注目すべき事項、および 複数のアカウントが閲覧できるチャットが表示されます。[アカウントグループを](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#bulk-import-and-account-groups)参照してください。 ## 既存のワークスペース セッションがあるワークスペースや、以前にセットアップが完了しているワークスペースでは、ウィザードは表示されません。 ページが読み込まれても、その値は目標によって上書きされません。フィールドを非表示にしても、 その機能がオフになったり、値が削除されたりすることはありません。「設定」**で最初のセットアップを開くと**、 同じ画面が再度表示されます。それらを完了しても、新しいエクスポートや観察は開始されず、その旨が表示されます。 また、変更されたチャットの選択内容は、「**チャットの選択を保存」**を実行した場合にのみ保持されます。 サイズと所要時間の見積もりは、選択されたチャットを最大3つ、各チャットから最大20件のメッセージを読み込むことを前提としています。 これはあくまで概算であり、Telegramの制限、特定のサーバーの速度、 あるいは各チャット内のファイル内容までは予測していません。 --- # Telegram · アカウントとセッション形式 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/ 電話番号、QRコード、または認証キーでログインし、Telethon、Pyrogram、またはTelegram Desktopのセッションをインポートして、複数のアカウントを運用できます。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 電話番号、QRコード、または認証キーでログインし、Telethon、Pyrogram、またはTelegram Desktopのセッションをインポートして、複数のアカウントを運用できます。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [はじめに](https://phishdestroy.io/tgwitness/ja/docs/reference/quickstart/) ![はじめに](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) TgWitnessは、Telethonを使用して、MTProto経由で**Telegramのユーザーアカウント**(ボットではありません)としてログインします。 各アカウントは、独自の**ワークスペース**(APIおよびコマンドラインツールでは「*ワークスペース*」と呼ばれます)内に存在し、 独自のセッション、ソース、ジャーナル、および署名鍵を持っています。 セッションファイル、セッション文字列、および認証キーは**アカウントの認証情報**です。これらを 所持している者は誰でも、そのアカウントとして行動することができます。これらにはメッセージ履歴は含まれていません。 > [!警告] **専用のアカウントを使用してください。**Telegramは、クライアントや目的を問わず、 過剰とみなされるリクエスト量に対してアカウントを制限し、永久に利用停止にする可能性があり、 それらの制限については一部しか公開されていません。個人用やその他の重要なアカウントではなく、 観測用に用意されたアカウントを接続し、専用の アカウントでAPI ID / APIハッシュを作成してください。 - [概要](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#at-a-glance) - [ご利用開始前に:API ID および API ハッシュ](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#before-you-start-api-id-and-api-hash) - [電話番号](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#phone-number) · [QRコード](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#qr-code) · [認証キー + DC ID](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#auth-key--dc-id) - [アカウントファイル](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#account-files): [Telethon .session](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#telethon-session) · [Pyrogram .session](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#pyrogram-session) · [セッションとJSONのペア](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#session--json-pair) · [TData](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#telegram-desktop-tdata) · [StringSession](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#telethon-stringsession) · [認証キーとDCを1行にまとめる](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#auth-key-and-dc-in-one-line) · [アカウントのJSON](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#account-json) - [お手持ちのものを特定する](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#identify-what-you-have) · [サポートされていない形式](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#unsupported-formats) - [複数のアカウント](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#multiple-accounts) · [アカウントファイルの安全な保管](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#keeping-account-files-safe) · [トラブルシューティング](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#troubleshooting) ## 概要 | 現在お持ちのもの | 「**アカウントの追加**」タブ | また、以下も必要となります | | --- | --- | --- | | 電話番号およびログインコードへのアクセス | **電話** | 2FAが有効になっている場合のパスワード | | 別のデバイスでTelegramが開かれている | **QRコード** | 2FAが有効になっている場合のパスワード | | `.session`ファイル(TelethonまたはPyrogram) | **ファイル** | アプリ設定用のオプションのJSONファイル | | `.session` + `.json`(同名) | **ファイル**(両方を選択してください) | 通常、これ以外の記載はありません | | Telegram Desktopの`tdata`フォルダ | **ファイル**(ZIP形式) | デスクトップ版でローカルパスコードが設定されている場合 | | Telethon StringSession(テキスト、`.txt`、`.tgwitness-session`) | **ファイル** | 別途APIペアは必要ありません | | 認証キーとDCを1行にまとめ、`<512 hex>:<1–5>` | **ファイル**(貼り付けまたはテキストファイル) | 別途APIペアは必要ありません | | セッションまたは認証キーを持つ`.json` | **ファイル** | 別途APIペアは必要ありません | | 認証キー(512 ヘックス文字)とその DC 番号 | **認証キー** | オプションのユーザーID | TgWitnessは、ファイル名ではなく内容によってファイルを識別します。ファイル名を変更しても、 そのファイルが変換されることはありません。 ## ご利用開始前に:API ID および API ハッシュ Telegram APIアプリケーションを作成しなくてもログインできます。ペアが入力されていない、 インポートされていない、またはワークスペースにすでに保存されていない場合、TgWitnessは組み込みの 50組の公開APIペアのプールからペアを1組選択します(`tgwitness/api_pool.py`)からペアをランダムに選択します。この際、新規ログイン時にはTelegram Desktopのペアを優先し、 保存済みのペアがあればそれを優先的に使用します。残りの候補はシャッフルされます。Telegramがペアを拒否した場合 (`API_ID_INVALID`, `API_ID_PUBLISHED_FLOOD`, `UPDATE_APP_TO_LOGIN`)、次のペアが試されます。 1回のサインインにつき最大8ペアまで試行され、拒否されたペアは再起動までスキップされます。サインインに使用されたペアは アカウントとともに保存され、そのアカウントで再利用されます。 組み込みのペアは公開されています。これらはTelegram クライアントおよびライブラリのオープンソースコードで公開されています。**API**IDと**APIハッシュ**は、Telegramに対してアプリケーションを識別するものであり、 アカウントデータへのアクセス権は一切与えません。サインインには、アカウント独自の認証方法(ログイン コードと2FAパスワード、またはそのアカウントがすでに認証済みのセッション)が使用されます。 `observation.started` レコードには使用されたペア名が記載されているため、組み込みのペアも 独自のペアと同様に法廷で証拠として記録されます。代わりに、my.telegram.org から独自のペアを入力することも可能です。 当プロジェクトの経験上、新しい個人用ペアを使用するとほとんどのアカウントからログアウトされてしまうため、 自身のアプリケーションが必要となるケースでのみ使用してください。専用のアカウントでペアを作成し、 収集開始前にそれを入力してください(手順は以下を参照)。 接続フィールドが欠落している場合は、同梱の [opentele2 2.0.0 カタログから](https://github.com/DedInc/opentele2/tree/7e973bc71cd7a714ad13ac703c0895a90d36a735)決定論的なデバイス/OS ペアを使用します: デスクトップ `2040`、Android `6`、Android X `21724`、iOS `10840`、macOS `2834`、および Web `2496`。 Android のソースビルド ID `4` も、 [Telegram Android の BuildVars](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java) で特定される通り、Android カタログを使用します。 WebはデフォルトでAとなります。インポートされた`K`アプリバージョンサフィックスまたは`macos`言語パックが選択された場合は Kとなり、バージョン`0.7.0`が選択された場合はWebogramとなります。不明なアプリケーションIDについては、Telethonのホスト デフォルト設定が維持されます。インポートされたフィールドは、古いアプリバージョンや空の 言語パックを含め、常に優先されます。カタログはAPI ID/ハッシュを変更することはありません。そのバージョンスナップショットは 明示的に確認され、ログイン時に取得されることはありません。保存されたプロファイルは、アップデート後も安定して維持されます。 `account.getAuthorizations`は、Telegramに保存されている認証メタデータを報告するものであり、 新しい`initConnection`のたびにその内容が反映されるわけではありません。実際に送信されたプロファイルと比較してください。 既存の認証を接続しても、それに対応するAPIハッシュの検証は行われません。 `initConnection`はAPI IDを送信しますが、ハッシュはログインリクエストで使用されます。 新しい携帯電話またはQRコードによる認証後、TgWitnessは設定、最寄りのDC、 オンライン状態、言語(言語パックが空でない場合)、アプリの更新、および 利用規約の更新を、リクエスト間隔を0.3~1.5秒として要求します。 ステータスの更新 により、アカウントは一時的にオンラインとマークされます。このシーケンスはログイン完了時に一度だけ実行され、 インポート、再接続、再起動時には実行されません。認証情報は最初に保存されます。リクエストが失敗した場合、 再試行やログインの破棄を行わずにシーケンスが停止します。結果は `account.initialized`として記録され、レスポンス本文ではなくエラー名が記載されます。 アカウントの制限については、Telegram独自のポリシーに基づいて決定されます。 `tdesktop` において、`tz_offset` が指定されていない場合、サーバーのローカル UTC オフセットが使用され、 [opentele2 アルゴリズム](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/fingerprint.rs) (MIT;ライセンスは `tgwitness/client_profiles.LICENSE` に記載)を用いて 900 秒に丸められます。これは各 接続時に更新されるため、夏時間の変更が反映されます。インポートされた `tz_offset` はすべてのプラットフォームで優先され、ゼロを含む値がそのまま保持されます。その他の `initConnection.params` のエントリは保持されます。 HTTP サインインフォームは、ファイルのインポートによって返された数値のタイムゾーンを受け入れます。 ブール値、小数、およびサポート範囲外のオフセットは拒否されます。 ダイレクト、SOCKS5、およびHTTP CONNECTルートでは、Telethonの`ConnectionTcpObfuscated` (難読化された短縮版MTProto)が使用されます。HTTPS CONNECTはプロキシへのTLSを維持し、 トンネル内では同じ難読化されたトランスポートを使用します。MTProxyは、必須の ランダム化された中間トランスポートと秘密情報の処理を維持します。ルートの切り替えにおいても、 同様の選択が適用されます。 難読化処理はパケットのフレーミングを変更しますが、Telegram に対してアカウント やそのクライアントのメタデータを隠すものではなく、また制限に対する免除を意味するものでもありません。 認証済みのクライアントが接続されると、TgWitnessは設定、最寄りのデータセンター、 現在の認証状態、レビュー済みのレイヤーベースライン、言語、アプリの更新状況、 および利用規約の更新状況を確認します。 これらの診断は、クライアントインスタンスごとに1回、 データ収集の前に実行され、接続詳細に実行時刻とともに表示されます。 `account.connection_checked`には、セッションハッシュ、IPアドレス、 トークン、APIハッシュを含まない結果が記録されます。利用規約への同意やアップデートのインストールは一切行われません。リクエストの 失敗やFloodWaitが発生すると、それ以降のリクエストは停止され、結果が欠落している場合は「不明」のままとなります。 ネットワークチェックがスキップされていても、ローカルチェックは結果を報告できます。 「[厳格なチャット選択」](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#strict-chosen-chats)が有効になっている場合、現在の 認証情報は要求されず、そのチェックは「スキップ」として表示されます。 ログイン後、および新しい接続が行われるたびに、TgWitnessはそのアカウントの「センシティブ コンテンツ」設定を読み取ります。 この設定がオフになっており、Telegramが変更を許可している場合、TgWitnessは設定をオンに切り替えます。 これにより、Telegramがセンシティブ(18+)とマークしたコンテンツが保存され、 `account.content_settings`が記録されます。この設定はアカウントに紐づいており、すべての Telegramアプリに適用されます。「厳格なチャット選択」が有効な場合は設定が変更されません。ログイン前にその設定をオンにしてください。 1つのワークスペースへの接続を復元する同時リクエストは、そのワークスペースのクライアントを共有し、 接続の確立が完了するのを待ちます。リクエストが失敗またはキャンセルされた場合、 次のリクエストが再試行できるようになります。接続の確立中に、保存された認証情報、クライアント、または認証状態が 変更された場合、以前のリクエストは「接続準備完了」と報告するのではなく、停止します。 FloodWaitの診断情報には、失敗したTLメソッド、Takeout/rangeラッパー、 サーバーが要求した待機時間、および`telegram.backoff`内の有効期限が保持されます。 接続の詳細には、リクエストが一時停止している間のメソッドと有効期限が表示されます。 この診断情報には、そのクライアントが 作成されてからのメソッドごとのクライアント呼び出しカウンターが含まれます。これらはネストされたピア解決を個別にカウントしますが、パケット やTelethonの内部リトライ試行はカウントしません。現在のカウンターは、ステータスAPIの `collector.rpc_activity`としても利用可能です。 リクエスト引数、ユーザー名、アクセス ハッシュ、例外テキストは含まれません。最後の診断情報と完全な期限は 再起動後も保持されます。メソッドレコードのない以前の待機は、 遡って特定することはできません。ソースレビューの[エクスポート制限](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-LIMITS.md)および ディスカバリーと履歴取得の違いについては、そちらを参照してください。 `official_app=True`または`False`は、Telegramの現在の認証フラグです。いずれの 値も、アカウントが制限されているか、信頼されているか、あるいは監視下にあるかを決定するものではありません。 既存の証拠モードの`account.devices`スナップショットは、引き続きすべての ログイン済みデバイスの履歴として残ります。接続診断情報には、現在のデバイスの説明のみが保持されます。 接続前に、アドバイザリチェックにより、APIプラットフォーム、言語パック、 デバイス/OSおよびアプリバージョンの形式、モバイルシステムのロケール、ならびにTelethonの実際の スキーマ層が、審査済みのカタログベースラインと照合されます。警告はサーバー ログおよびアカウントステータスのメタデータに表示されますが、インポートされた値を置き換えたり、 スキーマ層を変更したりすることは決してありません。異なる層が検出された場合は互換性を確認するシグナルとなり、アカウントの 独自の接続ステータスによって正常に機能しているかどうかが示されます。 Telegramは、どのクライアントプロファイルが使用されていても、 自社側で制限を決定します。接続が切断されたアカウントのステータスでは、 別のデバイス記述を生成する代わりに、保存されたプロファイルが使用されます。 代わりに独自のアプリケーションを使用するには: 1. [my.telegram.org](https://my.telegram.org) を開き、ご自身が所有する任意の電話番号でログインしてください。 認証コードはSMSではなく、Telegramアプリに届きます。 2. **API開発ツール**をお選びください。 3. アプリケーションを作成します:タイトルと短縮名(5~32文字)を任意で指定し、プラットフォームは「**デスクトップ」を選択してください**。 URLと説明は空欄のままでも構いません。 4. **App api_id**(数値)と**App api_hash**(32文字の16進数)をコピーしてください。 パネル内のサインインフォームの下に、「**API ID + ハッシュ**」という項目があります。**API ID** に 1 組の `api_id:api_hash`ペアを貼り付けると、両方のフィールドに値が入力されます。1 組のペアを すべてのアカウントでご利用いただけます。ログインに成功すると、その情報は暗号化され、 そのワークスペース内にのみ保存され、ブラウザへ送信されることはありません。 これには3種類の認証情報が関係しています: | シークレット | 開く | 設置場所 | | --- | --- | --- | | パネルトークン | TgWitnessのウェブパネル | データディレクトリ内の`panel-token.txt`、または`TGWITNESS_TOKEN` | | API ID + ハッシュ | これ単体では意味を成しません。アプリを特定するものです。 | my.telegram.org にて、組み込みのペア、インポートされた設定、またはご自身のアプリをご利用いただけます。 | | アカウント認証 | Telegramアカウント | 電話またはQRコードによるログインで作成するか、セッションとして取り込むことができます。 | Telegramにプロキシ経由で接続する必要がある場合は、まず「 **その他のツール」→「アカウント」→「設定」→「接続設定」→「接続経路の変更」**で設定を行ってください。 ## 電話番号 1. **[その他のツール] → [アカウント**] → [**電話番号**] タブを開き、国際形式で番号を入力してください。 例:`+44 7700 900123`。スペースやハイフンは自動的に削除されます。 2. **「続行」**をクリックしてください。API ID およびハッシュは空欄のままでも構いません。 3. Telegramが送信するコードを入力してください。通常はTelegramアプリ宛てですが、SMSを送信するかどうかはTelegramが決定します。 4. アカウントに二段階認証が設定されている場合は、そのパスワードを入力してください。これはパネル トークンでも、デバイスのパスコードでもありません。 5. ログイン後に表示されるアカウントIDを確認し、ソースを選択してください。 ログインコードおよび2段階認証(2FA)のパスワードは、ディスクに書き込まれることはありません。 ## QRコード この機能は、アカウントがすでにスマートフォンや別のコンピュータでログインされている場合に使用してください。 1. **「QRコード」**タブ → **QRコードを表示します**。API ID および ハッシュは空欄のままでも構いません。 2. ログイン済みのデバイスで:**[設定] → [デバイス] → [デスクトップデバイスをリンク]** を選択し、コードをスキャンして 確認してください。 3. Telegramから要求があった場合は、TgWitnessに2FAパスワードを入力してください。 QRコード画像はローカルで生成されます。コードには有効期限があります。**「別のQRコードを生成」** を押して、再試行してください。パネルをロックしたり、ワークスペースを切り替えたり、別のログインを開始したりすると、 生成中のコードはキャンセルされます。 ## 認証キー + DC ID 認証キー(Auth Key)とは、すべてのTelegramセッションの基盤となる256バイトの認証情報であり、 512文字の16進数で表記され、データセンター番号DC 1~5が併記されています。 1. 「**Auth key**」タブ。キーをすべて貼り付けてください。「`…`」を含む短縮されたキーでは機能しません。 2. キーとともに提供されたDC IDを選択してください。 3. 必要に応じて**ユーザーID**を入力してください。Telegramが 異なるアカウントであると報告した場合、TgWitnessは接続を拒否します。 4. Press **Connectアカウント**。 認証キー(512文字)は、APIハッシュ(32文字)とは異なります。同じキーは JSON形式でもインポート可能です。「[アカウントJSON](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#account-json)」をご参照ください。 ## アカウントファイル **「アカウントを追加」→「ファイル」**を開き、**1つのアカウントに属するファイルを**最大4つ(合計8 **MiB**)選択して、**「ファイルを確認」**を押してから、**「アカウントを接続**」を押してください。ファイルを選択したり、 セッションのテキストを貼り付けたりしても、何も送信されません。**「ファイルを確認」**を押すと、ファイルがTgWitnessサーバーに送信され、 サーバーはログインせずにファイルを読み取り、見つかったセッションを表示します。 「**ファイル**」、**「認証キー」**、および「一括インポート」フォームでは、接続前に並行セッションに関する警告が表示されます。 デフォルトでは、インポートされた認証情報は再利用されます。ここでそのキーが使用されている間は、元の クライアントを閉じたままにしてください。**「ファイル」**および**「認証キー」**では、 後述する「**独立した認証情報の作成**」も利用可能です。一括インポートでは引き続き ダイレクトモードが使用されます。電話および対話型QRログインでは、個別の認証情報が作成されます。 インポートフォームでは警告の見出しが常に表示されたままですが、ファイルやキー/セッション文字列が指定されると、 その詳細説明が自動的に展開されます。読み終えた後は折りたたむことが できるため、スマートフォン上でもファイルピッカーや接続操作をそのまま利用できます。 [検証済みのデプロイメント](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/)(Phala Cloud、Intel TDX)では、 インポートされたキーによる収集が行われません。そこでは、「**独立した 認証の作成**」が選択されている場合にのみ、**ファイル**と**認証キーが**連携し、一括インポートは拒否されます。電話およびQRコードによるログインは通常通り機能します。 - ファイルは、TgWitnessサーバー上の**メモリ内で**変換されます。アップロードされたデータは保存されず、 ZIPファイルはディスクに解凍されず、外部サービスへの接続も行われません。 - 生成されたセッションは、その後Telegramで照合されます。ファイルにユーザーIDが記載されている場合、 そのIDはTelegramが報告するアカウントと一致している必要があります。 - 異なるアカウントや異なるAPI認証情報を記述したファイルは、 いずれか1つを選択する代わりに、拒否されます。 - **「パスコード」または「セッションテキスト」**には、TDataのローカルパスコードフィールドが格納されており、ここに StringSessionを貼り付けたり、**ログインせずにファイルを読み**込んだりできます(Telegramに接続せずに フォームに入力されます)。 StringSessionを貼り付けると選択されたファイルがクリアされ、 ファイルを選択すると貼り付けられたテキストがクリアされるため、チェックと接続には最新の選択内容が使用されます。 パスコードを変更した後は、再度**「ファイルをチェック」を**押してください。 ### 独立した認証を作成する 「インポートしたファイルに接続する前に**独立した認証を作成する**」または 「認証キー」を選択してください。TgWitnessは、インポートされたドナーに一時的に接続し、それを使用して 新しいクライアントのQRログイントークンを承認した後、承認直後にドナーとの接続を切断します。 新しいクライアントには、独自の認証キーと個別に選択されたデスクトップ プロファイルが割り当てられます。ドナーから提供されたAPI認証情報およびデバイスプロファイルは、 ドナーとの接続にのみ使用されます。既存の認証がログアウトされたり、取り消されたりすることはありません。 **この手順の間は、ドナーの元のクライアントを完全に閉じた状態にしておいてください。**最初の 接続では依然としてコピーされた鍵が使用されるため、このモードではその初期の 並行使用によるリスクを排除することはできません。新しい認証が接続されれば、所有者は元の クライアントを再開し、両方を同時に使用できるようになります。 対話型**QRコード**ログインでは、 元のクライアントがここでキーをコピーしたり接続したりすることなく、ログインを承認できます。 **ドナーのセッションからログアウトしたり、セッションを終了したりしないでください。**QR ログインを承認したセッションが終了すると、Telegramも承認したセッションを終了します。実証実験では、ドナーがログアウトしてから1秒以内に新しい 認証が停止しました。インポート機能では、 ドナーのセッション(`session_origin.approved_by`:デバイス、API ID、作成時刻)が記録されます。 セッション一覧ではそれがマークされ、「**セッションを終了」**を選択すると承認が取り消され、「**他のすべてのセッションを終了」** および「**これを唯一のセッションにする」を選択すると、**ログイン状態が維持されます。 Telegramが2段階認証を要求した場合、このモードでは `twoFA` 選択されたJSONに存在する場合、そこから取得し、 存在しない場合はパスワードの入力を求めます。インポートされたパスワードが拒否された場合は、パスワード入力フォームに戻ります。 パスワードは保存されません。候補キーは、 `independent_login.enc`に暗号化されて保存されます。これには、データセンター移行中の変更も含まれます。 中断後は、同じドナーを選択し、このオプションを選択することで、保存された候補キーを再開できます。 ドナーは `help.getAppConfig` 承認前に検証されます。凍結されたアカウントの場合は そこで処理が停止します。Telegramがログイン承認前にドナーを拒否した場合、未承認の 候補キーは破棄され、インポートを最初からやり直すことができます。別のドナーが 保存済みの候補キーを置き換えるのは、Telegramがその候補キーがログインしていないと報告した場合のみです。 ログイン中、または2FAパスワードを待機中の候補キーは保持されます。 ワークスペースはそのアカウント用に予約されたままとなります。インポートの完了に失敗しても、 新しいワークスペースは削除されません。そのデータディレクトリとVaultキーは保持してください。最終的な認証情報および `account.authorized` ジャーナル記録には、インポート方法、入力形式、および ドナーのAPI IDが含まれますが、ドナーのキーやパスワードは含まれません。 5年11月2026日、専用アカウントがTelethon、Pyrogram、 およびTDataのドナーを用いた実証テストに合格しました。内容は、2段階認証(2FA)の完了、 個別の新しい認証キー、ドナーと新規クライアントによる同時アクセス、 および公開チャンネルの閲覧です。 また、Telethonのケースでは、 パスワード入力ステップで中断した後、保存されていた候補を再開することもできました。各新しい 認証は、ログイン後の6つの初期化リクエストを完了し、その署名付き ジャーナルも検証されました。元のセッションは、提供された4つのフォーマットすべてで引き続き使用可能でした。 Telegramの [RPC エラーデータベース](https://core.telegram.org/api/errors.json) 関連付け `FRESH_CHANGE_ADMINS_FORBIDDEN` 管理者の交代に伴い、 `FRESH_CHANGE_PHONE_FORBIDDEN` 電話番号の変更に伴い、および `FRESH_RESET_AUTHORISATION_FORBIDDEN` 他のセッションの 失効、有効期間の変更、またはパスキーの登録とは異なります。 `SESSION_TOO_FRESH_*` および `PASSWORD_TOO_FRESH_*` は、所有権の移転および 収益やギフトの引き出しに関するものです。これらは回収操作ではありません。新しいログインが行われたからといって、 一律に 24-時間の閲覧禁止。エクスポートは別途TAKEOUT_INIT_DELAY_*を返すことができます。TgWitnessはサーバーから要求された一時停止を保持し、制限を回避するためにトークンの受け入れを自動的に再試行したり、セッションを取り消したりすることはありません。 `TAKEOUT_INIT_DELAY_*`. TgWitness サーバーから要求された一時停止状態を維持し、制限を回避するために トークンの受け入れを自動的に再試行したり、セッションを取り消したりすることはありません。 **その他のツール → アカウント → アカウントのセキュリティ → このアカウントのセッション → 他のすべてのセッションを終了** `auth.resetAuthorizations`を オペレーターの要求に応じて呼び出し、セッションの 終了前後の数を`account.all_other_sessions_terminated`に記録します。Telegramは、ログインから24時間経過したセッションからのこの要求を受け付けます。 インポートされたセッションからQRコードでこのワークスペースにログインした場合、承認を行ったセッションは ログイン状態を維持します。TgWitnessは`account.resetAuthorization`を使用して他のセッションを1つずつ終了させ、 `kept_approving_session`に記録します。**このセッションのみを残し**、その理由を指定して停止させ、 パスワードは変更しません。 **このセッションのみ、**このワークスペースからログインして作成された鍵についても同様の処理を行い、アカウントに二段階認証パスワードが設定されていない場合は、それを有効にします。パネルにはそのパスワードが一度だけ表示されます。TgWitnessは、その時点までのみワークスペースの保管庫にパスワードを保持します。ジャーナルには以下の内容が記録されます `session.exclusive_from`。その後、Telegramが別のセッションを一覧表示した場合、ジャーナルにはそのセッションが記録され `session.exclusive_ended` 、パネルはアラートを表示します。検証ツールは両方を表示します。 **Telegramが許可する場合、これを唯一のセッションとするのは**、タイマーによる同一アクションに相当します。この オプションは、このワークスペースで作成されたキーの「**このアカウントのセッション**」に表示され、 `session.exclusive_automatic`として記録されます。監視中、コレクターは5分ごとに、 そのキーの`account.authorized`レコードから24時間が経過したかどうかを確認します( それ以前にはTelegramは`FRESH_RESET_AUTHORISATION_FORBIDDEN`を返します)。その後、同じ 操作を1回実行します。成功した場合は、手動ボタンと同様に`session.exclusive_from`として記録されます。 拒否された場合は、Telegramの理由とともに`session.exclusive_postponed`として1回記録され、 コレクターは最大6時間まで遅延時間を徐々に延ばしながら再試行を行います。読み取り専用設定はここでは効果ありません: セッションの終了はアカウントのセキュリティに関する操作であり、チャット操作ではないからです。 自動実行によって生成された2段階認証のパスワードは、Telegramが設定を行う前に、ワークスペースキーで暗号化され、ワークスペースの保管庫に保存されます。パネルはこれを一度 `POST /api/account/sessions/only/password`から一度取得し、取得後は削除されます。その後、**このアカウントの「セッション」**を開いた際、手動フローと同じダイアログに表示されます。接続ページには、パスワードが待機中であることが表示されます。このパスワードはジャーナルには記録されず、表示されるまでは再起動後も保持されます。 監視中に新しいセッションも報告されます。Telegramのセッションリストにエントリが追加されると、 `account.sessions`レコードがそのエントリを`added`の下に記録し、パネルはそのスナップショットの デバイス、アプリケーション、国を記載したアラートを表示します。 ### ウィットネス・プローブ **その他のツール → アカウント → アカウントのセキュリティ → 「ウィットネス・プローブ」**は、別のクライアントがこのアカウントの 更新情報を受信しているかどうかを確認します。別のTelegramアカウントでログインし、独自の セッションキーを持つ2つ目のワークスペースを追加し、両方のアカウントでプライベートグループを作成します。次に、そのグループを「**プローブ チャット**」として、2つ目のワークスペースを「**ウィットネス・ワークスペース**」として選択し、プローブを有効にします。両方のアカウントで **「読み取り専用」**をオフにし、ウィットネス・ワークスペースは「監視中」である必要があります。 監視中、このワークスペースは60~120秒ごとに`probe::`をグループに送信し、 `probe.sent`を記録します。ウィットネスは`ack::`で応答し、`probe.seen`および `probe.ack_sent`を記録します。20秒以内にライブ更新としてこのセッションに到達したACKは、 `probe.acked`として記録されます。それ以外の場合は、ワークスペースがグループの最近の履歴を読み取ります。 そこで 見つかったものの、ライブで配信されなかったACKは、理由 `probe_ack_missed_live` とともに `coverage.gap` として記録される:パネルはアラートを発し、 後続のACKがライブで到着するまで(`connection.restored`、理由 `probe_ack_live`)、イベントの取り込みを失敗としてマークする。 `probe.unanswered` として記録されるACKはない;待機中の接続中断や読み取れない履歴は `probe.inconclusive` として記録される。読み取り専用、Telegramの制限、およびFloodWaitの一時停止は、 一度だけ `probe.skipped` として記録される。 ### Telethon `.session` | | | | --- | --- | | 概要 | Telethonベースのツールが作成するSQLiteデータベース。例:`my_account.session` | | 以下の組織から認められています | テーブル `sessions`(`dc_id`、`server_address`、`port`、`auth_key` を含む)および `version` = 7 または 8 | | 要件 | 認証済みセッションの行がちょうど1つ。閉じた、完全なデータベースです。 | まず、そのファイルを作成したプログラムを閉じてください。その隣に「`my_account.session-journal`」または 「`my_account.session-wal`」が存在する場合、データベースは確定されていません。元のクライアントを 適切に開いてから閉じてください。これらのサイドカーファイルを削除すると、破損したコピーが残ってしまう可能性があります。 ### Pyrogram `.session` | | | | --- | --- | | 概要 | Pyrogram ベースのツールが生成する SQLite データベース | | 以下の組織から認められています | テーブル`sessions`(`dc_id`、`auth_key`、`test_mode`、`user_id`、`is_bot`を含む);`version` = 2 または 3 | | 要件 | 本番ネットワーク上での認証済み**ユーザー**セッションは1つまでです。ボットおよびテスト用DCのセッションは拒否されます。 | 保存されたユーザーIDは、ログイン時にTelegramと照合されます。 ### セッションとJSONのペア アカウントは、多くの場合、 `447700900123.session`や`447700900123.json`のように、同じ名前の2つのファイルとして配布されます。**両方を**一度に選択してください。 - JSONから、TgWitnessは`app_id`/`api_id`および`app_hash`/`api_hash`を使用するため、 通常、APIの認証情報を入力する必要はありません。 - 接続プロファイルでは、`device_model`(別名 `device`)、`system_version` (別名 `sdk`)、`app_version`、`lang_code`、`system_lang_code`(別名 `system_lang_pack`)、 `lang_pack`、およびオプションの `tz_offset`(UTCからの秒数、-43200 ~ 50400)が使用されます。 指定されたフィールドは、生成されたデフォルト値やパネル/ブラウザの 言語よりも優先されます。競合する別名は拒否されます。解決されたプロファイルは、 暗号化されたワークスペースの認証情報に保存され、アプリバージョンを含めて再起動後も再利用されます。 - `phone`、プロキシ設定、およびデバイストークンは**無視**されます。`twoFA`は、 「**独立した認証を作成**」が選択されている場合にのみ読み取り専用となります。直接インポートでは無視されます。 - サポートされている認証フィールドを含まない JSON は、単なるメタデータです。セッション ファイルを追加するか、電話または QR コードによるログインに進んでください。サポートされているセッションまたは 認証キーを含む JSON であれば、それだけで認証が可能です。[「アカウント JSON](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#account-json)」を参照してください。 ### Telegram Desktop (TData) TDataとは、Telegram Desktopアプリケーション(desktop.telegram.orgから入手できるクロスプラットフォーム アプリ)の`tdata`フォルダのことです。 | システム | デフォルトの`tdata`の場所 | | --- | --- | | Windows | `%APPDATA%\Telegram Desktop\tdata`(ポータブル版Telegram:`Telegram.exe`の隣) | | Linux | `~/.local/share/TelegramDesktop/tdata` | | macOS | `~/Library/Application Support/Telegram Desktop/tdata` | インポートするには: > **並行セッションに関する警告。**TDataの直接インポートでは、Telegram Desktopの認証 キーが再利用されます。そのキーをDesktopと TgWitnessで同時に使用しないでください。Telegramは `AUTH_KEY_DUPLICATED`により認証を無効化することがあり、その場合、新しいログインを行うまで両方のコピーが使用できなくなります。 > > > > Desktopをトレイプロセスを含めて完全に終了させ、 TgWitnessがインポートされたセッションを使用している間は、そのインスタンスを閉じたままにしておいてください。**終了させてください。ログアウトしたり、セッションを取り消したりしないでください:** セッションの取り消しを行うと、インポートされたコピーも無効になります。両方のクライアントを実行する必要がある場合は、 「**独立した認証を作成」**を選択し、新しいログインが成功するまでDesktopを閉じたままにするか、 携帯電話またはQRコードでTgWitnessにサインインしてください。専用の アカウントの使用を推奨しますが、それによってクローンされた鍵を並行して安全に使用できるようになるわけではありません。 > > > > これは、インポートされた`.session`ファイル、StringSessionテキスト、およびAuth Key HEXにも適用されます。 独自に作成された認証情報を持つ他のクライアントは、ログイン状態を維持できます。 [Telegramの「AUTH_KEY_DUPLICATED」に関するドキュメント](https://core.telegram.org/api/errors#406-not-acceptable)をご参照ください。 1. Telegram Desktopを完全に終了してください。 2. `tdata` から、以下の 2 つの**項目のみ**を含む ZIP ファイルを作成してください: - `key_datas` - その隣にある、末尾が「`s`」で終わる16文字のファイル(通常は「`D877F783D5D3EF8Cs`」) メディアキャッシュを含むフォルダ全体をZIP形式で圧縮すると、通常、制限を超過してしまいます (512エントリ、解凍後32 MiB)。 3. 「**ファイル**」からZIPファイルを選択してください。Telegram Desktopに**ローカルパスコード**が設定されている場合は、 まず「**パスコード」または**「**セッションテキスト**」欄に入力してください。これは2FAのパスワードではありません。 対応機能:アーカイブごとに1つのアカウント、最新の`key_datas`/`key_data0`/`key_data1`ストレージ、 ローカルパスコード。非対応機能:複数のアカウントがログインしているフォルダ、旧式のデスクトップ レイアウト、パスワードで保護されたZIPファイル、および独立したmacOSネイティブアプリ「Telegram for macOS」。 ### Telethon StringSession 通常、`1`で始まり、長さが約350文字の1行のテキストです。これを `.txt`または`.tgwitness-session`ファイル(最大4 KiB)として読み込むか、 **「パスコード」または「セッションテキスト」**欄に貼り付けてください。Telethon形式の文字列のみが受け入れられます。PyrogramおよびTDLibの 文字列は異なる形式を使用しています。 ### 認証キーとDCを1行にまとめる アカウントリストには、多くの場合、`<512 hexadecimal characters>:` のような生の認証情報が記載されています。 例えば、`a1b2…ef:5` などです。その行を**「パスコード」または「セッションテキスト」**の下に貼り付け、 テキストファイルとして読み込むか、[アカウント JSON](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#account-json) の `session` フィールドに入力してください。TgWitness は、 DC 1~5 を、`auth_key` + `dc_id` JSON インポートと同じ本番アドレスにマッピングし、 その形式を**「Auth key HEX」および「DC**」として報告します。それ以外の DC 番号やキー長は拒否されます。 ### アカウントのJSON **`.json`** で終わるファイル内に、最大 **64 KiB** の JSON オブジェクトが 1 つ含まれています。 | フィールド(別名) | 意味 | | --- | --- | | `api_id` (`app_id`) | アプリケーションID(正の整数) | | `api_hash` (`app_hash`) | アプリケーションハッシュ(32文字の16進数) | | `string_session`(`session_string`、`session_str`;旧形式の`session`) | Telethon StringSessionのテキスト、または`<512 hexadecimal characters>:`。ファイル名ではありません。 | | `auth_key` (`auth_key_hex`) + `dc_id` | 512文字の認証キー(Auth Key)およびDC 1~5をすべてご入力ください | | `user_id` (`id`) | オプション:認証情報が保存される前に、Telegramとの照合が行われます | | `device_model` (`device`) | 接続デバイスの説明 | | `system_version` (`sdk`) | 接続先のOSバージョン | | `app_version` | Telegramに送信されたアプリケーションのバージョン | | `lang_code`, `system_lang_code` (`system_lang_pack`), `lang_pack` | クライアント言語、システム言語、およびクライアント言語パック。空の`lang_pack`も許可されます。 | | `tz_offset` | `initConnection.params`で送信される、秒単位のUTCオフセット(オプション)。整数または小数を含む整数文字列 | エイリアスとメイン名の両方が存在する場合、それらは一致している必要があります。明示的なTelethon セッションフィールドは、別の形式の汎用的な`session`ブロブよりも優先されます。もし 両方に認識可能なTelethonセッションが含まれている場合、それらは同じ認証を記述している必要があります。 明示的なフィールドがない場合、`session`は有効なTelethon StringSession、または`<512 hexadecimal characters>:`形式の認証キー およびDCでなければなりません。例: ``` { "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" } ``` ``` { "api_id": 1234567, "api_hash": "0123456789abcdef0123456789abcdef", "auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS", "dc_id": 2, "user_id": 123456789 } ``` 最初の例では、API認証情報のみを入力します。電話番号またはQRコードでログインするか、セッション ファイルを追加してください。一括リスト(アカウントのJSON配列)は受け付けられません。 ## お手持ちのものを特定する | ご覧の通り | これは | 使用方法 | | --- | --- | --- | | `*.session`;テキストエディタで開くと、先頭に `SQLite format 3` と表示されます | Telethon または Pyrogram SQLite | **ファイル**(自動検出) | | `tdata`フォルダには`key_datas`が含まれています | Telegram Desktop TData | 2つのファイルをZIP形式で圧縮し、次に「**ファイル」へ** | | `1` で始まる 1 行のテキスト、約 350 文字 | Telethon StringSession | **ファイル** | | 1行のテキスト`512 characters 0-9a-f`、その後に`:`、そして1~5の数字 | 認証キーとDC | **ファイル**、Boxの**パスコード、またはセッションテキスト** | | `*.json`、`app_id`、`app_hash` | 関連メタデータ | **ファイル**およびそのセッション | | `*.json` と `auth_key` または `string_session` | アカウントのJSON | **ファイル** | | 512文字 `0-9a-f` | 認証キー | **認証キー** | | 32文字 `0-9a-f` | APIハッシュ | **API ID + ハッシュ** | | TDLibアプリからの`td.binlog`または`db.sqlite` | TDLib ストレージ | 未対応 | | `123456789:AA…` | ボットトークン | 未対応 | ## サポートされていない形式 | フォーマット | 代替案 | | --- | --- | | TDLib ストレージ (`td.binlog`) および TDLib エクスポート | 電話番号またはQRコードでログインしてください | | Pyrogramのセッション**文字列** | Pyrogramの`.session`ファイル、または携帯電話/QRコードをご利用ください。 | | 複数のアカウントでログインした状態のTData | Telegram Desktopで他のアカウントからログアウトするか、各アカウント専用のセッションファイルをご利用ください | | ボットトークン | 対応していない機能:TgWitnessはユーザーアカウントとして監視を行います | | 多数のアカウントのCSV/JSONリスト | **アカウント → アカウントのインポート**からサポートされているセッションファイルをインポートするか、個別のワークスペースで電話番号やQRコードを使ってサインインします | | Test-DC またはボットセッション | 本番環境のユーザーアカウントを使用してください | ## 複数のアカウント アカウント選択ボタンの横にある**「+」**を押すか、 **[その他のツール] → [アカウント] → [設定] → [接続設定] → [ワークスペース**] を開き、ラベルを入力して サインインしてください。 - メインワークスペースを含め、ワークスペースの数に制限はありません。各ワークスペースには、独自のセッション、プロキシ ルート、情報源、キャプチャポリシー、ジャーナル、署名鍵、チェックポイント、およびエクスポート設定があります。 - 表示されているワークスペースを切り替えても、他のワークスペースは一時停止されません。 - ジャーナルは、それを作成したアカウントに紐付けられたままとなります。別の アカウントでログインするには別のワークスペースが必要となり、1つのアカウントを2つの ワークスペースに割り当てることはできません。 - メインパネルのトークンにより、すべてのワークスペースを管理します。[付与されたアクセス権限](https://phishdestroy.io/tgwitness/ja/docs/reference/access/)により、他のユーザーを特定のアカウントやチャットに限定し、個別の権限やセッション制限を設定することができます。 - **アカウントは**ワークスペースの名前を変更したり、追加されたワークスペースを、そのセッション、ジャーナル、 ソース、および署名鍵とともに削除したりします。メインのワークスペースはパネルから削除することはできません。 ### 一括インポートとアカウントグループ **「アカウント」→「アカウントのインポート」**を使用して複数のアカウントを追加し、ベース名でファイルを紐付け、 各ログイン結果を確認できます。各アカウントには独自のワークスペースが割り当てられます。 グループは、関連するアカウントをまとめて管理しますが、セッション、鍵、 証拠は統合されません。**「Accounts**」の**「グループ」を開くと**、そのページが表示されます。 `/groups/`: - **アカウント:**各メンバーの接続経路、観察内容、最後のメッセージが表示され、 「**すべて**開始」および「**すべて一時停止」**の機能があります。 - **要確認:**ログアウトされたアカウント、利用できないアカウント、または 接続、取り込み、ソース、メディアに問題があるアカウント。各名称をクリックすると、そのカードが表示されます。 - **複数のアカウントが閲覧できるチャットには、** 共有ソース、それらを閲覧しているアカウント、および 利用可能なワークスペースの閲覧期間(最大7日間)における中断が表示されます。**N個のアカウントでのエクスポートでは** 、チャンネルまたはスーパーグループのエクスポートが各アカウントに分割され、1つのアーカイブに署名されます。 - **グループのエクスポート:**各アカウントの署名付きエクスポートが以下に格納された1つのZIP `accounts/` 、 `manifest.json` 各アカウントのSHA-256およびキーのフィンガープリントを列挙し、メイン ワークスペースによって `manifest.signature.json`。各アカウントのアーカイブは、 `python -m tgwitness.verify` およびそのアカウントの信頼済みフィンガープリントを使用して、各アカウントのアーカイブを個別に検証してください。 メンバーはグループの設定を共有しますが、各アカウントは独自の設定値を保持することもできます。 [共有設定](https://phishdestroy.io/tgwitness/ja/docs/reference/settings/#account-groups)、 [インポートおよびグループのガイド](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Accounts.md#import-accounts-and-share-settings)、 ならびに[MTProxyプールダッシュボード](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md#pool-dashboard-and-custom-sources)をご覧ください。 ## ログアウト **その他のツール → アカウント → Telegramからログアウト**(観測を一時停止)を選択すると、Telegramにセッションの終了が要求され、 アカウントの「**設定」→「デバイス」**からもそのセッションが消え、ワークスペースの保管庫からも セッションが削除されます。ジャーナル、ソース、設定、署名鍵は残され、 ジャーナルにはログアウトが記録されます。 ワークスペースは引き続きそのアカウントに属しており、 そのアカウントのみが再度接続できます。Telegram から応答がない場合でも、セッションは ここで削除され、パネルにその旨が表示されます。Telegram の **[設定] → [デバイス]** からセッションを終了してください。 ## Telegramがセッションを終了した際 Telegramがアカウントを凍結、利用停止、またはログアウトさせた場合、あるいは別のデバイスからセッションを終了させた場合、 ジャーナルにはその原因、Telegramのエラー、ルート、およびデータセンターが記録されます。アカウントの 健全性には、**「アカウント喪失レポートをダウンロード**」が表示されます。これは、喪失前の24時間分のジャーナル記録 (接続、ルート、セッション、アカウント通知、およびカバレッジ ギャップなど)を含む署名付きJSONファイルであり、それぞれにジャーナルハッシュと署名が付いています。これを `python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP`で確認してください。証拠エクスポート には完全なハッシュチェーンが含まれています。凍結されたアカウントは、接続時および監視中に検出され、その 送信および参加アクションは無効化されます。 ## アカウントファイルの安全な保管 - `.session`、TData ZIP、StringSession、認証キー、およびアカウントのJSONはすべて、 パスワードと同様に扱ってください。TgWitnessは、インポートされた認証情報を暗号化された保管庫に保存します。そのため、 その後、元のファイルを削除しても問題ありません。 - 同じ認証情報を2つのプログラムで同時に実行しないでください。Telegramによって認証情報が無効化される可能性があります (`AUTH_KEY_DUPLICATED`)、その結果、両方のプログラムが動作しなくなります。 - 有効期限が切れた、または取り消されたセッションは、変換によって復活させることはできません。再度ログインしてください。 ## トラブルシューティング | メッセージまたは現象 | 手順 | | --- | --- | | *このセッションを読み取ることができません。元のクライアントを閉じてください…* | SQLiteファイルが開かれているか、未完了の状態です(`-journal`/`-wal`サイドカー)。元のプログラムを正常に終了させてから、ファイルを再度コピーしてください。 | | *対応しているTelethon SQLiteスキーマ:7および8* / *Pyrogram … 2 および 3* | このファイルは、非常に古い、あるいは不明なライブラリのバージョンで作成されました。代わりに、電話またはQRコードでログインしてください。 | | *サポート対象となるのは、承認された本番環境のユーザーセッションのみです。* | このPyrogramファイルは、ボットまたはテストネットワークに属するものです。 | | *TDataアーカイブのエントリ数が512件、または32 MiBを超えています* | ZIPファイルは`key_datas`および`D877F783D5D3EF8Cs`のみとし、フォルダ全体は含めないでください。 | | *TDataを復号できません。デスクトップのローカルパスコードをご確認ください。* | 「**パスコード」または「セッションテキスト」**の欄に、Telegram Desktopのローカルパスコードを入力してください。 | | *TDataアカウントは一度に1つずつインポートしてください* | Telegram Desktopには複数のアカウントがありました。「[サポートされていない形式」](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#unsupported-formats)をご覧ください。 | | *選択されたファイルには、さまざまなアカウントやAPI認証情報が記載されています。* | 1つのアカウントのファイルのみを選択してください。 | | *JSONには、サポートされているAPIの認証情報や承認情報が含まれていません* | [アカウントのJSON](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#account-json)内のフィールド名をご確認ください。 | | *APIメタデータのみ* | このJSONにはセッションが含まれていません。「`.session`」ファイルを追加するか、電話番号またはQRコードをご利用ください。 | | *Auth Key HEXには、512文字の16進数文字すべてが含まれている必要があります* | キーが切り詰められているか、`…`が含まれています。 | | アカウントIDがインポートされたアカウントと一致しません | このファイルのユーザーIDは、Telegramが報告しているものとは異なります。このファイルは別のアカウントのものです。 | | このアカウントはすでに別のワークスペースに属しています | アカウントを2回追加するのではなく、そのワークスペースを開いてください。 | | 関連していますが、「**その他のツール」→「ソース」**のチャットリストにプライベートグループが表示されていません。 | メンバーシップを確認してください。ピッカーは最初の1,000件のダイアログを検査します。「**その他のツール」→「パラメータ」**で上限を引き上げてください。 | | プロキシ接続に失敗しました | ルートとIPモードを確認してください。自動MTProxyは、動作する別のエントリを試行します。「アドレスを非表示」は待機状態となり、「Direct」は最後の手段として、設定された遅延時間の後に直接接続を試みます。[ルーティングモード](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/#ip-modes)を参照してください。 | 関連項目:プロキシおよび暗号化に関する[接続とセキュリティ](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/)、 およびログイン後に収集されるデータの[収集方法について](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/)。 --- # Telegram · アクセスと権限 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/access/ アカウントやチャットへのアクセス範囲を限定し、権限を選択し、セッションやIPアドレスを制限し、アクセス権を取り消すことができます。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) アカウントやチャットへのアクセス範囲を限定し、権限を選択し、セッションやIPアドレスを制限し、アクセス権を取り消すことができます。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [はじめに](https://phishdestroy.io/tgwitness/ja/docs/reference/quickstart/) ![はじめに](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) レビュー担当者には1つのチャットへのアクセス権を、アナリストには案件のエクスポート権限を、 オペレーターには選択したアカウントの管理権限を付与します。各ユーザーには独自のトークンが割り当てられます。メイン パネルのトークンは管理者が保持します。 [アカウントの設定](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/) · [接続経路](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/) · [セキュリティモデル](https://phishdestroy.io/tgwitness/ja/docs/reference/security/) ## 2つの適用範囲、2つの異なる役割 **収集範囲によって**、アカウントが記録する対象(選択したチャット、Telegramの フォルダ、またはアカウント全体)が決まります。**アクセス範囲によって、**記録された アカウントやチャットのうち、他のユーザーが閲覧・利用できるものが決まります。アクセス権を付与しても、 Telegramのチャットに参加したり、収集を開始したり、Telegramアカウントの権限が付与されたりすることはありません。 アクセス権限では、選択したワークスペース、その中の選択したチャット、すべての ワークスペース、 [またはアカウントグループ内のすべてのアカウント](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#bulk-import-and-account-groups)を開くことができます。**「すべてのワークスペース」には、 後から追加されたワークスペースも含み**、将来追加されるアカウントも対象となります。グループへのアクセス権も、 そのグループに後から追加されるアカウントを対象とします。ケースを特定のワークスペースに限定したい場合は、 そのワークスペースを明示的に選択してください。 ## アクセス権を付与する 1. メイン管理者としてサインインし、「**その他のツール」→「アクセス」**を開いてください。 2. 「**アクセス権を付与する」**の項目で、ログ上で識別できる名前を入力してください。 3. ワークスペースを選択し、必要に応じて個々のチャットを選択してください。 4. この人物が実行しうる行動を選択してください。「**表示」**は常に含まれます。 5. 必要に応じて、有効期限、ログイン/セッション制限、および許可されるアドレスを設定してください。 6. **「アクセスを作成」**をクリックしてください。トークンを今すぐコピーしてください。トークンは一度しか表示されません。 7. パネルアドレスとトークンを非公開で送信してください。受信者は、通常のサインインページでそのトークンを入力します。 あなたのメインパネルトークンやTelegramのセッションは必要ありません。 発行されたトークンが表示されたパネルを別のブラウザセッションで開き、 表示されているチャットや許可されている操作を確認してから、相手にお渡しください。 アクセス名は暗号化されたローカルストレージに保持され、管理者パネルによって解決されます。 新しいアクセスおよびワークスペース作成の監査記録からは名前が省略されますが、既存の署名付き記録は元のフィールドを維持します。 ## 権限を選択してください テキストのみの公開デモを行う場合は、通常の レビュアーアクセスではなく、**「公開ショーケース」**を使用してください。これにより、明示的に選択された公開チャンネル、保持された編集および 削除履歴、署名付き統計情報が表示され、作成者フィールドは伏せられ、ファイルは API境界で閉じられます。[ショーケースを作成して検証してください](https://phishdestroy.io/tgwitness/ja/docs/reference/showcase/)。 | 利用許諾 | 本ツールの機能 | | --- | --- | | `view` | 閲覧可能なチャット、キャプチャされたメッセージ、プロフィール、ファイル、およびフィルタリングされたジャーナル記録をご確認いただけます。これらは常に含まれています。 | | `export` | 許可されたチャット履歴および資料をエクスポートできます。ワークスペース全体の証拠データをエクスポートするには、そのワークスペース全体へのアクセス権が必要です。 | | `sources` | ソース、スナップショット、プロファイルの取得を管理します。チャット限定のアクセス権限では、許可されたチャットに対してのみ操作が可能であり、アカウント全体のソース検出およびスコープ設定は非公開のままとなります。 | | `collect` | コレクターの起動または停止を行います。収集操作はアカウントに影響を与えるため、ワークスペース全体へのアクセス権が必要です。 | | `interact` | アクセス範囲内で、サポートされているTelegramの操作を行ってください。「チャット限定」のアクセス権限では、アカウント全体のリンクプレビュー機能はご利用いただけません。 | | `settings` | 収集設定、タイムスタンプ、通知、オフサイトコピー、およびパラメータを変更できます。ワークスペース全体へのアクセス権が必要です。 | | `account` | Telegramへのログインおよびログアウト、接続経路の管理が可能です。ワークスペース全体へのアクセス権が必要です。 | | `board.read` | ケースボードのメモは、許可されたワークスペースおよびチャット内でのみ閲覧してください。 | | `board.write` | ブックマーク、ハイライト、スライス、コメント、および「開く」「レビュー」ステータスを追加できます。また、`board.read` も必要です。 | | `board.manage` | コレクション、チームの最終ステータス、および他の参加者のカードを管理します。また、ボードへの読み書き権限も必要です。 | オフサイトレプリカの復旧キーをダウンロードできるのは、メイン管理者だけです。 `settings`または`account`へのアクセス権限を委任しても、そのキーは付与されません。 権限と適用範囲は同時に確認されます。権限にチェックを入れても、 チャット限定のアクセス権の場合、他のチャットが開かれたり、ワークスペース全体での操作が可能になったりすることはありません。 並行してエクスポートを行う場合、アクセス権限は、選択されたすべての アカウントにおいて、エクスポート対象のチャットをカバーしている必要があります。付与されたアクセス権限では、新しいアクセス権限の作成、他者の セッションの管理、または管理者コンソールの起動は行えません。 ### 3つの便利な設定方法 | 人物 | 範囲 | 権限 | | --- | --- | --- | | レビュー担当者 | ある事例の記録されたチャット | `view` | | 引き継ぎの準備を行うアナリスト | 調査およびエクスポート対象のチャット | `view`、`export`;Telegramを通じて対応する必要がある場合にのみ、`interact`を追加してください。 | | 収集オペレーター | 選択されたワークスペース全体 | `view`、`sources`、`collect`。`settings`または`account`は、必要な場合にのみ追加してください。 | 「Access」フォームの初期プリセットには、「Case Board」も含まれています。レビュー担当者は閲覧のみ、アナリストは閲覧および書き込みが可能、 オペレーターは管理が可能です。プリセットは編集可能であり、既存の権限は 自動的に拡張されることはありません。継承されるチャット範囲およびエクスポート時のプライバシーについては、[「Case Board」](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/)を参照してください。 ## 制限とセッション | 設定 | 仕組み | | --- | --- | | 並行セッション | 同時接続セッション数を1~100に制限します。上限に達した場合は、次のログインを拒否するか、最も古いセッションを終了します。 | | ログインが可能です | トークンを使用してセッションを開始できる回数を制限します。許可された最後のログインが使用されたからといって、既存のセッションが終了することはありません。 | | 有効期限: | アクセス権には絶対的な有効期限が設定されています。有効期限が切れたアクセス権では、ログインやリクエストの継続はできません。 | | 一定時間操作がない場合の記録 | セッションの非アクティブ状態によるタイムアウトは、5分から30日まで設定可能です。リクエストが成功するとタイムアウト時間が延長されます。また、開いているパネルはポーリングを行うことで、アクティブ状態を維持することができます。 | | 許可されたアドレス | 特定のIPアドレスまたはCIDRサブネットを受け入れます。「first-sign-in binding」が有効になっていない限り、空欄のままにするとすべてのアドレスを受け入れます。 | | 初回ログイン時に紐付ける | 初回ログインに成功すると、そのアクセスに対する許可済みアドレスが確定します。 | IPアドレスとは、アプリケーションから認識されるクライアントのアドレスを指します。リバースプロキシや トンネルの背後にある場合は、IPルールに依存する前に「**開いているセッション」**に表示されるアドレスを確認してください。 そうしないと、複数のユーザーがプロキシのアドレスを共有しているように見える可能性があります。 ## アクセスの変更または取り消し **「アクセス許可」**の下にあるエントリを編集して、その適用範囲、権限、または制限を変更します。 適用範囲および権限の変更は、その後のリクエスト( すでに開かれているセッションからのリクエストを含む)で反映されます。アクセス権を取り消すと、そのセッションは終了し、 発行されたトークンは使用できなくなります。また、**開いているセッションについては、**管理者が アクセス権全体を取り消すことなく、個々のセッションを終了させることもできます。 保存されたエクスポートコピーには、作成者、ワークスペース、チャット範囲、および必要な権限が保持されます。 付与されたアクセス権は、その権限が有効である間のみ、自身のコピーを一覧表示またはダウンロードできます。 ケースボードを含むコピーには、さらに `board.read`が必要です。管理者はすべてのコピーを取得できます。 このメタデータやグループバンドルを含まない古いコピーは、管理者のみがアクセス可能です。ダウンロードチケット および準備済みのファイル応答は、ファイルの準備完了後、データを送信する前にアクセス権限を再確認します。 管理者を含め、各アクセス権限はワークスペースごとに10件の保留中のダウンロードチケットを保持できます; ワークスペース全体の上限は1,000件です。チケットは120秒後に失効し、1回限りの使用となります。 アクセス権の取り消しを行っても、すでに誰かがダウンロードしたファイルを復元することはできません。ログアウト、 パネルのロック、またはセッションの終了を行っても、実行中のコレクターは停止しません。 ## 管理者が確認できる内容 レビュー担当者およびアナリストには、プロキシエンドポイント、 プール診断情報、サーバーパス、または生の接続エラーを含まない収集進捗情報が提供されます。接続診断には、 ワークスペース全体に対する`account`権限が必要です。通知の閲覧、 オフサイトコピー、およびパラメータ設定には、`settings`権限が必要です。 ブラウザ上の完全なUser-Agent文字列は、アクセスセッションには保持されません。アップグレード を行うと、変更可能なセッションキャッシュからもこれらが削除されます。パネルプロセスのログでは、 IPリテラル、URLの認証情報、およびラベル付き秘密情報がマスクされます。ローカルサービスのログや 以前に署名されたジャーナルレコードは書き換えられません。アクセスルールおよび署名済み サインインレコードでは、引き続きクライアントアドレスが使用されます。 ### メインキーを置き換える [**その他のツール] → [アクセス] → [マイリミット] → [管理者キーの再発行]** を使用するか、パネルが実行中の状態で管理対象のインストール環境から `tgwitness token rotate` を実行してください。 同僚トークンで開かれたセッションを含め、既存のすべてのブラウザセッションが終了します。 リクエストを行ったブラウザには新しいセッションが割り当てられます。新しい管理者キーは、非表示にする前に保存してください。 発行済みの同僚トークンは、別途取り消されるまで有効です。 `TGWITNESS_TOKEN` を使用しているインストール環境では、その環境設定を変更し、再起動する必要があります。 ### リクエストとプロキシの境界 このAPIでは、クライアントおよび認証情報ファミリー( panel、archive/MCP、witness)ごとに、1分あたり最大600件のリクエストが許可されます。認証のクールダウン時間は、これらのファミリーごとに個別に設定されます。 1分間に10回の認証拒否があると、1秒から 最大5分までの指数関数的なクールダウンが開始されます。クールダウン期間中に認証に失敗すると、クールダウン時間が延長されます。10分間 認証に失敗しなければ、延長されたクールダウン時間はリセットされます。認証拒否時にはHTTP 429が返され、 `Retry-After`が返されます。制限はメモリ内にあり、1つのpanelプロセス内のワークスペース間で共有されます。 再起動するとリセットされます。ライブストリームは、ベアラートークンあたり4つ、panelプロセスあたり32 個に制限されています。ストリームを開く際も、APIリクエストの割り当てが消費されます。 リクエスト本文の受信期限は60秒ですが、ログイン、デモアクセス、 アーカイブAPI、およびwitness-headパスでは10秒に、MCPトランスポートでは8秒に短縮されます。各アプリケーションでは、 クライアントアドレスごとに4つの未完了の本文が許可されており、予約済み ルート割り当ての全体上限は32 MiBおよび64 MiBです。 ボディのないリクエストは、これらのスロットを消費しません。サイズ超過のボディには 413が返され、タイムアウトしたボディには408が返され、クライアントの容量超過には429が返されます。 `Retry-After: 1`。 ボディの全体容量が枯渇した場合は、503を返します。 `Retry-After`. 実際のTCPピアが `TGWITNESS_TRUSTED_PROXIES`(カンマ区切りのIPまたはCIDR)に属していない限り、転送されたIPヘッダーは無視されます。 `TGWITNESS_PROXY_HEADER`を`x-forwarded-for`または`cf-connecting-ip`に設定してください。XFFは、 最も近いプロキシから最初の信頼できないピアに向かって順に処理されます。 形式が不正または重複した 信頼済みアドレスのメタデータは拒否されるため、許可リストに登録されたプロキシ アドレスを継承することはできません。管理対象のクイックトンネルは ローカルの Cloudflare コネクタを信頼し、独自ドメインの設定ではローカルの Caddy を信頼します。 ダイレクトデプロイメントは、デフォルトではプロキシを信頼しません。Uvicornを自分で起動する場合は、 この境界が実際のピアを受け取れるよう、Uvicornのプロキシヘッダー処理を無効にしてください。 `TGWITNESS_PANEL_ALLOWED_IPS`は、管理者を含むすべてのパネルへのアクセスを、 指定されたIPアドレスまたはCIDRに制限します。インストーラのルーティングIDプローブはパブリック状態のままであり、 アカウントデータは返されません。許可リストを有効にする前に、 必要なローカル管理ルートを追加してください。管理対象インストールの**START-HERE**ガイドには、 サービスの設定および復旧手順が含まれています。 APIの`ws`クエリセレクタは、リクエストパス内でワークスペースを特定する必要があります。 不明、不一致、または重複するセレクタは、404エラーで拒否されます。 パネルスクリプトおよびスタイルには、SHA-384整合性メタデータが含まれています。インポートマップは、 import-mapの整合性をサポートするブラウザにおいて、ローカルにインポートされたJSモジュールも対象とします。 動的に生成される言語応答は別途扱われます。これらのチェックは、 配信されたページに対するアセットの置換を検出します。ページ自体とそのハッシュは パネルサーバーから提供されるため、そのサーバーおよび配信経路を保護してください。 **この開始以降のログには**、プロセスログとすべての ワークスペースからのジャーナルアクティビティ(ログイン、拒否、経路変更、オペレーターの操作など)が組み合わされています。これは、 現在のプロセス用のインメモリコンソールであり、すべてのメッセージの恒久的なコピーではありません。 頻繁に発生するメッセージイベントは、コンソールを埋めることなく、ジャーナルに保存されます。 アクセス権の付与、変更、取り消し、およびセッションの開始・終了の際にも、 署名付き`access.*`ジャーナル記録が生成されます。これらの記録にはトークンは含まれません。 発行されたトークンおよびセッション認証情報は、ハッシュ化された状態で暗号化された保管庫に保持されます。 保留中のQRサインインは、それを開始したパネルセッションに属します。 そのセッションを終了または 取り消すか、メインパネルトークンをローテーションすると、サーバー上のその保留中のQR クライアントがキャンセルされます。これは、ブラウザが独自の キャンセルリクエストを送信できない場合にも適用されます。トークンのローテーションにより、メインパネルトークンを直接 使用して開始されたQRサインインもキャンセルされます。別の操作を待機しているQRリクエストは、開始前に 再度アクセスを確認します。完了済みのTelegram認証および別のパネルセッションによって開始された保留中のサインインは 維持されます。 ****メイン管理者および信頼境界**** メイントークンには制限が課されません。これを使用してブラウザにログインすると、 管理者が設定したセッション制限の対象となるセッションが作成されます。メイントークンを 直接送信するスクリプトは、完全なアクセス権を維持し、ブラウザセッションとしてカウントされません。 これは、1つのインストール環境におけるアプリケーションレベルのアクセス制御です。すべてのワークスペースは サーバープロセスを共有しており、ホスト管理者からの隔離は行われていません。メイン トークン、Telegramセッション、署名鍵、およびデータディレクトリは秘密に保持してください。ウィットネストークンは 独立したチェックポイント/健全性認証情報であり、パネルアクセストークンではありません。 --- # Telegram · 接続、プロキシ、およびデータ保護 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/connection/ 認証、自動プロキシプール、IPモード、フォールバックポリシー、外部リクエスト、およびシークレットストレージ。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 認証、自動プロキシプール、IPモード、フォールバックポリシー、外部リクエスト、およびシークレットストレージ。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [導入と復旧](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/) ![展開と復旧](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) このドキュメントでは、TgWitness 0.9.3の動作とその制限について説明します。認証、 ソースへのアクセス、ネットワーク接続、およびキャプチャの完全性は、それぞれ独立した状態です。 サインインの手順、ファイル形式、および複数アカウントについては、 [「アカウントとセッション形式」](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/)から確認してください。イベントポリシーおよび再起動の 動作については、[「収集の仕組み」を](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/)参照してください。 ## 接続設定の手順 In **その他のツール → アカウント → 接続経路**、管理者は以下を選択できます **このアカウント**, **アカウント グループ** または **すべてのアカウント**、その後、ルートを選択してください。 **レビューの選択** 影響を受けた アカウントの一覧を表示します。 **準備と確認** 保存済みのルートを変更することなく、 提案されたルートをテストします。 **チェックした接続を適用する** プレビューを検証し、必要に応じて 監視を一時停止し、ルートを保存して、すでに実行中の監視を再開します。 以前にアイドル状態だったアカウントでは、データ収集は決して開始されません。履歴のダウンロードは 一時停止されたままとなり、別途再開することができます。切り替えを行う前に、アクティブなエクスポートを一時停止してください。 グループの変更では、デフォルトで各アカウントのルートが維持されます。プレビューに意図した変更が 表示されている場合にのみ、そのオプションをクリアしてください。 アプリケーションは各 アカウントの結果を報告します。これは、データベース全体にわたる「すべてか無か」のトランザクションではありません。 切り替えに失敗した場合、そのアカウントは以前の設定に戻ります。再開に失敗した場合は 明示的に表示されます。プレビューは10分後に期限切れとなり、接続 設定やグループメンバーシップの変更には、新たな確認が必要です。 「Apply」は、ルート、 モード、およびポリシーに変更がない場合、成功したプリフライトの結果を最大90秒間再利用します。ただし、管理対象トンネルについては、実行中の プロセスが同一である必要があります。それより古い結果、変更されたトンネルプロセス、および自動MTProxyプールルートについては、 再度チェックが行われます。署名付きアプリケーションレコードには、元のチェック時刻が保持され、 再利用の有無とその経過時間が記録されます。各プリフライトは、一時的な未認証の クライアントを閉じ、コレクターは自身の認証済みセッションを使用して接続します。 | ルート | TgWitnessが管理するもの | | --- | --- | | 直接 | ホストからの接続。外部ホストのVPNは検出も強制もされません。 | | VPN | アカウントごとに1つのフルトンネルWireGuardプロファイルがあり、ローカルのユーザースペースSOCKS5プロセスによって実行されます。ホストインターフェースやドライバはインストールされません。 | | 私のプロキシ | SOCKS5、HTTP CONNECT、またはMTProxyの認証情報。SOCKS5/HTTPフィールドにはURLを入力できます。複数のアカウントを選択すると、入力したプロキシが共有されます。 | | 公開版 MTProto | 既存のプールでは、Telegramルートが割り当てられています。詳細設定で別途適切なプロキシが設定されるまで、外部へのリクエストは無効になっています。 | | WARP | 選択したアカウントごとに個別のローカルトンネルを設定し、WARP登録情報とWireGuardプロファイルをそのアカウントのVaultに保存します。 | 現在のルートの確認では、アカウントのセッションではなく、 新規の認証されていないTelegramトランスポートが使用されます。これは、ルートを経由して アカウントのデータセンターへのトランスポート接続を開き、認証されていないMTProtoの往復通信を 1回行います (`req_pq_multi`);認証キーは生成されず、アカウントも使用されません。 報告される遅延は、その接続時間に往復時間を加えたものであり、チェックでは 両方を別々に記録します。HTTP対応のルートについては、 CloudflareのHTTPSトレースをそのルート経由でリクエストし、報告された出口IP、 国、WARPの状態、およびチェック時刻を表示します。トレースが 「WARPアクティブ」と報告しない限り、WARPの準備は失敗します。これらの事前チェックは、ルートの接続状況と 観測された出口を報告します。アーカイブの取得および 検証結果を通じて、キャプチャされた記録を確認してください。ローカルプロセスが実行されているだけでは、出口チェックの成功とはみなされません。 パネルは、直近5回のチェックの移動平均を保持しています。ルートは、 その平均が5秒を超えた場合、または3回連続で平均を超えた場合に「**遅い」**と判定され、 2回連続でチェックに失敗した場合は「**利用不可」**となります。 `network.slow_route` そして `network.route_recovered` 変更内容を記録します。WARPルートの速度が低下した場合、「**Re-roll WARP」は** そのアカウントのトンネルを他のCloudflare WARPエンドポイントに対して再起動し、 最速のルートを維持するとともに、 `network.warp_rerolled` その前後時刻と共に記録します; **「New WARP identity」**は新しいWARPデバイスを登録し、それが より高速な場合にのみ維持します。ローカルプロキシアドレス、Telegramアカウントおよびそのセッションは 変更されません;Telegram接続は再起動されたトンネルを介して再接続されます。低速なWARP ルートは、最大30分ごとに1回、自動的に再ロールされます;それでも 改善されない場合、それ以降の再ロールはオペレーターの対応を待ちます。 ### ポータブル版WARPおよびWireGuard これは、**非公式のWARP統合**であり、 [wgcf 2.3.1](https://github.com/ViRb3/wgcf/releases/tag/v2.3.1)および [wireproxy 1.1.3](https://github.com/windtf/wireproxy/releases/tag/v1.1.3)を使用しています。 管理者は、最初のダウンロードまたはWARP 登録の前に、設定を明示的に承認します。 これらのセットアップ接続は GitHub および Cloudflare に直接行われ、 マシンの IP アドレスが公開されます。通常のアカウントのトラフィックは、 アプリケーションが起動するまで既存の経路を維持します。Cloudflare が出口アドレスと国を選択します。別々のトンネルでも 同じ出口アドレスを共有できます。この機能では、国の選択、定期的な IP ローテーション、およびホスト全体の VPN キルスイッチは提供されません。 サポートされているヘルパーのダウンロード:LinuxおよびmacOSのx86-64/ARM64、ならびにWindowsのx86-64。 アーティファクトは、レビュー済みのソースに同梱されているSHA-256ハッシュと照合され、 キャッシュされた実行ファイルは起動前に再度チェックされます。 いかなるヘルパーも PATHに追加されたり、システムサービスとしてインストールされたり、パブリックリスナーが割り当てられたりすることはありません。すべてのファイルは ワークスペースの`portable-routes/`ディレクトリおよび暗号化されたボールトエントリ内に格納されます。 ループバックSOCKS5リスナーには、個別に生成された認証情報が必要です。 プライベートプロファイルおよびWARPアカウントの認証情報は、既存の ワークスペースボールトで暗号化されます。実行中、ヘルパーは所有者専用の平文設定ファイルを必要としますが、 通常停止時にはこのファイルは削除されます。ホストがクラッシュした場合、このファイルが 所有者専用のデータフォルダに残されることがあります。これによりディスクが暗号化されるわけではなく、 管理者からの保護もされません。 パネルの親パイプが 消失した場合、スーパーバイザーはトンネルを閉じます。失敗したトンネルは、直接的なフォールバックを有効にすることはありません。パネルを再起動すると 選択されたトンネルが復元され、起動に失敗した場合は、所定の遅延を置いて再試行されます。**Stop tunnel** は監視も一時停止し、停止状態を維持します。**Start tunnel** はトンネルを開始します。準備ができたら、別途監視を再開してください。 アップロードするWireGuardプロファイルには、1つのインターフェースと1つのピア、完全なIPv4 およびIPv6ルートを含める必要があります。また、フック、インクルード、環境変数の置換、余分な リスナーは含めないでください。パブリックエンドポイントアドレスは、起動前に解決および固定されます。 OpenVPN/IPsecおよびプライベートエンドポイントには、外部VPNまたはSOCKS5ゲートウェイを使用してください。 ## 認証方法 **API ID および API ハッシュはアプリケーションを識別するものであり、アカウントへのログインに代わるものではありません。** TgWitness ではこれらはオプションです。優先順位は、フォームに入力されたペア、次に インポートされたアカウント JSON からのペア、次にワークスペースに保存されたペア、そして 50 組の 公開ペアのプールを順に試行し、Telegramが1つを拒否した場合は自動的にローテーションされます。 Telegram Desktopのペア(2040)のみ、対応するTelegram Desktopクライアントの説明とともに送信されます。 [my.telegram.](https://my.telegram.org) orgのAPI開発ツールから取得したご自身のペアは、すべてのアカウントで使用可能です。各アカウントには、引き続き独自の認証が適用されます。 | 方法 | 要件 | TgWitness サポート | | --- | --- | --- | | 電話番号、コード、オプションの2段階認証 | アカウントへのアクセス;APIペアは任意です | パネルへのログイン | | 認証キー(HEX)+DC ID | 512文字の完全なキーおよびDC 1~5 | 「Direct **Auth key」**タブ;認証が保存される前に、オプションのユーザーIDがチェックされます | | Telethon StringSession | 有効なセッション文字列 | パネルへのログイン | | Telethon SQLite`.session` | 完成済みで一貫性のある文章 | スキーマのパネルからの直接インポート 7/8;オプションのオフラインCLI | | Pyrogram SQLite`.session` | 本番環境のユーザーセッションを終了しました | スキーマのパネルからの直接インポート 2/3 | | Telegram Desktop TData ZIP | 最新のアカウント1つ。保護されている場合はローカルパスコード | チェックサムおよび復号化の検証を伴うインメモリ変換 | | アカウントのJSON | サポートされているAPI/セッション/キーフィールド | API認証情報はメタデータのみで自動的に設定されますが、セッション/キーまたは電話番号/QRコードによるログインは依然として必要です。 | | QRコードによるログイン | Telegramの公式アプリによる確認 | ローカルでのQRコード生成、有効期限設定・再試行、オプションの2段階認証 | | TDLib / Pyrogram StringSession | その他のライブラリ固有のフォーマット | 未対応 | | ボットトークン | 独自のアクセス/更新モデルを備えたボット | このコレクターでは使用されていません | Telegramは、SMSを送信するかどうかを含め、コードの配信方法を選択します。APIハッシュでは、 失効したセッションを修復したり、忘れた2FAパスワードを置き換えたりすることはできません。TgWitnessは、 ログインコードやTelegramの2FAパスワードをディスクに永続化しません。 非公開のソースについては、アカウントはすでにアクセス権を持っている必要があります。グループのユーザー名は 不要です。プロキシまたはセッションのインポートによって、メンバーシップや管理者 権限が付与されることはありません。メンバーが参加前の履歴を閲覧できるかどうかは、チャットの設定によって決まります。 ## Telethonのセッションファイルをインポートする Telethon SQLite、Pyrogram SQLite、Telegram Desktop TData は、それぞれ異なる形式を使用しています。 このパネルは、サポートされている構造を検出して変換しますが、ファイル名の変更は 変換には該当しません。「**ファイル**」から 1 つのセッションとその対応する JSON を選択し、**「ファイルを確認」**を押してから、**「アカウントに接続**」を押してください。最大 4 つの一致するファイルと、 合計 8 MiB までが受け入れられます。 TData/JSONの詳細については、[フォーマットの制限を](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/)参照してください。 パスコードの復元機能はありません。電話/2FAまたはQRコードによるログインでは、別途認証が行われます。 オプションの「Telethon専用」コマンドラインパスは引き続き利用可能です: 1. 元のセッションを使用しているクライアントを停止し、一貫性のあるコピーを作成してください。 コンバーターは、WAL/ジャーナルが未完了のファイルを拒否します。チェックを回避するためにそれらのファイルを削除するのではなく、元の クライアントを適切に終了させてください。 2. TgWitness環境から、以下のコマンドを実行してください: ``` python -m tgwitness.sessions account.session --out account.tgwitness-session ``` 1. 「**アカウントの追加」→「ファイル」**で、結果ファイルをアップロードするか、 その文字列を貼り付けて、次に進んでください。 2. 表示されている数値のアカウントIDを確認し、情報源を選択して、監視を開始してください。 **変換されたファイルは、暗号化されていないアカウントアクセス秘密鍵です。** これを保護された ストレージに保管し、決してコミットしたり、第三者の変換サービスに送信したりしないでください。TgWitnessは 認証済みセッションを暗号化された保管庫に保存します。セッションをコピーしても 別の認証が作成されることはありません。クローン化された認証キーを使用してクライアントを同時に実行したり、 独立した更新配信が行われると想定したりしないでください。 変換処理では、元のメッセージやエンティティキャッシュ、あるいは 永続的な更新カーソルではなく、権限のみが転送されます。また、プロセスの再起動を跨いだ更新の復元は行われません。 ## MTProto、Telethon、およびプロキシ MTProtoはTelegramのプロトコルです。Telethonは、TgWitnessが使用するPythonクライアントライブラリです。 MTProxyはTelegramのトランスポートプロキシであり、SOCKS5およびHTTP CONNECTが一般的な トンネルを提供します。いずれもアカウント認証に代わるものではありません。 各ワークスペースのルートは、 **[その他のツール] → [アカウント] → [設定] → [接続設定] → [接続ルートの変更]** ログインする前に 設定してください。新しいワークスペースのデフォルト設定は **自動 MTProxy · 公開リスト** with **アドレスを非表示にする**. 明示的に「Direct」を使用していた既存のワークスペースは、それを許可するモードを維持します。 ファイルの読み取りは、公式 アプリと同様に、メッセージを読み取る接続とは別の接続を介して行われます。アカウントが属するデータセンター内では、そのアカウントの認証キーを 新しいMTProtoセッションで再利用します。別のデータセンターの場合は、アカウントが接続されている間に1つのキーが生成・認証され、 そのキーはメモリ内でのみ保持されます。すべてのファイル接続は、アカウントと同じ経路を 使用します。データセンターごとの接続数は、以下によって制限されます。 **「パラメータ」→「パフォーマンス」→ Telegramデータセンターごとのファイル接続数**; 0 は、アカウントのメイン 接続を通じてのみファイルを読み込みます。1つのインストール環境において、すべてのアカウントを合わせて、同時に確立されるTelegram接続は最大5つまでです 。 ## IPモード ルートによって接続方法が決定されます。パネルの「アカウント」 セクションにある「IPモード」および「**IP保護**」の設定により、サーバーのアドレスが公開されるタイミングが決まります。これらの設定は、 VPNをインストールしたり、マシンからのすべてのトラフィックをルーティングしたりするものではありません。 | モード | Telegram | 外部からのリクエスト | | --- | --- | --- | | アドレスを非表示にする (`hide`) | プロキシをご利用ください。どのプロキシも機能しない場合は、しばらくお待ちください。直接的な代替手段はありません。 | SOCKS5/HTTP が必要です。適切なプロキシがないリクエストは拒否されます。 | | 最終手段としてのダイレクトメッセージ(`fallback`) | 自動MTProxyは、設定された遅延時間が経過した後、Directを使用し、その後、正常に動作しているプロキシに戻る場合があります。 | 設定済みの外部プロキシ、またはアカウントのSOCKS5/HTTPルートの利用を推奨します。それ以外の場合は、「Direct」も許可されます。 | | トンネルまたはVPNを経由したサーバー(`tunnel`) | ダイレクトルートおよび即時自動プールフォールバックが許可されています。 | 該当するプロキシが設定されていない場合は、ダイレクト接続が許可されます。 | トンネルまたはVPNモードでは、そのネットワークを別途管理していることを前提としています。正常に動作する トンネルがない場合、宛先からはサーバー自身のアドレスが見えてしまいます。オプションの名前ではなく、 実際のネットワーク環境に応じてモードを選択してください。 ### ルートを選択してください | ルート | 設定 | 境界 | | --- | --- | --- | | 自動MTProxy | 組み込みのリストまたは演算子カタログ | Telegramの接続経路を正常に維持しています。直接のフォールバックはIPモードによって異なります。 | | 直接 | トンネルモードまたはVPNモード | テレソンは、ホストのネットワーク経路を使用します | | SOCKS5 | ホスト、ポート、オプションのユーザー名/パスワード | python-socks、リモート宛先DNS対応 | | HTTP CONNECT | ホスト、ポート、オプションのユーザー名/パスワード | プレーンなHTTP CONNECTを使用します。プロキシ自体へのTLSは実装されていません。 | | MTProxy | ホスト、ポート、シークレット | 実験的なTelethonトランスポート:32桁の16進数、または`dd`+32桁の16進数 | 偽の TLS `ee` シークレットは拒否されます。Telethon 1.45 の正規化機能では、プレフィックス やドメインを削除できますが、これは偽の TLS を実装するものではありません。`tg://proxy?server=…&port=…&secret=…` または `https://t.me/proxy?server=…&port=…&secret=…` を貼り付け、「**リンクからフィールドに値を入力」**を選択してください。 これにより、接続や保存を行わずにフィールドの検証と入力が行われます。内容を確認し、 ルートは別途保存してください。手動入力用のフィールドは引き続き利用可能です。[Telegramプロキシリンク](https://core.telegram.org/api/links#proxy-links)をご参照ください。 ### インストール時に提供されるパブリックプロキシ この組み込みリストには、 [SoliSpirit/mtproto](https://github.com/SoliSpirit/mtproto)、 [zakky8/mtproto-proxy-pro](https://github.com/zakky8/mtproto-proxy-pro)、 [kort0881/telegram-proxy-collector](https://github.com/kort0881/telegram-proxy-collector)、 [3yed-61/MTP-Collector](https://github.com/3yed-61/MTP-Collector)、 [Therealwh/MTPproxyLIST](https://github.com/Therealwh/MTPproxyLIST)、 [KhodeJav/telegram-proxy-collector](https://github.com/KhodeJav/telegram-proxy-collector) および [tgmtproxy/telegram-mtproto-proxy-list](https://github.com/tgmtproxy/telegram-mtproto-proxy-list)。 同梱のスナップショットには、エンドポイントの情報、ソースの帰属情報、およびダウンロード日が含まれています。 リストは入力情報であり、以下の接続性チェックによって、どのプロキシが使用されるかが決定されます。 **自動MTProxyは**Telegramのトランスポート接続性をチェックし、正常に動作するプロキシを維持し、 障害が発生した場合は別のプロキシに切り替えます。ワークスペースは、十分な数の 正常に動作するエントリが利用可能な場合、異なるプロキシを優先します。プロキシは出口アドレスを共有できます。障害が発生したプロキシは、 再試行する前に待機します。すべてが機能しない場合、IPモードによって、収集を 待機させるか、直接接続を使用できるかが決定されます。 プロキシを変更しても、アカウントは 変更されず、そのジャーナルも消去されません。経路の選択や変更は、署名付きジャーナルに記録されます。 自動ルートが有効な場合、リストは1時間ごとに更新され、転送チェックは デフォルトで10分ごとに実行されます。これらの間隔は設定可能です。**公開リストを更新すると** リフレッシュが要求されますが、リストを閲覧するだけでは、保存済みの手動ルートは変更されません。 **TelegramのトラフィックとHTTPSリクエストは、異なる経路を使用します。**リストのダウンロードには、 別のHTTPS接続と、提供された外部リクエスト経路が使用されます。 `TGWITNESS_PROXY_FEED_PROXY`は、HTTP/SOCKS5プロキシを使用してその経路を明示的に上書きします。 両方のコレクター「Compose」バリアントは、これを転送します。バックグラウンドプールはメインワークスペースに従います。 Telegramのセッション、API認証情報、パネルトークン、ボットトークンは、フィードプロバイダーには送信されません。 プロバイダー名、スナップショットの日付、およびダウンロード経路は、**「リストの出典」**の下に表示されます。 MTProxyはTelegramのトラフィックのみを伝送します。タイムスタンプ、 通知、オフサイトコピー、ソースチェックなどのワークスペースのHTTP操作は、 設定されている場合は別のSOCKS5/HTTPプロキシを使用し、設定されていない場合はアカウントのSOCKS5/HTTPルートを使用します。どちらの設定もない場合、「Hide the address」は リクエストを拒否します。その他のモードでは「Direct」が許可されます。外部リクエストは無効にできます。明示的に 設定されたフィードダウンロードプロキシは、引き続き個別のオペレーターによるオーバーライドの対象となります。 独立したウィットネスサービスは、独自のルートを維持します。 オペレーター管理のプライベートサービスの場合、既存のサーバー環境設定「 `TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1`」により、プライベート宛先が許可され、 プロキシ側でのホスト名解決が維持されます。この設定はパネルからは有効化できません。「パブリック専用」 モードでは、パブリックリゾルバーにクエリを送信する前に`.onion`宛先を拒否します。Torオニオン サービスを利用するには、明示的なプライベート宛先設定と適切なプロキシが必要です。 この DNS の動作は、Telegram のトランスポートではなく、外部 HTTP 操作に適用されます。 Cloudflare は、[JSON DNS エンドポイント](https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/)について文書化しています。 ****自動プールパラメータ**** [**その他のツール] → [パラメータ] → [自動MTProxy]** で、失敗閾値、クールダウン、 計画的なローテーション、プロキシの共有、および許容されるフォールバック遅延を設定してください。 | 制御 | デフォルト | | --- | --- | | 置換前に接続を切断します | 3件を10分以内に | | 接続試行ごとに試行されたプロキシ | 3 | | 初回/障害発生後の最大再試行回数 | 10分 / 6時間 | | 予定されているローテーション | 無効化済み;失敗時に有効化 | | プロキシごとのアカウント数 | 0:個別のエントリを優先し、必要に応じて共有する。排他的なエントリを待つ場合は 1 に設定する。 | | 許可されるダイレクトフォールバックまでの遅延時間 | 所要時間:10分;「アドレスを非表示にする」を選択しても、Directへのアクセスは依然として拒否される | | フィードの更新/転送チェック | 60 / 10分;メインワークスペースの値は共有プールに適用されます | 異なるプロキシが1つの出口アドレスを共有できる場合があります。Telegramの制限はすべてのルートに適用されます。 公開リストを独自のオペレーターカタログに置き換えるには、以下のオーバーライドを設定してください。 これにより、`proxies`配列が空の場合を含め、外部サブスクリプションが完全に無効化されます。 [空のカタログを](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proxies.config.example)`proxy-config/proxies.json` にコピーし、デプロイ済みのパブリックエンドポイントを追加してください: ``` {"format": "tgwitness-proxy-catalog-v1", "proxies": [ {"id": "project-eu", "label": "Project EU", "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"} ]} ``` 例示された値は置き換える必要があります。最大32件の異なるエントリが受け入れられます。 認証済みリストは、共有秘密鍵なしでラベル/ホスト/ポートを返します。いずれかを選択すると、 その認証情報がワークスペースの保管庫に保存されます。明示的なトランスポートテストが行われるまでは、 可用性は未検証のままです。カタログの形式が不正な場合は、手動での設定が可能となります。 ネイティブ起動:`TGWITNESS_PROXY_CATALOG`をローカルのJSONパスに設定してください。Docker: ``` docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build ``` オーバーレイは`proxy-config`を読み取り専用でマウントします。ファイルはコンテナのUID 10001から読み取り可能である必要があります。 当該ディレクトリは、Git、Dockerのビルドコンテキスト、およびソースアーカイブから除外されています。この カタログは収集アカウントを設定するものです。[Witnessボットは](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/)、MTProxyではなく、独自の HTTP/SOCKS5ルートを使用します。 直接フォールバックは、上記のIPモードによって制御されます。ルートを変更する前に、 監視を一時停止してください。保存を行うと、古いクライアントは切断され、未完了のログインはキャンセルされます。 新しいクライアントは、保存されたルートを使用します。アカウントのジャーナルとセッションの紐付けは維持されます。 設定を変更すると、以前のルートが上書きされます。編集する際は、プロキシの認証情報を再入力してください。 認証情報は`network.enc`で暗号化されています。APIはユーザー名、 パスワード、またはシークレットを返しません。署名付きレコードには、ルートタイプと認証情報の 有無が含まれていますが、エンドポイントやシークレットは除外されています。オペレーターはパネル上で エンドポイントを確認できます。シークレットフィールドは、保存、ロック、またはワークスペースの切り替え後に消去されます。 **「Telegram接続のテスト」**は、ログイン前でも利用可能で、ルートを経由して一時的な 非認証のTelegram接続を開閉します。IPチェック サイトには接続しません。テストに成功しても、グループへのアクセス、完全な 配信、または匿名性が保証されるわけではなく、単にトランスポート接続が確立されたことを示すものです。 このプロキシは、Telegram DCからのメディア ダウンロードを含め、Telegramクライアントの接続に適用されます。ブラウザ、pip、SSH、および手動で起動されたTSAツールには、それぞれ別の経路が設定されています。 プロキシのホスト名はローカルで解決される場合があります。`rdns`は宛先のホスト名に影響を及ぼしますが、 Telegramは多くの場合、数値のDC IPアドレスを提供します。 SOCKS5およびプレーンなHTTP CONNECT自体は、プロキシの認証情報や クライアントからプロキシへのトンネルを暗号化しません。MTProtoはTelegramのトラフィックを別途保護します。信頼できないネットワーク上では、 プロキシへの適切なセキュアチャネルを使用してください。プライベートグループは 転送中にMTProtoによって保護されるクラウドチャットです。エンドツーエンドのシークレットチャットは別のチャット タイプであり、[シークレットチャットモジュール](https://phishdestroy.io/tgwitness/ja/docs/reference/secret-chats/)によって記録されます。 ## 暗号化と署名 | レイヤー | 実装済み | 運用者の責任 | | --- | --- | --- | | Telegramの通信量 | Telethon MTProto | プラットフォームの信頼性、経路、および可用性 | | Webパネル | ベアラー・トークン、ループバックのデフォルト設定、リクエスト制限 | リモートアクセスにはHTTPSまたはSSHトンネルをご利用ください | | 秘密 | API 認証情報、セッション、プロキシ認証情報、および署名用秘密鍵を管理するための Fernet | 復号鍵と稼働中のホストを保護してください | | Vaultキー | 新規インストール用のローカルキー、または外部マスターキー | 保護されたストレージと鍵のバックアップを分離 | | メッセージと添付ファイル | プレーンテキスト形式でのアプリケーションデータ保存 | 暗号化されたディスク/ボリューム | | ZIP/JSONL/CSV/HTML | 整合性チェックを実施しており、コンテンツの暗号化は行われません。 | エクスポートされたコピーや転送データの保護 | | 出所と時刻 | 署名付きジャーナル、プロセス受領証、RFC 3161 対応ツール | 信頼できる鍵、独立したチェックポイント/TSA、および保管手順 | 「アカウント」の**「ストレージ保護」**には、これらの状態が表示されます。パネルトークンは アクセスシークレットであり、暗号化パスワードではありません。これにより管理者権限が付与され、 [発行された](https://phishdestroy.io/tgwitness/ja/docs/reference/access/)トークンはアカウントやチャットごとに範囲を限定することができます。ワークスペースは ホストプロセスを共有しており、独立したテナントではありません。 BitLocker、LUKS、FileVault、または管理対象の暗号化ボリュームは、 それぞれの脅威モデルに基づいてストレージを保護することができます。 ロック解除され、稼働中のマシンの管理者は、 依然としてデータを読み取ることができます。ストレージの計画には、SQLiteのWAL/SHM、メディア、一時的なエクスポートデータ、スワップ領域、バックアップ、 およびブラウザのダウンロードデータを含めてください。Dockerボリュームは、単に ボリュームであるという理由だけで暗号化されるわけではありません。 ## 外部マスターキー **新規**インストールを行う場合は、マスターキーをデータディレクトリの外に配置してください。 これにより、既存のローカルキー保管庫が自動的に移行されるわけではありません。サービスIDのみがアクセス可能なキー ディレクトリを用意し、以下のコマンドを実行してください: ``` python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key python -m tgwitness --data-dir /private/observations/new-case ``` PowerShell(インストール済みのプロジェクト環境を使用): ``` python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key $env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key' python -m tgwitness --data-dir E:\PrivateData\new-case ``` Dockerでは、ファイルを`/data`の外側(例えば `/run/secrets/tgwitness-master.key`)に読み取り専用でマウントし、環境変数をそのパスに設定してください。 サービスUIDは、そのファイルを読み取れる権限を持っている必要があります。キーバイトではなく、パスを 環境変数または設定ファイルを介して渡してください。 各ワークスペースには、ランダムなパブリックソルトと、 HKDF-SHA256を通じて導出された独自のFernetキーが割り当てられます。`vault.external.json`には、マスターキーではなく、導出メタデータが保存されます。 キーが欠落している、または間違っている場合、自動的に置き換えられることなく起動に失敗します。復旧のために、 ソルトのメタデータとマスターキーの両方を保管しておいてください。 すべてのワークスペースは同一のマスターキーから派生しており、その秘密鍵が漏洩すると、 インストール全体に影響が及びます。実行中のプロセスは秘密情報を復号化できます。これはHSMや パスワードKDFではありません。ランダムな鍵の代わりに、任意のユーザー設定のパスワードは使用できません。 意図的な移行が 実施され、検証されるまでは、既存のインストール環境については既存の鍵を維持してください。`vault.key`を削除したり、マスターキーを置き換えたりすると、 セッションや署名鍵へのアクセスが失われる可能性があります。暗号化されたバックアップと鍵は別々に保管し、 隔離されたインスタンスで復旧テストを行ってください。 --- # Telegram · 導入 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/ TgWitnessは、Windows、Linux、macOS、またはDocker上で、HTTPS経由でサービスとして実行でき、バックアップや更新機能も備えています。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) TgWitnessは、Windows、Linux、macOS、またはDocker上で、HTTPS経由でサービスとして実行でき、バックアップや更新機能も備えています。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![展開と復旧](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) **英語** · [Русский](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/DEPLOYMENT.md) · [ウクライナ語](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/DEPLOYMENT.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/DEPLOYMENT.md) · [ポルトガル語(ブラジル)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/DEPLOYMENT.md) · [Türkçe](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/DEPLOYMENT.md) · [アラビア語](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/DEPLOYMENT.md) · [فارسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/DEPLOYMENT.md) · [ウルドゥー語](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/DEPLOYMENT.md) · [ヒンディー語](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/DEPLOYMENT.md) · [インドネシア語](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/DEPLOYMENT.md) · [Tiếng Việt](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/DEPLOYMENT.md) · [簡体字中国語](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/DEPLOYMENT.md) ## インストール方法を選択してください ポータブルパッケージをご利用の場合は、GitHub Releasesから`TgWitness--windows-amd64-portable.zip`を解凍してください。 その他の方法をご利用の場合は、ソースのZIPファイルをダウンロードして解凍するか、リポジトリをクローンし、 プロジェクトディレクトリから以下のコマンドを実行してください: | インストール | はじめに | バックグラウンドで動作しますか? | | --- | --- | --- | | Windows用ポータブルパッケージ | `TgWitness.cmd` | いいえ、ウィンドウは開いたままにしておいてください。 | | Windowsネイティブ版 | `Start.cmd` | いいえ。バックグラウンドでの使用には、オプションのログオンタスクをご利用ください。 | | Linux/macOSネイティブ | `sh start.sh` | いいえ。バックグラウンドでの実行には、systemd または launchd を使用してください。 | | サポートされているあらゆるホストでのDocker | `docker compose up -d --build --wait` | はい、Dockerデーモンが実行されている間は可能です。 | | Windows 版 Docker ヘルパー | `scripts\Docker.cmd` | はい。このヘルパーは、Webサーバーの稼働状態を確認します。 | | Linux/macOS 用の Docker ヘルパー | `sh scripts/docker-start.sh` | はい。このヘルパーは、Webサーバーの稼働状態を確認します。 | 第三者が確認可能なクラウドサーバーについては( プロバイダーのAPIを通じて作成され、SSHを使用せず、Cloudflare Tunnel経由でのみアクセス可能なもの)、 [高保証デプロイメント](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/)をご覧ください。 ネイティブ起動時には、プライベートな`.venv`が生成され、ピン留めされた依存関係がインストールされます。 Dockerは、ホスト側のPythonを必要とせずに、イメージ内でこれらをビルドします。初回 セットアップにはインターネット接続が必要です。 Python 3.11 以降が見つからない場合、`Start.cmd` は、 現在の Windows ユーザー向けに Python 3.12 をインストールする前に確認を行います(winget を使用、それ以外の場合は Python Software Foundation の署名を確認した上で python.org の インストーラーを使用)。管理者権限を要求することは 一切ありません。Docker および OS サービスは引き続き前提条件となります。 ネイティブおよびポータブルインストールでは、フォルダ内の`data/live`を使用します。Dockerでは、`tgwitness-data`という名前のボリュームを `/data`で使用します。これらは、データディレクトリ全体を意図的に移行するまでは、 別々のインストールとして扱われます。新しいDockerコンテナがネイティブの アカウントを自動的に検出することは期待しないでください。 ## インストール要件 ネイティブインストールには、`venv`および`ensurepip`を含むPython 3.11以降、 最初の依存関係のインストールに必要なインターネット接続、および `.venv`用の書き込み可能なプロジェクトディレクトリが必要です。同梱のパネルには、Node.jsやフロントエンドのビルドは不要です。ランチャーは 通常のOSアカウントから実行してください。TgWitnessでは管理者/root権限は必要ありません。 - **Windows:**`Start.cmd`は、まず`py -3`、次に`python`、さらにユーザーごとのデフォルトのインストールフォルダおよび 「Program Files」フォルダを順に確認し、バージョン3.11以降が必要です。いずれも見つからない場合は、 前述のユーザーごとの自動インストールが提案されます。`py -3 start.py`も動作します。 ポータブル版パッケージは、Pythonを一切必要としません。 - **Linux:**`start.sh`が`python3.13`、`python3.12`、`python3.11`、`python3`、および `python`を試行し、該当するものがない場合は、apt、dnf、pacman、zypper、apk、またはHomebrew用の インストールコマンドを表示します。Debian/Ubuntuでのインストールでは、選択したインタプリタに対応する `python3-venv`パッケージが必要になる場合があります。 ディストリビューションの古い デフォルトのPythonは、Python 3.11以降に置き換えるか、それを補完する必要があります。 - **macOS:**最新の Python 3.11 以上のディストリビューションをインストールしてください。OS に付属の インタプリタが要件を満たしているとは想定しないでください。プロジェクトディレクトリ内の `python3 start.py` を使用してください。 - **Docker:**Compose v2.20 以降を搭載した Docker Engine/Desktop をご利用ください。Windows 上で Docker Desktop を使用する場合は、Linux コンテナを使用する必要があります。コンテナは 独自の Python 依存関係をインストールするため、ホスト側で別途 Python をインストールする必要はありません。 ## ローカルコンピュータ Windowsでは「`Start.cmd`」、Linux/macOSでは「`sh start.sh`」をご使用ください。「`scripts\Setup.cmd`」または 「`sh start.sh --setup-only`」を実行すると、 環境が準備されます。ランチャーは初回使用時に依存関係をインストールし、その後の起動時には その環境を再利用します。セットアップおよびTelegramのデータ収集にはインターネット接続が必要ですが、 既存の記録の閲覧やエクスポートの作成はオフラインでも可能です。 セットアップ後に`python start.py --check`を実行すると、コレクターを起動せずに、ローカルの依存関係、Ed25519、 ストレージ、鍵の設定、およびリスニングアドレスを確認できます。 構造化された出力を得るには、`--json` を使用してください。`--data-dir`、`--host`、および `--port` を実行してください。このチェックでは、パッケージのインストール、ジャーナルの作成、Telegram への接続は行われません。 また、完全性やカバレッジの検証を行うものでもありません。起動時には、既存のジャーナルが別途検証されます。 `python start.py --help` もインストールを回避します。 start.py を実行した後、Windows では `.venv\Scripts\python.exe`、Linux/macOS では `.venv/bin/python` を使用して補助コマンドを実行するか、まずその環境を有効にしてください。 以下の `python -m ...` の例では、環境が有効になっていることを前提としています。 ``` python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787 ``` 環境変数:TGWITNESS_DATA、TGWITNESS_HOST、TGWITNESS_PORT、TGWITNESS_TOKEN。 TGWITNESS_VAULT_KEY_FILE は、新規インストール時に外部キーモードを選択します。「[外部マスターキー」](https://phishdestroy.io/tgwitness/ja/docs/reference/security/#external-master-key)を参照してください。 TGWITNESS_TOKEN を指定する場合は、24文字以上でなければなりません。暗号学的に ランダムな値を使用してください。指定しない場合、アプリは panel-token.txt に 256 ビットのランダムなトークンを生成します。 環境変数による上書きでは、そのファイルは上書きされません。資格情報をローテーションするには、再起動してください。 データディレクトリを所有できるプロセスは、正確に1つだけです。クロスプラットフォームのOSファイルロックにより、 意図しない同時書き込みが防止されます。Uvicornワーカーは1つ使用してください。パネルでは、任意の数の ワークスペースを管理でき、追加のワークスペースディレクトリは profiles// 配下に配置されます。 別々のサービスインスタンスについては、別々のディレクトリとポートを使用してください。SQLiteのWALファイルは、ネットワークファイルシステムではなく、 ローカルの永続ストレージに保存してください。レプリカ間で1つのボリュームを共有しないでください。 ## Windows用ポータブルパッケージ 各GitHubリリースには、`TgWitness--windows-amd64-portable.zip`およびその `.sha256`が含まれています。これには、python.orgからの公式の埋め込み可能なPython 3.12ランタイム (`tools/build_portable.py`でチェックサムが固定されています)、TgWitnessおよびその固定された依存関係、 ならびに3つのランチャーが含まれています: | ファイル | 目的 | | --- | --- | | `TgWitness.cmd` | パネルを起動します。追加のオプションはそのまま渡されます(例:`TgWitness.cmd --port 8790`)。 | | `TgWitness-Demo.cmd` | `data\demo`で合成デモを開始してください | | `TgWitness-Check.cmd` | 起動せずに準備状況チェックを実行してください | 固定されたロシア語形態素辞書とPDFカラープロファイルは、 オフラインで使用できるようバンドルされています。パッケージングでは、依存関係の `data`ディレクトリ内にある既知のファイルパスのみが許可されており、これらのディレクトリに予期しないファイルが存在するとビルドに失敗します。 アーカイブ全体を、`Documents\TgWitness` などの書き込み可能なフォルダに解凍してください。ZIP ファイル内や Program Files フォルダ内から 実行しないでください。ランタイムは隔離されたモジュールパスを使用するため、 他の Python インストールや `PYTHONPATH` が影響を与えることはありません。 データは パッケージ内の`data`フォルダに保存されます。更新するには、TgWitnessを停止し、新しいバージョンを新しい フォルダに解凍してから、`data`フォルダをコピーしてください。 Python 3.12 を使用して、64 ビット版 Windows 上でご自身でビルドするには: ``` python tools/build_portable.py ``` ## コンテナ ``` docker compose up -d --build --wait ``` これにより、/data 用の名前付き永続ボリュームが作成されます。 Web ポートは 127.0.0.1:8787 にマッピングされます。プロセスは UID 10001 として実行され、 権限が制限され、読み取り専用のルートファイルシステム、および書き込み可能な /data と /tmp を持ちます。 `--wait` は、戻り値を返す前に Web サーバーの正常性を確認します。Telegram の認証および 配信状況はパネルに表示されます。提供されているヘルパーは、ビルド後に 180 秒の 準備完了タイムアウトを使用します。初期の依存関係のダウンロードには、それ以上の時間がかかる場合があります。 両方のベース Compose ファイルはプロジェクト名「`tgwitness`」を使用しているため、新しいリリースを 別のディレクトリに展開しても、自動的に新しいデータボリュームが選択されることはありません。そのプロジェクトについては、 1つのデプロイメントのみをアクティブにしておいてください。独立したインストールを行う場合は、一意の「 `docker compose -p NAME ...`」と異なるホストポートを使用し、更新時にも両方を維持してください。 異なるプロジェクト名を使用している古いデプロイメントについては、元の 名前を`-p`と組み合わせて引き続き使用してください。`docker compose ls`には既存のプロジェクトが一覧表示されます。 `deploy/env.example`を`.env`にコピーし、`TGWITNESS_PORT`を変更して別のループバック ポートを使用するようにしてください。例えば、`TGWITNESS_PORT=8788`ではパネルが `http://127.0.0.1:8788`で公開されますが、コンテナは引き続き8787番ポートでリスニングします。`.env`はGitで無視されています。 初期トークンを取得する: ``` docker compose exec tgwitness cat /data/panel-token.txt ``` 便利なコマンド: ``` docker compose ps docker compose logs --tail 100 -f docker compose stop docker compose up -d --wait ``` `restart: unless-stopped`は、クラッシュやDockerデーモンの 再起動後にコレクターを再起動します。Linuxサーバーでは、お使いのディストリビューションのサービス マネージャー(通常は`sudo systemctl enable --now docker`)を使用して、起動時にDockerを有効にしてください。Windows/macOSでは、 Docker Desktopの「サインイン時に起動」設定を有効にしてください。デスクトップのサインアウト、スリープ、または停止された Dockerデーモンの停止は、データ収集を中断させる可能性があります。明示的に停止されたコンテナは、 再度起動するまで停止したままとなります。 この設定例では、/tmp ボリュームの上限は 512 MiB に設定されています。エクスポートの構築では、 代わりに、永続的な /data 上の各ワークスペースの `temporary-exports/` ディレクトリを使用します。そこでは、 同時エクスポート、ジャーナル/WAL の増加、メディア、およびバックアップ用にスペースを確保してください。 ランチャーは deploy/constraints.txt を使用して、条件を満たすランタイム依存関係のバージョンを固定します。 Docker および高信頼性サーバーは、deploy/requirements.lock および deploy/build.lock に基づき、pip --require-hashes オプションを使用してインストールされます。すべてのパッケージファイルは、コミットに記録された SHA-256 と 一致する必要があります。そのため、PyPI やミラーサイトで置き換えられたファイルは拒否されます。 ソースのみを 提供するパッケージ(jieba、pyaes)は、ランチャー、Windows ポータブルビルダー、および Dockerfile によって、 deploy/build.lock に固定された setuptools を使用して(`--no-build-isolation`)ビルドされるため、 pip は別途の、固定されていないビルド環境を解決することはありません。 Pythonベース イメージおよびオペレーティングシステムパッケージについては、引き続き個別のリリース認定が必要です。 ジャーナルと鍵を破棄する意図がない限り、`docker compose down -v` を使用しないでください。 コンテナのヘルスレポートは、Webサーバーの稼働状況を報告するものであり、Telegramのキャプチャが成功したかどうかを示すものではありません。 パネルのコレクターの状態、ハートビート、エラー、およびカバレッジイベントを確認してください。 ### 独立した証人プロフィール オプションの`witness`サービスは、独自の コンテナ内で[独立したウィットネス](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/)を実行し、`witness-data`ボリューム内に独自のキーとジャーナルを持ち、コレクターに対しては読み取り専用の ウィットネストークンのみを付与します。パネル内の「**その他のツール」→「エクストラ」→「独立したウィットネス**」でトークンを作成し、 ボットトークンとチャンネルを`.env`に追加してから、プロファイルを起動してください: ``` docker compose --profile witness up -d # deploy/compose/compose.image.yaml: same flag docker compose logs witness # witness key fingerprint ``` 本サービスは、Composeネットワーク内のコレクター(`http://tgwitness:8787` )にアクセスします(`TGWITNESS_WITNESS_COLLECTOR` で上書きされます。例えば、`/profiles/` は 別のワークスペース用です)。他者が運営する別のサーバー上のウィットネスをご利用の場合は、 そこで`deploy/compose/compose.witness.yaml` を使用し、`TGWITNESS_WITNESS_COLLECTOR` をコレクターのHTTPS アドレスに設定してください。そのファイルにはウィットネスのみが含まれています。 ## 公開されているイメージをインストールする `deploy/env.example`を`.env`にコピーしてください。`TGWITNESS_IMAGE`には、公開版を指定してください。その際、 リポジトリパスは**小文字で**指定してください。例: ``` TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3 TGWITNESS_PORT=8787 ``` `compose.yaml`の代わりに、このファイルを単独で実行してください: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt ``` ホスト側でソースからのビルド、Python、またはコンパイラは必要ありません。リリースワークフローは、 Docker DesktopのLinux VMを含む、Linux AMD64およびARM64コンテナを対象としています。 ワークフローの概要にあるバージョンタグ、または「`ghcr.io/owner/repository@sha256:...`」をご利用ください。 「`latest`」タグの移動や、無人でのアプリケーションアップグレードは設定されていません。 プロジェクト名が一致する場合、イメージとソースのバリアントは同じデータボリュームを使用します。 ## サーバーでのHTTPSの自動設定 Dockerが動作するサーバー、ご自身が管理するドメイン、および永続的なローカルストレージをご用意ください。 ドメインのA/AAAAレコードをサーバーに向けるように設定してください。IPv6がサーバーに到達する場合にのみ、AAAAレコードを公開してください。 証明書の発行のために、着信TCP 80および443、ならびに発信DNS/HTTPSを許可してください。 これらのポートは、他のサービスによって既に使用されていない必要があります。 `deploy/env.example`を`.env`にコピーし、スキームやパスを含めないホスト名を設定してください: ``` TGWITNESS_DOMAIN=watch.your-domain.org ``` HTTPSオーバーレイを使用してソースのビルドを開始します: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt ``` ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait ``` 公開用画像の場合は、代わりに最初のファイルとして「`deploy/compose/compose.image.yaml`」を使用してください。 後のステータス、ログ、更新、および停止コマンド用に、「`-f`」の引数は両方とも保持しておいてください。 Caddyは証明書の取得と更新を行い、HTTPをHTTPSにリダイレクトし、 プライベートなComposeネットワーク上のコレクターへリクエストを転送します。証明書の状態は 専用の永続ボリュームに保存されます。コレクターの直接ホストポートは、ループバック専用に保たれます。 提供されているCaddyの設定では、アクセスログの記録は有効になっていません。 `https://watch.your-domain.org` を開き、パネルトークンを入力してください。準備状況の確認 はコンテナを対象とします。証明書の発行および外部からの到達可能性は、DNS およびファイアウォールに依存します。HTTPSが利用できない場合は、DNS、ファイアウォールルール、および以下を確認してください: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy ``` 提供されているCaddyイメージは、`2-alpine`タグに従っています。pullコマンドを実行すると、そのイメージが更新されます。 インフラのバージョンを固定する必要がある場合は、テスト済みのダイジェストをデプロイメントにピン留めしてください。 ## 更新とバックアップ アップデート後も「Compose」プロジェクト名とデータ量を維持します。まず、 コレクターを停止し、完全なバックアップを作成してください。デフォルトのソースベースのデプロイメントの場合: ``` docker compose stop docker compose cp tgwitness:/data ../tgwitness-backup-before-update ``` リポジトリ外で、毎回新しいバックアップ先を使用し、それを アカウントへのアクセス権限が必要な資料として保護してください。例示されているパスはあくまで参考です。ご自身のプライベートなバックアップ 場所をご利用ください。隠しファイル、すべてのワークスペース、鍵、 ジャーナル、メディアを含め、ディレクトリ全体をコピーしてください。設定されている場合は、外部ボールトのマスターキーも別途バックアップしてください。 証拠用ZIPファイルは、復元可能なアプリケーションのバックアップではありません。HTTPSの場合、 証明書やアカウントの状態を保持する必要がある場合は、Caddyのボリュームも保存してください。 ソースからのデプロイを行うには、新しいリリースファイルを入手し、以下のコマンドを実行してください: ``` docker compose up -d --build --wait ``` イメージを展開する場合は、`TGWITNESS_IMAGE` を希望のバージョンに変更し、以下のコマンドを実行してください: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait ``` 前述の停止/コピーコマンドについても、インストール先の Compose ファイルをご利用ください。 `.env`、カスタム設定、および同じプロジェクト名はそのまま維持してください。`down`は名前付き ボリュームを保持し、**`down -v`**は**それらを削除します**。`.venv`を異なるオペレーティングシステム間 またはPythonバージョン間でコピーしないでください。ネイティブアップデートを行う場合は、TgWitnessを停止し、データ ディレクトリ全体をバックアップした後、ソースファイルを置き換え、起動前に`python start.py --setup-only`を実行してください。 更新後に、パネルのアクセス権、アカウントの識別情報、観測状態、およびカバレッジを確認してください。 再起動後、TgWitnessは保存されたTelegramの更新位置から再開し、 更新中に見逃した更新をリクエストします。将来のバージョンでストレージ形式が変更された場合、 ロールバックには更新前のバックアップが必要になる可能性があります。 ## リモートサーバー サービスをループバックに限定し、SSHトンネルを使用するか、HTTPSを リバースプロキシで終端させてください。基本のComposeファイルはローカルのみに対応しています。オプションの `deploy/compose/compose.https.yaml`オーバーレイは、設定されたドメイン向けにCaddyを提供します。 ベアラートークンは、URLやプロキシログに含めないでください。リバースプロキシでは、 リクエストサイズと接続レートを制限する必要があります。プレーンなHTTPをインターネットに公開しないでください。 [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) ディレクトリには、systemd、Windows ログオンタスク、macOS ユーザーエージェント、および Caddy の例が 用意されています。インストール前に、それらのパスを確認・調整してください。 これらはテンプレートであり、ローカルで実行されるプラットフォーム固有の設定ではありません。通常のランチャーでは、 バックグラウンドサービスやタスクは登録されません。 Windowsでは、ウィンドウなしの`pythonw.exe`起動時、起動時およびサーバーの診断情報は データディレクトリ内の`logs/server.log`に保存されます(1ファイルあたり5 MiB、ローテーションされたバックアップが2つ)。 コンソール起動時には、コンソールログが保持されます。どちらの モードでも、HTTPアクセスログの記録は無効になっています。ログはデータディレクトリと共に保護し、共有する前に内容を確認してください。 ## 再起動とデータ欠落 最後に要求された監視状態は保持されます。監視がアクティブだった場合、 起動時に再接続を試み、選択された情報源の監視を再開します。手動で一時停止すると、 その設定は解除されます。再起動に失敗した場合は記録され、パネルに表示されます。 TgWitnessは、アカウントおよび各チャンネルに対するTelegramの更新位置 (pts、qts、seq、date)をワークスペースのボールトに保存し、次回の起動時に復元します。 その後、クライアントはプロセスが停止していた間に見逃した更新をリクエストし、 定期的な再チェックによって見逃したメッセージを回復するとともに、Telegramが もはや返さない保存済みのメッセージを記録します。ダイアログは起動時に再読み込みされます。 起動のたびに、前回の ジャーナルヘッド、オフライン境界、および再開時の更新位置が記録されます。 モニターは10秒ごとに接続状態を確認し、1分ごとにハートビートを追加します (**[その他のツール] → [パラメータ] → [Liveness record every]**)。 接続切断や通信のない期間は、その理由とともにカバレッジのギャップとして記録されます。 履歴のスナップショットは、ライブレコードの隣に個別の「現在の履歴」観測値として保存されます。 メディアクイーは各ワークスペースのSQLiteデータベースに格納されます。メッセージとそのジョブは アトミックにコミットされます。実行中に中断されたジョブは、起動時にリトライできるよう復旧されます。 各ダウンロードには、120秒の基本タイムアウトに加え、そのサイズに応じた256 KiB/sでの処理時間が加算され、 添付ファイルの種類ごとに1~2,000 MiBの上限があります。タイムアウト、速度、再試行回数は**「その他のツール」→「パラメータ」**で設定可能です。コレクターは サイズが不明なファイルをスキップします。一時停止しても、キューに格納された作業は保持されます。再試行では、元の 観測されたファイル記述子が使用され、その後編集されたメッセージの最新バージョンは決して使用されません。 一時的な障害に対する再試行回数には上限があります。メディアのFloodWaitによる一時停止は、再起動後も維持されます。 メディアの復旧はTelegramの更新復旧とは別であり、消失したファイルを復元することはできません。 ## バックアップ、復元、および容量 `tgwitness backup FOLDER` は、パネルの稼働を継続したままデータディレクトリをコピーします。 まずチェックポイントをコピーし、次にオンラインバックアップAPIを介してSQLiteファイルをコピーし、その後キー、メディア、 プロファイルをコピーするため、コピーされたチェックポイントがコピーされたジャーナルよりも新しいということはありません。`backup-manifest.json` には、各ファイルのSHA-256とジャーナルのヘッダーが一覧表示されます。 復元するには、TgWitnessを停止し、 データディレクトリ全体をそのフォルダと置き換えます。次回の起動時に、ジャーナルが古いコピーから復元されたことが 記録されます。この記録では、ジャーナルがデータディレクトリ外のフォルダであるTGWITNESS_STATE_DIR( `TGWITNESS_STATE_DIR` )に保存されているヘッダーと比較されます。具体的には、 Compose内の`tgwitness-state` ボリューム、systemdユニット内の`/var/lib/tgwitness-state` 、それ以外の場合はユーザーのローカル状態フォルダ です。書き込み可能な状態フォルダがない場合、復元は検出されず、ログに一度その旨が記録されます。 このコマンドを実行しない場合は、vault.key、 signing.enc、credentials.enc、SQLiteデータベース/WALファイル、メディア、トークン、チェックポイント、 およびすべてのprofiles/サブディレクトリを含む**データディレクトリ全体を**コピーする前に、プロセスを停止してください。 復元 は、宛先サービスが停止している間に完全なコピーを復元してください。Vaultキーの欠落や 署名キーの不一致があると起動に失敗します。アクセスを強制するためにキーを再生成しないでください。 秘密のバックアップは暗号化し、アクセス制御を行ってください。証拠用ZIPファイルはポータブルであり、 アプリケーションのバックアップやTelegramセッションのバックアップではなく、証拠資料そのものを確認してください。 自動的な保存期間満了による削除機能はありません。すべてのメッセージ、生 メタデータ、メディア、一時的なエクスポートデータ、およびバックアップを保存するためのディスク容量を確保してください。 ジャーナル全体を読み込む代わりに、起動時の検証とストリームレコードのエクスポートを実行します。 エクスポートは読み取り用スナップショットを固定しますが、新しいWALへの書き込みは継続可能です。長時間実行されるエクスポートでは WALページが保持されるため、ディスク容量は依然として重要です。 ZIPファイルは、独立した検証ツールのデフォルト設定に合わせて、非圧縮時4 GiB に制限されています。**「More tools」→「Parameters」→「Largest signed ZIP」** で上限を引き上げることができ、そのようなアーカイブは`verify.py --max-gib N`で検証されます。他のフォーマットにはイベント数の制限はありません。 対応しているブラウザは、ユーザーが選択したファイルにレスポンスのチャンクをストリーム配信します。その他のブラウザは 最大128 MiBまでバッファリングし、それ以上の転送は認証済みのCLIに転送されます: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` 別のワークスペースの場合は**「Exports → Workspace ID」**から `--profile ID` を、 リモートサーバーの場合は `--format zip|jsonl|csv|html`、`--url https://your-server` を、 5 GiB の転送制限を変更する場合は `--max-mib` を使用してください。プレーン HTTP は ループバックの場合にのみ許可されます。トークンはヘッダーで送信され、リダイレクトは拒否され、既存のファイルは 上書きされず、ダウンロードが未完了のファイルは完了したファイルとして公開されません。 TGWITNESS_TOKENが生成されたトークンを上書きする場合、その有効な値を含む、別途保護されたファイルを使用してください。 panel-token.txtは、上書きによって書き換えられることはありません。 コマンドのSHA-256は転送チェックサムに過ぎません。署名付きZIPファイルについては、別途検証を行ってください。 このパネルには、キューに入れられている/失敗したメディア、最も古い保留中のメディア、空きディスク容量、Telegram へのリクエストの一時停止、およびアクセスが未確認のソースが表示されます。これらの診断情報は、 完全なエンドツーエンドの配信モニターではありません。ワークスペースはプロセスを共有しているため、ノイズの多いアカウントが 他のワークスペースに影響を与える可能性があります。 個別のワーカープロセス、保存期間/ローテーション、耐久性のある更新 復旧、および完全な導入認定については、引き続き対応が必要です。パネルへのアクセス範囲については、 「[アクセスと権限](https://phishdestroy.io/tgwitness/ja/docs/reference/access/)」に文書化されています。独立したチェックポイントについては、 [ウィットネスガイド](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/)で説明されています。 詳細な手順:[接続・セキュリティ](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/)および [動作モード](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/)。 --- # Phala / Intel TDX · 高信頼性の導入 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/ Hetzner または Phala Cloud 上の 24 時間 365 日稼働のシールドサーバー、Gateway DNS、および第三者が再現可能な検証手順。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) Translation coverage: this edition includes material from the English original. Hetzner または Phala Cloud 上の 24 時間 365 日稼働のシールドサーバー、Gateway DNS、および第三者が再現可能な検証手順。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [導入と復旧](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/) ![展開と復旧](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) 高信頼性デプロイメントでは、アーカイブの検証に加え、収集環境に対する独立したチェックが 追加されます。レビュー担当者は、クラウドプロバイダーおよびCloudflareが保持する デプロイメントおよびアクセス記録を照会し、Intel TDXデプロイメントでは、コレクターの 環境に対するハードウェア認証が追加されます。 通常のローカル環境およびDockerでの使用方法は変更ありません。 `python -m tgwitness.cloud`を使用してデプロイしない限り、ここで実行されるものはありません。また、コレクターはデプロイ設定で指定された場合にのみホストを読み取ります。 `TGWITNESS_ASSURANCE`. フローチャート · オペレーター → サーバー、着信ルールなしのファイアウォール (プロバイダー API); オペレーター → トンネルとDNS (Cloudflare API); サーバー、着信ルールなしのファイアウォール → トンネルとDNS (送信専用); サーバー、着信ルールなしのファイアウォール → サーバー上で生成された署名鍵; Verifier、読み取り専用トークン → プロバイダーログとファイアウォール; Verifier、読み取り専用トークン → トンネルコネクタのアドレスとインジェス; Verifier、読み取り専用トークン → 署名済み /api/assurance ステートメント; Verifier、読み取り専用トークン → 証拠 ZIP · オペレーター · Verifier、読み取り専用トークン · サーバー、着信ルールなしのファイアウォール · プロバイダーログとファイアウォール · トンネルコネクタのアドレスとインジェス · 署名済み /api/assuranceステートメント · 証拠 ZIP · トンネルとDNS · サーバー上で生成された署名鍵 · プロバイダー API · Cloudflare API · 送信専用 **図表をテキストで記述** 1. オペレーター → サーバー、着信ルールなしのファイアウォール (プロバイダー API) 2. オペレーター → トンネルとDNS (Cloudflare API) 3. サーバー、着信ルールなしのファイアウォール → トンネルとDNS (送信専用) 4. サーバー、着信ルールなしのファイアウォール → サーバー上で生成された署名鍵 5. Verifier、読み取り専用トークン → プロバイダーログとファイアウォール 6. Verifier、読み取り専用トークン → トンネルコネクタのアドレスとインジェス 7. Verifier、読み取り専用トークン → 署名済み /api/assurance ステートメント 8. Verifier、読み取り専用トークン → 証拠 ZIP **このページでは** - [検証者が確認できる事項](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#what-a-verifier-can-check) - [プロバイダー](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#providers) - [Phala Cloud上の機密VM(Intel TDX)](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) - [開始する前に](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#before-you-start) - [パネルより](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#from-the-panel) - [ドメイン不要のクイックトンネル](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#quick-tunnel-without-a-domain) - [デプロイ](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#deploy) - [デバッグ展開とロック](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#debug-deployment-and-lock) - [デプロイを削除する](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#remove-a-deployment) - [任意のサーバー(自己認証済み)](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#any-server-self-attested) - [検証](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#verify) - [証拠引渡しに関する報告書](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#report-for-evidence-handover) - [外部証人としてのCloudflare](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#cloudflare-as-an-outside-witness) - [デプロイ結果の読み取り](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#reading-the-deployment-result) ## 検証者が確認できる内容 | 主張 | 検証方法 | 管理: | | --- | --- | --- | | このサーバーは、既知の時刻にプロバイダーのAPIを通じて作成されました。 | Serverオブジェクトと、プロバイダー独自のログにおけるその作成 | プロバイダー | | プロバイダーのアクセスパスを使用したユーザーはいませんでした | コンソールリクエスト、レスキュー、パスワードリセット、再構築、ISO、イメージ、バックアップのログ | プロバイダー | | 接続できませんでした | プロバイダのファイアウォールにはインバウンドルールがなく、SSHは初回起動時から非表示になっています。 | プロバイダー(ファイアウォール)、ホスト(SSH) | | このパネルには、トンネルを経由してのみアクセスできます。 | Tunnelのイングレスはパネルのみへ転送され、コネクタはサーバーのアドレスから実行されます。 | Cloudflare | | このソフトウェアは、 | コレクターの署名付きソースツリーのハッシュ値は、デプロイされたコミットのチェックアウトと一致します。 | Collector、Git との照合済み | | 署名鍵はそのサーバー上で作成されました | この鍵は、プロバイダのサーバーIDと、受信したcloud-initのハッシュ名を記載したステートメントに署名します。 | Collector:プロバイダーとの照合済み | | このジャーナルは、そのキーおよびサーバーに属しています | 証拠ZIP内のすべてのプロセス開始には、そのサーバーのホスト測定値が含まれています。 | 証拠 ZIP | | Telegramキーは、検証済みの実行中に生成されました | `account.authorized`には`key_origin: "created"`が記録されます。 | 証拠 ZIP | コレクターは、SSHの状態、セッション、ログイン履歴、および起動情報を、署名付き process-start レコードおよび `host.state` レコードに記録します。通常のVMでは、これらはローカルのインベントリ レコードであり、レビュー担当者はこれらをプロバイダーの独立した記録と比較します。以下の Intel TDXの展開では、さらにハードウェアによる測定値の検証も行われます。 認証済みデプロイメントは、インポートされたセッションキーに基づいて収集を行いません。電話または QRコードでサインインするか、セッションファイルを使用して独立したログインを行ってください。いずれの場合も、Telegramの 認証キーは認証済み実行内で生成され、ジャーナルには `key_origin: "created"`が記録され、`python -m tgwitness.cloud verify`の実行により `account_key`が通過します。インポートされたキーを含むジャーナルでは、このチェックに失敗します。 ## プロバイダー | `--provider` | 認証情報 | Verifierの読み取り専用アクセス権 | 検証者向けのプロバイダーログ | 保存目的: | | --- | --- | --- | --- | --- | | `hetzner` | `HCLOUD_TOKEN` | 同じプロジェクトのリードトークン | サーバーおよびファイアウォールの動作 | リソースが存在する限り | | `digitalocean` | `DIGITALOCEAN_TOKEN` | 読み取り専用の個人アクセストークン | Dropletのアクション | Dropletが存在している間は | | `linode` | `LINODE_TOKEN` | `linodes`, `firewall`, `events` 読み取り専用スコープ | アカウントのイベント、ファイアウォールルールのバージョン | 90日間 | | `vultr` | `VULTR_API_KEY` | 読み取りアクセス権を持つユーザーおよび `activity_logs` 権限 | アカウントのアクティビティログ(メソッド、パス、アクター) | 30日間。監査ログのサブスクリプションを利用すれば、さらに長期に保存可能です。 | | `aws` | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` | `ec2:DescribeInstances`, `ec2:DescribeSecurityGroups`, `cloudtrail:LookupEvents` | CloudTrailのイベント履歴 | 90日間 | | `phala` | `PHALA_CLOUD_API_KEY` | 同じワークスペースのAPIキー | アプリケーションの改訂およびCVMの操作:Docker Composeの設定および環境の変更、再起動、OSのアップグレード | このアプリケーションが存在する限り | | `generic` | なし | なし | なし:**自己認証済み** | – | 各ケースごとに専用のプロジェクト、チーム、アカウント、またはサブアカウントを使用してください。これにより、検証者の 読み取り専用アクセス権では、このデプロイメントのみが表示されます。認証情報は `--provider-token-file` または上記の変数から読み込まれ、コマンドラインからは決して読み込まれません。AWSの場合、ファイルには 地域が格納されます `ACCESS_KEY_ID SECRET_ACCESS_KEY [SESSION_TOKEN]`; リージョンは `--location`. すべてのレポートには、各プロバイダーの記録の範囲が明記されています。 要約すると:Hetznerは コンソールリクエストをログに記録します。DigitalOceanのRecovery Console、LinodeのLish/Glish、およびVultrのWeb コンソールは、そのものとしてはログに記録されません。そのため、初回起動時にはrootがロックされ、コンソールへのログインには パスワードのリセットまたは起動方法の変更が必要となり、これらはログに記録されます。Vultrは、インスタンスを読み取れる任意のキーに対してコンソールの アドレスを返しますが、記録にもレポートにもそのアドレスは保存されません。 ## Phala Cloud上の機密VM(Intel TDX) この `--provider phala` コレクターは、dstackによって管理[されるPhala Cloud](https://phala.com/)上の Intel TDX機密仮想マシン内で実行されます。ホストおよびPhalaのスタッフは、その メモリを読み取ることができず、プロセッサはマシンが起動した内容に関する証明に署名します。検証者は Phalaの主張を鵜呑みにしません: `tgwitness.tdx` すべての証明を、ピン留めされたIntel SGXルートCAに至るまで、Intelの失効リストおよびIntelが署名したプラットフォームデータと照合して自ら検証し、デバッグや移行が可能な マシンは拒否します。 | レポートの登録 | 表示内容 | | --- | --- | | `tdx_binding` | この認証には、コレクターによる署名付き声明およびこのリクエストのランダム値が含まれます。 | | `tdx_quote` | Intel はこの認証を保証しており、Intel がプラットフォームを最新の状態であると評価した場合にのみ、認証に合格します。 | | `tdx_compose_hash` | dstack イベントログから再生される RTMR3 は、コレクターが報告するアプリ作成の状況を測定します。 | | `tdx_compose` | そのコンパイル結果は、デプロイされたコミットのコードが生成するものとバイト単位で完全に一致しています。ソースファイルはハッシュで、両方の画像はダイジェストで固定されており、その他のコードは一切含まれていません。 | | `tdx_identity` | 認証情報は、デプロイされたアプリケーションおよびインスタンスから提供され、PhalaのKMSからの鍵と暗号化されたディスクが使用されます。 | | `tdx_os` | MRTD および RTMR0-2 は、Dstack-TEE が公開する dstack OS イメージから検証ツールが算出する値、CVM が報告する OS イメージのハッシュ、および QEMU が VM の構成に基づいて生成する ACPI テーブル(ファームウェア、カーネル、initrd、ルートファイルシステムのハッシュを含むコマンドライン、メモリ、vCPU、デバイス)から算出された値と一致します。開発用イメージは失敗します | OSイメージ(約180 MB、うち21 MBが保持される)は、 [Dstack-TEE/meta-dstack](https://github.com/Dstack-TEE/meta-dstack/releases) からレコードの隣にある `dstack-images` へ一度ダウンロードされます。`--tdx-image FOLDER` を使用すると別のフォルダまたは解凍済みのイメージが使用され、 `--tdx-image none` では比較がスキップされます。 測定は、Dstack-TEE/dstackの`dstack-mr` および`qemu-acpi` クレートを基に行われます。プライベートな測定の回帰分析では、QEMU自身のACPI 出力と保持されたPhala Cloudの引用を比較します。実環境での検証には、公開されたイメージも必要です。 `--tdx-measurements` は、代わりにJSON形式で指定されたMRTDおよびRTMR0-2 を引き続き比較します。 ジャーナルに記録されたコレクターの起動のたびに、このような認証情報が含まれるため、 `verify --evidence`は各起動と、その起動に使用されたOSイメージを確認します。Phalaのアプリケーションのリビジョン およびCVMの動作は、プロバイダーログとして機能します。デプロイ後にDocker Composeの設定が変更された場合、 レポートは不合格となり、再起動の履歴はレビューのために一覧表示されます。 パネルで以下を選択します: **機密仮想マシン・Phala Cloud** 以下で **[その他のツール] → [エクストラ] → [サーバー] 24/7** Phala Cloud APIキーを貼り付けてください。クイックトンネルはHetznerと同様に機能します。コマンドラインからは: ``` python -m tgwitness.cloud deploy --provider phala --name case-1 --server-type tdx.small \ --ref v0.8.0 --repository https://github.com/phishdestroy/TgWitness --quick-tunnel \ --provider-token-file phala-key.txt python -m tgwitness.cloud verify --record deployments/case-1/deployment.json \ --provider-token-file phala-key.txt --cloud-init deployments/case-1/docker-compose.yaml \ --source CHECKOUT_OF_COMMIT --fingerprint COLLECTOR_FINGERPRINT --report certificate.md python -m tgwitness.cloud check-report --report certificate.pdf --verifier-fingerprint VERIFIER_KEY ``` `--tdx-collateral` Intelの証明書および失効リストを、Intelからダウンロードする代わりに ファイルから読み込みます。ここではGateway DNSは利用できません。Phalaには、 送信トラフィック用のプロバイダファイアウォールがないためです。 `verify --source` builds the reference installer from your checkout, which runs that checkout's code on this computer. For a deployment made from a repository other than the official one, `verify` refuses unless you also pass `--trust-source`; do so only for a checkout you have read. ### verify.py を使用したオフラインチェック Phalaアカウントを持たない受信者は、スタンドアロンの検証ツールを使用して、オフラインで引用内容を確認します: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_FINGERPRINT python verify.py phala-tdx-attestation.json ``` 証拠アーカイブ内のすべての`process.started`レコードの引用、および 署名付きコレクターステートメント(デプロイメントレコードや公開されたアテステーションレコード内にあるものも含む)の引用について、 `verify.py`は、引用部分のECDSA P-256署名をそのアテステーションキーで検証し、引用元の エンクレーブレポートの署名をPCK証明書で検証し、このレポートがアテステーションキー (鍵およびQE認証データのSHA-256)を指定していること、IntelのTDXクォーティング エンクレーブ(プロダクションモード)から送信されたものであること、およびPCK証明書のチェーン(PCK証明書 → Intel SGX PCK Platformまたはプロセッサ CA → Intel SGX Root CA のチェーンが正しいかを確認します。このRoot CAのSHA-256値は`verify.py`にピン留めされています。デバッグ可能または 移行可能なTDは拒否し、REPORTDATAが開始レコード(ジャーナルキー、実行、ソース ツリー、ホスト)または署名済みステートメントのSHA-512値であることを確認し、MRTD、RTMR0-3、およびREPORTDATAを出力します。 また、コレクターは、Intelのサービスが応答する際、各クォートとともにIntelの担保情報(TCB情報、QE ID、失効リスト、およびそれらの 発行者チェーン)も保存します。これを利用して、`verify.py`はIntelの 署名と失効リストを検証し、記録された時点、あるいは 担保情報の発行日がそれより後の場合はその時点におけるTCBステータスを算出します。 これがない場合、結果は「TCBステータスを 確認できません(アーカイブに担保データなし)」と表示されます。VMが実行したコード(compose RTMR3が測定する項目、 MRTDおよびRTMR0~2の背後にあるOSイメージ)、プロバイダーログ、およびIntelの現在の評価については、 `python -m tgwitness.cloud verify`による検証が行われます。したがって、オフライン検証では、認証済み収集の実行は 「部分的」とマークされ、それ自体では`sealed`ティアや`attested`プロファイルには到達しません。 ### アテステーション証明書 Phalaのデプロイでは、`verify --report certificate.md`も証明書を書き込みます: 自己完結型の `certificate.html` と、A4 形式の `certificate.pdf` には、判定結果、Intel のルートからコレクターキーまでの信頼チェーン、 通常サーバーおよび高保証サーバーとの比較、 公開イメージから算出された値と並べて示された測定結果、各 部分の保証元、Intel の証明書チェーン、すべてのチェック項目、プロバイダーログ、および 検証を再現する方法が記載されています。 JSONレポートが正式な記録であり、各ページはその内容を表示しています。 本レポートは、署名とタイムスタンプを用いてデジタルで封印されており、`certificate.seal.json` およびその隣にある `.tsq`/`.tsr` ファイルに格納されています: | Seal | 追加機能 | | --- | --- | | 認定電子タイムスタンプ、`http://tsa.belgium.be/connect` | ベルギー連邦政府の認定信頼サービスプロバイダー(FPS Policy and Support、BOSA)から提供された`certificate.json`の正確なバイトデータに対するRFC 3161タイムスタンプです。 同機関は、ベルギーのEU信頼リストにおいて「認定タイムスタンプサービス、ステータス付与済み」として掲載されています。2026年10月20日に発行されたリスト時点でのルート(Belgium Root CA6)およびリストのエントリは、`tgwitness/tsa_roots.py`に固定されています。 規則(EU)第910/2014号第41条に基づき、このようなタイムスタンプは、すべてのEU加盟国において、日付および時刻、ならびにデータの完全性に関して正確であると推定されます。 | | RFC 3161 タイムスタンプ、FreeTSA | 2つ目の、独立したタイムスタンプ | | 検証者の署名 | Ed25519 を使用して、レポートの SHA-256 およびすべてのタイムスタンプを記載した記述文に、検証者自身の鍵(`--sign-with FOLDER`、デフォルトは `~/.tgwitness/verifier`)で署名しています。PDF には、同じ鍵による署名が含まれています | `--timestamp URL`(再現可能)は他の認証機関を選択し、`--timestamp none`は選択せず、`--sign-with none`はシールを未署名のままにします。`check-report`は、レポートのハッシュ、検証者の署名、 各タイムスタンプの信頼できるルートへの紐付けとその適格ステータス、およびPDFの署名を検証します。 EU域外における 適格タイムスタンプおよびレポート全体の法的効力は、それを受け取る裁判所 または当局によって決定されます。このシールは、レポートが存在した時点と、それが変更されていないことを示しています。 この証明は、IntelのTDXモジュールおよびマイクロコード、ならびに メモリバスの物理的完全性に依存しています。Phalaのアカウント内でアプリケーションを制御する者は誰でも、別のコンポーズを展開することができ、 それは新しいコンポーズハッシュを持つ新しいリビジョンとして表示されます。ホストは、マシンの時刻 ソースとネットワークを制御します。 デプロイを行い、 `--evidence`、再起動、OSイメージの比較、封印された証明書、および破棄の各処理がPhala Cloud上で実行されました。[2026年11月4日の実行結果](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/#live-phala-cloud-deployment--4-november-2026)をご参照ください。11月9日には、稼働中のTelegramアカウントからデータを収集したデプロイが行われました。ある実行では、VM内で生成されたセッションキーが使用されました。[稼働中のアカウントでの実行結果](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/#phala-cloud-with-live-telegram-account--9-november-2026)[およびVM内で生成されたキー](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/#session-key-created-inside-the-tdx-vm--9-november-2026)についてご参照ください。 ## 始める前に 1. Cloudflareゾーン、そのアカウントID、**およびCloudflare Tunnelの編集**、 **ゾーンの読み取り**、**DNS編集**が可能なAPIトークン。これらは `--cloudflare-token-file` または `CLOUDFLARE_API_TOKEN`で指定されます。検証者向けには、**Cloudflare Tunnelの読み取り権限**、**DNSの読み取り権限**、および 監査ログ用のアカウント設定の**読み取り権限**が必要です。ドメインがない場合、 [クイックトンネル](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#quick-tunnel-without-a-domain)ではこれらはいずれも不要です。 2. 専用プロジェクトへの書き込み権限を持つプロバイダーの認証情報; `lock` 以下も同様に使用します: - Hetzner:読み取りおよび書き込み権限を持つAPIトークン; - DigitalOcean:書き込み権限付きの個人用アクセストークン; - Linode: `linodes`, `firewall` および `events` 読み取り/書き込みスコープを持つ個人用アクセストークン; - Vultr:専用アカウントまたはサブアカウントのAPIキー; - AWS:IAM 認証情報の使用が許可されています `ec2:DescribeVpcs`, `ec2:DescribeImages`, `ec2:CreateSecurityGroup`, `ec2:AuthorizeSecurityGroupIngress`, `ec2:RunInstances`, `ec2:CreateTags`, `ec2:DescribeInstances`, `ec2:DescribeSecurityGroupRules` および `ec2:RevokeSecurityGroupIngress`. 3. 実行するコミット。リリースタグは、 `git ls-remote`; サーバーが受け取るのは、常に40文字のコミットのみです。 ## パネルから ご自身のコンピュータで、**「その他のツール」→「エクストラ」→「24/7サーバー」** を選択すると、Hetzner向けの同じ`deploy` が3つの ステップで実行されます:ヨーロッパまたは米国を選択し、Hetznerトークン(読み取り・書き込み)を貼り付け、その後、 そのトークンでパネルが検出したサーバータイプ、月額料金、アドレス、バージョンを確認します。確認するまでは 何も作成されません。 パネルには、`deploy` が報告する各ステップが表示され、続いて アドレス、パネルトークン、および署名キーのフィンガープリントが表示されます。ドメインがない場合、サーバーには [クイックトンネル](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#quick-tunnel-without-a-domain) が割り当てられます。**「Your servers」→「Find the current address」** では、再起動後に再度アドレスが照会されます。独自のドメインで固定アドレスを使用するには、 **「Optional」→「your own domain」** を開き、Cloudflareトークンを追加します(準備済みのリンクでは、「Zone Read」、「DNS Edit」、および「Cloudflare Tunnel Edit」が選択されます)。 トークンは、ブラウザのタブから同じコンピュータ上のTgWitnessへ、各リクエストごとに転送され、 どこにも書き込まれません。デプロイメント記録、編集済みのcloud-init、パネルトークン、および クイックトンネル用のアドレスキーは、 `deployments/NAME` データディレクトリ内に保持されます。 パネルは、直接のループバック接続( (`127.0.0.1`、プロキシやトンネルヘッダーなし)。ネットワーク経由でアクセスされたパネルでは、代わりにコマンドが表示されます。 バージョンは、GitHub APIを通じて解決される、実行中のパネルのリリースタグがデフォルトとなります。 場所、サーバータイプ、価格はHetznerのAPIから取得されます: `cpx22` 提供されている場合はそちらが使用され、 そうでない場合は、メモリが2 GB以上の最も安価なx86タイプが使用されます。 ## ドメイン不要のクイックトンネル `--quick-tunnel` 置き換える `--zone`, `--cloudflare-account` および `--panel-host`; Cloudflareの アカウントやトークンは一切使用されません: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --quick-tunnel --provider-token-file hetzner.token ``` サーバー上では、cloudflaredがパネルへの [クイックトンネル](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/)を開きます。 これは、Cloudflare経由で `https://….trycloudflare.com` アドレスで、cloudflared またはサーバーが再起動するたびに変更されます。サーバー上の小さなサービスが、各アドレスをランダムな ntfy.sh トピックに投稿し、デプロイメントディレクトリにのみ保持されている鍵で (`address-key.txt`)、そしてntfy.shが投稿を12時間保持するため、3時間ごとにこれを繰り返します。 `deploy` および**「現在のアドレスを検索」**は署名付き投稿のみを受け付けるため、偽造された投稿によって あなたやあなたのパネルトークンが他人のアドレスに転送されることはありません。トピックは記録に残り、 公開された cloud-init にも記載されます。これらを保有する者なら誰でも現在のアドレスを読み取ることができますが、その際も依然として パネルトークンの入力が求められます。いずれの場合も、サーバーは受信ポートを一切開放しません。 検証者(verifier)にはアドレスキーがなく、トピックを読み取る誰でもそこに投稿できます。そのため、コレクター も自身の Ed25519 キーで署名したアドレス自体を投稿し、`verify` はデプロイメントレコード内のコレクターキーで署名された最新の 投稿を採用します。投稿の順序は、投稿が主張する時刻ではなく、ntfy.sh が それを受け取った時刻によって決定されます。 この変更以前のコレクターは何も署名せず、 `verify`は最新の投稿を取得し、`statement`のチェックでその旨を伝えます。偽造された投稿は そのチェックを失敗させることしかできません。なぜなら、アドレスは依然としてコレクターの鍵で応答しなければならないからです。 コストについて:クイックトンネルの記録を保持するCloudflareアカウントがないため、`verify`は トンネル、コネクタ、およびDNSチェックを「利用不可」と報告し、結果はせいぜい`incomplete`となります(Phala Cloudではチェックは通過します:コネクタは測定対象のCompose内で実行されます); プロバイダーの記録、ファイアウォール、署名付きステートメント、ホスト測定、およびインストーラーの比較は 通常通りチェックされます。リファレンス・インストーラーとのバイト単位の比較には、`--quick-tunnel`を すでに認識しているデプロイ済みのコミットが必要です;0.7.0のチェックアウトではドメイン・インストーラーがビルドされ、 差異が報告されます。 Cloudflareは試用版のクイックトンネルを提供しており、200件のリクエストを 処理可能ですが、Server-Sent Eventsは伝送しないため、パネルのライブ更新(0.7.0以降のバージョン)が クイックトンネル経由で届かず、ビューの再読み込みが必要になる可能性があります。この点については未検証です。本番環境で 運用する必要がある場合は、独自のドメインを使用してください。 ## デプロイ 送信されるすべての内容を事前に確認してください。 `plan` プロバイダーやCloudflareへのリクエストは一切行いません: ``` python -m tgwitness.cloud plan --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org ``` その後、同じオプションと認証情報を使用してデプロイします: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org \ --witness-host case-witness.example.org \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` 最初に利用すべきサーバーの種類: `cpx22` (Hetzner)、 `s-1vcpu-2gb` (DigitalOcean)、 `g6-standard-1` (Linode)、 `vc2-1c-2gb` (Vultr)、 `t3.small` (AWS)。 `--location` および `--image` 各 プロバイダーの欧州リージョンにあるUbuntu 24.04をデフォルトとして設定します。 `--repository` 別の https Git リポジトリからのコミットを取得します。この際、URL に認証情報は含まれません (デフォルトでは `https://github.com/phishdestroy/TgWitness.git`). `deploy` は `--out` 別のデプロイディレクトリも受け付けます(デフォルト `deployments/NAME`; すでに デプロイが含まれているディレクトリは拒否されます)と、 `--wait`、コレクターの署名付きステートメントを待つ時間(分): 1~240、デフォルトは20、または60( `generic`. コマンド: 1. Cloudflareトンネルを作成し、そのインジェストはパネルのホスト名をパネルへ転送し、 指定されている場合は、ウィットネスのホスト名を `/api/witness/head` および `/api/assurance` のみへ転送するCloudflareトンネルを作成します。 2. それらのホスト名に対してプロキシ化されたCNAMEレコードを作成し、既に存在する名前は拒否します。 3. 着信ルールのないプロバイダーファイアウォールと、その背後にSSHキーなし、 バックアップなし、コンソールエージェントなし、かつSSHを隠蔽し、rootをロックし、 `cloudflared`、正確にそのコミットを取得し、検証した上で、TgWitnessを 強化されたsystemdサービスとして起動します; 4. コレクターからの署名付きステートメントを待ち受け、そのステートメントにこのサーバーと この cloud-init のハッシュが指定されていることを確認します。 `deployments/case-2026-11/` 以下のように記述します: | ファイル | 目次 | 共有しますか? | | --- | --- | --- | | `deployment.json` | ID、ハッシュ、実行されたAPI呼び出し(メソッド、パス、ステータス)、および最初に署名されたステートメント | はい、検証ツールを使用します | | `cloud-init.redacted.yaml` | 2つのシークレットが置き換えられた正確な cloud-init は以下の通りです。 `REDACTED` | はい | | `panel-token.txt` | パネルトークン | いいえ | プロバイダーのルートパスワード、トンネルトークン、パネルトークンは、決して `deployment.json`。末尾に表示されるコレクターのフィンガープリントは、 自身が単独で管理していないチャネル(例えば、ウィットネスチャネルや受信者へのメッセージなど)を通じて公開してください。 Telegramには、 `https://case.example.org` で、 [アカウント](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/)ガイドに記載されているように、パネルトークンを使用してTelegramにログインしてください。パネルの操作は署名付きジャーナルに記録されますが、これらは SSHセッションではありません。[ウィットネス](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/)はポーリングを行うことができます `https://case-witness.example.org`. SSH 機能はありません。ブートストラップに失敗した場合、コレクターは一切応答しません。サーバーを削除して 再デプロイするか、デバッグデプロイを使用して原因を特定してください。 ### ユーザーデータに含まれる秘密情報 cloud-initには、パネルトークンとCloudflareトンネルトークンの2つのシークレットが含まれています。 署名鍵はこれらには含まれておらず、サーバー上で生成されます。Hetzner、DigitalOcean、Linodeは APIを通じてユーザーデータを返しません。Vultrは、インスタンスを読み取れる任意のキーに対して データを返し、EC2は `DescribeInstanceAttribute`。AWSの場合は、検証者に表にある3つの アクションのみを許可し、決して `ec2:Describe*`。Vultr については、検証者のキーが両方の トークンを読み取れるものと仮定します。トンネル・トークンがあれば、誰かが 2 つ目のコネクタを実行できます: `verify` サーバー上にないコネクタを すべて報告し、コレクターのステートメントは、それぞれが 新しいチャレンジに署名するため、その方法では偽造できません。 `--quick-tunnel` 2つ目のシークレットは代わりにアドレスキーとなります: これを読み取った者は、パネルが受け入れる偽のアドレスを投稿することができます。 収集担当者の公式声明には、サーバーのアドレスやログイン元の情報は記載されていませんが、 これらはいずれも署名付きジャーナルに記録されています。 ## デバッグ展開とロック `--debug-ssh-key KEY --debug-ssh-from 198.51.100.4` 1つのアドレスまたは小規模なネットワーク(IPv4の場合は最大/24、IPv6の場合は最大/48)からの1つの鍵に対してSSHを維持します。 `KEY` すでにプロバイダーに登録済みであること: Hetznerプロジェクト内のSSHキーの名前またはID、DigitalOceanチーム内の SSHキーのIDまたはフィンガープリント、プロファイルのSSHキーがrootに追加されているLinodeのユーザー名、 Vultrアカウント内のSSHキーのID、またはリージョン内のEC2キーペアの名前。これらの オプションは `generic`には適用されません。このようなデプロイは `debug` として記録され、**決して** 高保証として報告されることはありません。作業が完了したら、 `sudo tgwitness-lock` を最後の SSH セッションの最後のコマンドとして実行し、その後: ``` python -m tgwitness.cloud lock --record deployments/case-2026-11/deployment.json --provider-token-file hetzner.token ``` ファイアウォールはすべてのインバウンドルールを無効にします。その後、レポートにはSSHが許可されていた時期と 遮断されていた時期が表示され、そのウィンドウは表示されたままになります。 ## デプロイメントを削除する `destroy` デプロイメントのラベルに基づいてサーバーとそのファイアウォールを削除し、 途中で失敗したデプロイメントも同様に削除した後、その トンネルを指すDNSレコードとトンネル自体を削除します。サーバーのジャーナルと署名鍵も同時に削除されます。その前に、 証拠をエクスポートしてください。記録は残され、 `removed`、削除処理のAPI呼び出しが記録されます。 ``` python -m tgwitness.cloud destroy --record deployments/case-2026-11/deployment.json --confirm case-2026-11 \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` Hetznerについては、API経由での削除機能が実装されています。その他のプロバイダーの場合 `destroy` は、何かを削除する前に 停止し、プロバイダーのコンソールで削除するラベルを指定します。手動でインストールされた サーバー(`generic`)は、トンネルとDNSレコードのみが失われます。クイックトンネルの展開には Cloudflareトークンは不要です。そのトンネルはサーバーで終了し、投稿はntfy.shから 12時間以内に失効します。 ## 任意のサーバー(自己認証型) `--provider generic` これは、購入または手動でインストールしたサーバー向けです。 `deploy` トンネル とDNSを作成し、 `install.sh` (プライベート)および `install.redacted.sh` (公開用)を書き込み、待機します。 このファイルを `install.sh` を新しくインストールした Ubuntu 24.04 サーバーにコピーし、そこで実行してください: ``` sudo bash install.sh ``` このツールは、ホストの状態(ログイン情報、アカウント、 `authorized_keys`、リスニングソケット、 サービス、スケジュールされたジョブ、パッケージ)を記録し、コミットをインストールし、ホストのファイアウォールを有効化し、 自身を削除し、SSHをマスキングしてセッションを終了します。このようなサーバーに関するレポートは、せいぜい **「自己証明型(SELF-ATTESTED)」**です。つまり、インストーラを実行した人物はそれ以前にroot権限を持っており、検証者にはプロバイダーの記録が 利用できません。とはいえ、説明のつかないサーバーよりはましです。インベントリ、 インストーラのハッシュ、およびその後のすべてのログインには署名が付いています。 ## 検証 検証者には `deployment.json`、公開されているインストーラー、読み取り専用の認証情報、そして 理想的には、そのコミットのチェックアウトと証拠ZIPが必要です: ``` git clone -c core.autocrlf=false https://github.com/phishdestroy/TgWitness.git checkout git -C checkout checkout 0123456789abcdef0123456789abcdef01234567 python -m tgwitness.cloud verify --record deployment.json \ --provider-token-file read-only.token --cloudflare-token-file cloudflare-read.token \ --fingerprint COLLECTOR_FINGERPRINT --cloud-init cloud-init.redacted.yaml \ --source checkout --evidence tgwitness-evidence.zip --report report.md ``` すべてのプロバイダーおよびCloudflareの値は、その時点で検証者によって要求されます。記録には、 照会対象となるIDのみが含まれます。終了コードは、**PASS**の場合は0、**FAIL**の場合は1、 **REVIEW**、**INCOMPLETE**、**またはSELF-ATTESTED**の場合は2となります。 `--fingerprint` は独立した チャンネルから送信される必要があります。それがなければ、キーはオペレーターの記録とのみ照合されます。 `python verify.py` [Evidence](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) と同様に、ZIPの証拠自体を検証します。 プロバイダーのアクションは分類されます。作成および作成後30分以内の起動は合格となります。 コンソール、レスキュー、パスワードリセット、再構築、ISO、イメージ、スナップショット、バックアップ、Systems Manager、 EC2 Instance Connect、およびファイアウォールの開放は不合格となります。電源関連のアクションや予期されない動作は すべてレビュー対象としてマークされます。未知のアクションが黙って通過することは決してありません。 ## 証拠の引き渡しに関する報告書 `--report report.md` Markdown形式のレポートを作成し、 `report.json` その横に: 1. 結果、コレクターキーのフィンガープリント、デプロイ、プロバイダー、コミット、サーバー、ファイアウォール、トンネル; 2. 各チェックとそのステータス、およびソース(プロバイダーAPI、Cloudflare API、コレクターのステートメント、 証拠ジャーナル); 3. 各アクションの評価、およびプロバイダーが記録している場合はその実行者を記載したプロバイダーログ; 4. トンネルの接続、設定、監査ログを保持する Cloudflare エンドポイント; 5. 署名済みの収集者声明; 6. 本レポートの対象範囲と、その範囲外となる事項; 7. 再現するためのコマンド、および渡されたすべてのファイルのSHA-256。 レポート、 `report.json`, `deployment.json`、公開済みのインストーラー、および 証拠ZIPを提出してください。レポートは早めに作成してください。プロバイダーのログは一定期間しか保存されません。 ## 外部ウィットネスとしてのCloudflare ここにある機能はすべてオプションです。Cloudflareアカウントがなくてもサーバーは動作し、 現在、以下の2つの機能が利用可能です: | 概要 | 表示内容 | TgWitness内 | | --- | --- | --- | | クイックトンネルまたは独自のドメインのトンネル | このパネルには、トンネルを経由してのみアクセスできます | サーバーウィザードについては、上記を参照してください | | drand リレー `drand.cloudflare.com` | drandラウンド後の記録はそれよりも新しいものです。このジャーナルは、その都度書き綴られていきました。 | 証拠モード、**追加の証人**、アカウントなし([フォーマット](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)) | | トンネルの状態に関する通知 | トンネルがダウンした際、CloudflareからのメールまたはWebhookによって通知されます | Cloudflareダッシュボードで設定してください | | ウィザードで「Gateway DNS (`--gateway-dns`、またはウィザード内の「**Cloudflare Gateway DNS**」) | サーバーが検索したすべての名前に対して、CloudflareがTLS経由で応答しました。Hetznerのファイアウォールにより、DNSはそれ以外のどこにも到達できません。ゲートウェイポリシーによって応答を書き換えることができたかどうか | Hetzner、無料のゼロトラストプラン、ドメインなし; `verify` ファイアウォール、ロケーション、ロギング、ポリシー、サーバーのクエリ、監査ログを確認します。エビデンスモードでは、ログがジャーナルにコピーされます。 | | Cloudflareとのゲートウェイ:サーバー上の1つのクライアント、Cloudflareのみを通すアウトバウンドファイアウォール | DNSだけでなく、サーバーが行ったすべての接続 | まだ実装されていません | | パネルの前面からのアクセス | パネルに誰がいつログインしたか | 未実装:独自のドメインが必要です | | SSH コマンドのログ記録 | デバッグセッション内の各コマンド | まだ実装されていません | Cloudflare独自のコピーをR2に保存する「Logpush」はエンタープライズ機能です。無料 プランでは、Cloudflareは `logpush is not enabled for this account`。ゲートウェイのログはそこで24 時間保持されるため、エビデンスモードでは、それが署名付きジャーナル(**Cloudflare Gatewayによる このサーバーのDNSクエリのログで**、「Account Analytics Read」権限を持つ読み取り専用トークン)にコピーされます。 `--gateway-location ID`(`--gateway-dns`と併用する場合)は、新しいゲートウェイDNSロケーションを作成する代わりに、 32文字のIDで指定された既存のゲートウェイDNSロケーションを使用します。`destroy`を実行しても、そのロケーションはそのまま残ります。 ゼロトラスト計画がない場合、アカウントには1つのDNSロケーションがあります。Cloudflareが別のロケーションを拒否すると、 サーバーは既存のロケーションを共有し、そのクエリはアドレスによって区別されます。このフィルタには ゼロトラストPII読み取り権限も必要であり、 `destroy` 共有ロケーションが残ってしまいます。1つのログクエリは 最大3時間にわたるため、コピーと `verify` 3時間ごとのウィンドウでその日のデータを読み取ります。 Gateway DNSはシステムリゾルバをカバーします。ポート443経由で別のリゾルバへのDNS over HTTPSや、 どこにも解決されないアドレス(Telegramのデータセンターなど)への接続は、 そのログには記録されません。 Cloudflareは、Telegramの暗号化内部、Telegramアカウントに紐づく他のデバイス (エビデンスモードのデバイスリストはTelegram側からそれらを記録します)、およびプロバイダーのハイパーバイザーを閲覧することはできません。 ## デプロイ結果の確認 通常の仮想マシン(VM)の場合、プロバイダーがホストインフラストラクチャを管理し、ローカルインベントリは プロバイダーの記録と併せて確認されます。Intel TDX の場合、検証者はさらに ハードウェアの仕様、コレクターのバインディング、コンポーズ、および OS の測定値を確認します。個々の 結果を確認して、どのチェックが合格したか、または利用できなかったかを確認してください。 過去のファイアウォールの詳細はプロバイダによって異なりますが、Linodeではルールのバージョンが保持されます。 [検証記録には](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/)、テスト済みのデプロイメントと残りの稼働中の チェックが記載されており、[検証範囲は](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope)これらの環境 チェックをアーカイブの取得および完全性と結びつけています。 --- # Telegram · パネルガイド Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/panel/ パネルのすべての画面:チャット、ジャーナル、ソース、エクスポート、エクストラ、保護モード、コードチェック。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) Translation coverage: this edition includes material from the English original. パネルのすべての画面:チャット、ジャーナル、ソース、エクスポート、エクストラ、保護モード、コードチェック。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [はじめに](https://phishdestroy.io/tgwitness/ja/docs/reference/quickstart/) ![はじめに](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [初期設定と設定](https://phishdestroy.io/tgwitness/ja/docs/reference/settings/) · [アカウント](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/) · [エクスポートと検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) · [事例レポート](https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/) 各画面の機能、署名済みジャーナルへの書き込み内容、および詳細な ガイドの場所。パネルには一度に 1 つのワークスペースが表示されます。つまり、独自の ソース、ジャーナル、署名鍵を持つ 1 つの Telegram アカウントです。上部バーのアカウントセレクターで ワークスペースを切り替えます。アドレスにはワークスペース情報が含まれます(`?ws=…`);アドレス、 セレクター、および読み込まれたアカウントが一致しない場合、操作はブロックされたままになります。 [「コレクション方法の比較」](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md)を使用して、ライブ 観測、全履歴、新規アカウント/チャットのエクスポート、保存済み記録の引き渡しの中から選択してください。 「エクスポート」ページには、ダウンロード操作ボタンの上に、上記と同じ比較表が表示されています。 **このページでは** - [目次](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#find-your-way) - [ここから開始](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#start-here) - [チャット](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#chats) - [ジャーナル](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#journal) - [ソース](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#sources) - [エクスポート](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#exports) - [設定、アカウント、接続](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#settings-accounts-and-connection) - [追加情報](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#extras) - [保護モード](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#protection-modes) - [その他のツール](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#more-tools) ## 使い方のガイド サイドバーには、「**ホーム**」、「**チャット**」、「**ジャーナル**」、 **「エクスポート**」、「**アカウント**」、「**設定**」の 6 つの日常的なセクションがまとめられています。アクセス権限のないセクションは 省略されます。**「その他のツール」**には、調査および管理ツールが含まれています。 サイドバーの下部にある**「外観」**を開くと、言語、テーマ、 タイムゾーン、またはインターフェースレベルを変更できます: | レベル | サイドバーのセクション | | --- | --- | | シンプル | 日次セクション | | 標準 | また、「その他のツール」の下にある「ケースボード」、「ソース」、「アクセス」、「ドキュメント」も同様です。 | | エキスパート | また、「その他のツール」の下にある「システムマップ」、「ネットワークトポロジー」、「エクストラ」、「アーカイブへの質問」、「パラメータ」、「アカウント」、「システムログ」、「統合」も翻訳してください。 | セクション名はすべてのレベルで同じままです。レベルはセクションを非表示にするだけです。非表示にされた機能は引き続き動作し、サーバーが すべての権限を独自にチェックします。レベル、言語、テーマ、タイムゾーンは オペレーターおよびワークスペースごとに保存されます。[設定を](https://phishdestroy.io/tgwitness/ja/docs/reference/settings/)参照してください。 サイドバー上部の「**セクションへ移動**」(Ctrl+K、Macの場合は⌘K)を使用して、 `#number` でチャット、パラメータ、またはジャーナルレコードを検索してください。矢印キーで移動し、Enter キーで開き、 Esc キーで閉じます。 上部バーには以下が含まれます: - **通知**:ジャーナルから抽出された問題やチャットの変更事項。 **すべて既読にするを選択すると**カウンターがリセットされ、**通知ルールをクリックすると**ルール設定画面が開きます。 Telegram、Discord、またはメールへの配信設定は、 [[Extras] → [Notifications]](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#notifications) で行います。 - 開始/一時停止の制御、接続設定、および Telegram、イベント取り込み、ソース、添付ファイルキューの健全性診断を含むコレクションステータスメニュー。 画面幅が狭い場合は、アクティビティアイコンから開いてください。 - **「ロック**」:このブラウザ上のパネルを閉じます。「コレクション」はサーバー上で引き続き実行されます。 バージョンと保護モードは「**外観**」の下にあります。[保護モードについては](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#protection-modes)、そちらを参照してください。 インストールすると、サインイン後に**「ホーム」**が開きます。明示的なリンクをクリックすると、指定された 画面が開きます。チャット範囲のレビューアは「**チャット」**を開きます。アドレス `/home`, `/case-board`, `/pseudo-secret` および `/network-topology` も、それぞれ対応する画面を開きます。 未知のページアドレスに対しては、HTTP 404が返され、関連するページの候補が表示されます。 デモ用ワークスペースには架空のメッセージが含まれており、Telegramには一切接続されません。 実際のワークスペースを変更するような操作は、ここでは拒否されます。 [システムマップには](https://github.com/phishdestroy/TgWitness/blob/main/docs/SYSTEM-MAP.md)、このインストール環境のアカウント経路、プロキシの状態、 ソケットエンドポイント、暗号化された保管庫、証拠サービス、および観測されたネットワークリクエストが表示されます。 アカウントを選択すると、そのパスを確認できます。利用可能だが無効化されているサービスも表示されたままになります。 ## ここから始めましょう アカウントを切り替えたり、再度ログインしたりすると、概要画面ではそのアカウント固有のグラフと要約がクリアされます。 読み込み中、読み取り失敗、および保存されたレコードがない期間には、それぞれ異なる状態が設定されています。 **再試行では**、読み取りに失敗した操作が繰り返されます。サーバーが待機を要求した場合、 次の試行時刻が表示されます。更新に失敗した場合は、同じワークスペースについて最後に正常に取得されたデータが保持され、 最終更新時刻がラベルとして付加されます。 接続された各アカウントには、**コレクターのハートビート** と**「最後に受信したイベント」** が別々に表示されます。前者はコレクターの稼働状況、後者はTelegramから 受信した最新の更新情報です。ソースからデータが送信されていない場合でも、 コレクターが稼働し続けている限り、後者の時間は変更されません。「collection-status」メニューを開くと、接続、取り込み、 ソース、および添付ファイルに関する診断情報を確認できます。 Choose a task. **Export my account** downloads what the account can read now. **Follow an investigation** records new messages, observed edits and deletion notices from the chats you choose. While observation is paused, Chats, Journal and Sources show the setup card: connect the account, choose sources, start observation. With the goal **Evidence for a case**, or in the Witnessed, Case preparation, GitHub-verified or Maximum [protection mode](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#protection-modes), starting observation first reads Telegram's session list (not while **Strict: read only the chosen chats** is on). If other sessions are signed in, the panel names their number and offers **Start anyway** or **Open Sessions of this account**. Other goals and modes start without that question. The goal question stays on this page until you answer or skip it. A new workspace opens the [first setup](https://phishdestroy.io/tgwitness/ja/docs/reference/settings/) instead. ## チャット 保存された会話は、デフォルトで読み取り専用です。 チャット行には、収集状況、保留中および失敗したファイルのダウンロード、初期履歴の 読み込み状況、Telegramのダイアログメタデータで返された制限情報が表示されます。アクセス状態が「失われた」または「未確認」 であっても、コンテンツの禁止を意味するわけではありません。**「フィルター」**を開いてこれらの状態を選択 するか、ファイルキューで並べ替えを行ってください。ページを再読み込みしても、選択内容はURLに保持されます。 **「再試行」**フィルターは、エラー後に待機中のチャットの初回読み込みを検出します。バッジには エラーの種類が表示され、収集中は次の試行時刻も表示されます。「ホーム」画面では、 再試行が必要な読み込みの数がまとめられています。「一時停止」中の収集は、再開されるまでジョブを保持します。 In **Simple** mode Home also shows **Can be handed to a court: yes** or **no · missing: …**. Yes means timestamps are on with an RFC 3161 authority and that authority recently returned a timestamp that validated against its root certificate; each export asks for a new one for its last record. The line names the missing item otherwise. It does not check the signing key: the recipient confirms its fingerprint, received separately, and runs `verify.py` with `--tsa-ca` and the authority's root certificate. A Bitcoin proof, a witness post or an attested collection run can also meet the minimum there but are not counted here. 「保存済み添付ファイル」のジャーナルエントリには、検出されたタイプ、名前、およびバイトサイズが表示されます。 Telegramから提供された新しいダウンロード結果についても、メディアの種類と再生時間が保持されます。 古い署名付きレコードは変更されず、欠落しているメタデータは復元されません。 - 名前またはIDでリストを検索します。複数の単語は順序を問わず一致し、 名前とIDの一部を組み合わせた場合も含まれます。「**+**」ボタンをタップすると、**「チャットまたはチャンネルを追加**」(ウォッチリストに追加または削除 )、 **「Telegramリンクを開く**」、および**「疑似シークレット・チャットを開始」**が表示されます。 **「Telegramリンクを開く」**では、 ユーザー名または招待リンクを入力すると、プレビューがジャーナルに保存されます。@ユーザー名やt.meリンクを検索して 一致する結果がない場合も、同様の処理が行われます。**「参加/開く」を選択して観察すると**、チャットに参加し、ソースに追加されます。 ボットを開くと、`/start` コマンドが送信されます。 - 疑似シークレットチャットは、同じリストに緑色の鍵マーク付きで表示され、「疑似シークレット」で開きます。 観察機能がオフの場合、リストには「**観察オフライン**」と「**観察を開始**」が表示されます。 - クイックフィルターは、1行に並んだタブで構成されています。「**すべて**」、**「疑似秘密**」、**「優先度**」、「**変更**」(保存された編集 または削除通知)、「**注意が必要**」(アクセス権の喪失または未確認、再確認時にメッセージが見つからない、 メディアの読み込み失敗、履歴の再試行、またはTelegramの制限)。 何も表示されていないタブは非表示になります。表示数は 検索およびタイプフィルターに準拠しており、クイックフィルターはステータスフィルターに取って代わります。これらの選択内容は 再読み込みや「戻る」「進む」操作の際もURLに残ります。 「**注意が必要」**は、メッセージを削除済みとしてマークするものではありません。**フィルターが**折りたたまれている場合でも、タイプ、状態、およびカスタム 並べ替えは、削除可能なチップとして表示されたままになります。 - 大規模なリストでは、一度に80件の一致結果が表示されます。**「さらに表示」をクリックすると**、次の80件が表示されます。開いている チャットやフォーカスされている行は、そのバッチの範囲外であっても、一致した場合は引き続き表示されたままになります。 カウンターには、全一致結果のうち表示されているチャットの数が表示されます。検索は、まだ表示されていないチャットも含め、 リスト全体を対象とします。 - 検索から、 **↓** 最初の検索結果に移動し、 **↑** 最後に表示された結果に対して、 そして **Enter** 第1試合の幕を開ける。そのリストの中で、 **↑/↓** そして **ホーム/終了** フォーカスを移動する; **Enter** フォーカスされているチャットを開きます。 **脱出** 検索画面に戻り、そこで もう一度押すと、検索クエリがクリアされます。 **フィルターをクリアする** コレクションや開いている会話を変更することなく、 リストをリセットします。 - チャットのヘッダーは、**削除済み・テキスト保持**、**保存前に削除**、**再確認で見つからない**メッセージの件数を表示します。各件数はそのメッセージだけを表示するボタンで、もう一度押すとすべて表示されます。メッセージ上の**削除済み**と**再確認しても見つかりませんでした**は、時刻と観測内容を示す注記を開きます。チャット一覧と通知も同じ定義を使います。削除されたメッセージは赤で表示され、保存済みのテキストを保持します。編集されたメッセージは保存したすべての版を保持します。 - **「保存済みメッセージの検索」**では、以前の テキスト版も含め、保存されているチャット全体が検索対象となります。削除、編集、メディア、および送信者によるフィルタリングも、保存されている チャット全体を対象とします。**「再確認時に見つかりませんでした」という表示は、**受信した削除通知とは別物です。 検索ではTelegramにメッセージの取得をリクエストしません。さらに取得するには**「履歴を読み込む」**を使用してください。 以前のバージョンで一致が見つかった場合、保存されたバージョンとそのジャーナルリンクが開きます。 **表示されているバージョンは**、そのメッセージおよびそのブックマークに使用された記録を示しています。 履歴の応答が遅れた場合でも、画面上に表示されている新しいリアルタイム編集内容を置き換えることはできません。 - メッセージの間には、2 種類のギャップ表示があります。**確認されていないメッセージ番号**は、ジャーナルに記録がない番号をチャンネルとスーパーグループでのみ示します。ほかのチャットはアカウント全体で 1 つの番号体系を共有するため、そこでの番号の飛びはそのチャットについて何も示しません。**対応範囲の不足**は、記録された中断から次に記録された再開までの期間を、ジャーナルに理由があればその理由とともに示します。表示はすべてのメッセージを表示しているときに現れ、メッセージフィルターが有効な間は隠れます。 - メッセージの上にある**「レポートを作成」をクリックすると、**このチャットが選択された状態でレポートスタジオが開きます。 投稿者のプロフィールカードにある同じボタンをクリックすると、そのチャットと投稿者が選択されます。 どちらの場合も下書きのみが変更されますので、エクスポートする前に保存してください。 - 投稿者の名前をクリックすると、メッセージの横に「人物カード」が開きます。ここには、保存されたプロフィール、 自己紹介、プロフィール写真、ギフト、リンク、メッセージ数、および ジャーナル記録を含むアクティビティタイムラインに加え、「**プロフィールを更新**」と「**レポートを作成**」が表示されます。**「閉じる」**、Escキー、または 別のチャットを開くとカードは閉じられますが、チャットの位置は維持されます。 カード内の**「リズム」** では、このチャットにおける投稿者の保存済みメッセージをUTCで集計します:アクティブ日数、 6時間の沈黙後にカウント開始、24時間以内の他者への返信までの中央値、 連続メッセージの最長記録、00:00~06:00に送信されたシェア、および 曜日×時間帯のヒートマップが表示されます。 - メッセージの上にある**選択**でメッセージ選択がオンになります。メッセージを押すと選択され、Shift を押しながら押すと範囲を選択できます。または**表示されているものを選択**を使い、続けて**レポートを作成する**を押します。レポートスタジオは**選択したメッセージ**が入力された状態で開きます。レポートは、ほかのフィルターを通過したそれらのメッセージの記録(観測、編集、削除通知)を対象とします。作成者フィルターは、送信者を持たない削除通知を除外します。選択できるのは最大 1,000 件で、スタジオのチップで 1 件ずつ外せます。チャット全体を並べて追加することもできます。欠落したメッセージ番号は、全体を選択したチャットについてのみ報告されます。 - **「履歴を読み込む」機能を使用すると**、直近の100件、250件、または500件のメッセージがこのビューおよび ジャーナルに読み込まれます。この機能は、「**チャットアクション**」内にあり、録音設定、読み取り専用モード、 秘密情報のマスキング設定などと同じ場所に表示されます。Escキーを押すか、メニューの外側をクリックするとメニューが閉じます。 以前のメッセージを読み込んでも、現在の読み取り位置は維持されます。Telegramが応答している間にクエリやページが 変更された場合、読み込みが完了すると、新しいビューを上書きすることなく、保存済みのジャーナルが更新されます。 自動読み込みが失敗した場合は、**「再試行」**が表示されます。 有効になっているすべてのソースを読み込むには、[「ソース」→「全履歴」](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#sources)を使用してください。 - **「チャットのエクスポート」**では、表示されている履歴全体を署名付きで `chat.json` かつ `chat.html`としてダウンロードします。複数の連携アカウントで作業を分担できます。各アカウントは、それぞれが担当する メッセージ番号の範囲をダウンロードしてその部分を署名し、エクスポートを開始した アカウントがアーカイブ全体に署名します。「[1つのチャットをエクスポートする](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md)」を参照してください。 - **「People」**には、このチャットに保存されたメッセージを持つすべてのユーザーが表示されます。ユーザープロフィールは、 第三者に関する個人情報であるため、デフォルトではオフになっています。チャットで オンになっている場合、プロフィールには名前とユーザー名の履歴、Telegramのフラグ、アバターのハッシュ、アクティビティ、 誰が誰に返信したか、その他の監視対象チャット、および言及されたウォレット、電話番号、ユーザー名 、リンクが表示されます。 すべての情報は、その記録にリンクしています。**「プロフィールのエクスポート」を行うと**、署名付きファイルが保存され、 オプションでパスワードZIPを設定できます。プロフィールをオフにすると、プロフィールファイルが削除されます。詳細については、「 [ユーザープロフィール」](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#people-profiles)を参照してください。 - **すべての著者を収集する** 同じタブ上で、Telegramに対し、チャット内に保存されたメッセージを持つすべてのユーザーのプロフィール、自己紹介、プロフィール 写真、ギフト、および自己紹介リンクの取得をリクエストします。チャンネル やスーパーグループでは、接続されている他のアカウントがこの作業を分担できます。選択された各アカウントは 収集作業に専念し、ユーザー全体を処理し、その作者の保存済みメッセージのいずれかを通じて 作者にアクセスします。別のタスクで忙しいアカウントは処理対象外となり、 空き次第に参加します。 連絡が取れない著者の場合は、チャット自身のアカウントに戻ります。 進行状況には、完了率、残り時間、各アカウントの分担割合が表示されます。 **一時停止** 勘定科目を解放します。保存された各レコードには、それを読み込んだ勘定科目の名前が記載されており、 各勘定科目がいつ参加し、いつ離脱したかは仕訳帳に記録されます。 - **今すぐプロフィールを保存する**は、チャットやボットのプロファイル(説明、 メンバー、招待リンク、ボットコマンド)のスナップショットを記録します。 ### 読み取り専用、送信、およびシークレット メッセージの上にある2つのスイッチは、アカウントと閲覧者を保護します: - チャットを開いたときは「**読み取り専用」モード**が有効になっています。 メッセージを送信したり、ボットの ボタンを押したりするには、この設定をオフにしてください。各操作を行う際、「**@アカウントとして送信しますか?**」または「**このボットボタンを @アカウントとして押しますか?**」と確認が表示されます。これは、チャットのメンバーにその操作が表示され、署名済みの ジャーナルに記録されることを示しています。**「このチャットでは10分間再確認しない」を選択すると**、しばらくの間、この確認が スキップされます。「**ケースの証拠**」という目標については、パネルおよびAPIにおいて、送信機能は無効になっています。 - **「Mask secrets」**は、パスワード、ログインコード、APIキーや ハッシュ、ボットトークン、セッション文字列、秘密鍵、JWT、またはクレジットカード番号 (カード番号はルーン和で検証されます)のように見える情報を隠します。**「Show」**を選択すると1つの値が表示され、その表示内容は ジャーナルに記録されます。このブラウザでのマスキングの無効化も記録されます。 表示のみが変更されます。元の記録およびすべてのエクスポートには、全文が保持されます。 ### 選択したメッセージを画像として保存する クラウドチャットで、[ ] を選択します。 **選択**, メッセージに印をつけ、次に **画像として保存**. チャット全体を記録するには、[ ] を選択してください。 **チャットを画像として保存する** チャットツールメニューでは、 保存されている最新の2,000件のメッセージが表示され、それより古いメッセージが除外されている場合はその旨が表示されます。 プレビューでは、 **光**, **ダーク** そして **クラシック** スタイル;長いキャプチャには「前へ」と「次へ」を 使用してください。 **署名付きZIPファイルをダウンロード** 各ページをPNG形式で保存し、さらに `pages.sig.json` そして `README.txt` ([署名入りチャットの画像](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#signed-chat-images)). 最大50件のメッセージを選択できますが、それらはすべて、読み込まれているチャット ウィンドウ内に表示されている必要があります。パネルでは、メッセージを黙って削除するのではなく、 選択範囲が大きすぎる場合は範囲を縮小するよう求められます。 各ページの末尾には、真正性ブロックが表示されます。そこには、ジャーナル記録番号、 チャット内容、レンダリング時刻、ワークスペースキーのフィンガープリント、 `verify.py` その ページ用のコマンド、およびチャット、キー、レンダリング時刻が記載されたQRコードが含まれます。署名を行うにはエクスポート 権限が必要であり、ジャーナルに `export.image_attested` 記録がジャーナルに追加されます。 画像には、保存された本文、作成者、メッセージ番号、UTC時刻、返信番号、 添付ファイルのラベル、および保存された編集・削除ステータスが含まれます。ここでは、保存された最新版の本文と 保持されているバージョン数が表示されますが、添付ファイルの内容、インラインボタン、 リアクション、および以前のバージョンの本文は表示されません。 長いメッセージは、 メッセージ番号とパート数を示して次のページに続きます。各ページには、 保存されたメッセージからレンダリングされたものであることが明記されています。PNG画像は視覚的な抜粋です。署名付きレコードや添付ファイルを 引き渡す際は、アーカイブとその検証ツールを使用してください。 レンダリングはTelegramへのリクエストを行わずにブラウザ内で行われます。署名については、 各ページのSHA-256とレコード番号のみがパネルに送信されます。既存の秘密情報マスキング機能により、テキスト、著者名、 および添付ファイルのラベルが保護されます。プレビューには閉じるまでスナップショットが表示され、パネルの ロックやワークスペース/チャットの変更時に消去されます。署名済みのジャーナルおよびレポートの選択内容は 変更されません。レポートの完全なエクスポートについては、[症例報告](https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/)を参照してください。 ### メッセージを転送する チャットの**「読み取り専用」**をオフにしてから、メッセージの下にある**「転送」**を選択するか、 最大100件のメッセージ**を選択**・マークして「**転送**」を選択します。送信先を 名前で選択します。リストには、保存済みのチャットや、そのアカウントが投稿可能な Telegramのチャット(グループ、プライベートチャット、ボット、および管理しているチャンネル)が表示されます。 パネルで 確認を求められた後、そのアカウントのメッセージ配信ペースに合わせて、Telegramのネイティブ機能を通じて 転送されます。リクエストとその結果は、送信元チャット、 メッセージ番号、送信先を明記した署名付きログレコードとして記録されます。コピーは、その チャットが監視されている場合にのみ、送信先に保存されます。転送を禁止しているチャットの場合は拒否が返され、何も送信されません。 ### チャットをチャンネルやグループに転送する メイン管理者は、保存済みのクラウドチャットを開き、ツールメニューから「**チャットを転送」** を選択できます。「**新しいチャンネル**」、「**新しいグループ**」、または**「既存のチャンネル またはグループ」**を選択してください。新しい転送先は非公開となります。既存の転送先の場合、**「チャットを選択」**では、そのアカウントが管理するグループやチャンネルが一覧表示されます。名前で検索してください。 宛先では、このアカウントによる投稿が許可されている必要があります。フォーラムの宛先はサポートされていません。 プレビューを行う前に、監視または他のアクティブなアカウントジョブを一時停止し、Telegramアクションを有効にしてください。 読み取り専用アカウントおよび「**事件の証拠**」ゴールは転送をブロックします。 **プレビューでは**、アクセス可能なTelegramの履歴範囲を読み取り、送信先を確認します。 送信先の作成やメッセージの送信は行われません。**「開始」**をクリックすると転送が開始されます。 プレビューは10分後に失効します。ワークスペースごとに1つの転送のみがアクティブにできます。 転送では、プレビューに表示されている最新のメッセージまで、Telegramの履歴が古いものから新しいものの順に読み込まれます。 これは、TgWitnessにすでに保存されているメッセージに限定されません。 その境界より後に到着したメッセージは除外されます。ネイティブ転送では、 Telegramの投稿者情報やメディアを、コピーをダウンロード・アップロードすることなく 保持します。境界内のアルバムはそのままの状態で保持されます。通知は表示されません。返信、 トピックの構造、リアクション、編集、および削除されたメッセージやアクセスできないメッセージは 復元されません。シークレットチャットはこのワークフローの対象外です。Telegramのコンテンツ保護 および投稿制限は引き続き有効です。 このパネルには、送信が確認されたメッセージ、スキップされたメッセージ、ステータス、および次回の送信可能時刻が表示されます。 サービスメッセージおよび個別に保護されたメッセージは、記録された 理由とともにスキップされます。アカウントのメッセージ間隔および1時間あたりの制限はすべてのメッセージに適用されます。アルバムは、 予約されたスロットの時間が来るまで待機します。FloodWaitおよびスローモードによる一時停止は、 アカウントの共有RPCバックオフを更新します。アカウントの既存のペース制御のデフォルト設定は変更されません。 **「一時停止」**はリクエスト間の処理を停止します。**「キャンセル」は、**すでに送信されたメッセージを削除したり、作成済みの宛先を削除したりすることなく、 残りの処理を停止します。処理中のリクエストは、 いずれの操作が有効になる前に完了する場合があります。ダイアログを閉じてもジョブはキャンセルされません。 プロセスの再起動後、未完了のジョブを再開するには明示的な**「再開」**操作が必要です。送信応答が失われたり 不完全であったりした場合、ジョブは確認のために一時停止されます。再開する前に 宛先を確認してください。再試行を行うと、保存されているTelegramのランダムIDと確認済みカウントは保持されますが、 これはTelegramによる無期限の重複排除が保証されるものではありません。作成結果が不明な 場合は自動的に再開できません。Telegramを確認し、作成された宛先(存在する場合)への新しい転送を開始する前に、 古いジョブをキャンセルしてください。 ジョブまたはそのジャーナルエントリの保存に失敗した場合、ワーカーは最後に保存された 状態を復元し、アカウントを解放します。すでにTelegramに到達している可能性のある 送信または作成は、引き続き「レビュー待ち」の状態のままとなります。保存が再び可能になった後、 失敗した開始または再開を再試行してください。確認済みの進行状況は、そのジャーナルエントリとともにのみ進みます。 署名済み `interaction.forward.*` 署名付き ジャーナルエントリには、境界、宛先、 確認済みの送信元/宛先メッセージID、およびスキップが記録されます。これらは転送の記録であり、 元の署名付き観測データやエクスポートデータを置き換えるものではありません。 ## ジャーナル ワークスペースが署名したすべての記録を、新しい順に表示します。 - **「概要」では**、監視対象のメッセージ数、記録された編集内容、削除通知、および 選択された情報源の数が表示されます。 - **イベントのタイムライン**は、イベントの種類(すべて、編集、削除、リアクション、 メンバーシップ、カバレッジ)、テキスト、およびソースでフィルタリングします。**以前のイベントを読み込む**は前のページに戻ります。 - レコードを開くと、その詳細、ハッシュ、ペイロードを確認できます。**このレコードへのリンクは**、 同じレコードを開くためのアドレスです。このプレビューでは機密情報がマスクされていますが、 エクスポートデータには元の情報が保持されます。 - ジャーナルは追記専用です。パネル内のどの操作でも、記録の編集や削除は行われません。 **エクスポート → ジャーナルの検証**または `python -m tgwitness.verify`で確認してください。 [エクスポートと検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/)を参照してください。 ## 出典 このワークスペースがどの会話を記録し、そこからどのような情報を保持するかを示します。変更は 今後のアクティビティに適用されますが、保存済みの記録はそのまま残ります。 **「チャットリストの更新」**は、アカウントのチャットとフォルダを読み込みます。メッセージはダウンロードされません。 ### 範囲 - **このアカウントが記録する内容** :**選択されたチャット** (追加したチャットのみ)、 **Telegramフォルダ** (アカウントのフォルダの一つ。後から追加されたチャットも 含まれる)、または**記事全文** (すべてのチャット、および新しいチャット、グループ、プライベートチャット、 ボットが追加されるたびに記録)。**調査モード** は専用アカウント用です。このアカウントが 閲覧するすべての内容、自身のメッセージやボタン操作を記録し、新しい チャットのプロファイルや以前に表示されたメッセージを即座に保存します。 [専用アカウントガイド](https://phishdestroy.io/tgwitness/docs/dedicated-account/) は、 メインアカウントを決して使用してはならない理由を説明しています。 - **「厳格:選択したチャットのみ**(デフォルトではオフ)」は、Telegramのサービス通知、セッション一覧、および有効化されたチャットの過去のメッセージの読み取りを停止します。機密コンテンツの設定には影響せず、通話に関する更新情報はスキップされます。詳細は[「厳格な選択チャット」](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#strict-chosen-chats)を参照してください。 - **ソースタイプにより、**フォルダモードおよびアカウント全体モードの対象は、チャンネル、グループ、プライベート チャット、ボットに限定されます。「**自身のアクション」では**、そのアカウント自身のメッセージ、編集、 返信時のキーボード入力などが追加されます。 - **新しいチャットやボットが表示されたら**、そのプロファイルと、指定した数までの 最新の表示可能なメッセージを保存します。 - **「選択したチャット」**には「おすすめ」のマークが付いています。「**変更を破棄」を選択すると、**フォームは 「**スコープを保存」**ボタンを押すまで、保存済みのスコープの状態に戻ります。 [「疑似シークレット」](https://phishdestroy.io/tgwitness/ja/docs/reference/secret-chats/)とは、本アプリに組み込まれた「シークレットチャット」インターフェースのことで、 プロトコルモジュールをインストール後、ボタンひとつでアカウントごとに有効化できます。クラウド上の 監視機能と履歴機能は、それぞれ独自の設定を使用します。 TgWitnessが 実行されていない間は何も記録されません。再起動後は、Telegramがまだ返している情報のみを 追跡し、レポートにはその間の空白期間が表示されます。チャットリストの上限([Parameters]で変更されていない限り1,000件のダイアログ)を超えたチャットは、 次にアクティブになった時点で追加されます。別のアプリ内で押された インラインボットボタンは表示されませんが、ボットの返信は記録されます。 ### 対象となるチャット ステータス(**有効**、**一時停止**、**優先度**、**除外**、**未確認の アクセス**、**無視**)やタイプでフィルタリングし、選択した項目に対して有効化、一時停止、優先度の設定または解除、 範囲からの除外、削除などの操作を行うことができます。ステータスバッジには状態のみが表示されますが、操作は 各行のメニューにあり、その機能の説明が記載されています。 一時停止や除外を行う際は、 確認が求められます(一括操作時も同様です)。ソースを削除する際はソース名の入力が求められ、関連する人物 プロフィールが削除されますが、保存された記録はジャーナルに残ります。 アカウントのチャットリストには表示されないが、記録が引き続き届いている状態を示すのは**更新の受信(チャットリストには表示されない)**であり、それ以外の場合は**アクセス未確認**です。**利用可能なチャット**は、**選択した項目を追加**または**一致するすべてを追加**とのチャットを追加します。 ### 全履歴 有効になっているすべてのソースの利用可能な履歴を、「チャット」と「ジャーナル」に読み込みます。 進行状況は再起動後も保持され、添付ファイルはメディア設定に従います。 [ソース履歴を](https://phishdestroy.io/tgwitness/ja/docs/reference/history/)参照してください。 ### 記録 - **保存する変更内容を選択してください**:新しいメッセージ、編集、削除通知、 表示されているリアクション、参加および退出。プリセットを選択するとフォームが変更され、 **「記録設定を保存」**をクリックすると適用されます。カテゴリを再度有効にしても、 見逃したイベントは復元されません。 - **利用可能な場合はメディアを保存します**:添付ファイルは1ファイルあたりのサイズ制限内でダウンロードし、 ファイルタイプごとに1~2,000 MiBの範囲で設定し、動画の長さを秒単位で制限します(0は制限なしを意味します)。 ダウンロードの試行ごとに、その結果が記録されます。 - **再確認**:優先チャットは数分おきに、その他のチャットはめったに確認しないため、アカウントは TelegramのFloodWait制限に引っかからないようにしています。0に設定するとグループが無効になります。優先チャットは リスト内の星マークでマークしてください。1回の処理で処理するチャット数とチャット間の休止時間は 「パラメータ」で設定できます。[コレクションを](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/)参照してください。 - 「保存」バーには、これらの設定が推奨設定と一致しているかどうかが表示されます。**「推奨設定に戻す」を選択すると 推奨**値が入力され、「**録画設定を保存」**を選択すると設定が適用され、 「**変更を破棄**」を選択すると保存済みの設定に戻ります。 ## エクスポート **「Downloads」**ではファイルの準備を行い、「**Build report」**ではレポートの表示形式を選択します。 | 概要 | 次のような用途にご利用ください | ガイド | | --- | --- | --- | | アカウントのエクスポート | そのアカウントが現在閲覧可能なコンテンツの最新スナップショット | [アカウントのエクスポート](https://phishdestroy.io/tgwitness/ja/docs/reference/account-export/) | | コピーの共有 | 完成したアカウントエクスポートの簡略版 | [開示事項](https://phishdestroy.io/tgwitness/ja/docs/reference/account-export/#prepare-a-disclosure-for-a-lawyer-or-another-recipient) | | 署名済み ZIP | 固定されたジャーナルの境界におけるジャーナル、レポート、添付ファイル、および検証ツール | [エクスポートと検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) | | HTML、PDF、JSON形式のレポート | 封印された読み取り可能なレポート | [事例レポート](https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/) | | JSONL、CSV | 署名付きのオリジナル記録;数式が破損しないスプレッドシート | [エクスポートと検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) | | 引き継ぎ要約 | 受信者が必要とするチャット、期間、および人物のみ | [証拠](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#investigation-handoff) | | チャットのエクスポート | 署名済みのチャット1件 `chat.json` および `chat.html` | [1つのチャットをエクスポートする](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md) | - **上記のダウンロードファイルをパスワードで暗号化してください**(12文字以上)は、 7-ZipやWinRARで開くことができるAES-256 ZIPを保存します。中の署名付きファイルは変更されていません。 パスワードは保存されません。 - このワークスペースのセッションキーがインポートされた際、アカウントのエクスポートおよびチャットの エクスポートダイアログには、1行でその旨が表示されます。つまり、そのキーのコピーはTelegramの セッションリストの外にも存在し得るということです。同じ行には「**独立した認証を作成**」というオプションがあり、 これを選択すると、そのオプションが選択された状態でサインインページが開きます。 [アカウント](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#create-an-independent-authorization)を参照してください。 - 失敗またはキャンセルされたチャットのエクスポートでは、保存された範囲が保持されます。「**1つのチャットをキャプチャまたはエクスポート」** を選択すると、「**エクスポートを再開」**と「**最初からやり直す**」が表示されます。「 [1つのチャットをエクスポート](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md)」を参照してください。 - 「チャットのエクスポート」では、「**これまでに読んだメッセージをダウンロード」**を選択すると、ZIPファイルが保存されます。このファイル内の各ページは、 書き込み時に署名されています。その下の行には、署名されたメッセージの数が表示されます。 - **準備済みのエクスポートには**、2 GiB以内のファイルが最大20個と、最新の1個が保存され、 繰り返しダウンロードが可能となっています。各ファイルには、受信者が照合できるようSHA-256ハッシュ値が付与されています。各カードには、ファイルの内容が記載されています: **署名付きアーカイブ**(ジャーナル全体とそのレコード数)、**レポート**、**ジャーナルレコード**、**または引き継ぎ 抽出データ**、案件名とID、および作成に使用されたレポートの選択項目(チャット、選択されたメッセージ、日付)です。 **「表示」をクリックすると、**1つのファイルに複数の種類が含まれている場合、リストが1種類に絞り込まれます。 - ブラウザが保存ダイアログを拒否した場合、パネルは通常のダウンロードに切り替わります。 - **署名用IDには**、鍵のフィンガープリントが表示されます。「**チェックポイントの保存」**および 「**署名済み実行レシートを**ダウンロード」を使用すると、コレクターの外部に保存できる記録が得られます。 「**タイムスタンプリクエスト**の準備」は、いかなるサービスにも接続することなく、RFC 3161準拠のリクエストを生成します。 ## 設定、アカウント、接続 - **設定**:目標、接続、記録対象、およびインターフェース。 [初期設定と設定を](https://phishdestroy.io/tgwitness/ja/docs/reference/settings/)参照してください。 - **アカウント**:各ワークスペースの状態、ソース、イベント、添付ファイルキューが表示されます。 **要確認**、**収集**、**オフラインまたは一時停止中**、または**未接続**でフィルタリングしたり、選択範囲の一時停止や再開を行ったり、アカウントファイルを一括インポートしたり、 グループを管理したりできます。[アカウント](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/)を参照してください。 - **アカウント**: このアカウントのサインインおよび接続経路。「ダイレクト」、WireGuard プロファイル、独自のプロキシ、パブリックMTProtoプール、またはWARP。経路を準備・確認し、 このアカウント、グループ、またはすべてのアカウントに適用します。詳細は [接続とプロキシ](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/) および [プロキシ](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md). **アカウントのセキュリティ → このアカウントのセッション** Telegramのセッションを一覧表示し、1つ またはすべてを終了させ、また — このワークスペースで作成されたキーの場合 — **「Telegramが許可している場合は、これを 唯一のセッションにする」**、この操作は、 24 時間 Telegramが要求する24時間経過後に、設定された2段階認証パスワードを一度表示します。詳細は [アカウントのセキュリティ](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#create-an-independent-authorization). **アカウントのセキュリティ → ウィットネス・プローブ** 別のワークスペースを使用して、この セッションがリアルタイムで更新を受信していることを確認します。詳細は [ウィットネス・プローブ](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#witness-probe). 一括の一時停止および再開を行うと、確認済みの選択内容は、それが 開かれたセッション内に保持されます。確認または実行が保留中の間は、コントロールは無効なままとなります。 ワークスペースを変更したり、パネルをロックしたりすると、残りのコマンドはキャンセルされます。 実行後、パネルはアカウントの状態を更新します。リクエストが失敗した場合、 サーバーがすでにそのコマンドを適用している可能性があるため、リクエストの失敗として報告されます。 コマンドは自動的に再実行されません。 ## 追加機能 オプション:収集を開始するには、アカウントと情報源さえあれば十分です。選択したオプションのみ の設定画面が開き、自動的に接続されることはありません。上部の「 **保護レベル**」カードには、[保護モード](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#protection-modes)が表示されます。 | カード | 追加機能 | ガイド | | --- | --- | --- | | ストレージとディスク容量 | バックアップ、古いファイルをクラウドへ移動、削除できない証拠用コピー | [ストレージ](https://phishdestroy.io/tgwitness/ja/docs/reference/storage/) | | 目的と保護レベル | 目標と2つの尺度に対する推奨設定 | [以下](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#goal-and-protection-level) | | 通知 | 問題点、変更されたメッセージ、日次サマリー、そして自分専用のコントロールボット | [以下](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#notifications) | | 証拠とバックアップ | タイムスタンプ、追加のウィットネス、および暗号化されたオフサイトコピー | [以下](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#evidence-and-backups) | | サーバーは24時間365日稼働しています | SSH 機能のないクラウドサーバーで、パネルから作成・削除が可能です。 | [高信頼性](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#from-the-panel) | | 独立した証人 | TelegramチャンネルやDiscordに投稿される署名済みチェック | [ウィットネス](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/) | | コードチェック | 実行中のプログラムと、GitHub上の公開コミットを比較します | [以下](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#code-check) | ### 目的と保護レベル 4つの質問: 1. **これは何に使うのですか?** 個人の記録、調査、または事件の証拠。 2. **どの程度の範囲を監視しますか?** 少数のチャット(最大約50件)、多数のチャット(最大約 500件)、あるいはアカウント全体。これにより、チャットリストの上限が1,000件、3,000件、または20,000件に設定されます。 3. **写真やファイルは?** テキストのみ、写真や短いメディア(写真 20 MB、動画 100 MB)、またはすべて(動画やドキュメントはそれぞれ最大 1 GB)。アカウント全体を 含む「すべて」を選択しても、4 GiB のディスク空き容量は確保されます。 4. **どこで実行されるのか?**このコンピュータ、または常時稼働しているサーバーです。 提案リストには、独立したタイムスタンプ、drand、Telegramのデバイスリストが記載されており、それぞれ 追加される内容について1行ずつ説明があります。タイムスタンプは、個人用 記録、調査、または証拠として、60分、30分、または10分ごとに開始されます。drandとデバイスリストにはタイムスタンプが必要です。変更を **適用するのは**、これら、添付ファイルポリシー、および上記の2つのパラメータのみです。各 変更はジャーナル記録となり、さらに `setup.applied`。通知、オフサイトコピー、 サーバー、ゲートウェイDNS、コードチェック、および証人は、次のステップとして、それぞれ 専用のフォームとともに提供されます。 2つのスケールは、目標値ではなく、設定された値に基づいて算出されます: | スケール | ポイント | | --- | --- | | 信頼性 | 署名付きジャーナル 1、タイムスタンプ 3、drand 1、デバイスリスト 1、一致するコードチェック 1、ウィットネスポーリング 1、認証済みサーバー 2、ゲートウェイ DNS ログ 1 | | 信頼性 | 常時稼働サーバー 3、オフサイトコピー 3、オブジェクトロック 1、問題通知 1 | 「読み取り」が**最大**で80%以上、50%以上なら「**高」**、25%以上なら**「中」**、それ以下は「**基本**」と評価されます。 信頼性は現在、質問4の回答にある常時稼働サーバーを基準として算出されており、 他のサーバーがチェックされる前の段階での評価となります。 ### 通知 通知はAppriseを経由して、Telegram、Discord、Slack、ntfy、メール、Matrix、および その他100以上のサービスに送信されます。サービスを選択し、1~2つのフィールドに入力してテスト送信を行うか、 Appriseのアドレスを直接貼り付けてください。 - **問題点**:ディスク容量がほぼ満杯、アカウントからログアウト、収集・コピー・タイムスタンプ エラー、デバイス、アプリケーション、および Telegramの国別リストを含むアカウントへの新規セッションのログイン、観測中にTelegramが報告する ログインコードまたは新規サインイン、および**「このセッションのみにする**」後の別のセッション。封印された サーバー上では、開かれたSSHポートやログインも問題となります。 - **変更点**:監視対象のチャットにおける削除済み、編集済み、および欠落したメッセージを、 チェックごとに1つの通知にまとめます([Parameters]で変更されていない限り、1分ごとにチェックが行われます)。 - **完了したタスク**:履歴、エクスポート、保存用コピー。 - **ウォッチリストのヒット**:アラートを送信するように設定されたウォッチリストとの一致。 - サーバー時間に基づき、指定した時刻に**日次サマリーが**配信されます。 通知にはチャット名と件数が表示されます。メッセージの抜粋表示はデフォルトでオフになっていますが、 これをオンにすると、メッセージ本文がこのマシンから外部に送信されます。 **オペレーターボットとは**、@BotFatherから作成した独自のボットであり、以下の質問に回答します `/status` 、 `/stats`、およびオプションで `/pause`, `/resume` および `/copy`に対応します。リストされたチャットおよび TelegramユーザーIDのみがこれを利用でき、会話のテキストはワークスペース内に残ります。別のアプリケーションがすでにそのコマンドを受信している場合は、別の ボットを使用してください。 [通知](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Notifications.md)および[オペレーターボットを](https://phishdestroy.io/tgwitness/ja/docs/reference/storage/#operator-bot-and-completion-notices)参照してください。 ### 証拠とバックアップ - **独立したタイムスタンプは**、各署名付きチェックポイントのSHA-256のみを、5~1,440分ごとにRFC 3161 の認証機関およびOpenTimestampsカレンダーに送信します。受信者は、 証拠として最低限、このようなサードパーティの時刻情報が必要です。**Anchorは現在** パスを実行中です。[タイムスタンプを](https://phishdestroy.io/tgwitness/ja/docs/reference/timestamp/)参照してください。 - **さらに多くの「ウィットネス」**が存在しますが、これらは選択されるまでは非アクティブ状態です。最新の drand ラウンド、Telegram の IP アドレスを含まないログイン済みデバイス一覧、および Cloudflare Gateway のサーバーの DNS クエリログなどです。[オプションの記録を](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)参照してください。 - **暗号化バックアップでは**、ジャーナル、ファイル、チェックポイント、チャットのエクスポートデータを S3互換のストレージ(Wasabi、Amazon S3、Backblaze B2、Cloudflare R2、MinIO)にコピーします。 すべてのデータはまずこのマシン上で暗号化されます。**暗号化キーをダウンロードし**、 別の場所に保管してください。これがないと、バックアップを読み取ることができません。ガバナンスまたはコンプライアンスモードの「オブジェクトロック」機能は、 オブジェクトが設定された日数間削除されないようにします。「[オフサイトコピー」](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Off-site-Copy.md)を参照してください。 ### コードチェック インストールされたプログラムが公開されているバージョンと一致するかどうかを確認します。 1. GitHub リポジトリ(公式のリポジトリは既に入力済み)と、タグ、ブランチ、またはコミットを入力してください。 2. **「Check now」は**、このワークスペースの外部リクエスト用ルートを通じて GitHub の API に問い合わせ、 そのコミットのファイル一覧を取得します。そして、測定対象の各プログラム ファイルの git blob ID をコミットと照合します。改行コードが変換された Windows 環境でのチェックアウトでも、照合は成立します。 3. 結果には、変更されたファイル、追加されたファイル、欠落しているファイル(それぞれ最大50件)が一覧表示され、 ジャーナル記録として保存されます。 `source.checked` ジャーナル記録として保存されます。 結果は、実行中のプログラムファイルに変更がない間のみ最新のものとして扱われます: 更新後は再度確認してください。トークンは不要で、パブリックリポジトリのみが対象となります; チャットや認証情報はアップロードされません。一致判定はディスク上のコードを識別するものです。これは ハードウェアによる認証ではありません。それについては、[Phala Cloud](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx)を参照してください。 ## 保護モード バージョン番号の横にあるスイッチャーは、選択されているモードと、18の 保護レイヤーのうちいくつが有効になっているかを示します。例えば、 `🟠 Witnessed 9/18`。**Change mode**を **追加情報 → Protection level**で開くと、選択画面が表示されます。モードは対象を定義し、 まだ不足している項目を一覧表示します。記録、署名、保存された設定は、どのモードでも同じです。 | モード | For | 追加機能 | | --- | --- | --- | | 🟢 簡単 | チャットの監視とコピーの保存 | 「Chats」には、ジャーナルとチャットのエクスポートが含まれます。署名処理はバックグラウンドで実行されます。 | | 🟡 署名済み | プラットフォーム、ホスト、または不正利用対応窓口への報告 | 署名付きアーカイブ、ジャーナルチェック、チェックポイント、引き継ぎ用抽出データ | | 🟠 ウィットネス済み | 記録が改ざんされたと主張される可能性のあるケース | 署名済みのジャーナルヘッダーを投稿する独立したウィットネス | | 🔴 法廷での使用に対応 | 弁護士、警察、または裁判所向けの証拠資料 | タイムスタンプ、暗号化されたオフサイトコピー、レポート内のケース詳細 | | 🟣 GitHub 認証済み | そのソフトウェアは誰でも確認できるものでなければならない記録 | コードチェックと GitHub Actions のキャプチャ | | ⚫ 最大 | 資金力のある相手に対する、重大な案件 | 24時間365日稼働の密閉型サーバー、隠されたIPアドレス、全18層 | 構成要素:すべての記録は署名され、チェーン化される;署名付き実行レシート;SHA-256 を使用して保存された添付ファイル;署名付きチェックポイント;再チェック;問題アラート;読み取り専用のウィットネスアクセス; スケジュールに従ってチェックを行うウィットネス;RFC 3161 タイムスタンプ;OpenTimestamps 証明;検証済みの 最新タイムスタンプ;暗号化されたオフサイトコピー;レポート内のケース詳細;コードの一致 チェック; TelegramがこのマシンのIPを一切認識しないこと;プロキシ経由の外部リクエスト;コピーへの オブジェクトロック;プロバイダーの記録を保持する封印されたサーバー。オフになっているレイヤーには「 **セットアップ**」があり、そのフォームが開きます。より低いモードを選択すると確認を求められ、 何も削除されません。 ## その他のツール **[Extras] → [独立キャプチャ]**: 別のブラウザまたはAyuGramレコーダーを接続し、その署名キーを固定し、キャプチャオプションを選択し、 開始・一時停止、スナップショットの撮影、および検証済みの署名付きアーカイブのダウンロードを行います。各レコーダーには、 独自のマニュアルログイン、ルーティング、ジャーナル、およびキーがあります。両方の接続は、初期状態では無効になっています。 英語の「[独立キャプチャガイド](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md)」を参照してください。 - **アーカイブに問い合わせてみましょう**:保存された観察結果を検索し、出典を確認した上で、 それらをAIモデルに送信するかどうかを決定します。[アーカイブ分析](https://phishdestroy.io/tgwitness/ja/docs/reference/analysis/)および ロー[カルでのOCRと文字起こしを](https://phishdestroy.io/tgwitness/ja/docs/reference/media-analysis/)参照してください。 - **パラメータ**:収集の制限とペース、再確認、ダウンロード、プロファイル、 通知、エクスポート。「名前で検索」、「**変更された値のみ**を表示」機能、および 「デフォルトを**復元…**」によるデフォルト設定の下書き作成。**パラメータの保存**を行うと、 次回使用時からその値が適用され、変更のたびにログ記録が残ります。 - **アクセス権限**:レビュー担当者、アナリスト、オペレーターごとに個別のトークンが発行され、選択された ワークスペース、チャット、権限に限定されます。[アクセス権限については](https://phishdestroy.io/tgwitness/ja/docs/reference/access/)こちらをご覧ください。 - **システムログ** :このプロセスが起動してから行った操作(接続、プロキシの変更、 ログイン、拒否、設定の変更)を、IPアドレスを非表示にして記録します。**「改行を追跡」機能により、** 最新の行が常に表示されます。メッセージはジャーナルにのみ残ります。 - **連携機能**:AI プロバイダー、[読み取り専用の MCP](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/) 接続、および [署名付き Webhook](https://phishdestroy.io/tgwitness/ja/docs/reference/webhooks/)。 - **Case Board**:証拠の横に表示される、チーム専用のメモ、ブックマーク、スライス。 [Case Board](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/)を参照。 - **ドキュメント**:[調査モード](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md)のドロワー。 ドキュメント化されたセッションの記録中は、メインサイドバーに移動します。 - 「エクスポート」内の**GitHub Actions capture**:あなたのフォークから取得したチャットが1つ表示されています。 [シールドキャプチャ](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)を参照してください。 --- # Telegram · 収集の仕組み Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/collection/ 記録範囲、リアルタイム更新、再確認、添付ファイル、自身の操作、および「ギャップ」の意味について、記録ごとに解説しています。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) Translation coverage: this edition includes material from the English original. 記録範囲、リアルタイム更新、再確認、添付ファイル、自身の操作、および「ギャップ」の意味について、記録ごとに解説しています。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [コレクション](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![コレクション](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69) TgWitnessは、接続されたTelegramアカウントが観測した内容を記録します。ライブモニタリングでは、 メッセージ、キャプチャされた編集内容、削除通知、および添付ファイルを、 その観測時刻とソースコンテキストとともに保持します。履歴の読み取り、再確認、および利用可能な 管理ログレコードにより、個別に識別された観測結果がそのレコードに追加されます。 **このページでは** - [ログインからジャーナルまで](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#from-login-to-a-journal) - [監視範囲:選択したチャット、フォルダ、またはアカウント全体](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account) - [適用範囲とイベントの選択](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#scope-and-event-selection) - [自身のアクション](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#own-actions) - [調査モード:チームへの参加とボットとの対話](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots) - [階層の再確認](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#recheck-tiers) - [メッセージ履歴と出典](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#message-history-and-attribution) - [履歴のスナップショット](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#history-snapshots) - [添付ファイルの取り扱い](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#attachment-handling) - [一時停止、ロック、切断、再起動](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#pause-lock-disconnect-and-restart) - [アカウントの分離と検証](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#account-isolation-and-verification) ## ログインからジャーナルまで 自己消滅型写真およびファイルについては、「[自己消滅型メディア」](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md)を参照してください。 ここでは、優先度ワーカー、保存済みおよび利用不可の結果、およびAPIコレクターにおける 既読通知ブロックの制限について説明しています。 フローチャート · ユーザーアカウントの認証 → アクセス可能なグループおよびチャンネルを選択してください; アクセス可能なグループおよびチャンネルを選択してください → イベントおよび添付ファイルの設定を保存する; イベントおよび添付ファイルの設定を保存する → 監視を開始する; 監視を開始する → アクティブなクライアントからの更新情報を受け取る; アクティブなクライアントからの更新情報を受け取る → 情報源およびイベントに関するポリシーを適用する; 情報源およびイベントに関するポリシーを適用する → 署名付き観測記録を追加する; 署名付き観測記録を追加する → ジャーナルの確認またはエクスポート; 署名付き観測記録を追加する → キューに格納された添付ファイルを処理する; キューに格納された添付ファイルを処理する → ダウンロード結果を追加してください · ユーザーアカウントの認証 · アクセス可能なグループおよびチャンネルを選択してください · イベントおよび添付ファイルの設定を保存する · 監視を開始する · アクティブなクライアントからの更新情報を受け取る · 情報源およびイベントに関するポリシーを適用する · 署名付き観測記録を追加する · ジャーナルの確認またはエクスポート · キューに格納された添付ファイルを処理する · ダウンロード結果を追加してください **図表をテキストで記述** 1. ユーザーアカウントの認証 → アクセス可能なグループおよびチャンネルを選択してください 2. アクセス可能なグループおよびチャンネルを選択してください → イベントおよび添付ファイルの設定を保存する 3. イベントおよび添付ファイルの設定を保存する → 監視を開始する 4. 監視を開始する → アクティブなクライアントからの更新情報を受け取る 5. アクティブなクライアントからの更新情報を受け取る → 情報源およびイベントに関するポリシーを適用する 6. 情報源およびイベントに関するポリシーを適用する → 署名付き観測記録を追加する 7. 署名付き観測記録を追加する → ジャーナルの確認またはエクスポート 8. 署名付き観測記録を追加する → キューに格納された添付ファイルを処理する 9. キューに格納された添付ファイルを処理する → ダウンロード結果を追加してください 認証、ソースへのアクセス、稼働中のコレクター、および完全な配信は それぞれ異なる問題です。ログインに成功しても、すべてのグループへのアクセスが許可されるわけではありません。 配信は個別に追跡されます。カバレッジ記録、更新ギャップの回復、および再チェックにより、 何が届いたかが確認できます。 ## 監視範囲:指定したチャット、フォルダ、またはアカウント全体 **その他のツール → ソース → スコープは、**ワークスペースがどのチャットを記録するかを決定します。 新規設定は「**チャットを選択**」から始まります。既存の保存済み設定は引き継がれます。セットアップウィザードで「 **すべてのチャット」**を選択すると、読み込まれたリストに 50件を超えるチャットが含まれている場合に確認のメッセージが表示されます。チャット数の推定は、引き続きサンプルに基づく個別の処理として行われます。 | モード | 記録 | 新しいチャット | | --- | --- | --- | | 選択したチャット(デフォルト) | 手動で追加したチャットのみ | 自動的に追加されることはありません | | Telegramフォルダ | アカウントのフォルダ内のチャット:フォルダに指定されたチャットに加え、そのフォルダのカテゴリ(連絡先、非連絡先、グループ、チャンネル、ボット)に含まれるチャットから、除外されたチャットおよび(フォルダの設定で指定されている場合)アーカイブされたチャットを除いたもの | 該当するチャットは、アクティブになるとすぐに追加されます。Telegramのフォルダに追加したチャットは、1時間以内に取り込まれます。 | | アカウント全体 | そのアカウントで表示されるすべてのチャット | 新しいチャット、グループ、プライベートチャット、またはボットは、最初の更新が届いた瞬間に追加されます。 | - **Source types** (channels, groups, private chats, bots) narrow the folder and whole-account modes. Chosen chats can be of any type, including private chats and bots; source types never stop a chat you added by hand. A type turned off, an exclusion or a switch to chosen chats stops automatically added sources as soon as it is saved, before the source list is recalculated and also when Telegram cannot be reached: their new messages, history passes, new-chat history, peer settings and profile observations. - **手動で追加したチャットは**、たとえフォルダの外にあっても、フォルダモードおよびアカウント全体モードで記録され続けます。 これらを停止させるには、*「除外」*、「*削除*」、または一時停止を行う必要があります。スコープによって (*自動的に*)追加されたチャットはフォルダに追従します。フォルダから外れたチャットは、次回の再計算時に一時停止されます。 - **除外されたチャットは**、どのモードでも記録されることはありません。フォルダモードおよびアカウント全体モードでは、 ソースで*「除外」*または*「削除」*を行うと、そのチャットがこのリストに追加されるため、スコープによって再度追加されることはありません。 手動でそのチャットを再度選択すると(「ソース」内の「チャット」から、または「設定」→「**どのチャット?**」から)、 リストから除外されます。リストには最大5,000件のチャットが保存されます。それを超えると、*「削除」*は拒否され、 代わりにチャットを一時停止することができます。 - **自身の操作**(デフォルトでオン):このアカウントが送信するメッセージ、その編集、および 返信キーボードのボタン操作。オフにすると、送信メッセージと編集はスキップされます。 - フォルダまたはアカウント全体に切り替える際には確認が求められます。これらのモードでは、 プライベートチャットや第三者のメッセージが記録されるため、専用のアカウントでのみ使用してください。 確認およびすべてのスコープ変更は、`scope.changed`レコードとして記録されます。メインアカウントとして 設定されたアカウントでは、スコープ設定フォームおよび調査機能は、startと同様にフォルダまたはアカウント全体の 選択を拒否します。これらを使用できるのは、記録を行わない1回限りのコピーのみです。 - スコープによって追加されたチャットは、*「auto」*とマークされたソースとして表示され、`scope.applied` (開始時および1時間ごと)または`source.discovered`(監視中に新たに検出されたチャット)として記録されます。選択したチャットに 戻すと、アカウントのチャットリストを再度読み込むことなく、自動的に追加されたすべてのソースが一斉に一時停止されます。 除外されたチャットは、スコープが 保存されるとすぐに記録が停止し、Telegramがチャットリストを返さない場合でもそのソースは一時停止されます。 監視中にスコープを保存すると、値に変更がなくても、スコープが再度適用されます。 これらのモードの適用範囲: - **「シークレットチャット」**では、付属の「[疑似シークレット」統合](https://phishdestroy.io/tgwitness/ja/docs/reference/secret-chats/)機能を使用しており、 パネルからプロトコルモジュールをインストールし、アカウントごとに有効化スイッチを設定します。クラウド履歴 および「テイクアウト」では、別の取得パスが使用されます。 - **オフライン期間。**再起動後、TgWitnessは保存された更新位置から再開し、 Telegramに欠落した更新を問い合わせ、チャットを再確認します。Telegramはバックログに上限を設けているため、 長時間の停止後には、レポートおよび`verify.py`が、残りの期間をギャップとして表示します([カバレッジを](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)参照)。 - 開始時には最初の1,000件のダイアログのみが表示されます(制限値は「**その他のツール」→「パラメータ」**で確認可能)。それより古い チャットは、次にアクティブになった時点で追加されます。追加されたチャットのそれ以前の履歴は取得されません。必要な場合は、履歴の スナップショットまたはチャットの完全なエクスポートを行ってください。 - 常に変化するフォルダの状態(ミュート、既読)は適用されません。そのようなチャットは 引き続き監視対象となります。 - 別のアプリで押された**インライン(コールバック)ボットボタンは**、2つ目の セッションからは認識されません。ボットの返信や編集は記録されます。返信用のキーボード入力は送信 メッセージとして届き、「`button_press`」というラベルが付けられます。 - チャットが増えれば、リクエストも増えます。Telegramは、同社が 過剰と判断した通信量に対してアカウントを制限するため、専用のアカウントを使用すべき理由がまた一つ増えます。 ### 厳選されたチャット **「厳格」:選択したチャットのみを読み取ることができ**、「**選択したチャット**」の下に表示されます。デフォルトではオフになっています。これは、 選択したチャットのみを対象とする権限を意図したものです。オンになっている場合は: - Telegramのサービス通知(777000)が読み取られていません。観測の開始時や終了時にも、観測中の毎 分にも読み取られていません。`session.security_baseline`や`account.security_event`の記録は一切書き込まれていません。 - The account's session list is not read: not when observation starts or stops (the panel's question about other sessions for **Evidence for a case** and the evidence protection modes is skipped too), not every two minutes while observing, not when a connection opens, and not by the connection check, whose *Current authorization* entry is shown as skipped. The two-step verification status used by the takeover check is not read either. So `account.sessions`, `session.concurrent_at_start` and `session.takeover_risk` are not written, and a session ended from another device is not reported as `session_revoked_externally`. - While this is the only session of the account (**Make this the only session** or its automatic version), the session list is still read every two minutes while observing and when a connection opens, so that `session.exclusive_ended` is recorded when another session appears. 777000 stays unread in that period, although the `session.exclusive_from` record says Telegram's sign-in notices keep being recorded. - 削除通知は、過去10分以内にセッションチェックが実行された場合のみ(そのセッションが 唯一のセッションである場合、または**このアカウントの「セッション」**を開いた後)、セッションチェックと比較されます。 それ以外の場合は、前回の権限チェックで このアカウントがメッセージを削除できなかったことが示されていない限り(プライベートチャットや通常のグループチャットではそのようなことは決してありません)、次のように表示されます:「*誰が 削除したかは不明です。このアカウント自体が、別のセッションやデバイスから削除した可能性もあります。」* - With a session key that was imported, nothing in the journal gives the time this session signed in until the session list is read (for example in **Sessions of this account**). Until then chat exports and **Automatic** account exports use the regular session instead of Takeout, with the reason `session_age_unknown`. - Turning a chat on does not read its earlier messages. Without the switch, each chat turned on (in Sources, in Chats, by joining from the panel or in the setup wizard) gets one `baseline` snapshot of its latest messages, up to **More tools → Parameters → Largest history snapshot** (500 by default), when observation next runs. A waiting snapshot that comes due while the switch is on is dropped. A chat joined from the panel does not get its latest messages read as a new chat either (the **When a new chat or bot appears** count, 100 by default), and opening a chosen chat with no saved messages in Chats does not load its last 100 messages by itself. **Load history** and snapshots you start yourself still read history. - アカウントの「機密コンテンツ」設定は、読み取られたり変更されたりすることはありません。このスイッチがない場合、サインイン時や新しい 接続のたびに、設定がオフの状態でオンになり、Telegram はこの変更を許可します(`account.content_settings`)。この設定は アカウントに紐づいており、すべての Telegram アプリで適用されます。Telegram が「機密」とマークしたコンテンツは、非表示のままになる場合があります。 - 電話による更新情報は、`account.phone_call` として記録されません。 - 観察を停止しても、セッションキーのフィンガープリントのみが書き込まれ、セッションリストや777000は読み込まれません。 It does not narrow what Telegram sends: updates of every chat still reach this session, and only the chosen chats are recorded. The account's chat list (up to **Chats read from the account's list**) and its folders are still read at start, and again when the scope is saved while observing, to find the chosen chats. Deletion notices without a chat (`deletion.unscoped`) are still recorded: they carry message IDs only and may belong to a chosen private chat or ordinary group. The frozen-account check (`help.getAppConfig`), the other connection checks, and features you turn on yourself (ending other sessions automatically, the witness probe, pseudo-secret chats, **Sessions of this account**, and Telegram's list of signed-in devices under **More witnesses**, which reads the session list at each timestamp pass and which setup ticks for the **Follow chats** and **Evidence for a case** goals) keep working. サインインする前に有効にしてください。そうしないと、サインイン処理そのものが現在の権限を確認し、機密 コンテンツを有効にしてしまいます。変更があるたびに、署名付きの `scope.changed` レコードが生成され、`observation.started` には `scope.strict` としてその値が格納されます。フォルダまたはアカウント全体に切り替えると、この機能は無効になります。 ## 適用範囲とイベントの選択 各ワークスペースには独自のソースがあります。TgWitnessはグループに参加したり、 招待を受け入れたり、すべてのメンバーを自動的に列挙したりすることはありません。ソースは、 アカウントからすでにアクセス可能なものでなければなりません。起動時、コレクターは選択されたソースを アカウントの表示可能なダイアログと照合します。「**その他のツール → パラメータ → チャット」でアカウントのリストから読み取る設定**に別段の指定がない限り、 最初の1,000件のダイアログが検査されます。 存在しないソースは「**アクセス未確認」**とマークされ、あなたが削除されたとはみなされません。 | 設定 | 収集します | 無効にした場合の影響 | | --- | --- | --- | | 新しいメッセージ | 通常配信されたメッセージ | 後から行われた編集や削除については、比較対象となる以前に記録されたテキストが存在しない場合があります。 | | 編集 | 編集済みのメッセージ版を提供 | 途中での変更内容は、後から復元されることはありません。 | | 削除 | 範囲指定された削除通知と、範囲指定のないアカウントレベルの通知 | 削除通知はジャーナルには追加されません。 | | 反応 | 送信された反応のスナップショット | 個別の反応に関する更新情報は追加されません。 | | メンバーシップ | 会員向けサービスのお知らせや参加者への最新情報を配信しました | これらの会員に関する観察事項は追加されていません。 | 設定は、ワークスペース内で選択されたすべてのソースに適用されます。変更を適用するには、フォームを保存してください。 変更内容は、署名付きの「変更前」および「変更後」の値とともに記録されます。カテゴリを無効にしても、 それ以前の記録は削除されません。また、再度有効にしても、見逃した更新内容は遡って反映されません。 運用記録やその他のグループサービス関連のイベントは、これらの 設定とは別個に扱われます。メンバーシップサービスメッセージについては、通常の 新規メッセージのキャプチャが無効になっている場合でも、メンバーシップが 有効になっているとメッセージ記録が生成されることがあります。キャプチャされたTelegram オブジェクトには埋め込まれたメタデータが保持されます。設定は、情報の黒塗りルールではありません。 **プライベートチャットや通常のグループでの削除は**、チャットを伴わないメッセージIDとして届きます。 これらのチャットはアカウント全体で共通のメッセージIDシーケンスを共有しているため、そのIDを持つメッセージが 以前に保存されていた場合、そのチャットは特定されます。削除は、そのチャットに `chat_resolution`でその方法を説明して記録されます。保存されたことのないIDは、 明示的に未解決のチャットを持つ**スコープ未指定の削除**として残ります。これらはTelegramの削除通知であり、 そのチャットとの関連付けがまだできない場合でも保存されます。 通知のスキーマにはIDが含まれており、 ジャーナルには受信時刻と、保存されたメッセージのコンテキスト( `deleted_message_was_outgoing` を含む)が追加されます。利用可能な管理者ログのエントリは、 アクション、実行者、および発生時刻に関する別の情報源となります。 ## 自身の行動 監視対象アカウントから送信されたメッセージには「`outgoing`」というラベルが付与されます。送信済み メッセージの編集については、プライベートチャットやグループチャットでは作成者本人がのみ編集可能であるのに対し、チャンネルへの 投稿は他の管理者も編集できることが明記されています。 送信メッセージが、そのチャット内で最も新しく保存された返信キーボードのボタン のテキストを繰り返し使用している場合、そのメッセージには`button_press`というラベルが付けられ、 そのキーボードの記録へのリンクが添付されます。 自身の操作を除外する処理は、バックグラウンドでの再チェックや、新しいチャット履歴の自動記録にも適用されます。 スキップされた送信メッセージは、再チェックの位置を先へ進めるため、それ以降の受信メッセージの記録を妨げることはありません。 パネルでの明示的な操作や、手動で要求された履歴のスナップショットは、引き続き記録されます。 ## 調査モード:チームへの参加とボットとの対話 **その他のツール → ソース → スコープ → 調査モードでは**、チームチャットに参加し、ボットを起動してそこに書き込みを行う専用 アカウントのスコープを準備します。対象は、アカウント全体、すべての ソースタイプ、自身のアクション、および表示されるすべてのチャットやボットのプロフィールと最新の 200件の表示可能なメッセージです。フォームを確認し、**「スコープを保存」**を押してください。アカウント全体への切り替えには、 通常の確認が求められます。 - **ボタン。**メッセージの下にあるボタンはメッセージと共に保持され、「**チャット**」に表示されます:リンク、Web アプリ、ログインリンク、コピー用のテキスト、コールバックデータ、インラインクエリ、電話番号や 位置情報の要求などです。 リンクはテキストとして表示され、パネルによって開かれることはありません。ボットが ボタンのみ(新しい支払いリンクなど)を変更した場合、それはメッセージの新しいバージョンとみなされ、 ライブ更新および再確認の双方において適用されます。 - **新しいチャットとボット。**フォルダモードおよびアカウント全体モードにおいて、**新しいチャットやボットが 出現すると**、出現直後に保存されます: - `source.profile`レコードとしてのプロファイル:ボットの説明とコマンド、ユーザー、グループ、またはチャンネルの「概要」テキスト、 メンバー、リンクされたチャット、およびTelegramが返した際の招待リンク ; - `new_chat` とマークされた履歴スナップショットとして、最新の表示可能なメッセージ(最大 1,000 件)を保存します。これには、 参加したばかりのチームチャットの以前のメッセージや、監視がチャットに 気付く前にボットが発信した内容などが含まれます。すでに保存済みのメッセージは重複して記録されません。 新たに選択されたチャットは、スコープが適用された際にこれらの設定を使用します。これには、 アカウントのダイアログリストにすでに存在するチャットも含まれます。プロファイルと履歴の初期読み込みは、 最大3つのチャットで同時に実行されますが、同一チャットに対する処理は順序通りに実行されます。 各履歴/プロファイルの処理段階では、設定された操作タイムアウトが適用されるため、停止したリクエストは ワーカーを解放します。履歴は、オプションのプロファイル読み取りの前に保存されます。プロファイルの 読み取りに失敗しても、その履歴の取得は妨げられません。 失敗した段階は5秒後に再試行され、 遅延中はワーカーを占有することなく、最大5分まで再試行回数が倍増します。 保留中のID、再試行の期限、および完了した段階はローカルに保存されます。再起動時には 未完了の段階のみが再開され、プロファイルの再試行によって完了済みの履歴読み取りが繰り返されることはありません。 順番が回ってくる前に無効化されたソースはスキップされます。概要画面では、アクティブなチャット、保留中の チャット、再試行中のチャットの読み込みが、添付ファイルのダウンロードとは別に表示されます。 FloodWaitが発生するとこの処理は一時停止され、その後再開されます。失敗は記録され、チャットの リアルタイム記録は継続されます。これには、新しいチャットの IDを解決している間の待機時間も含まれます。保留中のプロファイル/履歴タスクは再試行のために保持され、既存の より長いアカウント全体の待機時間は短縮されません。ワーカーはこの待機時間を共有します。並行処理 によってTelegramのリクエスト制限が回避されることはありません。 - **オンデマンドのプロファイル。** **「チャット」→「プロフィール」→「プロフィールを保存」では**、任意のソースの現在のプロフィールを 保存できるようになり、メッセージの上部に最新のプロフィールが表示されます。 - **チャット状態のスナップショット(プレビュー)。**メッセージストリーム以外の状態は、 メッセージがなくても変化します。すべてのメッセージの固定を解除するとメッセージレベルの痕跡は残らず、管理者は 権限を失い、ギフトは非表示、変換、アップグレード、または返金されます。監視中は、有効になっている すべてのソースが定期的に読み取られ、署名付き `chat.state` レコードとして保存されます:タイトル、ユーザー名、 説明、メンバー数および管理者数、リンクされたチャット、スローモード、固定メッセージID (最大100件)、権限と肩書きを持つ管理者、およびチャンネルや ユーザープロフィールに表示されているギフト(最大100件)。 各レコードには、前回のスナップショットとの相違点が記載されています: 変更されたフィールド(変更前と変更後)、追加または削除された固定メッセージ、管理者および ギフトの追加、変更、またはリストから削除されたもの。 - Telegramが拒否する部分(例:管理者ではないメンバーの チャンネル管理者リスト)は `errors`; 以前の値は保持され、 `carried_forward`にリストされ、削除されたものとして報告されることはありません。 - 変更点がカウントのみであるレコード、および変更がないことが確認されたレコードは、 最後の完全な状態を `state_seq` および累積 `state_overrides`で参照されます。完全な状態は、 少なくとも7日ごとに、またカウント以外の何かが変更された際には常に書き込まれます。 - `parts_complete` は上限付きリストを示します。追加には以前の完全なリストが必要で、 削除には現在の完全なリストが必要であり、明示的な空の値はリストのクリアを記録します。 - **[その他のツール] → [パラメータ] → [チャット状態]** で、間隔(デフォルトは12時間、0に設定するとスナップショットが 無効になります)、ソース間の休止時間、読み込む部分、および変更が 見つからなかったチェックを記録するかどうかを設定します。 `FLOOD_WAIT` そして `FLOOD_PREMIUM_WAIT` 残りの スナップショット要求を停止し、アカウント全体の期限がまだ残っている場合はそれを保持し、 中断されたチャットは、その待機時間後に再試行が可能となります。 - **表示されません。**別のTelegramアプリで押されたインライン(コールバック)ボタン、ボットがそのような押下に対して返すポップアップや リンク、および別のアプリで使用された招待リンクは、 TgWitnessには届きません。その後、ボットが送信または編集した内容は記録されます。 ### パネルからの発言 **「Chats」**には、選択したワークスペースのTelegramアカウントを使用するミニクライアントが追加されました: - プレーンテキストのメッセージを入力するか、保存済みのメッセージの下にある**「返信」**を選択してください。送信される メッセージは、送信更新が対象範囲から除外されている場合でも記録されます。 - 「Press**」ボタンは、**現在のコールバックボタンまたはテキストボタンの下にあります。サーバーは メッセージを再度取得し、キーボード入力が保存されたバージョンと異なる場合は、その操作を拒否します。 コールバックの受信確認には、Telegramのポップアップテキスト、アラートフラグ、およびURLが保持されます。また、返信内容は 会話の下にも表示されます。URLは選択可能なテキストのままとなり、自動的に開かれることはありません。 - **「+」**を押して → **Telegramリンクを開き**、`@username`、公開`https://t.me/name`リンク、 `https://t.me/+invite` / `joinchat/invite`、または `?start=parameter` を含むボットリンクを入力し、「 **プレビューを保存**」を押します。参加前に、元のリンクとTelegramのプレビューに署名が行われます。 **参加/開いて確認すると**、グループ/チャンネルに参加するか、ユーザー/ボットが開かれ、 チャットが有効なソースとして追加され、開始パラメータを含む`/start`がボットに送信されます。 管理者の承認待ちの参加リクエストは、メンバーシップとしてではなく「保留中」として記録されます。 「**観測を開始**」をオンにすると、受信する返信をリアルタイムでキャプチャできます。パネルのアクションは、 観測が一時停止している間も機能します。パネルはその場で直接応答を保存し、ライブ 観測が会話の残りをキャプチャします。 新しく追加されたソースは、観測が実行中の場合、設定されたプロファイル/履歴の取り込みを使用します。 ソースが一時停止している場合は、「**その他のツール」→「ソース」**で有効にしてから、送信やボタンの操作を行ってください。 `interaction.preview`、`interaction.requested`、`interaction.result`は、証拠エクスポートに含まれる通常の署名付き ジャーナルイベントです。リクエストには、アカウント、メッセージ/ボタン またはプレビューレコード、および監視が実行されていたかどうかが識別されます。レシートは、成功、 拒否、承認待ち、および不明な結果を区別します。中断されたリクエストはTelegramに到達している可能性があります: 新しい操作を開始する前にチャットを確認してください。 リクエスト ID を再利用すると、 再起動後を含め、アクションを繰り返すことなく保存された受信確認を取得できます。パネルは、 現在のページセッション中に同じアクションに対して曖昧な応答があった場合でも、その ID を保持します。 また、アクションが成功した後でビューの更新に失敗した場合も、その ID を保持します。受信確認は 表示されたままとなり、再度クリックすると取得できます。 コールバックおよび参加 RPC には 1 回の 試行があります。再試行可能な読み取り操作は、設定された再試行ポリシーを維持します。チャットを切り替えると、 下書きと返信先が即座にクリアされ、新しい会話が読み込まれるまで送信が無効になります。 このミニクライアントは、テキストおよびコールバックボタンを処理します。ミニアプリケーションのボタンには**「ミニアプリを開く」**という機能があり、 これにより、アプリケーションが隔離されたブラウザ([ミニアプリケーション](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md))内で実行されます。ログイン、 電話番号や位置情報の要求、支払い、インラインクエリ、添付ファイルについては、引き続きTelegram クライアントが必要となります。これらの機能の保存済みボタンメタデータは引き続き表示されます。新しいコントロールでは英語のテキストが使用されます。 ## ティアの再確認 再確認では、Telegramに対し、見逃されたメッセージ、編集内容、およびもはや返されなくなったメッセージについて再度問い合わせを行います。 星印が付いたソースは**優先**ソースであり、デフォルトでは15分ごとに再確認されます。 その他のすべてのソースは6時間ごとに再確認されます。選択されたチャットは当初から優先ソースとして扱われますが、 フォルダまたはアカウント全体から追加されたチャットは通常のソースとして扱われます。 1回のパスで再チェックされるソースは最大30個で、 残りは次の分まで待機します。再接続後は、優先ソースが先に処理されます。両方の 間隔は、**「その他のツール」→「ソース」→「記録」→「再チェック」**(0に設定するとその階層がオフになります)で設定され、 `recheck.changed`として記録されます。 見逃されたメッセージは、前回の処理が停止した地点から上流に向かって取得されます。取得上限は「 **その他のツール → パラメータ → チャットおよびパスごとの見逃されたメッセージの復元数**」(デフォルトは1,000)です。したがって、長期間の停止後、 ギャップよりも新しいライブメッセージが先に保存されていた場合でも、再チェックはギャップ全体を埋めます。 まだ追いついていないチャットは、ティア間隔を待つのではなく、次の分に再度再チェックされます。 `recheck.completed`は、処理が完了するまで`continues_after`を示します。 比較対象には、メッセージ本文、エンティティ、キーボード入力(削除を含む)、および添付ファイルの 内容・識別情報が含まれます。 ファイルへのアクセスハッシュやファイル参照のみを変更しても、 編集とはみなされません。また、Telegramが自動的に入力する項目(リンクプレビューの読み込み、ストーリーの閲覧、このアカウントによってロック解除された有料 メディア、請求書の受領など)も編集とはみなされません。「チャット」に保存された各バージョンは、メディアのメタデータを含む完全なジャーナル記録にリンクされています。 ## メッセージ履歴と出典情報 例えば、コレクターが「10:00に会議」という記録を検知し、その後「11:00に会議」という記録を確認し、 さらに削除通知を受け取ったとします。この場合、3つの異なる記録が追加されます。 元のテキストは残され、編集後の内容は別のバージョンとして扱われ、通知には 削除が検知されたことが記録されます。 最初のバージョンが消えた後に収集が開始された場合、そのテキストは利用できません。 プロセスがオフラインの間に複数の編集が行われた場合、その後確認された バージョンのみが保存されます。削除通知では、一度もキャプチャされなかったコンテンツを復元することはできません。 この記録は、以下の複数の情報源を組み合わせています: | 出典 | 保持される情報 | | --- | --- | | ライブメッセージまたは編集更新 | メッセージID、送信者のメタデータ、キャプチャされたバージョン、受信時刻、および提供されたTelegramメッセージ/編集日時。 | | 削除のリアルタイム通知 | 報告されたメッセージID、受信時刻、生の通知、および以前に保存されたコンテンツへのリンク。 | | 利用可能な管理ログ | アクション、アクター、送信日時、および送信されたメッセージの内容。これらは、必要な権限を持つアカウントによって読み取られます。 | | パネル操作 | 選択されたアカウントにおける、要求されたアクションとその記録された結果。 | | 再確認 | Telegramの現在の応答と、以前に保存されたメッセージとの比較。 | `observed_at` これは、レコードがコレクタクロック上で書き込まれた時刻であり、 次のように増加します `seq`とともに増加します。ライブ更新の処理中に書き込まれたレコードには、 `received_at`、つまり更新がコレクターに到達した時刻、および `processing_delay_ms`、受信から書き込みまでの時間が付加されます。観測開始時に保留されていた 更新は、それより後のものよりも先に、到着順に処理されます。 `source_at` は、そのイベントがソース日時を提供している場合に、それを保持します。テレグラムのクロックオフセット観測、 クロック不連続性レコード、[および外部時刻チェックは、](https://phishdestroy.io/tgwitness/ja/docs/reference/timestamp/) 関連するタイミングコンテキストを提供します。通常のメッセージ通知のフィールドは その通知を記述しており、管理ログおよびインタラクションレコードは独自の属性情報を保持します。 ## 履歴のスナップショット スナップショットは、有効化されたソースから最新の表示可能なメッセージをリクエストするもので、1回のリクエストにつき最大 500件まで取得できます。結果は「履歴観測」としてラベル付けされます。手動によるスナップショットは 観測と並行して実行されます。繰り返される観測は 個別の記録として保持されます。ソースを有効にすると、 [「厳格なチャット選択」](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#strict-chosen-chats)がオンになっていない限り、そのソースの`baseline`スナップショットが1回取得されます。 読み取り中にソースが無効化されると、スナップショットは停止します。返信は、 要求されたチャットに属し、かつ要求された 境界より下で、厳密に降順となる正のメッセージIDを含むものでなければなりません。無効な返信があると、そのメッセージが保存される前にスナップショットが中断されます。 すでに保存済みのメッセージは、中断記録とともに署名付きジャーナルに残ります。 スナップショットは添付ファイルポリシーに従いますが、ライブイベントの切り替えとは別個に処理されます。 削除されたメッセージや見逃された中間バージョンを復元することはありません。 一時停止中にスナップショットをリクエストできますが、キューに入れられた添付ファイルは、監視が開始され、 ダウンロードワーカーが実行されるまで待機します。 **履歴**の実行は独立した排他タスクです。監視を開始せず、選択した取得元の読み取りと待機中の添付ファイルのダウンロードを順番に行います。一時停止するとアカウントを解放し、再開すると保存した処理を続けます。複数の空きアカウントでの日付・言語・返信フィルターについては、[分散チャットエクスポート](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md)をご覧ください。 ## 添付ファイルの取り扱い 添付ファイルのダウンロードはデフォルトで有効になっており、空きディスク容量が1 GiB未満になると一時停止します。コレクターは、 メッセージの監視とダウンロードのジョブを同時に実行します。このジョブは元のメディア 記述子とサイズポリシーを維持するため、後から編集された添付ファイルが黙って置き換えられることはありません。 ダウンロードはメッセージのキャプチャ後に実行されます。ダウンロードが完了すると、SHA-256 値とバイト数を伴う`media.saved` レコードが作成されます。スキップ、失敗、再試行、および中断された 処理にはそれぞれ異なる結果が割り当てられます。ファイルは、その`media.saved` レコードが存在する場合に保存済みとみなされます。 また、完了したファイルは、元の観測された添付ファイル 記述子に記載されたバイト数と一致している必要があります。短すぎる、または予期せず長い応答は、保存済みメディアとして記録されません。 `media.saved`が書き込まれる前に、ファイルとそのフォルダエントリがディスクにフラッシュされます。前のコレクタ プロセスが正常に停止せずに終了した場合、次回の起動時に、その実行中に「保存済み」として記録されたすべてのファイルが読み込まれます。 ファイルが 欠落している場合、またはそのバイト内容が記録されたSHA-256と異なる場合、そのファイルには`media.missing_after_restart`レコードが作成され、その ダウンロードは再度キューに入れられ、バイト内容が異なるファイルは`media-damaged/`に移動されます。オフサイトストレージに移動されたファイルは 読み込まれません。 1つのワークスペース内では、同じ添付ファイル表現に対してキューに入れられた並行ジョブは、 アクティブな転送を待機し、再利用する前に保存されたバイトを再確認します。各ジョブは、 独自の符号付き結果と、以前に保存されたファイルレコードへの参照を保持します。待機中の ジョブをキャンセルしても、アクティブな転送はキャンセルされません。その転送が失敗したりキャンセルされたりした場合、 次のジョブが再試行できます。異なる添付ファイルは並行してダウンロードできます。 同じアカウント、表現、予想サイズ、およびキャプチャアクションを持つジョブは、 一致するジョブが1つ実行中の間、キューに残ります。これらはダウンロードスロットを占有しないため、 キューの先頭に処理に時間がかかるファイルのコピーが多数あっても、他のファイルのダウンロードを開始することができます。 試行が完了すると、キューが再開されます。優先レーン、保存された再試行遅延、および 履歴の所有権は引き続き適用され、各観測には独自の結果が割り当てられます。 チャットのエクスポート機能では、同じエクスポートディレクトリ内でのファイルの再表示に際し、 アクティブな転送も共有されます。各メッセージは添付ファイルへの参照を保持しており、再利用には 新たなサイズ確認とSHA-256チェックが必要です。共通の転送ロックを保持することなく、 異なるファイルを並行してチェックすることができます。一時的なダウンロードおよびコピーパスは 各操作ごとに一意であり、キャンセル時には、クリーンアップを行う前に、アクティブなローカルファイルリーダーがすべて終了するのを待ちます。 エクスポートファイルインデックスは、メタデータへのアクセスのみをシリアライズし、ファイルのハッシュ計算やダウンロードは行いません。 異なる添付ファイルに対するサーバー側のハッシュ読み取りも並行して実行され、クライアントの 3つのファイルリクエストスロットをバイト単位のダウンロードと共有します。同じ表現に対する繰り返し読み取りでは、 キャッシュされた完全な結果のみが再利用されます。ファイルの読み取りは通常のリクエストキューを空けたままにし、 リクエストがスロットを取得した際に、保存されていたFloodWaitの期限が再度チェックされます。 制限は、写真、動画、GIFおよびアニメーション、ラウンド動画メッセージ、 音声メッセージ、音楽およびオーディオ、ステッカー、ファイルといった**種類ごとに**設定されています。 各タイプは個別に無効化可能で、 1~2,000 MiBの範囲で独自のサイズ制限が設定されています。新しいワークスペースでは、写真用が20 MiB、 動画用が100 MiB、ファイル・音声・ラウンド動画用が50 MiB、音声およびGIF用が20 MiB、 ステッカーは5 MiBとなります。新しいワークスペースでは、GIFとステッカーは有効に設定されるまで無効のままとなります。タイプごとの制限が導入される前にポリシーが保存されたワークスペースでは、すべてのタイプが有効なままとなり、すべてのタイプに対して単一の 制限が維持されます。*最大ファイルサイズ*を設定すると、すべてのタイプが一括して設定されます。 無効化されたタイプでは `media.skipped`レコードが生成され、サイズ不明または上限を超えるファイルはダウンロードされません。大容量ファイルの ダウンロード時間は、そのサイズと256 KiB/sという基準速度に基づいて追加で割り当てられます。ジョブは 再起動後も存続しますが、有効期限が切れた参照、アクセス不能、または削除されたファイルによって、復元が妨げられる可能性があります。 待機中のジョブは、そのジョブに保存された制限値を維持するため、制限値の引き上げは新しいファイルにのみ適用されます。 タイプを無効にしたり、その制限値を引き下げたりすると、除外対象となる待機中のファイルもスキップされ、それぞれに `media.skipped`レコードが生成されます。ダウンロードを無効にすると、再度有効になるまでキューは一時停止されます。 ## 一時停止、ロック、切断、再起動 | 動作または状態 | 効果 | | --- | --- | | ワークスペースを切り替える | パネル表示を変更します。その他のコレクターは状態を維持します。 | | パネルをロックするか、タブを閉じてください | サーバーと監視機能は稼働したままとなります。 | | 観察の一時停止 | そのコレクターを停止し、キューに格納されている添付ファイルの処理を保持します。 | | ソースを無効にする | 今後のスコープ指定によるキャプチャを停止します。無効化されている間、それに関連するキューに登録されたメディア処理ジョブは待機状態となります。 | | 出典を削除する | 情報源として認識されず、ユーザープロフィールは削除されますが、すでに保存された記録は追記専用ジャーナルに残ります。まだ処理待ちの添付ファイルは、失敗(`source_removed`)として記録されます。フォルダモードおよびアカウント全体モードでも、これらは除外されます。 | | 接続経路を変更する | 一時停止が必要となり、古いクライアントを終了し、未完了のログインをキャンセルします。 | | Pythonプロセスを停止する | すべてのワークスペースを停止します。オフライン中は、いかなる観測も行われません。 | | アクティブな監視終了後に再起動します | 保存されたセッションを使用して、保存された範囲の再開を試みます。手動で一時停止すると、その意図は解除されます。 | コレクターは、検出された接続切断、再試行、エラー、起動/停止、および ハートビートを記録します。短時間の中断は、定期的な接続チェックでは検出されない場合があります。 再起動後、見逃された更新は保存された更新位置から要求され、 監視対象のチャットは定期的に再チェックされます。[証拠形式を](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#durable-collection-and-process-receipts-02)参照してください。スナップショットは現在の状態を コンテキストとして追加し、その間のギャップは記録されたままとなります。 ## アカウントの分離と検証 各ワークスペースには、独自のジャーナル、認証、署名鍵、ポリシー、およびキューがあります。 そのワークスペースのアクティブなクライアントのみが、リアルタイムの観測データを記録できます。拒否されたクライアント、保留中のクライアント、 置き換えられたクライアント、および接続テスト中のクライアントは、そのジャーナルにリアルタイムの更新を書き込むことはできません。 異なるアカウントが同じグループを監視することは可能ですが、それぞれのジャーナルは独立したままです。 各イベントには、前回のハッシュ値とEd25519署名が含まれます。エクスポート対象は、 固定のシーケンス番号を通じてワークスペースのジャーナル全体を網羅します。パネルフィルターは エクスポート内容をフィルタリングしません。エクスポートの準備が行われている間も、その範囲を超えて収集が継続される場合があります。 **「ジャーナルの検証」機能は、**表示された 境界を通じてイベントの連鎖と署名を検証します。ワークスペースが変更されると結果はクリアされ、パネルには 検証後に追加された新しい記録が表示されます。ZIP形式でのエクスポートでは、収集されたメディアの検証も行われます。 フィンガープリントとチェックポイントは個別に保持してください。各モードにおける取得チェックについては「 [検証範囲](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope)」を、 日常的な収集については「[日常業務](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/)」を参照してください。 --- # Telegram · シークレットチャット:設定と記録 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/secret-chats/ シークレットチャットのプロトコル拡張をインストールし、アカウントごとに有効にして、TgWitness が作成または承諾したチャットを記録します。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) シークレットチャットのプロトコル拡張をインストールし、アカウントごとに有効にして、TgWitness が作成または承諾したチャットを記録します。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) 公開されたアプリケーションには、シークレットチャットのバックエンド、コレクターとの統合、 APIルート、および **疑似秘密** インターフェース。プロトコルライブラリは別のモジュールです: open **疑似秘密** そして、[押す] **インストールして電源を入れる**. 着信の自動受諾機能は、 有効にするまでオフのままです。 ## プロトコルモジュール | | | | --- | --- | | モジュール | `kiaro-telethon-secret-chat` 0.2.0 | | 著者 | キアロ様 | | ライセンス | GPL-3.0-or-later; その `LICENSE` および `NOTICE` 保存されたアーカイブ内に留まる | | 出典 | [KiaroSama/Telethon-Secret-Chat](https://github.com/KiaroSama/Telethon-Secret-Chat) のコミット `d87bf037b90060383c7b704d8a06ebb98c621c6f` | | 確認 | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` パッケージファイルの一覧とそのSHA-256値に対して | **「インストールして有効化」**機能は、メイン管理者が利用できます。TgWitnessは、 Telegram外部からのリクエスト用にワークスペースが設定したルートを通じてGitHubから そのコミットのソースアーカイブをダウンロードし、パッケージ内のすべてのファイルを TgWitnessリリースで固定された値と比較し、アーカイブを `modules/telethon-secret-chat-.zip` データディレクトリに 保存し、メモリからコードを読み込みます。再起動は不要です。チェックは 起動のたびに再度実行され、異なるアーカイブは読み込まれず、ページにその旨が表示されます。 パッケージファイルが変更されたり、欠落したり、追加されたりすると、チェックに失敗します。 このモジュールは、独自のライセンスに基づく独立した作品です。TgWitnessには同梱されていません。 インストール時には、各ユーザーが作者自身のリポジトリからダウンロードする必要があります。 **詳細** このページには、 読み込まれたモジュール、その作成者、ライセンス、コミット、およびSHA-256が表示されます。 GitHubにアクセスできないホストの場合、代わりに同じコミットをPython 環境にインストールすることができます。そうすると、パネルはそのコピーを使用します: ``` python -m pip install ".[secret-chats]" ``` TgWitnessは、自身が作成または受け入れたチャットのエンドポイントとなります。TgWitnessは、 メッセージ、利用可能な添付ファイル、タイマーの変更、および削除通知を署名付き ジャーナルに記録します。以前に保存されたコンテンツは、後の削除通知後も引き続き利用可能です。 ## パッケージの入手可能性 8 年11月2026 日、公開されたインストーラパッケージは、ソース [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) 、 リリース`b35f8e18f3d1-1ff85ec98bb2` 、バージョン0.9.1 プレビューにおいて検証されました。 [不変のWheel](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) およびその依存関係ロックは、SHA-256 およびRSAリリース署名の検証に合格しました。 パッケージ化されたバックエンドおよびインターフェースは、そのソースリビジョンとバイト単位で一致していました。 このパッケージには、API登録およびコレクタフックも含まれています。 そのパッケージにはプロトコルライブラリが含まれておらず、依存関係の ロックにも含まれていません。 `secret-chats` [pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml)内の「extra」は、 パネルボタンと同じコミットを指定しています。 このパッケージ検査により、どのファイルと依存関係宣言が同梱されるかが確定されます。 [検証レコード](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/)は、個別のランタイムチェックを特定します。 11月6日の以前のガイドでは開発用スナップショットについて説明していましたが、 現在では上記のパッケージについては説明していません。 ## インターフェースを使用してください **「Pseudo-secret」**を開き、ページでモジュールが提供されている場合はインストールし、アカウントで有効にして接続してください。 自動承認が有効になっていない限り、受信リクエストは承認されるまで待機します。 開始、承認、送信、終了の各操作では、アカウントの対話権限 および読み取り専用保護が適用されます。 | アクション | 保持された結果 | | --- | --- | | ユーザー名またはユーザーIDでチャットを開始する | 送信リクエスト;ピアは自身のデバイス上でこれを受け入れます。 | | リクエストを受け付ける | TgWitnessが受信エンドポイントとなります。 | | メッセージの送受信 | `secret_chat.message`とその方向、内容、および指定されたタイマー。 | | ファイルを受信する | SHA-256および`secret_chat.file`レシートによって保存された復号済みバイト。証拠のエクスポートに含まれます。 | | タイマーまたは削除通知を受け取る | 保持されたメッセージやファイルとは別に、アクション記録が存在します。 | | チャットを確認する | 会話、ファイル受信確認、通知、およびキーの可視化。 | 別のデバイス上の既存のシークレットチャットは、そのデバイス固有の鍵を保持します。 インポートされたクラウドセッションでは、これらの鍵は転送されません。シークレットチャットの鍵素材および カウンタはワークスペースのボールトを使用し、保存されたメッセージおよび復号化されたファイルは 通常のワークスペースストレージの保護機能を使用します。 ## 保存済みのメッセージを検索する 開いているチャット内で**「メッセージ検索」**を使用すると、大文字小文字を区別せずに 文字列を検索できます。検索フィールドで**「前へ」**や**「次へ**」、あるいは「Enter」や「Shift+Enter」を押すと、 一致するメッセージ間を移動できます。カウンターはメッセージ数を表示し、各メッセージ内で最初の一致する 文字列がハイライト表示されます。「Esc」キーを押すと検索条件がクリアされます。 検索機能では、周辺の会話、保存されたファイル、削除通知が 表示されたままになります。この機能は、パネルにすでに読み込まれているレコードを検索します。以前の レコードが残っている場合、パネルにその旨が表示されます。「**古いレコードを読み込む**」を選択すると、履歴が拡張され、 現在のメッセージを表示したまま検索結果が更新されます。 同じワークスペース内でチャットを切り替えても、各チャットの検索履歴は保持されます。パネルを ロックしたり、ワークスペースを変更したりすると、それらの検索履歴は消去されます。検索語句は ページのメモリ内に保持され、ブラウザのストレージには保存されず、APIクエリとしても送信されません。 検索を行っても、Telegramメッセージや入力・既読通知は送信されません。チャットの 開封やその他の操作については、従来の表示設定が引き続き適用されます。 **ビルドレポートは**、選択したチャットのレポート範囲を維持します。表示検索では、 エクスポートされるレコードが自動的に制限されることはありません。レポートをダウンロードする前に、 選択範囲をプレビューしてください。 ## 永続化および相互作用の制御 統合された実装では、重複検出に耐久性のあるジャーナル検索を使用し、 ダウンロード失敗後も添付ファイルのジョブを保留状態に保ち、終了処理を 他のリモートアクションと同じインタラクションガードを経由してルーティングします。これらは、 過去の6日付けの開発スナップショット監査で報告された3つの処理経路に代わるものです。 ジャーナルへの書き込みに失敗した復号済みメッセージは、再試行のためにボールトに保持されます。 添付ファイルのサイズや空きディスク容量のチェックにより、ジョブは保持されたままダウンロードが延期されます。 このモジュールは、アカウントの既存の接続を再利用します。読み取りおよび入力通知は、 [「相手側に表示される内容](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees)」で選択された内容に従ってのみ送信され、スクリーンショットの 通知は一切送信されません。[secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py)、 [APIルート](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py)、および [アクセスポリシーを](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py)参照してください。 [過去の監査](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md)記録は、元の スナップショットの調査結果を保持しています。現在の利用可能性および実装については、 上記のパッケージリビジョンおよび[現在の](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md)機能から確認してください。 ## インターフェースのデモ Webサイトのシナリオでは、架空のリクエスト、メッセージ、ファイルを使用して パネルのワークフローを実演しています。これはインターフェースの例であり、プロトコルおよび取得のチェックについては、 検証レコードに日付付きの個別の結果が記載されています。 --- # Telegram · ソース履歴を読み込む Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/history/ 有効化されたソースから過去のメッセージを読み込み、一時停止や再開を行い、署名付きの進捗レポートを検証します。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 有効化されたソースから過去のメッセージを読み込み、一時停止や再開を行い、署名付きの進捗レポートを検証します。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [コレクション](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![コレクション](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69) In **その他のツール → ソース → 対象となるチャット**, 有効になっているチャットを確認し、「標準API」または 「Takeoutエクスポート」を選択してから、 **全履歴を読み込む**. この実行により、ソースのリストが確定され、利用可能な過去のメッセージが 「Chats」および署名付き観測日誌に取り込まれます。「Media」は、既存の添付ファイル 設定と永続的なダウンロードキューを使用します。これは、チャットごとの署名付き JSON/HTMLエクスポートとは別ものです。 アカウント全体の収集を行うには、**「アカウント全体」** を選択し、範囲を保存してください。履歴 は、ソースリストに署名する前に、アーカイブされたチャットを含め、アクセス可能なすべてのダイアログを 更新します。この検出では、選択済みチャットピッカーのリスト制限は適用されません。後で検出された チャットは監視対象となり、設定された初期スナップショットが取得されます。再度フル実行を行うことで、 それらの以前の履歴を読み込むことができます。「**履歴の読み込み中および読み込み後も監視を継続する」** を有効にしておくと、履歴の読み込み中に新しいメッセージ、編集、削除通知を記録できます。 履歴の1回の実行またはエクスポートには取得スロットが使用されますが、ライブ監視はそれと並行して実行されます。 同時に実行するチャットを1~3件、アタッチメント処理担当者を1~5名選択し、利用可能な「最近の操作」を保持するかどうか、 および以前に保存されたバージョンを比較するかどうかを指定します。テイクアウトには、Telegramでの承認や、 サーバーで指定された待機時間が必要になる場合があります。これらの設定は、処理を再開しても維持されます。転送、再試行、信頼に関する詳細については、[「バックフィル動作」および 「エビデンス契約」](https://github.com/phishdestroy/TgWitness/blob/main/docs/BACKFILL.md)を参照してください。 ## 一時停止、再開、および部分的な結果 - **「履歴の一時停止」**を選択すると読み取りが停止します。**「履歴の再開」を選択すると**、各ソースの最後にコミットされた メッセージから再開されます。アプリを再起動した場合も、再開されるまで実行は一時停止されたままとなります。 再開するには、同じ未使用の Telegram アカウントが必要です。 - メッセージの観測、添付ファイルの処理、カーソルのコミットが1つのトランザクションで行われます。 再開された実行では、すでにコミット済みの観測は繰り返されません。ライブキャプチャや 別途明示的に開始された実行では、同じメッセージを独立して観測することができます。 - 各ソース(Takeout 内の各 Telegram スプリット範囲)は、最初の読み取り時にメッセージ ID の上限を固定します。それより新しいメッセージは、 ライブ観測に属し、そのソースの残りの履歴ページには属しません。 - アクセスできないソースや、取得中に無効化されたソースは、 「失敗」または「スキップ」として表示されたままになります。その他のソースは処理が継続されますが、全体的な結果は不完全となります。 - Telegramでは、チャットの管理ログは管理者のみに表示されます。一般のメンバーが 管理ログを読み取ろうとした場合、その操作は`history.admin_log.unavailable`として記録され、`reason: not_admin`という理由が 付きますが、これにより履歴が不完全になることはありません。一方、管理者が管理ログの読み取りに失敗した場合は、履歴が不完全になります。 - FloodWait の遅延は、保存されたアカウントのバックオフ設定に従います。一時的な障害が発生した場合は最大 5回まで再試行します。リソースの枯渇やディスク容量不足の場合は、カーソルの位置を維持したまま一時停止します。 - **「この履歴の実行を終了」を選択すると**、保存された観測結果は保持されます。これによって観測結果が削除されたり、 標準APIの添付ファイル処理ジョブがキャンセルされたりすることはありません。「Takeoutを終了」を選択すると、残りのTakeout ファイルはスキップ済みとしてマークされます。一時停止を選択した場合は、それらの処理を再開可能です。新しい実行を開始すると、有効化されたソースが再度読み込まれます。 履歴の完了とは、履歴の読み取りのみを指します。添付ファイルは、処理待ちの状態のままとなる場合、 処理に失敗する場合、または設定されたポリシーによって除外される場合があります。ジャーナル および添付ファイルキュー内のメディア受信確認状況を確認してください。バイトデータが保持された完了済みの受信確認のみが、 保存された添付ファイルとみなされます。履歴操作は明示的なスナップショット要求であり、 将来のライブイベントのカテゴリを選択するスイッチとは別個のものです。 ## 転送と検証 **署名済みの進捗レポート**を保存した後、**「証拠のエクスポート」**機能を使用して、 ジャーナルと保存された添付ファイルをダウンロードしてください。後に行われる証拠のエクスポートには追加の記録が含まれる場合がありますが、 レポートのカウンターは、作成時点のジャーナルプレフィックスに紐付けられています。 このバージョンの信頼できるチェックアウトから検証ツールを実行してください: ``` python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT ``` 期待される署名鍵のフィンガープリントは個別に保持してください。検証ツールは、 レポートの署名、証拠アーカイブ、レポートのチェックポイント、ソースプラン、アカウント、 および保存済み/利用不可のメッセージ数をチェックします。新しい実行では、ソースの進行状況や オプションも署名付きカーソルイベントに紐付けられます。`--evidence` オプションを指定しない場合、 署名付きレポートとその内部の一貫性のみがチェックされます。従来の進行状況フィールドおよび添付ファイルの 要約は、引き続き署名付きコレクターステートメントとして扱われます。証拠検証ツールは、アーカイブされたメディアのバイトデータをチェックします。 検証済みの履歴を、その取得間隔、カバレッジ、および 利用可能な「最近のアクション」とともに読み取ります。このワークフローは現在アクセス可能な履歴を読み取ります。 [ライブモニタリングは](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#message-history-and-attribution)バージョン と通知を到着順に保持し、[シークレットチャットでは](https://phishdestroy.io/tgwitness/ja/docs/reference/secret-chats/) 有効化されたエンドポイント統合が使用されます。検証には、 検証[モード](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope)で説明されている、保持されたチェックポイント、 ウィットネス記録、および該当する取得証明を使用してください。 取得カーソルはローカルワークスペースの状態を表します。証拠用ZIPファイルを復元しただけでは、 保留中の取得ジョブやTelegramセッションは復元されません。元のジョブを継続する必要がある場合は、 ワークスペースのバックアップを保管しておいてください。 --- # Telegram · ワークフローと操作方法 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/operations/ パネルの日常的な運用:モード、監視カテゴリ、パラメータ、通知、エクスポート、バックアップ、および容量について。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) Translation coverage: this edition includes material from the English original. パネルの日常的な運用:モード、監視カテゴリ、パラメータ、通知、エクスポート、バックアップ、および容量について。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [導入と復旧](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/) ![展開と復旧](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) 初回接続の際は、[アカウントおよびセッション形式](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/)をご利用ください。 保存されたバージョン、イベントポリシー、およびデータ欠落に関する説明については、 [「収集の仕組み」](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/)をご覧ください。本ガイドでは、日常的な運用と復旧について解説しています。 管理対象のインストールには、ランチャーのほかに、**、START-HERE.html、**、**、START-HERE.txt、**が含まれ、 リポジトリへのリンクやコマンドはインストールパスに合わせて調整されています。 SSH経由で`tgwitness guide --print`を実行するか、`tgwitness paths`を実行して 実際のデータディレクトリを特定してください。root権限でのsystemdインストールでは、プライベートな状態情報は `/var/lib/tgwitness-…`に保存され、`/opt/tgwitness`にはプログラムが格納されます。 管理対象の一時的なCloudflareトンネルにおいて、`tgwitness tunnel off`は、 ローカルパネルと収集機能は稼働したまま、外部からのアクセスを遮断します。`tgwitness tunnel on`は アクセスを有効にし、`tgwitness tunnel restart`は新しいトンネル接続を作成します。 `tgwitness open`を使用すると、現在のアドレスを確認できます。明示的な停止設定は、 サービスの再起動後も維持されます。`tgwitness stop`は、パネルと収集機能の両方を停止します。 **このページでは** - [オペレーターのワークフロー](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/#operator-workflow) - [メインキーを共有せずに作業内容を共有する](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/#share-work-without-sharing-the-main-key) - [実行モード](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/#runtime-modes) - [監視カテゴリ](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/#monitoring-categories) - [通知](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/#notifications) - [パネルのレイアウト](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/#panel-layout) - [導入環境](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/#deployment-environments) - [起動時のチェックとエクスポート](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/#startup-checks-and-exports) - [バックアップ、復元、および中断](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/#backup-restore-and-interruptions) - [容量と保存期間](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/#capacity-and-retention) ## オペレーターのワークフロー フローチャート · 保存先と鍵の保護方法を選択してください → トークンを使用してパネルを開く; トークンを使用してパネルを開く → ワークスペースを選択してください; ワークスペースを選択してください → ダイレクト接続またはプロキシ接続の設定; ダイレクト接続またはプロキシ接続の設定 → 電話番号を入力するか、ファイルまたはQRコードを選択してください; 電話番号を入力するか、ファイルまたはQRコードを選択してください → アカウントの身元を確認し、アクセス可能なグループを選択してください; アカウントの身元を確認し、アクセス可能なグループを選択してください → イベントおよび添付ファイルの保存ポリシーを設定してから、監視を開始してください; イベントおよび添付ファイルの保存ポリシーを設定してから、監視を開始してください → エラー、アクセス、キュー、ディスクの状態を監視します; エラー、アクセス、キュー、ディスクの状態を監視します → 独立したチェックポイントを保持する; 独立したチェックポイントを保持する → 資料のエクスポートと検証 · 保存先と鍵の保護方法を選択してください · トークンを使用してパネルを開く · ワークスペースを選択してください · ダイレクト接続またはプロキシ接続の設定 · 電話番号を入力するか、ファイルまたはQRコードを選択してください · アカウントの身元を確認し、アクセス可能なグループを選択してください · イベントおよび添付ファイルの保存ポリシーを設定してから、監視を開始してください · エラー、アクセス、キュー、ディスクの状態を監視します · 独立したチェックポイントを保持する · 資料のエクスポートと検証 **図表をテキストで記述** 1. 保存先と鍵の保護方法を選択してください → トークンを使用してパネルを開く 2. トークンを使用してパネルを開く → ワークスペースを選択してください 3. ワークスペースを選択してください → ダイレクト接続またはプロキシ接続の設定 4. ダイレクト接続またはプロキシ接続の設定 → 電話番号を入力するか、ファイルまたはQRコードを選択してください 5. 電話番号を入力するか、ファイルまたはQRコードを選択してください → アカウントの身元を確認し、アクセス可能なグループを選択してください 6. アカウントの身元を確認し、アクセス可能なグループを選択してください → イベントおよび添付ファイルの保存ポリシーを設定してから、監視を開始してください 7. イベントおよび添付ファイルの保存ポリシーを設定してから、監視を開始してください → エラー、アクセス、キュー、ディスクの状態を監視します 8. エラー、アクセス、キュー、ディスクの状態を監視します → 独立したチェックポイントを保持する 9. 独立したチェックポイントを保持する → 資料のエクスポートと検証 認証、通信接続、グループへのアクセス、および配信の完全性は、 それぞれ異なる特性です。接続ステータスが緑色であっても、すべての イベントが記録されたことを意味するわけではありません。 ## 主鍵を共有せずに作業内容を共有する [**その他のツール] → [アクセス]** を開き、レビュー担当者やアナリストに独自のトークンを付与します。そのユーザーが 開くことができるアカウントやチャットを選択し、閲覧、エクスポート、または操作アクションを許可します。 収集の開始・停止を行うオペレーターにはワークスペース全体へのアクセス権が必要です。一方、レビュー担当者は 単一のチャットに限定することも可能です。セッション制限、有効期限、およびIPルールは、 Telegramアカウントの認証とは別個に設定されます。[「アクセスと権限」](https://phishdestroy.io/tgwitness/ja/docs/reference/access/)を参照してください。 **「Open sessions」**を使用して接続を終了するか、アクセス権を無効化してすべての セッションを終了させてください。管理者コンソールでは、ワークスペースを横断して 現在のプロセスのアクティビティを一元的に確認できます。セッションを終了しても、データ収集は継続されます。 ## 実行モード | モード | アクション | 動作 | | --- | --- | --- | | デモ | scripts\Demo.cmd または `--demo` | 合成データ;実際のアカウントとの連携は無効化されています | | 所見 | 監視を開始する | 選択した情報源について、配信された更新情報を記録します | | 履歴のスナップショット | チャット → チャット操作 → 履歴を読み込む | 最大500件の最新メッセージを保存します。過去の変更履歴のすべてを復元することはできません。 | | 一時停止 | 観察の一時停止 | データを保持したまま、収集を停止し、キューに格納されたジョブを保留にする | | レビュー/引き継ぎ | エクスポート | ZIP、JSONL/CSV/HTML、チェックポイント、処理確認書、およびタイムスタンプのリクエスト | | 複数のアカウント | ワークスペース、または上部の「**+**」ボタン | 1つのプロセス内で、いくつでも個別のワークスペースを作成できます | ローカルデモへのアクセスは、手動でトークンを入力することなく自動的に開始されます。これは、 隔離された 合成デモへの直接ループバックアクセスにのみ有効な、プロセス存続期間中の機能を使用しており、メインパネルのトークンは開示されません。実際のワークスペースおよびリモート またはプロキシ経由のデモアクセスでは、トークン認証が維持されます。デモへのアクセスによって、Telegramの権限が付与されることはありません。 ## 監視カテゴリ ![アカウントごとの監視設定と合成ソースデータ](https://phishdestroy.io/tgwitness/assets/sources.png?v=761b8bfa296c) [**その他のツール] → [ソース] → [記録] → [保存する変更の選択]** で、新規メッセージ、編集、 削除通知、リアクションの更新、メンバーシップイベントを個別に選択します。デフォルトでは すべてのカテゴリが保持されます。**[メッセージ、編集、削除]** を選択すると、元のコンテキストが 保持され、個別のリアクション/メンバーの更新は無効になります。[**表示されているすべてのアクティビティ]** を選択すると、 5つすべてが復元されます。プリセットで形式を変更し、**[記録設定を保存]** を押して適用します。 保存されたポリシーは、そのワークスペース内で選択されたすべての情報源に適用されます。その他の ワークスペースは、それぞれ独自の設定を維持します。実際の変更ごとに、署名付きの変更前・変更後の 値が記録されます。また、現在のポリシーは、処理レシートおよび観測 開始記録にも含まれます。カテゴリを無効にしても、それ以前の観測データは削除されません。再有効化 しても、見逃された変更は復元されません。 このバージョンでは、グループごとのカテゴリ上書き機能はありません。 以前のコンテンツが重要な場合は、新しいメッセージの記録を有効にしておいてください。削除通知では、 一度もキャプチャされなかったテキストを復元することはできません。運用・カバレッジ記録やその他のグループ サービスイベントは常に保持されます。 明示的な履歴スナップショットは、 リアルタイムのカテゴリ選択とは別のものであり、サービスメッセージが含まれる場合があります。これらの設定は、 それ以外にはキャプチャされたTelegramオブジェクトに埋め込まれた反応やメンバーのメタデータを 削除するものではありません。 履歴のスナップショットは、一時停止中に添付ファイルをキューに入れる場合があります。処理を行うには、監視を開始してください。 キューに入れられたからといって、ダウンロードされたわけではありません。利用できない元のファイルは、 新しい編集版に置き換えられず、結果は個別に記録されます。 **「ロック」**操作を行うと、ブラウザへのアクセス権と秘密フィールドはクリアされますが、データ収集は継続されます。 タブを閉じても、プロセスは実行されたままとなります。Pythonプロセスまたはサービスを停止すると、 ブラウザの状態にかかわらず、データ収集は停止します。 追加のワークスペースは、その ジャーナルおよびケースボードのメモを含む、署名済みのZIPまたはASiC-Eコンテナが完全にダウンロードされた後に削除できます。アーカイブの準備だけでは 不十分です。セットアップイベント以外の記録や、ダウンロード後に追加されたメモがある場合、**「削除」** ボタンは利用できません。 パネルがファイル自体を受信した場合、すべての バイトの受信が完了してから初めてエクスポートをカウントし、その後、そのサイズを ``POST /api/exports/{id}/received`` に報告します。途中で中断された ダウンロードはカウントされません。ブラウザの保存ダイアログ(ファイルシステムアクセス)を使用する場合、パネルは ファイルの書き込みと閉じ処理が完了した後に報告を行います。 保存ダイアログがない場合、パネルは受信したファイルをブラウザの ダウンロード機能に引き渡すため、例えば保存ダイアログが キャンセルされた場合など、ブラウザがファイルを保持したかどうかを確認できません。この場合、パネルはファイルが保存されたことではなく、ダウンロードが開始されたことを報告します。 ブラウザが 独自にダウンロードするファイル(パネルのブラウザバッファ容量を超えるエクスポート)や、 別のHTTPクライアントによるダウンロードは、サーバーがレスポンス全体を送信した時点でカウントされます。 オペレーティングシステムやリバースプロキシはレスポンスを数メガバイト単位でバッファするため、こうした ダウンロードの場合、サーバー側では終了間際の途切れを検知できません。 パネルにファイルが保存されたと表示されない限り、 削除する前にダウンロードしたファイルを確認してください。グループエクスポートは、 準備完了直後にダウンロードされた場合にそのアカウントとしてカウントされますが、「**準備済みのエクスポート」**から再度ダウンロードした場合はカウントされません。 Before deleting, the panel shows the format, size, preparation time and SHA-256 of the last downloaded signed archive and asks to confirm that this archive is saved outside the workspace. The server refuses `DELETE /api/profiles/{id}` without `kept_copy` set to that SHA-256 (or to `confirmed` for an archive downloaded before the fingerprint was recorded). 追加のワークスペースを削除すると、そのコレクターが停止し、ローカルデータが削除されます。 ロックされたファイルやファイルシステムのエラーにより削除が中断された場合、パネルには失敗が報告され、 そのワークスペースは「利用不可(`DeletionPending`)」としてリストに残ります。そのファイルを保持している プログラムを閉じてから、**削除を**再試行してください。 TgWitnessを再起動しても、そのワークスペースは停止したままとなり、 部分的に削除されたジャーナルや鍵は再作成されません。削除が成功したことは、 ディレクトリが削除された後にのみ記録されます。別途エクスポートまたはバックアップされたコピーは、 それぞれの保存ポリシーに従って保持されます。 ## 通知 **[設定] → [通知とオフサイトコピー] → [通知先]**、または **[その他のツール] → [エクストラ] → [通知] → [設定]** を開きます。TgWitnessは Appriseを使用して、Matrix、Telegram、Discord、Slack、ntfy、電子メール、およびその他の 対応サービスにアラートを送信します。1つのワークスペースに複数の通知先を追加できます。 1. 1行につき1つのApprise送信先URLを入力してください。ご利用のサービスに応じた [サービスカタログおよびURL形式](https://appriseit.com/services/)をご使用ください。 2. 「**通知を送信**」をオンにしてから、「問題アラート」、「監視対象の チャットでの変更」、および「日次サマリー」を選択してください。サマリーの時刻はサーバーの時刻に基づきます。 3. 削除および編集された メッセージの保存テキストをアラートに含めたい場合は、「**短い抜粋を含める」**をオンにしてください。 4. **「保存」通知**をタップし、次に「**テスト送信」**をタップして配信状況を確認してください。 独自の受信先を設定する場合は、AppriseのJSON[Webhook](https://appriseit.com/services/json/)をご利用ください。 例えば、`jsons://notify.example.org/tgwitness`はHTTPS経由でその エンドポイントにJSONを送信します。これは架空の例ですので、実際の受信先に置き換えてください。 宛先や設定は、選択されたワークスペースに属します。変更通知は、 新たに追加されたチャットを含め、監視対象のソースを網羅しています。トップバーのベルアイコンには、 最近の問題やチャットの変更も一覧表示されます。 デモでは、通知設定は表示されていますが、送信機能は無効になっています。実際のワークスペースで 配信設定を行ってください。通知は、そのワークスペースのDirect、SOCKS5、または HTTPルートを使用します。MTProxyでは通知を転送できません。SMTPなどのHTTP以外の宛先には、 ダイレクトルートが必要です。 ## パネルレイアウト ![合成データを用いた接続ワークスペース](https://phishdestroy.io/tgwitness/assets/connection.png?v=c8781089fe29) **ジャーナルには**、観測結果、検索、およびフィルタが表示されます。編集を行うと、記録された各バージョンが表示され、 削除を行うと、利用可能な場合は削除前のコンテンツが表示されます。出典が不明な場合は、その旨が明示されます。 集計データは「**概要**」で確認でき、取得の詳細についてはローカルガイドに記載されています。 編集されたメッセージを開くと、**文中の差分**または**並べて表示**でバージョンを比較できます。**元データ**には保存されたフィールドが表示されます。隠しリンクやボットボタンへの変更は個別に表示されます。添付ファイルのプレビューを開くと、保存された画像、音声、または動画を確認できます。ダウンロードボタンを使用すると、保存されたオリジナルファイルを取得できます。 **Live** は、レコードの到着に合わせてジャーナルとチャットを更新します。確認中は一時停止するか、準備ができたときに新着イベントボタンを使用してください。その間も収集は継続されます。**Ctrl/Cmd+K** でパネルのアクションを検索したり、ジャーナル内を検索したりできます。 **その他のツール → 「ソース」**には、観測範囲(選択したチャット、Telegramのフォルダ、またはアカウント全体 )、アクセス可能なあらゆる種類のチャット、優先度スターが付いた選択済みソース、添付ファイル および再確認の設定、履歴のスナップショットが含まれます。非公開ソースは、公開リンクのないダイアログ/ID によって選択されます。アクセスステータスは、恒久的な権限ではなく、直近の確認状況を表します。 ソースをフィルタリングしてチェックボックスを選択し、まとめて有効化、一時停止、または優先としてマークできます。利用可能なチャットリストでは、**選択した項目を追加**は選択した項目を使用し、**一致するすべてを追加**は現在の検索条件とタイプフィルターを使用します。 **「チャット」→**「**ユーザー**一覧」には、メッセージが保存されているすべてのユーザーが表示されます。チャットでユーザープロファイル機能が有効になっている場合、 クリックするとそのユーザーのプロファイルが開き、ジャーナル記録へのリンクが表示されます。 **その他のツール → エクストラ → 「独立したウィットネス」は**、読み取り専用のウィットネストークンを作成し、各ウィットネスが最後に確認した日時を表示し、 ウィットネスを実行するためのコマンドとオプションを提供します([独立したウィットネス](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/))。 **その他のツール → 「パラメータ」**には、他のページに記載されていないワークスペースのすべての制限とペースが記載されています: 読み込まれるダイアログの数、チャットリストが再読み込みされる頻度、ハートビートおよびチェックポイントの 間隔、起動バッファ、再チェックがリクエストを分散させる方法(最初の遅延、チャットごとの パスごとのチャット数、チャット間の休止時間、復元および再リクエストされたメッセージ数)、ディスク予約容量、ダウンロードのタイムアウトおよび 再試行、ユーザープロファイルの検索条件(独自の正規表現を含む)、 通知のサイズと頻度、スナップショット、ZIPおよびブラウザダウンロードの制限、Telegram クライアントのタイムアウトと再試行。各フィールドには範囲とデフォルト値が表示され、変更されたフィールドは マークされ、1つずつまたはまとめて復元できます。 すべての変更は、変更前後の値とともに `parameters.changed`として記録され、監視開始記録には 適用中の値が記載されます。値は次回使用時から適用され、クライアントのタイムアウトおよび再試行は 次回の接続時から適用されます。再確認間隔、添付ファイルの種類とサイズ、証拠およびオフサイトコピーの 間隔は、それぞれのページに表示され、プリセットだけでなく、その範囲内の任意の値を設定できます。 上部バーのベルアイコンには、監視対象のチャットにおける最近の問題や変更が一覧表示されます。未読のものは、 既読としてマークされるまでカウントされます。変更はチャットごとおよび時間ごとにグループ化され(「削除 12件、 編集 1件、見つかりませんでした 0件」)、ログアウトやディスク容量不足などの問題は、 チャットがどれほど活発であってもリストに残ります。 **その他のツール → アカウント登録** は電話番号入力欄から始まります。**「続行」** をクリックすると直接 コード入力画面に進み、API 認証情報が未入力の場合にのみ入力が求められます。QR コードおよびファイルインポートは 別のタブで利用可能です。保存された API 認証情報は、そのワークスペース内でのみ再利用されます。 入力画面にはサイドバー、統計情報、設定説明文はありません。「**設定」** アイコンをクリックすると、API、プロキシ、ストレージ、および追加アカウントの設定画面が開きます。新しいワークスペースを開くと [初期設定画面](https://phishdestroy.io/tgwitness/ja/docs/reference/settings/) が表示されます。サインイン後、保存済みのソースと記録を含むワークスペースが開くと、**「チャット」** 画面が表示されます。 ルートを変更するには、観測を一時停止する必要があり、未完了のログインはキャンセルされます。既存の ジャーナルを、別のTelegramアカウントに自動的に再紐付けすることはできません。 **エクスポート機能は**ジャーナルの整合性をチェックし、ポータブルなファイルを生成します。そのワークスペースIDは ダウンロード用CLIに渡すことができます。各エクスポートは完全なジャーナルプレフィックスを固定します。それ以降の イベントは、次のエクスポートに含まれます。検索フィルターはパッケージの範囲を変更しません。 詳細な署名およびカバレッジ情報は、「**検証と証拠**」に記載されています。 このパネルでは、「**Collector」の健全性状況**として、コレクターの状態、キュー入りまたは失敗したメディア、最も古い保留中のメディア、空き ディスク容量、リクエストの一時停止、およびアクセスが未確認のソースを報告します。 これらの詳細は、初期状態では折りたたまれており、「アカウント」画面では非表示になっています。セットアップ カードには、次の手順(アカウントの接続、ソースの選択、または監視の開始)が表示されます。 アカウント一覧は読み込み時のスナップショットであり、 選択されたワークスペースは定期的に更新されます。これはマルチプロセス型のSLAモニターではありません。 UIはローカルのアセットを使い、ソースのコンテンツをテキストとして描画します。デスクトップと幅の狭いChromiumレイアウトはテスト済みです。 ## 導入環境 | 環境 | インストール | 検証状況 | | --- | --- | --- | | Windows PC/サーバー | Python 3.11 以上、scripts\Setup.cmd/Start.cmd、プライベートデータディレクトリ | Windows/Python 3.12環境でローカルに検証済みです。 | | Linuxサーバー/VPS | Pythonのvenv、専用サービスユーザー、HTTPS/SSH | コード、CI、および systemd の例が提供されていますが、このホスト上では実行されていません。 | | macOS | Pythonのvenv、フォアグラウンドプロセス、またはユーザーエージェント | launchd の使用例を掲載しています。別途、インストール状況の確認が必要です。 | | Docker/Compose | 永続ボリューム、ワーカー1台 | 定義とCIランタイムチェックが提供されています。ローカル環境ではDockerは利用できません。 | | スマートフォン用ブラウザ | 稼働中のサーバー上の保護されたパネルに接続してください | Chromiumのナローレイアウトでの動作確認済みです。コレクターはiOS/Androidでは動作しません。 | 移植性が高いため、クラウドサービスやフロントエンドの構築は必須ではありません。ただし、各ターゲットには 互換性のある Python/crypto 依存関係、ローカルディスク、およびネットワークアクセスが必要です。 [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/) および[サービステンプレート](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md)をご参照ください。 ワークスペースは、CPU、メモリ、およびイベントループを共有します。プロセスの分離を行うには、個別の インスタンス、ポート、データディレクトリ、およびアカウント認証を使用してください。別々のインスタンス間で統一された 管理パネルは存在しません。複数のワーカーを1つのデータベースに割り当てないでください。 ## 起動時の確認とエクスポート 準備済みの環境を起動する前に、`python start.py --check`を実行してください。機械可読なチェックを行う場合は`--json`を 追加するか、指定した`--data-dir`、`--host`、`--port`を指定してください。 このコマンドは、Telegramへのログインやジャーナルの作成を行わずに、前提条件をチェックします。 アプリケーションの起動時にジャーナルの検証が実行され、キャプチャの準備状況が パネルに表示されます。ポートが使用中の場合は、単に既存のインスタンスが存在している可能性があります。 File System Access API をサポートするブラウザでは、書き込み可能な ストリームを通じてエクスポートデータが保存されます。その他のブラウザでは、最大 128 MiB までがバッファリングされます。より大規模な エクスポートや、ファイルストリーミングに対応していないブラウザでは、ストリーミング CLI をご利用ください: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` 子ワークスペース用のエクスポートから「`--profile ID` 」を追加してください。リモートアクセスには「`--url https://server` 」を使用してください。プレーンHTTPは、ループバック先でのみ受け入れられます。トークンは ファイルから読み込まれ、ヘッダーとして送信されます。画面に表示されたり、URLに含まれたりすることはありません。リダイレクトは 拒否されます。既存の出先は上書きされません。 転送に失敗した場合は、 その一時的な部分ファイルが削除されます。報告される SHA-256 は転送チェックサムです。署名付き ZIP ファイルについては、信頼できるフィンガープリントまたはチェックポイントを用いて別途検証してください。 ## バックアップ、復元、および中断について 1. 監視を一時停止し、プロセスを完全に終了させてください。 2. データディレクトリ全体をコピーしてください:データベース、WAL/SHM(存在する場合)、メディア、 `credentials.enc`、`signing.enc`、`network.enc`、Vaultキー/メタデータ、トークン、 チェックポイント、およびすべての`profiles/`ディレクトリです。 3. 外部キーモードの場合、マスターキーを別途保管し、各 `vault.external.json`を保持してください。新しいキーを生成しても、以前の秘密鍵を復元することはできません。 4. 宛先が停止している間に復元を行い、元のキーを設定し、 アクセスを制限し、再開前に整合性を検証してください。 5. ダウンタイムと検証結果を記録する。ダウンタイムは記録された空白期間として残る; 履歴スナップショットは、その直後の状態を追加する。 Evidence ZIPs exclude sessions/private keys and are not full service backups. `tgwitness backup FOLDER` makes the same copy while the panel keeps running and leaves out the search index, which rebuilds itself; see [Updates and backups](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/#updates-and-backups). Four things are protected differently: | 概要 | 保護 | | --- | --- | | パスワードなしでファイルをエクスポートする(デフォルト設定) | 署名されているため変更は検出できます。エクスポートを暗号化するにはパスワードを設定してください | | パスワード付きでファイルをエクスポートする | パスワードを設定した場合、エクスポートされたデータは変更されることなく、7-ZipやWinRARで開くことができるWinZip AES-256 ZIP形式で保存されます。パスワードは保存されません([証拠の取り扱い](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/))。 | | ジャーナルデータベースおよびディスクに保存された添付ファイル | 暗号化されたディスクまたはボリュームとフォルダーのアクセス権 | | Telegramのセッションと署名鍵 | データディレクトリ内で暗号化されています(`credentials.enc`、`signing.enc`、`network.enc`)。 | フルサービスのバックアップとは、前述の停止されたデータディレクトリのことであり、エクスポートではありません。 両方とも、保護されたストレージと意図的な転送メカニズムを使用してください。一時的なサーバーエクスポートは各ワークスペースの `temporary-exports/`に保存されます。完了したレスポンスはクリーンアップされ、中断されたエクスポート ファイルは、そのワークスペースのインスタンスロックが保持されている間に、次回の起動時に削除されます。 接続復旧イベントの後、コレクターは 保存された更新位置から、見逃した更新を要求します。永続的なメディアジョブとTelegramの更新位置は再起動後も維持されます。 [証拠形式を](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#durable-collection-and-process-receipts-02)参照してください。 ## 容量と保存期間 デフォルトの制限(すべて**「その他のツール」→「パラメータ」**で変更可能):最初の1,000個のダイアログ、スナップショットあたり500件のメッセージ、 4 GiBの非圧縮署名付きZIPコンテンツ(より大きなアーカイブには `verify.py --max-gib N`が必要)、および128 MiBのブラウザ用フォールバック。**「その他のツール」→「ソース」→「記録」→「添付ファイル」**で、添付ファイルは種類ごとに1~2,000 MiBを 消費します。ダウンロードCLIのデフォルト転送量は5 GiBです。利用可能なディスク容量が 下限となる場合があります。 ジャーナル、メディア、WAL、一時的なエクスポート、およびバックアップ用にスペースを確保してください。 エクスポートでは、Composeの512MiBの`/tmp`ではなく、データボリュームが使用されます。 グループ数のカウントだけでなく、イベント/秒、キューの経過時間、メディアバイト数、ディスクレイテンシを測定してください。 ライブ配信は、稼働中のコレクター上で測定されます。 自動的な保持期間満了による削除機能はありません。ジャーナルの末尾を削除すると、 保持されているチェックポイントとの関連性が無効になります。 優先再確認はすでにあります。スター付きのソースはデフォルトで15分ごと、それ以外は6時間ごとに再確認されます([再確認の階層](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#recheck-tiers)を参照)。パスワード保護付きエクスポートは上記のとおり動作します。範囲を限定したアクセスは[アクセスと権限](https://phishdestroy.io/tgwitness/ja/docs/reference/access/)に記載されています。[READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md)、[LIVE_ACCEPTANCE.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md)、[VERIFICATION.md](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/)も参照してください。 --- # Telegram · 調査モード Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/ チャンネル、グループ、プライベートチャット、ボットにまたがるアカウント全体の調査について、調査範囲の設定から検証済みのケースパッケージの作成までを網羅しています。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) チャンネル、グループ、プライベートチャット、ボットにまたがるアカウント全体の調査について、調査範囲の設定から検証済みのケースパッケージの作成までを網羅しています。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![調査](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) チャンネル、グループ、プライベートチャット、ボットを横断して、事案を 初期の取得段階から、引用されたタイムライン、検証可能な引き継ぎに至るまで追跡できます。インタラクティブなウェブサイト 版は `/docs/cases/` にあります。[プレビューの手順をご覧ください](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally)。 **このページでは** - [実例:4つの会話にわたって宛先が変化するケース](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/#worked-case-a-destination-changes-across-four-conversations) - [1. 事案を定義し、全容を収集する](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/#1-define-the-case-and-collect-the-whole-account) - [2. すべての情報源を網羅し、歴史的背景を把握する](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/#2-inventory-every-source-and-acquire-historical-context) - [3. 変化し続ける状況と意図的な相互作用を反映する](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/#3-preserve-the-evolving-case-and-deliberate-interactions) - [4. チャット間の観察結果の関連付け](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/#4-connect-observations-across-chats) - [5. チャット横断型タイムラインの構築](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/#5-build-the-cross-chat-timeline) - [6. アカウントの視点を、その出所を損なうことなく追加する](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/#6-add-account-perspectives-without-losing-their-origin) - [7. ケースの引き継ぎの整理と検証](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/#7-assemble-and-verify-the-case-handoff) - [調査内容を適応させる](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/#adapt-the-investigation) ## 事例:4つの会話にわたって目的地が変更されたケース ある告知がボットを指し示しています。運用グループが新しい支払い 先について議論し、ボットのキーボードにそれが表示されます。告知が編集され、 非公開のフォローアップメッセージでその支払い先が繰り返され、グループメッセージが消えます。 疑問点は以下の通りです。変更の前後で何が確認されたか、どのTelegram アカウントが各項目を投稿したか、宛先がどこに表示されたか、どの添付ファイルのバイトが 保存されたか、そしてどのような間隔が不明のままであるか、ということです。 この例に登場するすべての名前、ID、時刻、およびジャーナルの参照情報は架空のものです。 ワークフローでは現在の機能が使用されています。ケースマップはあくまで例示であり、アプリケーションによって自動的に 生成されたグラフではありません。 フローチャート · チャンネル → ワークスペース・ジャーナル; グループ → ワークスペース・ジャーナル; プライベートチャット → ワークスペース・ジャーナル; ボット → ワークスペース・ジャーナル; ワークスペース・ジャーナル → すべての情報源を検索する; ワークスペース・ジャーナル → 記録の参照先を含む人物プロフィール; ワークスペース・ジャーナル → 保存されたバージョンと添付ファイルの受信確認; すべての情報源を検索する → アナリストのタイムラインおよび情報源登録簿; 記録の参照先を含む人物プロフィール → アナリストのタイムラインおよび情報源登録簿; 保存されたバージョンと添付ファイルの受信確認 → アナリストのタイムラインおよび情報源登録簿; ワークスペース・ジャーナル → 署名付き証拠 ZIP; アナリストのタイムラインおよび情報源登録簿 → 個別に検証済みの証拠資料を用いた案件の引き継ぎ; 署名付き証拠 ZIP → 個別に検証済みの証拠資料を用いた案件の引き継ぎ · チャンネル · グループ · プライベートチャット · ボット · ワークスペース・ジャーナル · すべての情報源を検索する · 記録の参照先を含む人物プロフィール · 保存されたバージョンと添付ファイルの受信確認 · 署名付き証拠 ZIP · アナリストのタイムラインおよび情報源登録簿 · 個別に検証済みの証拠資料を用いた案件の引き継ぎ **図表をテキストで記述** 1. チャンネル → ワークスペース・ジャーナル 2. グループ → ワークスペース・ジャーナル 3. プライベートチャット → ワークスペース・ジャーナル 4. ボット → ワークスペース・ジャーナル 5. ワークスペース・ジャーナル → すべての情報源を検索する 6. ワークスペース・ジャーナル → 記録の参照先を含む人物プロフィール 7. ワークスペース・ジャーナル → 保存されたバージョンと添付ファイルの受信確認 8. すべての情報源を検索する → アナリストのタイムラインおよび情報源登録簿 9. 記録の参照先を含む人物プロフィール → アナリストのタイムラインおよび情報源登録簿 10. 保存されたバージョンと添付ファイルの受信確認 → アナリストのタイムラインおよび情報源登録簿 11. ワークスペース・ジャーナル → 署名付き証拠 ZIP 12. アナリストのタイムラインおよび情報源登録簿 → 個別に検証済みの証拠資料を用いた案件の引き継ぎ 13. 署名付き証拠 ZIP → 個別に検証済みの証拠資料を用いた案件の引き継ぎ ## 1. 事案を定義し、全容を把握する 1. 収集用アカウントを専用のワークスペースに接続してください。[Case Board](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/) または事件登録簿に、事件参照番号、アカウント ID、ワークスペース、および 観察開始時刻を記録してください。信頼できる署名鍵のフィンガープリントは、別途保管してください。 2. 専用の収集アカウントでは、**「その他のツール」→「ソース」→「スコープ」→「調査モード」**を開きます。プリセットでは、「 **アカウント全体**」、「チャンネル/グループ/プライベートチャット/ボット」、「自身のアクション」、「ソース プロファイル」、および新しく発見されたソースの表示可能な最新200件のメッセージが選択されています。 内容を確認し、**「スコープを保存」**を押して、スコープの確認を完了してください。 メインアカウントでは、選択したチャットまたはフォルダを使用します。アカウント全体の収集は、 調査対象としてマークされたアカウントで利用可能です。 3. **チャットを読み込み**、ソースをアカウントのダイアログリストと比較してください。 除外項目を確認してください。**その他のツール → パラメータ → アカウントのリストから読み込むチャットの**デフォルト値は 1,000で、最大20,000まで指定可能です。リストの制限を超えるソースは、 アクティブになった時点で追加されます。実際に列挙された内容を記録してください。 4. [**その他のツール] → [ソース] → [記録]** で、**[表示されているすべてのアクティビティ]** を選択し、 監視設定を保存してください。添付ファイルの種類や制限、および空きディスク容量を確認してください。 5. 監視を開始します。制御された新しいメッセージ、編集、削除を検証し、その後、 テストの参照情報および発生したエラーを記録します。 アカウント全体のスコープでは、保存された設定の範囲内で、そのアカウントが参加している チャット内での、アカウントから可視なアクティビティが記録されます。シークレットチャットはシークレット[チャット](https://phishdestroy.io/tgwitness/ja/docs/reference/secret-chats/)モジュールによって記録され、 既存の会話は[「履歴」](https://phishdestroy.io/tgwitness/ja/docs/reference/history/)を通じて遡及的に記録されます。[「収集スコープ」](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account)を参照してください。 ## 2. すべての情報源を網羅し、歴史的背景を把握する チャットごとに1行ずつ、ソース登録簿を作成してください: | 分野 | 記録 | | --- | --- | | アイデンティティ | ワークスペース、アカウントID、数値のチャットID、タイトル、およびタイプ | | 可視性 | メンバーシップ/役割、アクセス権の確認の有無、除外事項 | | リアルタイムキャプチャ | 開始時期、選択されたイベントの種類、およびその後のポリシー変更 | | ジャーナルの履歴 | スナップショットの要求/完了状況、制限、時間、および記録の参照情報 | | 全履歴 | チャットごとの署名付きエクスポートファイル名、境界、および完了/失敗 | | 添付ファイル | メディアの受信状況、ハッシュ値、サイズ、およびスキップ/失敗の結果 | | 対応範囲 | サービス停止、取り込みの不完全さ、FloodWait、利用できないメッセージ、その他の欠落 | 各情報源に応じて適切な取得方法を使用してください: - 「**その他のツール」→「ソース」→「対象範囲内のチャット**」で**完全な履歴を読み込むと**、有効化されたソースからの利用可能な過去の メッセージがワークスペースのジャーナルに読み込まれます。一時停止/再開 および署名付き進捗レポートに対応しています。[履歴取得を](https://phishdestroy.io/tgwitness/ja/docs/reference/history/)参照してください。 - **履歴スナップショットは、**最近表示されたメッセージを観察ジャーナルに保存します。 デフォルトの上限は500ですが、**「その他のツール」→「パラメータ」→「最大履歴スナップショット」で** これを10,000まで増やすことができます。これらは現在の履歴の観察結果であり、再構築された編集内容ではありません。 - **[エクスポート] → [1つのチャットをキャプチャまたはエクスポート] → [チャット全体をエクスポート]**、または **[チャット] → [チャットをエクスポート**] を選択すると、 1つのチャットで現在表示されている履歴が、個別の署名付き `chat.json` / `chat.html` バンドルとして取得されます。ケースのソースについてこれを繰り返し、各結果を保持してください。 - **新しいチャットやボットが出現した際**、そのプロフィールと最大1,000件の最近の メッセージを保存できます。調査モードでは200件が選択されます。既存のチャットについては、 モードを有効にしても、遡ってそのデータを取り込むことはできません。 - **表示可能な添付ファイルをダウンロードすると**、設定されたポリシーに基づきバイト数が保持されます。 SHA-256およびバイト数が記載された、完了済みの`media.saved`レシートが必要です。キューに入れられた ジョブ、サムネイル、またはファイル名は、保持される添付ファイルには該当しません。 チャット全体のエクスポートを行っても、ジャーナルやユーザープロフィールにはすべての メッセージが反映されるわけではありません。TgWitness内で分析が必要な履歴については、 **「履歴全体を読み込む」**または「範囲指定されたジャーナルのスナップショット」を使用してください。履歴の取得を開始する前に、 有効になっているソースリストを確認してください。いずれの方法でも、Telegramがもはや返さないデータは復元できません。 ## 3. 変化し続ける事案と意図的なやり取りを保存する 進行中の事件に関連するチャットを優先的な情報源としてマークしてください。再確認の間隔、継続的な 追跡状況、およびメディアへの反映状況を確認してください。アカウントを使用中は、コレクターの監視を継続してください。 **「チャット」→「プロフィール」→「今すぐプロフィールを保存」**を使用して、 説明文やボットコマンドなどの情報源メタデータを保持してください。これは、保存されたメッセージから導き出される 人物プロフィールとは別物です。 情報源を追跡したり、ボットとやり取りしたりするケースについては: 1. **「Telegramリンクを開く」→「プレビューを保存」は、**指定されたリンクと、操作実行前の プレビューを記録します。 2. **「Join / open and observe」**は、join/openを実行し、指定された場合はボットのstart パラメータを送信します。承認待ちの参加リクエストは「pending」として記録されます。 3. パネルから送信されたテキスト返信およびサポートされているボタンの押下操作については、 `interaction.requested`および`interaction.result`が保持されます。コールバックの受信確認では、 返されたポップアップテキスト、アラートの状態、およびURLを保持することができます。 これらは実際のアカウント操作です。別のTelegramアプリでのコールバックの押下は、 収集ツールからは確認できませんが、その結果として送信されたメッセージや編集内容は確認できる場合があります。 ミニクライアントは、ウェブアプリ、決済、電話、位置情報のワークフローを実行しません。 正確な動作については、「[パネルの操作」](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#act-from-the-panel)をご覧ください。 ## 4. チャット間の観察結果を関連付ける 「**Journal**」で「**All sources**」を選択し、記録されたコンテンツを検索してください。一致した レコードを開き、ワークスペース、チャット、メッセージID、シーケンス、およびレコードのハッシュを記録してください。 関連するチャットで、「**People」→「プロフィールを有効にする」**を開き、対象者のプロフィールを確認してください: - 長期にわたり観測された名前/ユーザー名およびTelegramの数値ID。 - 返信の関係性には、元の記録への参照を含めます。 - **また、**このワークスペースのジャーナル内にある、そのIDが書き込みを行った他のチャットにも含まれています。 - アクティビティ、編集・削除履歴、および言及されたウォレット、電話番号、ユーザー名、リンク。 - 保存されたアバターのメタデータおよび類似のキャッシュされたアバター、ならびにそれぞれの出典元。 調査結果で派生プロファイルを使用する前に、引用されたレコードを開いてください。プロファイルの対象は、 メッセージが保存されているユーザーであり、グループの全メンバーではありません。**その他のツール → パラメータ → 「事実ごとの引用レコード数」は**、 参照リストを制限するものであり、基礎となるアクティビティの数を制限するものではありません。 メンションやアバターの類似性は手がかりであり、所有権や身元は数値IDおよび属性付き送信者に基づいています。 署名付きドシエでは、エンコーダーのヒントと、転送および再利用されたファイルが、 `clients.forwarded`と`clients.reused`に分類されます。これらのファイルは、 `clients.observed`や`media_timing.pre_existing`リストには含まれません。 「再利用されたファイル」とは、 このジャーナルのより前の部分で、 読者が許可されたチャット内で、別のメッセージにおいて同じTelegramドキュメントIDが検出されたことを意味します。その最初の検出記録が 引用されます。同じメッセージの別の検出や編集は、再利用とはみなされません。 この資料の`paid_reactions`セクションには、掲載されている各メッセージについて、入手可能な最新の「スター」 ランキングが、ソースレコードおよび匿名フラグとともに保持されています。 これらはスナップショット時点の集計値であり、追加支払いの合計や、反応したユーザーの完全なリスト ではありません。ランキングが含まれていないスナップショットについては、代替となる リストは提供されません。このセクションでは、表示制限に達した場合、省略されたメッセージが報告されます。 ウォッチリストおよびインジケーターのエクスポートでは、ボタンラベル、URL、コピーテキスト、インライン クエリ、および有効なUTF-8としてデコードされるコールバックバイトが検査されます。無効またはサイズ超過の コールバックエンコーディングは、テキスト抽出時にスキップされますが、元のバイトは 保存されたレコードに残ります。 既存のウォッチリストについては、これらの追加フィールドを含む古いレコードを 検査するために再スキャンが必要です。検査処理ではボタンは押されません。 具体例: | リンク | 記録 | サポート対象の観測項目 | | --- | --- | --- | | 同じ送信者アカウント | グループ #146 および非公開のフォローアップ #205 | いずれもTelegramの送信者ID「71001」を提供しています。 | | 同じ宛先 | #146、ボットキーボード #173、チャンネル編集 #188、プライベートメッセージ #205 | すべてに`pay.example.invalid/new`が含まれます。繰り返し出現する宛先は、その資料へのリンクです。 | | 保存されたファイルは同じです | メディア受領書 #151 および #209 を完了しました | 保存されたバイトについて、SHA-256の値が完全に一致しています。 | | チャンネルの出典 | #101 および #188 | 送信者が明記されていない限り、チャンネルへの投稿をユーザー71001によるものと見なさないでください。 | 添付ファイルのハッシュ値とそれに関連するメッセージ参照を照合し、 それらのレコードに指定された Telegram ID ごとにアカウントのタイムラインをグループ分けした状態を維持してください。 [Case](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/)Boardにはチームの作業メモを残してください。#146、#188、#205など、 参照する記録にはブックマークを付け、目的の文字列を正確にハイライトし、 2つの記録間または特定の時間範囲内のすべての記録されたアクションの一部を保存してください。 メモ やステータスは、チームによるレビュー内容を独自の署名付き履歴として保持し、 ソースの観察結果とは個別に識別可能です。 ## 5. チャット横断型のタイムラインを作成する **「チャット**」に保存されたバージョンと、その**ジャーナル記録の「#…」**リンクをご利用ください。 **ジャーナル**では、「**すべてのソース**」に「**編集**」「**削除**」「**カバレッジ**」を組み合わせてください。 提供されている場合は「`source_at`」と「`observed_at`」の両方を保持してください。 | 観察期間の例 | 参考資料 | 所見 | | --- | --- | --- | | 09:00 | チャンネル #101 | 元の送信先が記録されました | | 09:12 | グループ #146; メディア #151 | 新しい保存先が投稿されました。ファイルのダウンロードが完了しました。 | | 09:16 | ボット #173 | キーボードは新しい宛先を指しています | | 09:20 | チャンネル #188 | 告知文を編集しました。保存された両方のバージョンが残されています。 | | 09:24 | プライベート #205; メディア #209 | 同じ送信者IDの宛先が繰り返され、同じファイルバイトが保持されています。 | | 09:28 | グループ #231 | 削除通知を受信しました。削除者および正確な削除時刻は不明です。 | これらの例示された参照の間に、その他の記録が存在する場合があります。シーケンス番号によって 観測順が定められますが、履歴のスナップショットにはより古いソース日付が含まれており、リアルタイムのイベントよりも 遅れて到着する場合があります。スナップショット、復元されたメッセージ、削除通知、および 再確認時に欠落していた結果については、それぞれ区別してください。 記録範囲の空白部分は「不明な期間」としてマークしてください。後から 履歴を取得しても、遡及的に中断のない観測が確立されるわけではありません。 ## 6. アカウントの視点を、その出所を損なうことなく追加する アカウントごとに個別のワークスペースを使用し、そのインベントリを繰り返し作成してください。 比較を行う際は、毎回、アカウントID、役割、署名鍵のフィンガープリント、および出典情報を記録してください。 メッセージ番号は、チャットやアカウントを跨ぐグローバルな識別子ではありません。 Case Boardは、各ワークスペース内でソースにリンクされたメモやコレクションを管理します。 グループ画面ではアカウントのステータスをまとめて確認でき、別々のワークスペースからの エクスポートデータをまとめて処理できます。これらのソースを、ケースノートや分析ツールで関連付けられます。各ジャーナルは 独自の起源と署名キーを保持します。グローバル検索や、複数のワークスペースを統合した タイムラインは生成されません。 1つのチャネル/スーパーグループのマルチアカウントエクスポートでは、 対象となるアカウントを使用して、そのチャットの履歴を取得します。 長期にわたる作業の場合は、[独立した証人](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/)との境界を維持してください。 制御された配信チェックを使用して、 各アカウントのキャプチャ経路と可視性を確認してください。 ## メディアの再配信および転送元 証拠報告書では、TelegramのドキュメントIDと、保存ファイルの記録から得られたSHA-256ハッシュを 個別に比較しています。これらは、個別のメッセージやチャット、および保存されている最初の 出現箇所と最後の出現箇所を、HTML形式の展開可能な観察タイムラインとともに表示します。 同一の メッセージに対する繰り返しのスナップショットや編集は、 同じキーの出現回数を増加させません。編集されたメッセージ内の別のファイルは、独自の出現回数を保持します。 「初出」は、レポートの選択範囲内におけるジャーナルの掲載順に基づいています。これは、 Telegram上での最古の公開を主張するものではありません。ドキュメントIDはTelegramのドキュメントを識別するものです。 SHA-256は保存されたバイトデータを比較します。異なる保存画像の64ビットdHashが 一致する場合、視覚的な手がかりとして表示されます。この比較では、 最寄り隣接探索ではなく、ハッシュ値が等しいもののみが対象となります。 dHash 分析を行う前に、画像のバイトデータは保存されたSHA-256と一致している必要があります。64 MiBを超えるファイルおよび4,000万ピクセルを超える画像はスキップされます。 送信元ごとのサマリーでは、宛先メッセージの個数をカウントします。ヘッダーのピアID、 非表示名、投稿者の署名、および「保存済みメッセージ」のコンテキストは、それぞれ別個に扱われます。 ユーザープロフィールのJSONには各送信者の送信元が含まれており、チャンネルの投稿も チャットレベルのサマリーに表示されます。ピアIDのない名前付き送信元は、テキストのグループであり、 特定された人物ではありません。インポートされたチャットのヘッダーは、引き続き「インポート済み」としてマークされます。 非コンパクトな証拠ZIPファイルには、アーカイブマニフェストによって保護された`media-repeats.json`、`forward-sources.json`、および `observed-sources.gexf`が含まれます。GEXF 1.3グラフには、 型付き`forwarded_from`および`recommended`エッジがあります。矢印は、観測されたチャットから 参照先のピアへと伸びています。 レコメンデーションの重みは、保持されたレコメンデーションの 観測回数を数え、フォワードの重みは、個別のメッセージ数を数えます。非表示の名前やインポートされた ヘッダーは、アイデンティティエッジを生成しません。グラフ操作によってプロファイルが解決されたり、 Telegramが呼び出されたりすることはありません。エッジのメタデータには、ソースシーケンスとハッシュが含まれます。 要約はレポートの選択内容に基づいていますが、証拠データのZIPファイルには 署名済みのジャーナルが完全な形で含まれています。メッセージイベントのみを含む選択範囲では ドキュメントIDが比較されますが、保存バイト数や画像の比較を行うには、 選択されたストリーム内に保存ファイルイベントが存在する必要があります。現在のクラウドメッセージの選択範囲には、`media.saved`は含まれていません。 制限は明示されています:分析ごとに保持されるキー/メッセージの 出現回数は200,000回、メディアキーは100,000個、レポートグループは20個、グループごとの 時系列参照は100件、エクスポートされるグラフのエッジは1,000本です。 比較の上限に 達した場合、結果には省略された発生回数が表示され、カウント値は下限値となります。 時系列およびグラフの表示制限は個別に報告されます。圧縮されたZIPファイルでは、 これらの派生した要約は省略されます。署名付きソースレコードは変更されません。 ## 7. 案件の引き継ぎをまとめ、確認する これらを、アナリストが作成したケースディレクトリにまとめて保管してください: | 資料 | 目的 | | --- | --- | | 事例ノートおよび情報源登録簿 | 質問、収集方針、アクセス権限・役割、調査結果、代替説明、および不備 | | タイムライン | 各エントリについて、日時およびワークスペース/チャット/メッセージ/シーケンスの参照情報を記載しています。 | | Case Board エクスポートおよびスライス(使用されている場合) | ソースにリンクされたブックマーク、引用、チームノート、コレクション、改訂履歴、および証拠用ZIPファイルと照合された選択済み記録 | | ワークスペースごとの署名付き証拠ZIPファイル | 記録されたジャーナル、マニフェスト、および保存されたメディアの完全な内容が含まれます。パネルフィルターを使用しても、ジャーナルのエクスポート範囲は狭まりません。 | | 個別に署名されたユーザープロフィールファイル | 派生した参照情報は、対応するワークスペースの証拠と照合して確認されました | | 署名付きチャット全記録のエクスポート | 観察ジャーナルとは別に、現在の表示履歴を取得します。 | | 信頼されたフィンガープリント、TSAルート証明書、および以前のチェックポイント | キーID、最終レコードの外部時刻、および保持されたジャーナルの境界 | | 設定が行われている場合、Witnessのアーティファクト | 独立したジャーナル、署名付き投稿、およびウィットネスのフィンガープリント | | 検証結果および納品ファイルのハッシュ値 | 何が確認されたか、どのバイトが転送されたか、そして誰に転送されたか | 信頼できるインストール環境から、ファイル名および各ワークスペースの実際のフィンガープリントを記載しています: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` `--require evidence`は、フィンガープリントが一致せず、かつ第三者からの外部時刻が 最後のレコードをカバーしていない場合、コード2で終了します。チェックポイントは補助的な検証です。 実際の検証結果と元の証拠資料は保持してください。Case Board からのワークスペース メモを、引用されたソース資料とともにエクスポートしてください。ワークスペースをまたぐ 調査結果を最上位のケースディレクトリにまとめます。各 TgWitness 証拠資料には、それぞれ独自の 署名と検証手順があります。 ## 調査の適応 | 事例 | トレース | 配信 | | --- | --- | --- | | ボットによる注文・支払いの紛争 | エントリーの告知 → 保存されたリンクのプレビュー → ボットの起動パラメータ → メッセージおよびキーボード版 → パネルコールバックの受信確認 → プライベート/グループのフォローアップ | 観測されたオファー/レスポンスのタイムラインおよび検証済みの情報源。支払いの確認は支払い記録から得られます。 | | インシデント発生後の削除されたメッセージ | 影響を受けたすべてのチャット → 保存されたオリジナル/編集履歴 → 削除または再確認時の欠落結果 → 保存されたメディア → カバー範囲およびその他のアカウントの視点 | 保存されたバージョンと明示的な不明な期間;削除を行った主体を推測して記載することはありません | | ある参加者が、チャットごとに名前を変えています | 数値の送信者 ID → 名前/ユーザー名の履歴 → 返信 → その他の観測されたチャット → 引用された宛先/ファイル | Telegramアカウントのアクティビティのタイムラインと、そのソースレコードへのリンク | [コレクション参照](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/) · [人物プロフィールの検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#people-profiles) · [証拠の引き渡し](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#investigation-handoff) · [検証完了](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/) --- # Telegram · 機能と対象範囲 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/features/ TgWitnessの現在の収集モデル、マルチアカウントワークフロー、エクスポート機能、および運用上の制限事項。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) TgWitnessの現在の収集モデル、マルチアカウントワークフロー、エクスポート機能、および運用上の制限事項。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [プロジェクト参照](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![プロジェクト参照](https://phishdestroy.io/tgwitness/assets/chapter-project.svg?v=f8e31208f561) TgWitnessは、接続されたアカウントからアクセス可能なTelegramの会話内容を保存し、 観測された変更を記録し、検証可能なエクスポートデータを生成します。このリファレンスでは、 収集モデル、現在のワークフロー、およびその範囲について説明します。 **このページでは** - [スタンドアロンアプリケーション](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#standalone-application) - [共有された調査](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#shared-investigations) - [アーカイブツール](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#archive-tools) - [オプションの追加項目](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#optional-extras) - [プロトコルおよび非公開情報源](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#protocol-and-private-sources) - [複数のアカウント](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#multiple-accounts) - [キャプチャと出典明記](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#capture-and-attribution) - [容量とTelegramの制限](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#capacity-and-telegram-limits) - [信頼性と復旧](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#reliability-and-recovery) - [証拠モデル](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#evidence-model) - [エクスポート、デプロイ、および引き継ぎ](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#export-deployment-and-handoff) - [安定版のリリース基準](https://phishdestroy.io/tgwitness/ja/docs/reference/features/#stable-release-criteria) ## スタンドアロンアプリケーション TgWitnessには、独自のインストール手順、データディレクトリ、およびリリースライフサイクルがあります。同梱の Webインターフェースでは、設定や確認を行うことができ、エクスポートされた記録は単独でも利用可能です。 利用者は自身のアカウントを連携させ、各アカウントで表示可能な情報源を選択することで、 保存された観測ジャーナルを取得します。パネルには、コンテンツ、保存された変更内容、観測の 出所、および既知の欠落情報が表示されます。別の調査員が、エクスポートされた資料を検証することができます。 このパネルでは、アカウントの認証、ソースへのアクセス、コレクターの 活動、および記録範囲を区別しています。メッセージ数が少ない期間や接続の問題を 評価する際は、これらの状態を総合的に確認してください。 ## 共同調査 管理者は、ワークスペースや 個々のチャットを範囲とする[アクセストークンを](https://phishdestroy.io/tgwitness/ja/docs/reference/access/)発行でき、アクションごとの権限、IP制限、有効期限、ログイン制限、 およびセッション制御を設定できます。読み取り専用のレビュー担当者は、 Telegramの認証やメインパネルのキーを受け取ることなく、ケースを閲覧できます。 チャット限定のアクセス権は、 アカウント全体の設定やジャーナル全体のエクスポートとは独立して管理されます。 自動MTProxyは、4つの公開ソースまたは オペレーターカタログから、Telegramの有効なルートを維持します。[IPモードによって](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/#ip-modes)、 障害発生時に別のプロキシを待機するか、明示的に許可された直接ルートを使用できるかが決定されます。 外部HTTPリクエストには、個別のルートと無効化スイッチが用意されています。 ## アーカイブツール [履歴の取得](https://phishdestroy.io/tgwitness/ja/docs/reference/history/)、[アーカイブの検索と分析](https://phishdestroy.io/tgwitness/ja/docs/reference/analysis/)、 [読み取り専用MCP](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/)、[ローカルOCR/文字起こし](https://phishdestroy.io/tgwitness/ja/docs/reference/media-analysis/)、および [送信用Webhookは、](https://phishdestroy.io/tgwitness/ja/docs/reference/webhooks/)バージョン0.7.1から実装されています。分析レポートと認識されたテキストは、 キャプチャされたイベントとは別個に保持されます。 [Case Board](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/) [は](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/)、ワークスペース内にソースにリンクされたブックマーク、引用、メモ、および コレクションを追加します。[レポートコンストラクタ](https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/)では、 資料やセクションを選択し、サポートされている HTML/PDF エクスポート用に 8 種類のデザインから 1 つを選択します。 ## オプション機能 日常的な設定は、「アカウント」→「ソース」→「観測」の順で行います。**「その他のツール」→「エクストラ」**は、 独立したキャプチャ、保存、目標および保護レベル、通知、 証拠およびバックアップ、常時稼働サーバー、Telegramウィットネスボット、コードチェックのための 独立した設定画面です。各項目は、設定を表示する前にその利用可能性と要件を明示します。カードを選択すると 手順が表示されますが、サービスの登録や開始は行われません。 ボットのセットアップには、読み取り専用アクセス権の作成、公開設定の選択、および ウィットネスホストでの起動という3つのステップがあります。ネットワークおよび公開オプション、既存の接続、 検証コマンドは、必要に応じて開示されます。 ダウンロードされた構成は、 実行中のウィットネスとは別個のものです。追加機能の切り替えを行っても下書きは保持されますが、アカウントの変更やロックを行うと、 一時トークンとフォームはクリアされます。組み込みのガイドには起動手順が含まれています。「Exports」から開く [「GitHub Actions」は](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)、あなたの フォークからピン留めされたコレクターを起動し、1回のチャットをキャプチャして、ワークフローの来歴を含む暗号化された引き継ぎデータを生成します。 ## プロトコルおよび非公開の情報源 **MTProtoはTelegramのプロトコルであり、TelethonはTgWitnessがMTProtoと 通信するために使用するPythonライブラリです。**これらは別々の接続方法ではありません。「Collection」はMTProtoを使用し、 オプションの「witness」はBot APIを通じて署名付きチェックを公開します。 各ワークスペースには、独自の認証済みクライアントとアカウント更新ストリームがあります。TgWitnessは、 設定されたソースから観測データを選択し、履歴のスナップショットやメディアのダウンロードなどの機能については、 個別に明示的なリクエストを行います。 非公開の情報源には、公開ユーザー名は必要ありません。Telegramのピアタイプと数値IDが 識別子となります。タイトルやユーザー名は変更される可能性があります。アクセスは、既存の メンバーシップおよび権限によって決まります。TgWitnessは、情報源に自動的に参加したり、 参加承認を迂回したりすることはありません。別のアカウントからのアクセスハッシュは、汎用的なアクセストークンではありません。 収集モデルでは、参加前の非公開履歴、参加者/管理者の 役割、セッションの失効、権限の削除または変更、グループからスーパーグループへの 移行、トピック/フォーラム、関連するディスカッション、チャンネルの識別情報、および利用できない 添付ファイルなどを考慮する必要があります。すべての組み合わせについて、実稼働環境での検証が完了しているわけではありません。 ソースの可視性は、コレクターの起動時に確認されます。範囲内の ダイアログ結果からソースが欠落している場合、**それはアクセスが確認されていないことを**意味し、削除が証明されたわけではありません。1つのソースが 利用できない場合でも、他のアクセス可能なソースの監視には支障がありません。招待 リンクや実際のセッションを、公開用フィクスチャに決して記載しないでください。 ## 複数のアカウント このパネルは、任意の数の**ワークスペース**に対応しており、各ワークスペースには以下の機能が備わっています: - 認証、暗号化された保管庫、および接続経路。 - SQLiteジャーナルおよびEd25519署名用ID。 - 選択された情報源、メディアキュー、およびキャプチャ設定。 - 監視状態、エラー、チェックポイント、およびエクスポート機能。 表示されているワークスペースを切り替えても、別のコレクターの動作は停止しません。ワークスペースをまたいだアカウントの 重複認証は拒否されます。すでに1つのTelegram アカウントに紐付けられているジャーナルを別のアカウントに再割り当てすることはできませんが、同じアカウントへの再接続は可能です。 これにより、アカウントの識別情報および関連するメッセージIDの範囲が保持されます。 本アプリケーションでは、ワークスペースの数に制限はありません。各ワークスペースは、共有の Python プロセスおよびイベントループ内で、 接続監視、メディアのダウンロード、再チェック、新規チャットの取り込みを行う独自のコレクター タスクを実行します。スループットはワークロードによって異なります。 プロセスの分離を行うには、別々のインストール、ポート、データディレクトリを使用してください。 各アカウントに、アクセス可能なソースを割り当ててください。異なるアカウントが同じ グループを監視している場合でも、その監視記録は分離されたままとなり、元のソースが保持されます。1台のオペレーター管理マシン上の2つのアカウントは、 2つの独立した「証人」とはみなされません。**グループのエクスポートでは** 、個別に署名されたワークスペースのZIPファイルと、それらの ワークスペースID、ハッシュ、および署名鍵のフィンガープリントを含む署名済みファイルリストがバンドルされます。 各ジャーナルは独自の 境界を維持します。ケースノートや分析ツール内で、これらのソース参照情報を保持したまま、 ワークスペースを横断した統合タイムラインを構築します。 ## キャプチャと出典明記 「Sources」では、新規メッセージ、編集、削除、リアクション、 およびメンバーシップについて、アカウントごとの設定切り替えが可能です。プリセットでは、すべてのカテゴリ、またはメッセージ/編集/削除のいずれかを保持します。 このポリシーはワークスペースで選択されたグループに適用され、再起動後も維持され、 変更前後のデータで署名されます。デフォルトではすべてのカテゴリが保持されます。 カテゴリを無効にしても 過去の記録は削除されません。また、再度有効にしても、記録されなかったイベントは復元されません。 運用記録、その他のグループサービスイベント、および明示的な履歴スナップショットは 別個に扱われます。キャプチャされたTelegramオブジェクトは、 個別の更新設定にかかわらず、埋め込まれたメタデータを保持する場合があります。現時点では、グループごとのカテゴリ上書き機能はありません。 | 資料 | 現在キャプチャ中 | 境界 | | --- | --- | --- | | メッセージ | テキスト、ピアID/メッセージID、送信者のメタデータ、返信、および元の更新エンベロープ | コレクターが署名した、アカウントから閲覧可能な観察記録として保存されます | | 編集 | 新たに観測されたバージョン、以前にキャプチャされたバージョン、受信時刻、および提供された編集日時 | メッセージの更新および利用可能な管理ログエントリは、それぞれの帰属フィールドを保持します。 | | 削除 | Telegram通知、受信時刻、および以前にキャプチャされたコンテンツ | アクターおよびソースアクションの時刻は、別の管理ログレコードによって提供されている場合に保持されます。 | | アカウントレベルの削除通知 | 元の通知;解決済みの記録には、保存されたチャットおよび相関付け手法が含まれます | 対象範囲内に、以前に保存されたプライベートチャットまたは通常グループの照合結果が正確に1件存在する必要があります。その他のIDは「`deletion.unscoped`」のままとなります。チャンネルおよびスーパーグループのIDは、この照合の対象外となります。 | | 反応 | 配信されたカウンターと、確認可能な最近のID | 利用可能なリアクターの完全なリストを確認するには、別途照会が必要です。チャンネルによっては身元が非公開となっている場合があります。 | | メンバーシップ | サービスに関するお知らせおよび参加者への最新情報の配信 | 可視性は役割とチャットの種類によって異なります。メンバーシップは配信されたイベントから報告されます。 | | 管理者の操作 | チャンネル/スーパーグループのチャットエクスポートに含まれる、関連する配信済み更新情報および管理ログのスナップショット | エクスポート機能は、エクスポートを行う管理者アカウントが利用可能な場合にログを読み取ります | | 添付ファイル | オリジナルバージョンの記述、ダウンロードされたバイト数/SHA-256、および試行結果 | 元のバージョンは保持され、後のバージョンに置き換えられることはありません | | 沿革 | 現在表示されているメッセージの明確なスナップショット | ライブ記録は以前のバージョンと削除通知を保持します | | コレクタープロセス | 開始/停止、ハートビート、エラー、設定、スコープ、および署名付き実行受領証 | ローカルインベントリ;GitHubおよびTDXによる[独立した環境チェックの](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope)追加 | インターフェースでは、ソースイベントで指定されたアカウント名が使用され、観測された 名前やユーザー名はそのまま保持されます。イベントに実行者が記載されていない場合、レポートではそのフィールドは未指定のままとなります。 ## 容量とTelegramの制限 容量はデプロイメントごとに決定されます。これは、1秒あたりのピークイベント数、添付ファイルの量とサイズ、追加の RPC、アクティブなアカウント数、ディスクのレイテンシ/空き容量、ネットワーク状況、Telegramの制限、 許容可能な遅延、およびキューの深さによって異なります。 Telegramは、パッシブ配信とアクティブなショートポーリングを区別しています。その更新 ドキュメントでは、オープンな チャンネル/スーパーグループに対する追加の`updates.getChannelDifference`呼び出しについて説明しており、**同時にショートポーリングを行う ソースは**最大10個までとすることを推奨しています。これはショートポーリングに適用されるものであり、選択されたグループの数は別途設定されます。 | モード | 目的 | ステータス | | --- | --- | --- | | 標準的な観察事項 | 選択した情報源からの更新情報を記録します | 実装済み | | 優先度の高い再確認項目 | スター付きソースは独自に設定可能な間隔を使用し、各範囲指定再チェック処理において優先されます。 | 履歴およびメッセージのクエリ機能を実装 | 優先度スターにより、これらの再チェックが制御されます。追加の ``updates.getChannelDifference` ` によるショートポーリングは、独立したユーザーモードとしては公開されていません。 FloodWaitを無視したり、追加アカウントからの容量を線形と仮定したりする ような、恣意的な高頻度ポーリングは有効なサイジングモデルではありません。デフォルトの制限は、 リストされた最初の1,000件のダイアログ、履歴スナップショットあたり最大500メッセージ、 収集ファイルの種類ごとに1~2,000 MiB、および4 GiBの非圧縮署名付きZIPコンテンツです。各 制限はワークスペースごとに変更可能で、ファイルサイズは **[More tools] → [Sources] → [Recording]** で、その他の項目は **[More tools] → [Parameters]** で設定します。 エクスポートには、イベント数の固定上限はありません。 ブラウザのフォールバックは、デフォルトで128 MiBに制限されています。ストリーミングCLIには設定可能な 転送制限があり、デフォルトは5 GiBです。 ## 信頼性と復旧 実装されている機能には、SQLite WAL/同期トランザクション、メッセージ およびメディアジョブの原子的な書き込み、永続的なジョブと再試行の遅延、オリジナルバージョンの記述子、 再試行回数の制限;永続化されたメディアのFloodWait;テキストイベントの ネットワーク待機時間外でのメディアダウンロード;後続の書き込みが継続中の安定プレフィックスによるエクスポート;設定および 監査記録の原子性;ログイン置換失敗後の有効な認証情報の保持; 破損した追加ワークスペースの隔離;明示的な再接続試行;明確な 認証喪失の報告;および単調時計を用いた実時間変更検出などが含まれます。 アカウントおよびチャンネルの pts/qts/seq は保存され、再起動後も復元されます。また、監視対象のチャットは 定期的に再確認されます。[証拠の形式については](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#durable-collection-and-process-receipts-02)、こちらをご覧ください。位置情報を 定期的に保存することは、ジャーナルの受諾に対するアトミックかつロスレスな確認ではありません。 各プロセスの開始時には、前回のヘッドとオフライン境界が記録されます。現在の履歴は ギャップの修復として扱われません。Telegramの差分保持容量には限りがあり、 `differenceTooLong`では消失したコンテンツのすべてを復元することはできません。復元不可能なギャップは、 後の履歴スナップショットが成功した場合でも、明示的に残しておく必要があります。 ## 証拠モデル 各イベントには、シーケンス、ローカルUTC観測時刻、提供されている場合は送信元時刻、 種類、送信元、提供されている場合はアクター、元のペイロード、前回のハッシュ、および署名が記録されます。 メッセージの観測データには、コレクターアカウントおよび実行コンテキストも保持されます。 署名付きプロセスレシートには、ランダムな実行ID、TgWitness/Python/OSの依存関係 バージョン、ソースファイルのSHA-256値および集約フィンガープリント、初期アカウント、 スコープおよび設定、UTC/単調な測定値、ならびに直前のジャーナルヘッダーが含まれます。 設定の変更、起動/停止、およびエラーは、同じジャーナルに記録されます。チェックポイントは、 起動時、監視中の5分ごと(変更可能)、および正常な停止時に保持されます。 保持されたローカルチェックポイントにより、以前のジャーナルプレフィックスへのロールバックを検出することが可能です。 | 仕組み | 本ツールが実現すること | | --- | --- | | ファイルの SHA-256 | バイト数が既知のダイジェストと一致しています | | イベントハッシュチェーン | 既知の境界を基準とした記録の順序付け/関連付け | | Ed25519 | 特定の鍵による署名 | | 独立して保持されているチェックポイント | 後続の資料は、維持された境界と一致しています。 | | プログラムファイルの測定 | 収集ツールによる測定ファイルに関する自己報告 | | 有効な独立したTSAの回答 | 明示的な信頼仮定の下における、TSA時刻ごとの特定のバイトの存在 | RFC 3161 リクエストの作成と応答の検証は OpenSSL なしで実装されています。証拠モードでは、チェックポイントのハッシュを設定済みのタイムスタンプサービスにも送信します。独立した時刻の裏付けを得るには、発行機関の応答を保存して検証してください。[TIMESTAMP.md](https://phishdestroy.io/tgwitness/ja/docs/reference/timestamp/) を参照してください。 チェックポイントを個別に保持し、署名鍵へのアクセスを管理し、転送 記録を保持し、信頼できるソフトウェアを使用してエクスポートを検証します。[検証の範囲](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope) では、これらのチェックが互いにどのように補完し合うか、およびどのような信頼の前提が適用されるかが説明されています。 ## エクスポート、導入、および引き継ぎ 署名付きZIPファイルには、元のJSONL、CSV、HTML、保存された添付ファイル、ハッシュ、 署名付きマニフェスト、および利便性を考慮した検証ツールが含まれています。これは1つのワークスペースと、固定された完全な ジャーナルプレフィックスを対象としています。パネル検索フィルターによって、記録が黙って削除されることはありません。 秘密鍵、 トークン、およびTelegramのセッションは除外されますが、元の観測データには依然として 個人情報やTelegramのメタデータが含まれている可能性があります。 ZIPダイジェスト、信頼できるフィンガープリント、チェックポイント、処理受領記録、および引き継ぎ記録は、 それぞれ個別に保持してください。検証対象のZIPファイルに含まれているという理由だけで実行可能コードを信頼するのではなく、 信頼できる環境から取得した検証ツールを使用してください。 ブラウザインターフェースは、Node.js、CDN、外部フォントを必要とせず、ローカルで動作します。1つの オペレータートークンでインストールを制御します。リモートアクセスには、HTTPSまたはSSHトンネルが必要です。 ネイティブのPythonおよびコンテナ定義が提供されており、 [deploy/ディレクトリ](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md)下にサービスの例が掲載されています。実行されたプラットフォームチェックは別途一覧化されています。 デフォルトのワークスペースはデータルートを使用します。追加のワークスペースは`profiles//`を使用します。 バックアップを行うには、プロセスを停止させ、完全なデータおよび鍵セットが必要です。証拠用ZIPファイルは アプリケーションのバックアップではありません。シークレットについては、新しいデータ ディレクトリ用に外部のマスターキーを使用できます。ジャーナルおよびメディアの暗号化は、オペレーターのディスクまたはボリュームによって提供されます。 [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/) および [OPERATIONS.md](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/) を参照してください。 ## 安定版のリリース基準 安定版がリリースされるまでは、次のように補足してください: 1. 実際のプライベートグループ、スーパーグループ、フォーラム、チャンネルにおいて、メンバー/管理者の役割や 非表示/表示の履歴(ログイン/2FA、権限の取り消し、アクセス権の喪失を含む)を記録します。 2. 既知の行動に対する、編集、削除、リアクション、メンバーシップ、およびメディアの監視を行います。 3. プロセスのクラッシュ/ホストのクラッシュ、ディスク障害/ディスク容量不足、有効期限切れのファイル参照、FloodWait、 ネットワーク切断、ファイルの破損、およびデータベースのロールバック。 4. 測定された遅延、キュー、メモリ、ディスク容量を考慮した、継続的なマルチアカウント利用。これには、 静的なソースと動的なソースの両方を併せて含みます。 5. MTProtoの状態遷移とジャーナルの受入の間に中断が生じました。 6. 対象のOS/コンテナ環境へのクリーンインストール、およびバックアップと復元の検証が行われています。 7. セキュリティ、署名、および帰属・証拠に関する主張についての独立した検証。 パネルのアクセス範囲については、「[アクセスと権限](https://phishdestroy.io/tgwitness/ja/docs/reference/access/)」で説明されています。バージョン0.6以降、TgWitnessは [ACCOUNTS.](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/)mdに記載されている、範囲限定の単一アカウントTDataおよびアカウントファイルのインポートをサポートしています。 公開前にTelegram APIの利用規約を確認してください。研究文献およびプラットフォームに関する [調査結果はRESEARCH.](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/RESEARCH.md)mdに記載されています。 --- # Telegram · Case Board の参照 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/ ブックマーク、正確なハイライト、アクションスライス、ディスカッション、アクセス範囲の制限、および Case Board で使用される署名付き注釈履歴。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) ブックマーク、正確なハイライト、アクションスライス、ディスカッション、アクセス範囲の制限、および Case Board で使用される署名付き注釈履歴。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [調査](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/) ![調査](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Case Board を使用すると、調査チームは保存された資料を共有して閲覧できます。 観察事項をブックマークしたり、特定の箇所をハイライトしたり、一連のアクションを保存したりして、同僚と議論することができます。 カードには、ソースへの参照情報と署名付きの改訂履歴が保持されます。チームの注釈は ワークスペース内に残り、元の Telegram の観察事項とは区別して識別可能です。 [証拠モデル](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) · [アクセス](https://phishdestroy.io/tgwitness/ja/docs/reference/access/) · [レポート](https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/) ![調査用合成フィード](https://phishdestroy.io/tgwitness/assets/case-board.png?v=da27ef9c5b51) **このページでは** - [事例を扱う](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/#work-with-a-case) - [利用許諾](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/#permissions) - [保存された契約](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/#stored-contracts) - [API およびエクスポート](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/#api-and-exports) - [動作制限](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/#operating-limits) ## 案件の取り扱い **「その他のツール」→「ケースボード」**をスタンダードモードまたはエキスパートモードで開きます。言語設定はパネルの設定に従います。 ジャーナルレコードや保存されたチャットメッセージの横にある**「ボードに追加」**を使用するか、対象をフォーカスして **B** キーを押してください。 ワンクリックでブックマークが「受信箱」に追加されます。タイトル、ラベル、メモを編集したり、 コレクションに移動したりできます。変更されたカードには署名付きのリビジョンが追加され、削除しても履歴は保持されます。 最初のケースでは、収集対象を選択し、ある質問に対する答えとなる記録を追加してください。コメント機能を使用して 解釈を確認し、次に**「プレゼンテーション」**機能を使用してカードとソースの文脈を順を追って確認してください。 成果物を準備する際は、[Report](https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/)Studioで「Case Board」の素材を別途選択してください。 スライスを保存しても、レポートのデータフィルターは自動的に設定されません。 保存されたチャットメッセージ内のテキストを選択すると、「**ハイライト → ボード」**が表示されます。色を選択し、 メモを追加してください。サーバーは、絵文字、RTLテキスト、 結合記号を含め、正確な引用文と保存されたバージョンを確認します。インターフェースは、マスクされたテキストや変換されたテキストを通じて選択範囲をマッピングすることはありません。 1つのチャット内で2つのレコードをShiftキーを押しながらクリックして「**その間のスライス**」を作成するか、**「時間によるスライス」**を使用するか、または ジャーナルの現在のチャット、期間、イベント種類のフィルターを保存します。保存されたスライスには独自の 権威ある述語があり、ジャーナルでそれを開くと、複数のチャット、メッセージ数の制限、およびアクター フィルターも適用されます。 「**ブックマーク以降に追加されたレコードを表示」を選択すると**、後から追加されたレコードのみが表示されます。ジャーナルの フィルターを変更すると、スライスから抜け出します。「People」から「**この人のアクションをスライス**」を選択すると、記録されたアクターIDが使用されます。 メッセージの作成者がメッセージを編集、削除、またはリアクションしたかどうかは想定されません。 「スライス」ダイアログでは、作成を許可する前に件数がプレビュー表示されます。「`all`」には、スナップショット、編集、削除、リアクション、メンバーシップ/サービスの更新、自身のアクション、 ボタン、メディアの結果、復元されたメッセージ、および将来のイベント種別を含む、記録されたすべての種別が含まれます。この選択項目は、 保存された観測データを記述しています。 「不明なチャット」の削除通知は別のコンテキストであり、 ワークスペース全体へのアクセス権を持つユーザーのみが利用可能で、選択されたチャットいずれにも帰属することはありません。 コレクションには、チャット範囲が明示されています。範囲が空の場合は、ワークスペース全体を指します。コレクションには その範囲外のカードを含めることはできません。チャット範囲が限定された参加者は、より広範囲の コレクションを閲覧することはできません。受信トレイは、未割り当てのカードのための仮想コレクションです。 検索とフィルターは表示されている カードのみを対象とします。スレッドやメンションは親カードのアクセス権限を継承します。削除されたコメントには、 ディスカッション内に「トゥームストーン」が表示されます。閲覧履歴は記録されません。 **プレゼンテーションモードでは**、選択したコレクション内のすべてのカードが開かれ、「カード」、「ソースのコンテキスト」、および「チーム コメント」の各ビューと、キーボードによる「前へ」「次へ」の操作が利用可能です。編集機能は提供されません。通常の フィードはページ分割されており、プレゼンテーションモードではリストがページ単位で読み込まれ、カードの詳細が1件ずつ取得されます。 ## 権限 すべての操作には、`view`、ワークスペース/チャットのスコープ、および `board.read` が必要です。`board.write` により、カード、 コメントの追加、移動、および「オープン」/「レビュー」ステータスの設定が可能です。`board.manage` により、コレクションの管理、 「確認済み」/「却下」ステータスの設定、他者のカードの修正/削除が可能です。ステータスはチームによる 決定であり、暗号学的検証の結果ではありません。 アクセス権限のプリセット:レビュー担当者 = 閲覧;アナリスト = 閲覧/書き込み;オペレーター = 閲覧/書き込み/管理、 これらは既存の権限に追加されます。既存の権限によって、新たな権限が自動的に付与されることはありません。 メイン管理者はすべての権限を持ち、「**メイン管理者」**として投稿します。帰属を示すために名前付き権限付与を使用してください。 メンションには、親カードの全文を読み取ることができる現在のアクセス権のみがリストされます。 チャットAに対するアクセス許可では、IDを推測したり、 偽の`target.chat_id`を指定したりしても、A+Bのカードやスライスを取得することはできません。ターゲットのメタデータは、サーバー上の署名付きイベントハッシュから解決されます。 コレクション、ディスカッション数、関連カード、およびライブ通知は、応答前にフィルタリングされます。 エクスポートには、`board.read`に加え`export`権限が必要です。ボードへのアクセス権を持たない既存のエクスポーターは、 チームノートを除いた通常の証拠アーカイブを取得します。SSEは、各バッチ処理の前に現在の権限を再確認します。 ## 保存された契約書 観察結果と同様に、注釈もワークスペース内の追記専用SQLiteテーブルにトランザクション形式で書き込まれます。 `annotations.jsonl`は、`events.jsonl`と同じ読み取り用スナップショットから生成された、その正確な正規形式のエクスポートデータです。 競合する別の注釈ストアは存在せず、`board.activity`ジャーナルイベントもありません。 各行には、正確に以下の内容が含まれています: ``` { "seq": 1, "at": "2026-11-02T14:00:00.000+00:00", "access_id": "admin", "access_label": "Main administrator", "kind": "board.bookmark", "payload": {"id": "32 lowercase hex digits", "target": {"event_hash": "64 lowercase hex digits"}}, "previous_hash": "64 zeroes for the first record", "hash": "SHA-256 described below", "signature": "base64 Ed25519 signature" } ``` 上記の省略された例はエンベロープを示しています。実際のペイロードには、モデルの デフォルト値およびサーバーで解決されたターゲットフィールドが含まれます。APIリクエストスキーマは [`tgwitness/schemas`](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/schemas/board-bookmark.json)にあり、`python tools/build_board_schemas.py`によってランタイムのPydantic モデルから生成されます。余分なリクエストフィールドは拒否されます。IDは 省略された場合、サーバー側で生成されます。 作成者、時刻、スナップショット、および署名は、 呼び出し元から指定することはできません。名前付きグラント ID は、Access の既存の 16 ヘックス形式に従い、カード ID は 32 ヘックスです。 正規化されたJSONはUTF-8で、オブジェクトキーはソート済み、トークン間の空白はなく、Unicodeはエスケープされておらず、 NaNや無限大は含まれません。注釈のハッシュは、 `format: "tgwitness-annotations-v1"`および`previous_hash`までの7つのエンベロープフィールドすべてを含む正規化されたオブジェクトのSHA-256です。 このフォーマットタグは、そのハッシュドメインをオブザーベーションから分離します。 署名は、 32 バイトの生のハッシュ値に対する Ed25519 です。シーケンスは 1 から始まります。リビジョンではカード ID を保持し、`supersedes` フィールドに先行する 注釈ハッシュ名を指定します。チャットのスコープを変更することはできません。移動、ステータス変更、削除は 別々のレコードとして扱われます。SQLite テーブルは UPDATE および DELETE を拒否します。 `case-board.json`には`{statement, signature}`が含まれます。正規のステートメントは ワークスペースキーによって署名され、`format: "tgwitness-case-board-v1"`、`public_key`、`created_at`、 `journal_head`、`meaning`、および`state`を含みます。Stateは決定論的なリプレイであり、`annotations_head`、 順序付けられた`items`配列(コレクション、カード、コメント(トゥームストーンを含む))、および`status_history`で構成されます。 各項目は、リビジョンを跨いで、最後の注釈ハッシュ、シーケンス、作成者、時刻に加え、元の 作成者および作成時刻を保持します。リプレイ処理では、リビジョン、 親項目、コレクション参照、および重複するアクションIDがチェックされます。`manifest.json`および新しいチェックポイントも `annotations_head`をバインドします。チェックポイントを独立して保持することで、切り捨てや、 コピーされた署名キーによる書き換えを検出します。 ### テキスト版 `range.start`は0を起点とするUnicodeコードポイントのオフセット、`length`は正のコードポイント数であり、 `quote`は、対象のイベントにおける`payload.text`または`payload.caption`の正確な部分文字列と 一致する必要があります。NFC/NFKC、大文字小文字の変換、またはグラフェム正規化は適用されません。 Pythonの文字列スライスや JavaScriptの`Array.from(text)`は、同じインデックス付けを実装しています。マークとZWJ絵文字を組み合わせると、 複数のコードポイントを占有する場合があります。`range.version`はターゲットイベントのハッシュであり、現在のメッセージ バージョンやTelegramのUTF-16エンティティオフセットではありません。その後の編集によって、ハイライトの位置が自動的に変更されることはありません。 ### 識別情報と時刻の切り分け `query` は、`chat_id` を 1 つ、または空でない `chat_ids` を、オプションで範囲指定の `from`/`to`、 メッセージ ID の範囲(1 つのチャットのみ)、`kinds: "all"` または完全一致/プレフィックスワイルドカードの種類、 明示的な `actors`、`search`、`hide_system`、および `include_unscoped` を正確に受け入れます。ジャーナルの種類グループは、 その正確な述語に展開されます。 検索では、署名付きソーステキストを変更することなく、ジャーナルのNFC/大文字小文字を区別しないペイロード検索が使用されます。 日付にはタイムゾーンが必要であり、UTCに正規化されます。 日付は **observed_at を**フィルタリングします。Telegram の `source_at` は別途表示されます。ソースのタイムスタンプがない 削除には、生成された削除時刻はありません。時間間隔の外で観測された遅延レコードは その間隔には含まれません。メッセージ ID のスライスには、それらのメッセージ ID に対する後の削除が含まれる場合があります。 `snapshot`は、作成時刻、ジャーナルのシーケンス/ハッシュ境界、一致数、最初/最後の シーケンス、および`result_hash`を固定します。後者は、一致した イベントハッシュのUTF-8正規化JSON配列のSHA-256ハッシュであり、空のスライスの場合は`[]`を含み、辞書順にソートされています。 また、正確な 種類数と、24 ビンの観測時刻のミニチュアも含まれます。スライスはクエリを保存するものであり、重複するソース レコードを保存するものではありません。エクスポート時、`board/slices/.json`には現在のハッシュと、追加・削除されたシーケンスがリストされます。 検証ツールは、作成時点での結果、続いて現在の結果を再構築します。 追加されたレコードは変更事実として報告されます。元のイベントを削除すると、不変の 証拠チェーンが断たれます。これは、スライスからの通常の削除として黙認されることはありません。 リアクションのスナップショットには、最近のアクター一覧が不完全な場合があります。エクスプローラーは、同じチャット/メッセージの隣接するスナップショット (スライス外の先行スナップショットを含む)を比較し、**観測値間の**集計カウントの 差分を報告します。欠落している最近のアクターについては、リアクションが削除されたとはみなされません。 最初のスナップショットには、推論された以前の状態は存在しません。アクターの観測値は、 架空のアクション時刻ではなく、それらが提供されたスナップショットに帰属したままとなります。 ## API およびエクスポート `GET /api/board`は、collection/chat/author/label/state/from/to/q/kind/comments、offset/limit およびnewest/oldest順序を受け付けます。`GET /api/board/card/{id}`は、カード、ソースのプレビュー、スレッド、 ステータスの履歴、および関連カードを返します。participantsサブルートは、該当するメンションの選択肢を返します。 `POST /api/board/{bookmark|highlight|slice|collection|comment|status|move|remove}`はレコードを追加します。 `POST /api/board/slice-preview`はクエリを計算します。スライスレコードは `GET /api/board/slice/{id}/records`でページ分けされます。再計算には常に最新の安定した読み取りスナップショットが使用されます。 ライブ `/api/stream`は、ジャーナルカーソルとは別に、ペイロードを含まない`board`通知を送信します。 `GET /api/board/export`は署名付きドキュメントを返します。チャット限定アクセスでは、明確にラベル付けされた 署名付き**開示**情報を受け取りますが、他のチャットの注釈や完全なメッセージチェーンは一切含まれません。完全な証拠用ZIPファイルには、 `annotations.jsonl`、署名付き`case-board.json`、およびスライスJSONの付録が含まれます。 HTML/PDF/JSONレポートの 設定では、「ボードなし」、「議論のないブックマーク/スライス」、または「コメント付きのカード」を選択できます。この セクションでは、チームの意見と観察結果を明確に区別しています。レポートデータのフィルタは、 閲覧可能なメモも制限しますが、証拠用ZIPファイル内の完全な署名済みソースファイルは完全な状態で保持されます。 `GET /api/board/slice/{id}/export` は、署名付きの `tgwitness-board-selection-v1` JSON 抜粋を生成します。 `?format=csv` は、独立した署名のない、扱いやすい表形式のデータを生成します。JSON と ZIP はそのまま維持してください: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_KEY_SHA256 --board python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 python -m tgwitness.verify case-board.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 ``` 選択チェックでは、署名付きステートメント、正確なソースレコード、および指定された境界におけるクエリの完全性が 検証されます。証拠用ZIPファイルは新しいものであっても構いませんが、その プレフィックスを含まなければなりません。未解決のターゲットは明示的に報告されます。元のスライススナップショットの不一致、変更された 注釈、リプレイ状態の不一致、またはソースの変更があった場合は失敗となります。 注釈のない古いアーカイブについては、 既存の検証動作が維持されます。 「引き継ぎ」はデフォルトで**「含めない」に**設定されています。明示的に含める場合、すでに 最小化された記録を通じてカードを表示し、アクセス不能または省略されたターゲットを省き、ソーステキストが 最小化されたハイライトを非表示にし、チームテキストを同じ言及/連絡先ルールでクリーンアップし、オプションで メタデータおよびノート内の既知の出現箇所において、調査員ラベルを R01、R02… に置き換えます。 元の `annotations.jsonl`は開示されません。署名付き`tgwitness-case-board-handover-v1`サイドカーおよびレポートには、 同じ最小化された資料が含まれています。スライス数は開示されたレコードのみを表しており、元の スナップショット/クエリのアクターの詳細は非開示となっています。最小化ツールが認識していないフリーテキストの名前については、 通常の引き継ぎと同様に、依然としてレビューが必要です。派生ファイルには独自の署名が付与されており、 元の注釈には完全なアーカイブ内で独自の署名が残されています。 ## 運用上の制限 パラメータには、カード数10,000件およびコメント数50,000件のソフトリミット、最大5,000 件のレコードを含むスライスページ、およびメディアプレビュー制御が含まれます。ソフトリミットに達した場合、履歴は削除されず警告が表示されます。 フィードページは 最大200カードです。スタンドアロンのJSONスライス抜粋は64 MiBまでです。クエリを絞り込むか、 大容量のデータには署名付きZIPを使用してください。スタンドアロン検証ツールでは、注釈の再生は256 MiBまでです。 Case Boardでは、外部へのコメント通知は有効化も実装もされていません。 この機能の自動受け入れテストでは、架空のデータとシミュレートされたTelegram通信を使用して、 保存、アクセス、表示、およびエクスポートを確認します。証拠チェックの範囲については、「[検証範囲」](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope) を参照してください。 --- # Telegram · アーカイブ分析 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/analysis/ 保存されたメッセージを検索し、AIの入力内容を検証し、出典情報を記載した分析レポートを管理できます。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 保存されたメッセージを検索し、AIの入力内容を検証し、出典情報を記載した分析レポートを管理できます。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [調査](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/) ![調査](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [ワークフローガイド](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) AIを使用しないローカル検索には**「ジャーナル」**を使用してください。[全文検索(プレビュー)は](https://phishdestroy.io/tgwitness/ja/docs/reference/search/) 単語の形態、フレーズ、ドメイン、および@ユーザー名に一致します。**「その他のツール」→「アーカイブに問い合わせる」**を使用するには、まず 「**その他のツール」→「統合」**でプロバイダーを有効化し、設定してください。ワークスペースセレクターで アカウントを選択し、フォームでチャットと観測期間を選択します。 検索は ローカルで実行されます。正確なフレーズやドメインを指定すると検索範囲が絞り込まれ、メッセージIDを指定すると保存された バージョンが取得されます。抜粋を確認し、そのジャーナルレコードやコンテキストを開くことができます。 ベクトルデータベースやTelegramの自動アクションはありません。 ## プロバイダーおよび同意 AI機能は、すべてのワークスペースで初期状態では無効になっています。モデル、エンドポイント、暗号化されたAPIキー、コンテキスト/出力の制限、タイムアウト、および1日あたりの リクエスト上限の設定は、メイン管理者のみが変更可能です。キーはブラウザに返されることはありません。現在のキーを維持するには、キーフィールドを空白のままにしておくか、 明示的に削除してください。 Ollamaは、ドキュメントに記載された[`/api/chat`エンドポイント](https://docs.ollama.com/api/chat)を使用し、 ストリーミング形式ではないJSON出力を生成します。デフォルトのアドレスは、 TgWitnessサーバー上の`http://127.0.0.1:11434`です。オペレーターは `TGWITNESS_AI_LOCAL_ENDPOINT`を使用してこれを変更できます。これはモデルによって制御されるアドレスではありません。選択したモデルは ご自身でインストールしてください。TgWitnessは自動的にダウンロードしません。 互換性のあるプロバイダーは、`/v1` で終わるベース URL および [Chat Completions プロトコル](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)( `messages`、JSON レスポンスモード、`max_completion_tokens`、 `choices[0].message.content`)に対応している必要があります。これらのフィールドがないサービスはサポートされません。 接続テストでは合成テキストが送信され、リクエスト予算にカウントされます。 すべてのリクエストは、ワークスペースで設定された外部ルートを使用します。ブロックされたルートや Telegram専用のMTProxyはエラーとなり、直接的な再試行は行われません。意図的に 設定されたローカルOllamaアドレスは、プライベートな宛先を許可します。 ループバックAI エンドポイントには、ワークスペースの「Direct」外部ルートが必要です。プロキシルートは 送信前に拒否されます。その他のプライベートサービスについては、既存のサーバーレベルのプライベート 宛先オプトインが適用されます。プレビューには、エンドポイントと外部ルートが表示され、 該当する場合はプロキシホストも含まれます。そのルートを変更するには、新しいプレビューが必要です。 生成前に、**モデルに送信されるデータには**リクエスト(質問、 確認済みの抜粋、イベントの種類、観測時刻、カバレッジマーカー)が含まれます。Telegram セッション、生データフィールド、プロバイダーキー、添付ファイルのバイトデータ、およびジャーナル全体は、 そのコンテキストには含まれません。不要なソースのチェックを外し、その後、明示的に 処理を承認してください。外部プロバイダーは、独自の ポリシーに基づき、送信されたコンテンツを保持する場合があります。「ローカル実行」とは、エンドポイントがローカルであることを意味し、別途設定された サービスは独自の設定に従います。 プロバイダーへの同時リクエストは、グローバルで最大2件、ワークスペースごとに 1件までです。プレビューは10分後に失効し、1回の回答を生成できます。 プロバイダーから報告されたトークン数が表示されます。コストの見積もりは、 入力と出力の両方の料金体系が設定されている場合にのみ表示されます。失敗したリクエストも 1日のリクエスト予算を消費します。自動再試行による追加の予算消費はありません。 ## 出典と制限事項 検索は、[全文インデックスが](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#ask-the-archive-and-mcp) 完成している場合にそれを使用します。選択されたチャット全体から、語形を含めた最適な一致結果を返します。最近の変更や特定のメッセージのバージョンに関する 問い合わせ、およびインデックスの 構築中の検索については、最新のレコードを対象とした範囲限定の語彙検索が行われます。プレビューには その手法名が記載されています。検索結果は最大24件まで返され、長いテキストは一致箇所を中心に切り詰められます。 切り詰められた抜粋や不完全な結果セットにはマークが付きます。この 期間は**観測**期間を指すものであり、Telegramの履歴が 完全であることを保証するものではありません。ワークスペース全体を対象とするイベントは、チャット範囲のアクセスからは除外されます。 欠落しているデータについては、利用可能なアーカイブ内に「見つかりませんでした」と表示されます。 モデルにはツールが提供されません。モデルのソースIDは、選択された レコードに対して解決され、ハッシュは再確認され、引用された文字列はそれらのレコード内に存在しなければなりません。 未知のID、変更された引用、および出典のない主張がある場合、その回答は却下されます。アプリケーションは リンクを作成しますが、モデルが生成したURLは引用として使用されません。これらのチェックにより、 出典の存在と引用の正確性が確認されます。 推論を信頼する前に、レコードと照らし合わせて確認してください。 ## レポート レビュー済みの回答を、独立した分析レポートとして保存します。これには、モデルの 要約、観測された時系列、抽出されたリンクとハンドル、編集・削除記録、 カバレッジの制限、およびソースイベントのハッシュが含まれます。プロバイダー、モデル、エンドポイント、時刻、 およびプロンプトテンプレートのバージョンも併記されます。身元情報は自動的に統合されません。 アナリストによる修正や注記は、モデルの要約とは別に保存されます。レポートは 暗号化された派生ファイル内に格納され、インデックスは署名付きイベントストリームの外部に配置されます。 元のイベントやメディアは変更されません。レポートを開くことができるのは所有者または管理者のみであり、 ソースへのアクセスは再度確認されます。 ダウンロードにもエクスポート 権限が必要です。バージョン1では、レポートへの署名や、モデルの結論が 検証済みの証拠であることを示唆するものではありません。制限:ワークスペースあたり100件のレポート、およびレポート1件あたり100件のアナリストによる修正 。 手動によるOCRおよび文字起こしについては、「[メディア処理」](https://phishdestroy.io/tgwitness/ja/docs/reference/media-analysis/)を参照してください。 クライアントへのアクセスについては、[MCPを](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/)参照してください。 --- # Telegram · 全文検索 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/search/ 保存されたメッセージを、単語の形態、完全なフレーズ、ドメイン、@ユーザー名で検索し、署名付きジャーナルに紐付けられたインデックスを用いて、最も一致度の高いものから順に表示します。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 保存されたメッセージを、単語の形態、完全なフレーズ、ドメイン、@ユーザー名で検索し、署名付きジャーナルに紐付けられたインデックスを用いて、最も一致度の高いものから順に表示します。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [調査](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/) ![調査](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [アーカイブの分析](https://phishdestroy.io/tgwitness/ja/docs/reference/analysis/) · [ローカルでのOCRおよび文字起こし](https://phishdestroy.io/tgwitness/ja/docs/reference/media-analysis/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **プレビュー。**「**ジャーナル**」で、検索フィールドの横にある**「最良の一致・語形」**を選択します。 結果はBM25でランク付けされ、同じ単語の他の語形とも一致します。 たとえば、*「перевод」*と入力すると*「переводом」*や*「переводы」*が、*「transfer」*と入力すると*「transfers」*が検索され、中国語の フレーズはスペースなしで検出されます。**「最新順・完全一致」を選択すると、**レコード全体に対する以前の 部分文字列検索が維持されます。 インデックスは派生データです。これは署名付きジャーナルから再構築されるものであり、それ自体は決して署名されず、 エクスポート対象にもなりません。元の記録は変更されません。 **このページでは** - [検索構文](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#search-syntax) - [言語](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#languages) - [インデックスの保存場所](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#where-the-index-lives) - [結果および署名付きジャーナル](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#results-and-the-signed-journal) - [認識されたテキスト](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#recognized-text) - [アクセス](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#access) - [アーカイブおよびMCPにお問い合わせください](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#ask-the-archive-and-mcp) - [依存関係](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#dependencies) - [ベンチマーク](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#benchmark) ## 検索構文 | 執筆 | 検索 | | --- | --- | | `перевод карта` | 両方の単語を含む記録(形式は問わない) | | `"переводом на карту"` | この順序で、この正確なフレーズを記載してください。 | | `бонус OR подарок` | どちらの単語でも可 | | `перевод -казино` | 除外語を含まない記録 | | `example.com` | ドメインおよびそのサブドメイン(隠しリンクやボタンのURL内にあるものも含む) | | `@username`, `t.me/username` | 当該アカウントのメンションやリンク、およびそのアカウントが送信したメッセージ | | `#tag` | ハッシュタグ | | `+79991234567`、ウォレットアドレス、メールアドレス | テキストまたはリンクで同じ値を記載 | | `from:@username`, `from:123456` | その送信者からのメッセージ | | `chat:-1001234567890` | チャットは1つ。アクセス権限を制限できるのは自分自身のもののみです。 | | `id:42` | メッセージ42の保存済みバージョン | | `since:2026-01-01 until:2026-01-31` | 観測期間:時刻を含まない日付は、その1日全体を指します | | `kind:edited` | 編集のみ(`new`, `snapshot`, `edited`, `recovered`) | | `source:ocr`, `source:transcription`, `source:all` | メッセージの代わりに、またはメッセージと共に認識されたテキスト | 他の単語が存在する場合、前置詞やその他の機能語は無視されます。 単語内に混在する類似文字(キリル文字の単語内のラテン文字の*「a」*など)、全角 および装飾用ユニコード文字、ならびに不可視文字は正規化されます。 ## 言語 言語は、各レコードのスクリプトや文字列から検出されます: | スクリプト | 一致 | | --- | --- | | キリル文字 | [pymorphy3](https://github.com/no-plagiarism/pymorphy3) を使用したロシア語およびウクライナ語の語幹抽出。オプションのウクライナ語辞書を使用しない場合は、軽量なウクライナ語ステマーが使用されます。 | | ラテン語 | 英語のSnowballステマーを使用。発音区別符号は無視する | | 中国語、日本語、韓国語、タイ語、ラオス語、クメール語、ミャンマー語 | 重複する文字ペア:スペースを含まない任意のフレーズが検出されます。中国語のクエリは、jieba を使用して単語ごとに分割されます。 | | その他のスクリプト | 正確な表現 | ウクライナ語辞書(`pymorphy3-dicts-uk`)はGPL-3.0の下で配布されているため、 デフォルトではインストールされません。以下のコマンドでインストールしてください `pip install "tgwitness[uk-dictionary]"`; インデックスが新しいアナライザーを認識し、自動的に再構築されます。 ## インデックスの保存場所 | モード | 保存 | 使用方法 | | --- | --- | --- | | ディスク上(デフォルト) | `search/fulltext.sqlite3` ワークスペースディレクトリ内 | 大規模なアーカイブに対応。再起動後もデータが保持されます。 | | メモリ内のみ | ディスク上には何も保存されず、起動のたびに再構築される | ディスク上にメッセージ本文の派生コピーは保存しない | | オフ | インデックスなし;**新しい順 · テキストはそのまま**保持 | 最小限のインストール環境 | メイン管理者は、各ワークスペースについて、「**ジャーナル」→「フィルター」→「検索インデックス」** でモードを選択します。 `TGWITNESS_FULLTEXT=disk|memory|off` 独自の設定がないワークスペースの デフォルト値を設定します。「メモリ」または「オフ」に切り替えると、ファイルが削除されます。 インデックスファイルはジャーナルと同じ保護措置が適用されており、プライベートデータ ディレクトリ内に格納されます。バックアップやオフサイトのコピーには含まれません。 新しい記録は数秒以内にバックグラウンドでインデックス化されます。検索時には まず直近の未処理データがインデックス化されるため、ほんの少し前に保存された記録も検索結果に表示されます。既存の日誌は 更新後にインデックス化されますが、その間もパネルの動作はブロックされません。インデックス化が完了するまでは、検索結果は インデックス化済みの記録のみを対象とし、日誌には進行状況が表示されます。**インデックスの再構築は** 最初の記録から再度開始されます。 ``` python -m tgwitness index status --data-dir data/live python -m tgwitness index rebuild --data-dir data/live --json ``` `rebuild` パネルを停止する必要があります(そうでない場合は終了コード 3)。 `--json`、 標準出力には結果のみが表示され、進行状況は標準エラーに出力されます。 ## 結果と署名付きジャーナル インデックスには、対象となる最新のジャーナルレコードのシーケンス番号とハッシュが保存されており、 ジャーナルを開く際にそれらと照合を行います。ジャーナルが置き換えられたり、復元されたり、編集されたりすると、 インデックスが再構築されます。すべてのレスポンスでこの位置情報が報告され、すべてのヒットは シーケンス番号に基づいて署名付きジャーナルから読み戻されます。インデックスは、どの レコードをどの順序で表示するかを決定しますが、その内容を決することは決してありません。チャットへのアクセスは、 インデックスの内容ではなく、ジャーナル自体のチャットフィールドに対して行われます。 ## 認識されたテキスト OCRデータと文字起こしデータは、暗号化されたアーティファクト内に保持されます。それらのインデックスは メモリ内にのみ存在し、認識ジョブが完了すると再構築されます。一致した項目は、 `media.saved` レコード上に「機械認識」というラベルとともに表示され、エンジン、モデル、および 抜粋が記載されます。Telegramで送信されたテキストとして表示されることは決してありません。この同じインデックスは **「認識済みテキストの検索**」機能にも利用され、プレーンな部分文字列との照合も引き続き可能です。 ## アクセス チャット範囲のアクセスでは、そのチャットからの記録のみが検出されます。これには、 添付ファイルの認識されたテキストも含まれます。 `chat:` その他のフィルターは、その範囲を絞り込むことしかできません。スコープ付きアクセスに表示されるインデックスのステータスには、 ジャーナルの合計件数は含まれません。モードの変更やインデックスの再構築は、 メイン管理者のみが実行できます。 ## アーカイブおよびMCPに問い合わせる **その他のツール → 「Ask the archive** 」は、インデックスの構築が完了すると、このインデックスからソースを取得します。 選択されたチャット全体から最適な一致結果が抽出され、保存されたテキストは1回のみカウントされます。最大24 個のソースが送信され、長いテキストは一致箇所を境に切り取られ、切り詰められたものとしてマークされます。 最近の変更に関する質問、1つのメッセージの保存済みバージョン、および インデックスの構築がまだ進行中の状態での検索には、以前の時系列順の検索方法が使用されます。プレビューには どの方法が使用されたかが表示されます。 MCPクライアントは以下を呼び出すことができます `search_messages` と `ranked=true` で呼び出し、 `next_offset`でページングを行うことができます。スコープ指定された接続では、自身のチャットのみを受信します。 順位付きページネーションは、ページサイズにかかわらず、最大で最初の1,000件の結果を対象とします。さらに一致する項目を確認するには、クエリ、チャット、または期間を絞り込んでください。「新しい順」検索では、各ページを選択する前に、メッセージ、OCR結果、および文字起こし結果が新しい順に並べ替えられます。 ## 依存関係 | パッケージ | ライセンス | 理由 | | --- | --- | --- | | pymorphy3、pymorphy3-dicts-ru、DAWG2-Python | MIT | ロシア語およびウクライナ語の語幹;辞書はローカルに読み込まれます | | snowballstemmer | BSD-3条項 | 英語の語幹、純粋なPython | | jieba | MIT | 中国語のクエリのセグメンテーション、純粋なPython(ソースコードのみの配布) | | pymorphy3-dicts-uk(任意) | GPL-3.0 | ウクライナ語の完全な辞書 | SQLite FTS5 を使用するには、 `unicode61` tokenizer が必要です。これは、 現在の Python ビルドに含まれる SQLite の一部です。これがなければ、ベストマッチ検索は「利用不可」と報告します。 ## ベンチマーク `python tools/bench_fulltext.py --messages 1000000 --work `200のチャットに含まれる、リンクやハンドルを含むロシア語、ウクライナ語、英語、 中国語、日本語のメッセージが混在する確定的な署名付きジャーナルを作成し、インデックスを構築し、 一般的な検索の所要時間を測定します(50件の結果、7回の実行における中央値)。 測定環境:Windows 11、Intel Core i9-13900K、128 GB RAM、Python 3.12.10、SQLite 3.49.1、データは exFAT ドライブに保存、アナライザー `fulltext-v1+pymorphy3-ru+light-uk+snowball-en`: | 測定 | 結果 | | --- | --- | | 署名付きジャーナル | 1,000,000件のメッセージ、1.50 GiB、19分で書き込み完了 | | ジャーナルからのインデックス構築 | 71秒、秒間約14,141メッセージ | | インデックスファイル | 58 MiB、ジャーナルの 3.8% | | 新しいレコードの直後に検索 | 中央値 8 ms、P95 9 ms | | 以前の部分文字列検索、同じジャーナル | `перевод` 3.2 秒、 `银行转账` 2.6秒, `verify-account.example` 2.6秒 | | 検索 | 一致するレコード | 最良の一致、中央値 | p95 | 新しい順、中央値順 | | --- | --- | --- | --- | --- | | 一般的な単語、語形: `перевод` | 134,403 | 82 ms | 85 ms | 7 ms | | 2つの単語: `оплата карта` | 28,996 | 43 ms | 43 ms | 14 ms | | 珍しい単語: `розыгрыш подарок` | 28,881 | 42 ms | 47 ms | 13 ms | | 正確なフレーズ: `"переказ коштів на картку"` | カウント対象外 | 35 ms | 36 ms | 6 ms | | ドメインとサブドメイン: `verify-account.example` | 12,435 | 17 ms | 17 ms | 3 ms | | @username: `@support_desk_bot` | 10,331 | 15 ms | 16 ms | 3 ms | | スペースなしの中国語: `银行转账` | 17,691 | 23 ms | 24 ms | 3 ms | | 日本語: `リンク` | 16,603 | 23 ms | 25 ms | 3 ms | | 英語の語幹: `withdrawal` | 27,775 | 26 ms | 26 ms | 2 ms | | ORおよび除外条件: `бонус OR подарок -казино` | 268,034 | 190 ms | 193 ms | 19 ms | | チャットフィルター: `chat:-1000000000007 перевод` | 652 | 9 ms | 9 ms | 6 ms | | 期間フィルター: `since:2026-01-01 until:2026-01-31 выплата` | 115,732 | 155 ms | 156 ms | 81 ms | 特定のフレーズは、ページが 満杯になるまで候補に対して文字通り順に照合されるため、その合計はカウントされません。所要時間は一致するレコードの数に比例して増加します。 チャットや期間を絞り込むと、広範囲な検索が高速化されます。合成コーパスでは 語彙数が限られているため、一般的な単語は実際のチャットに比べてはるかに多くのレコードと一致します。 --- # Telegram · 読み取り専用 MCP Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/ MCPクライアントを、有効期限付きかつ取り消し可能なアクセス権限で、選択したワークスペースやチャットに接続します。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) MCPクライアントを、有効期限付きかつ取り消し可能なアクセス権限で、選択したワークスペースやチャットに接続します。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [アーカイブとの連携](https://phishdestroy.io/tgwitness/ja/docs/reference/cli/) ![アーカイブとの連携](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) アナリストクライアントを、選択したワークスペースやチャットに接続します。TgWitnessは、 **パネルプロセス内の`/mcp`でStreamable HTTP**を提供します。各接続には、独自の トークン、有効期限、および許可されたツールが割り当てられます。MCPは、Telegramメッセージの送信、 設定の変更、または署名付きジャーナルの修正を行うことはできません。これらの接続は、 [コマンドライン](https://phishdestroy.io/tgwitness/ja/docs/reference/cli/)でも同様に機能します。 [ワークフローガイド](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **このページでは** - [インストールと確認](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/#install-and-check) - [接続を確立する](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/#issue-a-connection) - [クライアントを接続する](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/#connect-your-client) - [Cloudflare Tunnel](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/#cloudflare-tunnel) - [ツールと範囲](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/#tools-and-boundaries) ## インストールと確認 パネルを実行している Python 環境を使用します。ソースのチェックアウトディレクトリから以下を実行します。 ``` # Windows PowerShell & .\.venv\Scripts\python.exe -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' & .\.venv\Scripts\python.exe start.py --check ``` ``` # Linux / macOS .venv/bin/python -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' .venv/bin/python start.py --check ``` インストール後、通常のデータディレクトリと起動引数を指定してパネルを再起動してください。 準備完了状態には、`[PASS] mcp: streamable-http available` が表示される必要があります。 **「その他のツール」→「統合」→「MCP」**では、実行時のステータスと、 そのサーバーの実際の Python 実行ファイルを使用したインストールコマンドが表示されます。**「再確認」**をクリックすると、ページを再読み込みせずに このステータスが更新されます。パッケージのインストールやサーバーの再起動は行われません。 この MCP エクストラは、公式の[MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) を使用しています。`deploy/constraints-mcp.txt` には、テスト済みの SDK および依存関係が固定されています。 ## 接続の発行 1. ラベルを入力し、クライアントに読み取りを許可するワークスペースとチャットを選択します。 2. ツールを個別に選択するか、プリセットを使用します。実装済みのツールのみが提供されます。 3. 1日、7日、30日、90日、または1分から90日の間のカスタム有効期限を選択します。 4. **Create connection** を押します。クライアント設定の横にトークンが1回だけ表示されます。 5. トークンと設定をコピーしてから、**Check connection** を実行します。これにより MCP が初期化され、許可されたツールが一覧表示されます。**メッセージは読み取られません**。結果にはプロトコルバージョン、ツール名、ツール数、経過時間が表示されます。 6. 認証情報を保存したら **Done** を押します。ポーリングが行われても、フォームと1回限り表示されるカードは維持されます。パネルをロックすると、表示されているシークレットは消去されます。 リストには、最近の使用状況、最後に使用したツール、アドレス、過去1分間のリクエスト数が表示されます。**Revoke** はアクセスを終了します。**Rotate token** は古い認証情報を失効させ、同じスコープ、ツール、有効期限を持つ新しいトークンを発行します(新しいトークンはその場でコピーしてください)。パネルのログイントークンや Telegram の認証情報は MCP トークンとしては機能しません。 ## クライアントの接続 パネルでクライアントを選択し、生成された設定をコピーします。設定にはシークレット参照または明示的なプレースホルダーが使用され、トークンは個別にコピーします。 | クライアント | 設定 | 接続 | | --- | --- | --- | | Claudeコード | `.mcp.json` | HTTP、`type: "http"`、Bearer ヘッダー | | Claude Desktop | `claude_desktop_config.json` | ローカル stdio ブリッジ | | Cursor | `.cursor/mcp.json` | 環境変数ヘッダーを使用した HTTP | | VS Code Local | `.vscode/mcp.json` | パスワード `promptString` 入力を使用した HTTP | | Windsurf | `mcp_config.json` | Bearer ヘッダーのプレースホルダーを使用した HTTP | | その他のクライアント | URL と Authorization ヘッダー | ストリーミング可能なHTTP | TgWitness は OAuth ディスカバリを使用せず、Bearer トークンを使用します。リモートコネクタに OAuth が必要なクライアントには、ローカル stdio ブリッジを使用してください。VS Code の場合、入力変数は **Local** ハーネスに適用され、Copilot セッションには転送されません。設定リファレンス: [Claude Code](https://code.claude.com/docs/en/mcp)、[Cursor](https://prod.cursor.com/docs/mcp)、[VS Code](https://code.visualstudio.com/docs/agents/reference/mcp-configuration)。 ローカルブリッジの正規のエントリポイントは以下のとおりです。 ``` python -m tgwitness.mcp_server --url https://your-panel.example/mcp ``` MCP extra がインストールされたクライアントのローカル Python を使用します。保護された環境で `TGWITNESS_MCP_TOKEN` を設定してください。認証情報はコマンド引数や URL に含めないでください。`tgwitness-mcp` は同じエントリポイントです。古い `tgwitness.mcp_bridge` モジュールと `TGWITNESS_ARCHIVE_TOKEN` という名前は警告付きの互換パスとして残されていますが、新しい設定では `mcp_server` と `TGWITNESS_MCP_TOKEN` を使用します。 ## Cloudflare Tunnel パネルの `/mcp` ルートを転送し、Bearer ヘッダーを保持します。管理者として MCP 設定を開くと、その実行セッションに対してパネルの現在のオリジンが登録されます。再起動直後から利用できる固定アドレスにするには、パネルを起動する前にパネルの HTTPS オリジンを `TGWITNESS_PUBLIC_URL` に設定してください。任意の Host ヘッダーや転送ヘッダーによって信頼されたアドレスが登録されることはありません。Host および Origin チェックにより、無関係なブラウザオリジンは拒否されます。レスポンスは `Cache-Control: no-store` を使用し、認証の値がログに記録されることはありません。 `*.trycloudflare.com` のアドレスは一時的なものです。トンネルの再起動によってホスト名が変わった場合は、設定された公開 URL と各クライアントの MCP URL を更新してください。保存するクライアント設定には固定のホスト名を使用してください。 ## ツールと境界 | ツール | 読み取り対象 | | --- | --- | | `list_workspaces` | 許可されたワークスペース | | `list_chats` | 許可されたチャット | | `search_messages` | 選択した期間内の保存済みメッセージ本文; `ranked=true` [全文検索](https://phishdestroy.io/tgwitness/ja/docs/reference/search/)に対応(語形変化、最良の一致を優先、 `next_offset` ページング)に対応) | | `get_message_versions` | キャプチャされたバージョンと削除の観測記録 | | `get_message_context` | 前後のキャプチャ済みメッセージ ID | | `get_journal_event` | ソース参照付きのサニタイズされた1件のレコード | | `get_capture_status` | 収集状況、許可されたカバレッジ記録、および `gap_summary`:チャンネルまたはスーパーグループごと、およびアカウント全体のシーケンスにおける、未観測のメッセージ番号([詳細](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#missing-message-numbers-gap_summary));チャットを選択して、そのリストされた欠落箇所を確認する | | `get_activity_stats` | UTC 時間および曜日ごとのメッセージ数、ピーク日、編集・削除の割合、送信者、ドメイン、および `@handles`、およびカバレッジ([詳細](https://phishdestroy.io/tgwitness/ja/docs/reference/cli/#activity-statistics)) | | `get_messages_by_date` | Telegramからの報告がある時点で、特定のIANAタイムゾーン(`Europe/Kyiv`, `UTC`)、Telegramが報告した時刻に基づいて保存されます; `from_utc` また `until_utc` 計算された日付(夏時間を含む)を明記すること | | `get_pinned_messages` | 最新のチャット状態スナップショットにピン留めされたメッセージとその保存版、およびリアルタイムで確認されたピン留め・ピン解除の通知 | | `get_chat_stats` | 対象範囲内の1つのチャットまたはすべてのチャットについて、保存された記録の件数、最初の観測と最後の観測、および `gap_summary`; 大量の読み取りを行う前にこれを使用してください | | `get_topics` | 保存済みトピックサービスからのフォーラムトピック:タイトルの履歴、閉鎖または非表示、保存済みメッセージ数 | | `get_media` | 保存された画像は、縮小されたJPEGプレビュー(最大36 KB)として、SHA-256ハッシュおよび `media.saved` レコードと共に画像として返されます。このファイルはまず記録されたハッシュ値と照合され、その他のファイルについてはメタデータのみが返されます | | `export_messages` | コマンドライン専用で、デフォルトでは選択されません:観測データを JSON Lines 形式でストリーム保存します([詳細](https://phishdestroy.io/tgwitness/ja/docs/reference/cli/#export))。MCP 経由では提供されません。 | すべてのツールは読み取り専用であり(`readOnlyHint`)であり、出力スキーマを宣言しています。宣言されたフィールド以外の項目は、そのままの形で返されます。 `tools/list` その接続に許可されたツールのみを返します。他の ツールへの呼び出しは拒否されます。グループコンテキスト、エピソード、用語、および返信チェーンに関するツールは、 このビルドでは提供されていません。これらに対応する個別のコンテキストパックバックエンドは含まれていないためです。 すべての読み取りでは、データベース処理の完了後も含め、トークン、ツール、およびワークスペース/チャットのスコープがチェックされます。制限は、1分あたり60リクエスト、1ページあたり50レコード、1結果あたり64 KiB、アーカイブのタイムアウトは8秒です。MCP 呼び出しがタイムアウトすると、期間の絞り込みや上限の引き下げを求めるツールエラーが返されます。 メッセージの結果には、`untrusted_content: true`、ワークスペース/チャット/メッセージID、 イベントシーケンス、保存されたハッシュ、およびパネルリンクが含まれます。生のTelegramオブジェクト、アクセスハッシュ、 セッション、およびキーは省略されます。テキストの切り捨て箇所にはマークが付けられます。編集、削除通知、 および`missing_on_recheck`は、それぞれ独立した観測項目です。カバレッジは、 結果が対象とする期間を示します。 キャプチャされたメッセージ内の指示は、決してクライアントの 指示としてではなく、証拠として扱ってください。読み取り専用アクセスによりアーカイブの変更は防止されますが、クライアントは 読み取りが許可されているコンテンツを引き続き保持できます。ハッシュは保存されたレコードを識別し、 整合性チェックをサポートします。結果を確認する際は、添付のソース参照およびカバレッジ記録を使用してください。 --- # Telegram · コマンドライン Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/cli/ スクリプトやエージェントからメッセージを検索、コンテキストの読み取り、アクティビティの集計、保存済みメッセージのエクスポートが可能で、--json 出力、安定した終了コード、スコープ付きの読み取り専用トークンをサポートしています。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) Translation coverage: this edition includes material from the English original. スクリプトやエージェントからメッセージを検索、コンテキストの読み取り、アクティビティの集計、保存済みメッセージのエクスポートが可能で、--json 出力、安定した終了コード、スコープ付きの読み取り専用トークンをサポートしています。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![アーカイブとの連携](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [読み取り専用 MCP](https://phishdestroy.io/tgwitness/ja/docs/reference/mcp/) · [全文検索](https://phishdestroy.io/tgwitness/ja/docs/reference/search/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Preview.** `tgwitness search`, `context`, `messages`, `stats` and `export` read saved observations for scripts and AI agents. They cannot send anything to Telegram, change settings or modify the signed journal. `tgwitness index` and `tgwitness backup` ([below](https://phishdestroy.io/tgwitness/ja/docs/reference/cli/#index-and-backup)) work on a local data directory and need no token. この場合 `--json`、stdoutにはJSONドキュメントが1つだけ出力されます(`export` JSON Lines形式で出力されます)。 進行状況、ヒント、エラーはstderrに出力されます。終了コードは安定しています: | コード | 意味 | | --- | --- | | `0` | 成功(結果が空の場合も含む) | | `1` | 失敗:パネルにアクセスできない、データが読み取れない、エクスポートが中断された | | `2` | 使用上のエラーまたは無効なリクエスト:日付が不正、不明なオプション、検索インデックスがオフ | | `3` | 現在利用不可:ワークスペースが実行中のパネルで開かれているか、パネルから「後で再試行してください」というメッセージが表示されています(レート制限、タイムアウト)。 | | `4` | アクセス拒否:トークンの欠落、有効期限切れ、または失効、対象範囲外のチャット、許可されていないツール | ## 読み方の2つの方法 **パネル経由(`--url`)。**このコマンドは、 MCPと同じスコープ付きアーカイブAPIを使用します。**「その他のツール」→「統合」→「MCP」**で接続を作成します。ワークスペースとチャット、 ツール、有効期限を選択し、トークンを1回コピーしてください。この接続は読み取り専用で、 指定されたチャットに限定され、1分あたり60リクエストにレート制限がかけられており、いつでも取り消しまたは 更新が可能です。パネルのログイントークンやTelegramの認証情報はここでは使用できません。 ``` export TGWITNESS_URL=https://panel.example.org # default http://127.0.0.1:8787 export TGWITNESS_MCP_TOKEN=tgw_mcp_... # or --token-file path tgwitness search 'перевод карта' --json ``` リモートパネルには HTTPS が必要です。プレーン HTTP が受け入れられるのは、 `127.0.0.1`, `localhost` および `::1`に限り、プレーンHTTPが受け入れられます。プロキシ環境変数は無視され、リダイレクトは 拒否されるため、トークンは指定したアドレスにのみ到達します。 **停止中のワークスペースから直接実行(`--data-dir`)。**トークンを使用せずに、 完全なローカルアクセス権でデータディレクトリを読み込みます。データディレクトリのコピー上で、または 収集が停止している間に使用してください。署名付きレコードは決して変更されません。パネルと同様に、 ワークスペースを開くと、そこから派生したインデックスが最新の状態に更新される場合があります。パネルでワークスペースが開かれている場合、このコマンドは コード `3`で終了します。代わりにパネル経由で読み込んでください。 `--data-dir`, `TGWITNESS_DATA`, `./data/live` 、またはコマンドを実行しているインストールのデータディレクトリが使用されます。 `--workspace ID` ワークスペースを選択します(デフォルト `default`). `tgwitness messages --workspaces` 閲覧可能なワークスペースを一覧表示します。 ## コマンド | コマンド | 結果 | | --- | --- | | `tgwitness search QUERY [--chat ID] [--since] [--until] [--any] [--limit N] [--offset N]` | 一致度の高い順に表示し、語形、引用符で囲まれた完全なフレーズ、ドメイン、および `@username` ([構文](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#search-syntax)) | | `tgwitness search QUERY --exact [--before SEQ]` | 正確なテキストを、最新のものから順に、インデックスを除いて記載してください。 | | `tgwitness context CHAT_ID MESSAGE_ID [--limit N] [--before SEQ]` | 前後10件のメッセージID範囲内の保存済みメッセージ | | `tgwitness messages [--limit N] [--offset N]` | 閲覧可能なチャット | | `tgwitness messages CHAT_ID [--since] [--until] [--limit N] [--before SEQ]` | チャットの保存済みメッセージ(新しい順) | | `tgwitness messages CHAT_ID --message ID` | 1つのメッセージについて、保存されたすべてのバージョンおよび削除記録 | | `tgwitness stats [--chat ID] [--sender ID] [--since] [--until] [--top N]` | 活動統計は以下の通りです。 | | `tgwitness export [--chat ID] [--since] [--until] [--output FILE]` | 記録された観測データは、ジャーナルの順序に従って JSON Lines 形式で保存されます | 日付は `2026-10-01` (UTC 0時)またはタイムゾーンを明記したISO形式の時刻 `2026-10-01T09:00+03:00`。 `search`, `messages` および `export` については、 観測時刻を選択します。各ページには最大50件のレコードが格納されます:ランク付け検索については `next_offset` (`--offset`) を参照して 順位付き検索を行い、 `next_before` (`--before`) については他の箇所を参照してください。 Ranked search stops at 1,000 results. The final page may be shorter than `--limit`. When more observations match, the last page says so (`truncated: true` with `--json`); narrow the query, chat or period. すべてのメッセージ結果には、`untrusted_content: true` 、ワークスペース、チャットおよび メッセージID、ジャーナルのシーケンス、保存されたレコードのハッシュ、およびパネルリンクが含まれます。編集、 削除通知、および`missing_on_recheck` は個別のレコードとなります。`stats` のカバレッジは、検索結果が対象とする期間を示しています。 ### アクティビティ統計 `stats` 対象範囲内の1つのチャット、1人の送信者、またはすべてのチャットについて、保存された観測データをカウントします: - UTC時間別および曜日別(月曜日を先頭)のメッセージ数、最も利用が集中する時間帯および曜日; - 編集、削除、および `missing_on_recheck` 共有; - 送信者、メッセージ数、および最初のメッセージと最後のメッセージの時刻; - 最も頻度の高いドメインおよび `@handles`、保存された各バージョンにおいて、メッセージごとに1回ずつカウントされた もの; - 対象範囲: `coverage.gap` 記録、およびワークスペース全体へのアクセスに関する、 コレクターのハートビートが接続されていない期間(`collector_liveness`). 期間には、**Telegramが報告するメッセージの時刻が**選択されます。 時間および曜日のカウントは、 送信者のタイムゾーンを推定するのに役立ちます。数値は ジャーナルからのリクエストに基づいて計算され、保存されることはありません。各結果は、 アクセスがワークスペースにまたがる場合、それが対象とするジャーナルの先頭を示します。パネル経由での読み取りは5秒後、 またはローカルで`--timeout`秒(デフォルトは30)経過すると停止します。その後、`complete`はfalseとなり、 `partial`には読み取られなかった最初のレコードが指定されます。その場合、 カウントされるのは最新のレコードのみです。 ### エクスポート `export` 保存された観測結果(新しいメッセージ、スナップショット、 編集、復元されたメッセージ、削除通知、 `missing_on_recheck` 保存されたメディア レコード)について、ジャーナルの順序に従って1つのJSONオブジェクトを書き出します。各行は他の結果と同じフィールドを持ち、 全文が含まれます。 `--output`、ファイルは `.partial` 名前で書き込まれ、 パネルの完了記録が記録された後にのみ名前が変更されます。エクスポートが中断された場合、 ファイルは残されず、コード `1`. `--output` は、既存のファイルを上書きすることはありません。 `--output` および `--json`を指定した場合、標準出力には要約(レコード数、最後のジャーナル シーケンス、およびワークスペース全体へのアクセス時にはジャーナルの先頭)が表示されます。 パネル経由でのエクスポートには、「**Export messages 」を許可する接続が必要です (コマンドラインのみ)** 。これはデフォルトでは選択されていません。このファイルは作業用コピーです。検証可能な 引き渡しを行うには、**「Exports」** にある署名付きエクスポートを使用してください。これは`python -m tgwitness.verify` で検証できます。 パネルは、完了 レコードを含め、各レコードを出力する前にアクセス権を再確認します。アクセス権が取り消されたり有効期限が切れたりしている場合、エクスポートは不完全なままとなります。遅延ページ読み取りは 、他のクエリとアーカイブワーカーの制限を共有し、待機時間には上限があります。 ### Index and backup These two commands read the data directory directly and take no token or `--url`. | コマンド | 結果 | | --- | --- | | `tgwitness index status [--workspace ID] [--data-dir DIR] [--json]` | Search index state of one workspace or, by default, every workspace: mode, `ready`, `building` or `not built`, indexed and journal head sequence. Works while the panel runs | | `tgwitness index rebuild [--workspace ID] [--data-dir DIR] [--json]` | Rebuilds the index from the first journal record. Rewrites only the derived index, never the signed journal. Exits with code `3` while the panel has the workspace open. Nothing is built when the workspace keeps its index in memory or has search off | | `tgwitness backup FOLDER [--data-dir DIR] [--json]` | Copies the whole data directory into a new or empty folder outside it while the panel keeps running, and writes `backup-manifest.json` with every file's SHA-256 and the journal heads | `index` accepts `--workspace default` or a workspace ID; the default is `all`. The backup skips temporary exports, SQLite sidecar files and lock files. The folder holds the Telegram session and signing keys, so keep it as private as the data directory. [Backup, restore, and capacity](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/#backup-restore-and-capacity) describes restoring and what the next start records. ## エージェントスキル [`.agents/skills/tgwitness-cli/SKILL.md`](https://github.com/phishdestroy/TgWitness/blob/main/.agents/skills/tgwitness-cli/SKILL.md) には、エージェント向けに、これらのコマンドの使用方法、記録の引用方法、および キャプチャされたテキストの扱い方が記載されています。エージェントは `.agents/skills` リポジトリのチェックアウトから読み込みます。 Claude Codeの場合は、 `tgwitness-cli` フォルダを `.claude/skills/` プロジェクト内の または `~/.claude/skills/`. ## MCP およびコマンドライン 両者とも、同じ接続、スコープチェック、および制限を使用しています。MCPの結果は 64 KiBのページ1つに制限されているため、MCPでは一括エクスポート機能は提供されていません。コマンドラインからストリーム出力されます。 `get_activity_stats` は両方で利用可能です。 --- # Telegram · ローカルでのOCRおよび文字起こし Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/media-analysis/ ローカルワーカーを使用してキャプチャされた画像や音声を認識し、抽出されたテキストを元のファイルと関連付けます。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) ローカルワーカーを使用してキャプチャされた画像や音声を認識し、抽出されたテキストを元のファイルと関連付けます。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [調査](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/) ![調査](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [ワークフローガイド](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) `media.saved` ジャーナルレコードを開き、**「添付ファイルを認識」** を選択してから、 **「その他のツール 」→「アーカイブに尋ねる」** の下にある「OCR」または「文字起こし」を選択してください(アーカイブのAIがオフのときは**「機械認識」** という名称になります)。処理は手動でローカルで行われます。 クラウドメディアモードや自動アップロード機能はありません。元の添付ファイルのバイトデータおよび `media_sha256` は変更されません。認識されたテキストは明示的に「機械 認識」としてマークされ、ソースのハッシュ、エンジン/モデルバージョン、 言語、パラメータ、完了時刻とともに別々に保存されます。文字起こしには返されたタイムスタンプが保持されます。 **「認識されたテキストの検索」**と「OCR/文字起こし」 フィルターを使用してこれらの結果を検索するか、ジャーナルのベストマッチ検索のソースとして認識されたテキストを選択してください。 どちらも、[メモリ内](https://phishdestroy.io/tgwitness/ja/docs/reference/search/#recognized-text)インデックスを通じて単語の形態を照合します。これは 独立した派生データ検索であり、機械認識結果を 元のTelegramテキストに無断で変換したり、署名付きイベントに追加したりすることはありません。 ## オプションのワーカーを設定する バージョン 1 では、ローカルの Docker デーモンを備えた Linux ホストが必要です。Windows 環境では、 独自のローカルデーモンを備えた Linux VM/WSL 環境内で TgWitness を実行できます。 本パネルは、信頼できない添付ファイルを自らデコードすることは決してありません。 ``` docker build -f deploy/media-worker/Dockerfile -t tgwitness-media:local . export TGWITNESS_MEDIA_IMAGE=tgwitness-media:local ``` TgWitnessのサービス環境でこれらの変数を設定し、サービスを再起動してください。 デーモンソケットのデフォルトは`/var/run/docker.sock`です。root権限なしのデプロイでは `TGWITNESS_DOCKER_SOCKET`を設定できます。ワーカーは、リモートのDockerコンテキストではなく、 そのUnixソケットを明示的に使用します。パネルユーザーに対してDocker APIを公開したり、 認識コンテナ内にそのソケットをマウントしたりしないでください。 文字起こしを行うには、CTranslate2 互換の Whisper モデルを別途インストールし、 `TGWITNESS_WHISPER_MODEL_DIR` をそのディレクトリに設定してください。ワーカーは `local_files_only=True` を使用してモデルを読み込み、選択されたモデルと入力データは読み取り専用でマウントされます。 エンジンの[モデル読み込みに関するドキュメント](https://github.com/SYSTRAN/faster-whisper)を参照してください。 提供されるOCRイメージには、英語とロシア語の学習データが含まれています。必要に応じて、 イメージに別の言語を組み込んでください。言語コードは [TesseractのCLI](https://tesseract-ocr.github.io/tessdoc/Command-Line-Usage.html)に準拠しています。 処理中はモデルは読み込まれません。ビルドおよびセットアップのダウンロードにはネットワーク通信が必要となる場合がありますが、 各認識コンテナではネットワーク通信が無効化されています。ネットワーク通信を有効にする前にイメージをインストールしてください。 実行時には`--pull=never`が使用されます。 ## 制限事項と復旧 コンテナは、読み取り専用のルート、機能制限(dropped capabilities)、`no-new-privileges` 、CPU 1 コア、メモリ 2 GiB、PID 制限、および容量制限のある 一時ファイルシステムを備えた、特権のないユーザーとして実行されます。マウントされるのは、選択されたファイルの検証済みコピーと、オプションの モデルディレクトリのみです。 コレクターのデータベース、保管庫、およびセッションは マウントされません。[Dockerランタイムのフラグ](https://docs.docker.com/reference/cli/docker/container/run/) によりこれらの制限が強制されます。これはコンテナの境界であり、ハードウェアエンクレーブではありません。 ファイルサイズは50 MiB、画像は2,000万ピクセル、音声は再生時間が既知の場合に限り30分、 処理時間は5分までと制限されています。一度に実行できるワーカーは1つで、 ワークスペースごとにキューに登録済みまたは実行中のジョブは最大20件、保持中のジョブは最大100件までです。 「Cancel」はコンテナを停止させ、「retry」は前回の試行にリンクされた新しいジョブを作成します。 中断されたジョブは、再起動後にマークされます。モデルが 設定された制限に適合できない場合、処理は失敗する可能性があります。隔離なしでは、処理は黙って実行されることはありません。 --- # Telegram · 送信されるWebhook Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/webhooks/ HMAC署名、再送信、配信ステータスを付加して、指定されたイベントをHTTPS受信先に送信します。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) HMAC署名、再送信、配信ステータスを付加して、指定されたイベントをHTTPS受信先に送信します。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [アーカイブとの連携](https://phishdestroy.io/tgwitness/ja/docs/reference/cli/) ![アーカイブとの連携](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [ワークフローガイド](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) 選択したワークスペースで、**[その他のツール] → [統合] → [送信Webhook]** を開きます。HTTPS 受信者を追加し、コレクター/メディア/エクスポートイベントを選択し、必要に応じて 新しい観測や変更に関するチャットを選択します。メッセージ本文はデフォルトで無効になっています。抜粋を有効にすると、 メッセージ変更イベントに最大1,000文字が追加されます。Telegramの生のフィールドや 認証情報は決して送信されません。 HMACシークレットを一度だけ、受信側の保護された設定にコピーしてください。これは TgWitnessの保管庫で暗号化されており、パネルからは取得できません。宛先を削除 して再作成することで、シークレットをローテーションしてください。**合成**テストキューに、 チャットコンテンツを含まないテストメッセージ**を送信し**、配信ステータスを更新して結果を確認してください。 配信機能は、Appriseと並行して既存の通知ループを拡張します。この機能は、 ワークスペースの外部ルートと既存のプライベート宛先制限を利用します。 その後の直接的なフォールバックやリダイレクトは行われません。URLには認証情報、 クエリ文字列、フラグメントを含めてはなりません。プライベートアドレスには、 パネルユーザーがバイパスできないサーバーレベルのネットワーク オプトインが必要です。 ## ペイロードと署名 スキーマ:[`tgwitness.webhook/1`](https://github.com/phishdestroy/TgWitness/blob/main/integrations/webhook.schema.json)。すべてのペイロードには `event_id`、`timestamp`、`workspace`、`type`、`synthetic`、およびカウンターが含まれます。 ジャーナルベースのイベントには、そのシーケンスとハッシュが含まれます。完全エクスポートの完了および 合成テストは配信イベントであり、架空の署名付きジャーナル参照は含まれません。 Telegramの削除通知と`missing_on_recheck`は、引き続き別個のタイプとして扱われます。 `X-TgWitness-Signature`ヘッダーは`t=UNIX_SECONDS,v1=HEX_HMAC_SHA256`です。 表示された秘密鍵をUTF-8バイトとして使用し、 `timestamp + "." + raw_request_body`の正確なバイト列に対してHMACを計算します。本文の解析や処理を行う前に、 定数時間で署名を照合してください。自身の時計から5分以上ずれている タイムスタンプは拒否してください。タイムスタンプは配信の試行ごとに更新されます。 `event_id`を、副作用が発生する前のアトミックかつ一意な 制約を伴う、耐久性のあるストレージ内の冪等性キーとして使用してください。有効な署名だけでは、 直近のリクエストがリプレイされるのを防ぐことはできません。処理済みのIDは、少なくとも リトライウィンドウ全体にわたって保持してください。受信者が保存されたイベントを再処理できる場合は、より長期間保持してください。 ## 再試行 配信は、HTTPリクエストの前に永続的にキューに入れられます。これらは「少なくとも1回」 というセマンティクスを使用します。つまり、確認応答の喪失や再起動により、 同じIDを持つイベントが再度配信される場合があります。指数関数的なバックオフを伴う8回の試行があり、15 秒から開始し、1時間を上限とします。成功には2xxレスポンスが必要です。再試行回数を 使い切ったジョブは、レビューのためにエラー情報と共に表示されたままになります。 キューには1,000件の配信が保持されます。キューが満杯になると、ジャーナルイベントのスキャンは一時停止し、 空き容量が確保された後に再開されます。 キューに追加できない完全エクスポートの完了処理は、 目に見えるキューエラーを発生させます。通知の処理ごとに最大5回の配信が試行され、 最新の100件の試行記録が保持されます。送信先を削除すると、 その送信先の保留中の配信も削除されます。 ## n8nの例 [サンプルワークフローを](https://github.com/phishdestroy/TgWitness/blob/main/integrations/n8n-tgwitness.json)インポートしてください。このワークフローは非アクティブ状態で、 機密情報や下流アクションは含まれていません。 n8nワーカー環境で`TGWITNESS_WEBHOOK_SECRET`を設定し、 その環境へのアクセスを許可するとともに、Codeノードに対して`crypto` 組み込み関数の使用を許可してください。この例では、Webhookノードのraw-bodyオプションを使用し、 署名と鮮度を確認し、検証済みのイベントに対して確認応答を行います。これは、 [ノードのドキュメントに記載されている実装と一致しています](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/nodes/Webhook/Webhook.node.ts)。 SIEMへの書き込みや通知を追加する前に、`event_id`をキーとする 耐久性のある冪等性ストレージを追加してください。n8nワークフローの編集および実行ログの保持期間は、 送信対象として選択したデータに応じて制限してください。TgWitnessは受信コマンドを追加しません。 --- # Telegram · 公開ショーケース Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/showcase/ 選択した公開チャンネルの保存済みメッセージや署名付きスナップショットを、有効期限付きかつ取り消し可能なリンクを通じて公開します。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 選択した公開チャンネルの保存済みメッセージや署名付きスナップショットを、有効期限付きかつ取り消し可能なリンクを通じて公開します。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [導入と復旧](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/) ![展開と復旧](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) **その他のツール → アクセス → 「パブリックショーケース」は**、既存の アクセストークンシステムを使用して、独立した読み取り専用のページを作成します。これは、インストール先に保存された観測データを読み取ります。訪問者のために コレクターを起動したり、Telegramにログインしたり、チャンネルを取得したりすることはありません。 ## ページを公開する 1. 表示したい公開チャンネルごとに、ソースプロファイルを保存してください。チャンネルは、 最後に保存されたプロファイルに公開ユーザー名が含まれている必要があります。グループやプライベートチャットは 対象外となります。 2. 管理者として、「**その他のツール」→「アクセス」→「パブリックショーケース**」(または`/showcase-manage.html`)を開いてください。 3. 最大16のワークスペースにまたがるチャンネルを選択し、公開ページのタイトルを入力して、 リンクの有効期間を1日、7日、または30日から選択します。ワークスペース内のラベルは 公開されません。最大64のチャンネルを含めることができます。 4. 公開する選択したチャンネルのテキストを確認し、「**選択した レコードをプレビュー**」をクリックします。プレビューでは、ビジターページと同じサーバーサイドのプロジェクションが使用されます。 5. 「**ショーケースリンクを作成**」をクリックします。リンクが表示されている間にコピーしてください。別の ブラウザで開いて、受信者のページを確認してから配布してください。 リンクのURLフラグメントにはアクセストークンが含まれています。ページは、 APIリクエストを行う前にこのフラグメントを削除し、ブラウザセッションと交換します。 リンクを所持しているユーザーは、有効期限が切れるか取り消されるまで、選択されたコンテンツを開くことができます。 新しいリンクでは、最大100の同時セッションが許可され、各セッションの最大継続時間は1時間です。既存の アクセス制御では、grant APIを通じて アドレスの制限やログイン回数の制限を適用することも可能です。通常のレビューアアクセスは別のモードであり、 もともと許可されていたメッセージやファイルは引き続き含まれます。 ## 訪問者に表示される内容 | 表示中 | 非公開に設定されています | | --- | --- | | 公開チャンネルのタイトル、ユーザー名、およびプロフィール確認日の抜粋 | アカウントID、ワークスペース内のラベル、および選択されていない情報源 | | キャプチャされたテキストと保存された各編集内容 | 構造化された送信者ID、名前、ユーザー名、電話番号、およびプロフィール情報 | | 削除時の記録(利用可能な場合、以前に保存されたテキストを含む) | 添付ファイル、アバター、サムネイル、ファイル名、および元のペイロード | | 著者/プロフィールまたは添付ファイルが記録されたことを示すマーカー | 転送および返信のメタデータ、ネットワーク経路、IPアドレス、認証情報 | | 選択したチャンネルのイベント数、現在のコレクション切り替え、ハートビートおよびチェックポイントの間隔 | コレクションの制御機能および通常の証拠データエクスポートAPI | | 署名フィンガープリント、ジャーナルチェックポイント、整合性証明 | 署名鍵とTelegramセッション | **公開メッセージのテキストは自動的に匿名化されません。**メッセージ内に記載された名前、メンション、電話番号、 リンクは、そのテキストの一部として残ります。 `Redacted`これは、構造化された作成者/プロフィールフィールドに適用されます。公開する前に、 編集や削除の履歴を含め、実際に選択された内容を必ず確認してください。 適格性は、Telegramのリアルタイム検索結果ではなく、**最後に保存されたソースプロファイルを**反映しています。 後続のプロファイルに公開チャンネルのユーザー名が含まれていない場合、新しいリクエストでは そのチャンネルが除外されます。公開設定が変更された場合は、ソースプロファイルを更新してください。 読者は、以前に受信したコンテンツをすでに保存している可能性があります。 元の署名付きレコードは変更されません。表示されるプロジェクションは 別途署名され、元のレコードを参照するハッシュを含みます。プロジェクションの 署名は表示された記述の真正性を保証し、参照される元のレコードは 独自の署名を保持します。 ## 署名と連続性を確認する **「フィンガープリントと署名付きチェックポイント」**を展開し、スナップショットをダウンロードします。ページが 更新されると、ダウンロードには直前のブラウザスナップショットと、それらのジャーナルの境界間の Merkle一貫性証明が含まれます。自動更新は、ページが表示されており、観測結果の最初のページが表示されている間、 1分ごとに実行されます。 TgWitnessをインストールしたら、ダウンロードしたファイルをオフラインで確認してください: ``` python -m tgwitness.showcase_verify showcase.json --fingerprint TRUSTED_COLLECTOR_SHA256 ``` フィンガープリントは、別途信頼されている参照元から取得する必要があります。ご自身で保持しているスナップショットと比較するには、 以下を使用してください `--previous earlier.json`を使用してください。これにより、 ダウンロードに含まれていた以前のスナップショットが上書きされます。現在の証明は、 その保存済みの境界から開始されなければなりません。認証済みのクライアントは、 `GET /api/showcase/{workspace_id}?challenge=<32-hex-random>&from_count=`を使用してその証明を要求できます。 ジャーナルが短い場合、境界が黙ってリセットされるのではなく、HTTP 409が返されます。 署名付きチェックポイントは、レコード数や不透明なヘッドハッシュを含め、**コレクター・ジャーナル全体**をコミットします。 表示されるメッセージ数は、 選択された公開チャンネルのみに適用されます。このページには、他のジャーナルの内容は一切表示されません。 これらはイベント数であり、一意のメッセージ数ではありません。設定は 現在の構成を表しており、過去のすべての記録間隔を表すものではありません。 署名および整合性検証により、保持されている 境界に対する変更を検出できます。対応するアーカイブから報告されたイベントを再集計し、 取得間隔と保持されているウィットネスのチェックポイントを併せて確認してください。 [証拠検証ツール](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md)、 [独立したウィットネス](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/)、および[実規模でテスト済みの記録](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/)を使用してください。 合成環境は、明示的に「合成」とラベル付けされています。 ## ページの公開を取り消す、またはホストする ショーケースマネージャーまたは既存の「**アクセス**」セクションにある**「取り消し」**機能を使用して、 リンクを閉じ、そのすべてのセッションを終了させます。リクエストによりアクセスが終了したと 検出されると、ビジターは表示されている記録を消去します。有効期限と権限は、すべての リクエストごとにチェックされます。ショーケースのアクセス権は、その場で通常のパネルアクセスに変換することはできません。 モードを変更するには、新しいアクセス権を作成してください。 インストール環境の既存のHTTPSアドレスを通じてページを提供します。リンクを公開しても、 新しいポートが開かれたり、トンネルが作成されたり、DNSが変更されたりすることはありません。HTMLおよびAPIは 引き続きユーザーのインストール環境上に残ります。ショーケースの訪問者は、このアクセス権限では通常の メッセージ、プロフィール、メディア、エクスポート、管理用のAPIを利用することはできません。 --- # Telegram · 証拠の仕組み Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/how-it-works/ ハッシュチェーン、署名、チェックポイント、およびウィットネスについて、検証者が使用する正確な数式を用いて解説しています。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) ハッシュチェーン、署名、チェックポイント、およびウィットネスについて、検証者が使用する正確な数式を用いて解説しています。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [証拠と検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) ![証拠と検証](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitnessは、収集アカウントが観測した内容を保存し、それらの観測結果を 署名付きジャーナルにリンクさせ、別のユーザーが、信頼できる 鍵、第三者からの外部時刻、および以前に保持されたチェックポイントに基づいて、エクスポート内容を検証できるようにします。 [ローカルのドキュメントウェブサイト](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally)には、 `/docs/concepts/` にインタラクティブな例、 `/docs/witness/` にチェックポイント決定エクスプローラー、および [Case Board](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/)、 [レポート作成](https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/)、[引き渡し抜粋](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#handover-extract)の手順解説が追加されています。 すべてのサンプルメッセージ、 カウント、遅延は架空のものです。チェーンサンドボックス内のハッシュは、 ブラウザ上で SHA-256 を使用して計算されます。Telegram には何も送信されません。 **このページでは** - [メッセージは変化し、観察結果は蓄積される](https://phishdestroy.io/tgwitness/ja/docs/reference/how-it-works/#a-message-changes-observations-accumulate) - [ハッシュの対象範囲](https://phishdestroy.io/tgwitness/ja/docs/reference/how-it-works/#what-a-hash-covers) - [以前のチェックポイントで追加された内容](https://phishdestroy.io/tgwitness/ja/docs/reference/how-it-works/#what-an-earlier-checkpoint-adds) - [ウィットネスの位置付け](https://phishdestroy.io/tgwitness/ja/docs/reference/how-it-works/#where-a-witness-belongs) - [既知のアクションに対する配信テスト](https://phishdestroy.io/tgwitness/ja/docs/reference/how-it-works/#test-delivery-against-known-actions) - [ワークフローを選択してください](https://phishdestroy.io/tgwitness/ja/docs/reference/how-it-works/#pick-a-workflow) ## メッセージは変化し、観察結果は蓄積されていきます シーケンス図 · Telegram → コレクター: 新しいメッセージ:10:00に集合してください; コレクター → 署名付きジャーナル: メッセージを追加。new; Telegram → コレクター: 編集:11:00に集合してください; コレクター → 署名付きジャーナル: メッセージ.editedを追加; Telegram → コレクター: 削除に関するお知らせ; コレクター → 署名付きジャーナル: メッセージ.deleted を追加する; 署名付きジャーナル に関する注記: 元のメッセージ、編集、削除の記録がすべて残ります · Telegram · コレクター · 署名付きジャーナル · 新しいメッセージ:10:00に集合してください · メッセージを追加。new · 編集:11:00に集合してください · メッセージ.editedを追加 · 削除に関するお知らせ · メッセージ.deleted を追加する · 元のメッセージ、編集、削除の記録がすべて残ります **図表をテキストで記述** 1. Telegram → コレクター: 新しいメッセージ:10:00に集合してください 2. コレクター → 署名付きジャーナル: メッセージを追加。new 3. Telegram → コレクター: 編集:11:00に集合してください 4. コレクター → 署名付きジャーナル: メッセージ.editedを追加 5. Telegram → コレクター: 削除に関するお知らせ 6. コレクター → 署名付きジャーナル: メッセージ.deleted を追加する 7. 署名付きジャーナル に関する注記: 元のメッセージ、編集、削除の記録がすべて残ります この簡略化された手順では、Telegramが各更新を配信し、選択された アカウントがそれを確認できたことを前提としています。操作イベントもジャーナルに記録されます。削除通知には、 削除者や正確な削除時刻は記載されません。配信の繰り返しは 個別の観測として扱われ、ジャーナル全体での重複排除は行われません。 ## ハッシュの対象範囲 ![観測、エンコード、ハッシュ化、署名:新しいイベントごとに、直前のハッシュが含まれます。](https://phishdestroy.io/tgwitness/assets/evidence-chain-animated.svg?v=368c25a3be9c) 式を内側から外側に向かって読み解いてみましょう。**C**は9つのフィールドを正確なバイト列に変換し、 **SHA-256はその**ダイジェストを生成し、**hex**はそのダイジェストの保存形式です。前の ハッシュはすでにイベント内に含まれています。**unhexは、**保存されたハッシュをEd25519が署名する32 バイトのバイト列に戻します。 [静的チェーン図](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-chain-static.svg) C(ei)を、9つのイベントフィールドからなる正規のUTF-8形式のJSONとします。最初の `previous_hash`は64個のゼロ文字で構成されます。それ以降の各レコードには、直前の レコードの16進数ハッシュが含まれます: hi = hex(SHA256(C(ei))) σi = Ed25519.Sign(sk,unhex(hi)) 署名は32バイトの生のダイジェストをカバーします。ハッシュの入力には、 `seq`、`observed_at`、`source_at`、`kind`、`chat_id`、`message_id`、`actor_id`、 `payload`、`previous_hash`が正確に含まれます。オブジェクトキーはソートされており、空白およびASCII エスケープは省略され、NaNおよび無限大は拒否されます。 [正確なエンコーディング](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#event-canonicalization)についてはこちらをご覧ください。 フローチャート · 64個のゼロ文字 → 記録 1 / ハッシュ h1; 記録 1 / ハッシュ h1 → レコード2にはh1 / ハッシュh2が含まれています; レコード2にはh1 / ハッシュh2が含まれています → レコード3にはh2 / ハッシュh3が含まれています; レコード3にはh2 / ハッシュh3が含まれています → 署名付きチェックポイント:カウント 3、見出し h3 (別の場所に保存する) · 64個のゼロ文字 · 記録 1 / ハッシュ h1 · レコード2にはh1 /ハッシュh2が含まれています · レコード3にはh2 /ハッシュh3が含まれています · 署名付きチェックポイント:カウント 3、見出しh3 · 別の場所に保存する **図表をテキストで記述** 1. 64個のゼロ文字 → 記録 1 / ハッシュ h1 2. 記録 1 / ハッシュ h1 → レコード2にはh1 / ハッシュh2が含まれています 3. レコード2にはh1 / ハッシュh2が含まれています → レコード3にはh2 / ハッシュh3が含まれています 4. レコード3にはh2 / ハッシュh3が含まれています → 署名付きチェックポイント:カウント 3、見出し h3 (別の場所に保存する) | 提供されたジャーナルに変更してください | どのような場合に検出されるか | | --- | --- | | 保存済みのハッシュを残したまま、レコード2を編集する | 再計算されたイベントのハッシュ値が異なります。その署名は、変更されたイベントをカバーしなくなりました。 | | 改変された記録およびその後のすべてのハッシュを再構築します | 元の署名が失敗しました。影響を受けた境界に保持されていたチェックポイントも一致していません。 | | 末尾を削除し、残りの接頭辞はそのまま残してください | 指定されたプレフィックスより前の、以前に保持されていたチェックポイントによると、エクスポートされたデータが短すぎることが判明しました | | 別の鍵を使用して、代替のジャーナルに再署名する | 別途信頼された鍵のフィンガープリントにより、IDの置き換えは拒否されます | ![保存済みのフィールドを変更すると、そのダイジェストが変更されます。ハッシュを再計算しても、元の署名は復元されません。](https://phishdestroy.io/tgwitness/assets/evidence-tamper-animated.svg?v=5ca92399bea5) **レコード2でこのロジックを試してみてください。**保存されたイベント内の`Meet at 11:00`を`Meet at 12:00`に変更すると、 再計算されたハッシュは一致しなくなります。後のチェーンを再計算することで リンクを修復することはできますが、元の署名が新しいダイジェストをカバーするようにすることはできません。 対照的に、Telegramでの編集が検出された場合は、新しいジャーナルレコードとして記録されます。 [変更履歴図(静的)](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-tamper-static.svg) ハッシュリンクだけでは、誰かが置換チェーンを再計算することを防ぐことはできません。 信頼性は、独立して信頼されている鍵による署名の検証、ジャーナルの先頭(ヘッダー)を固定する第三者からの外部 時刻、およびコレクターの外部に保持された参照情報 によって確保されます。 ## 以前のチェックポイントで追加された内容 ![カウント「3」と見出し「h3」はそのまま残してください。後でエクスポートされた4件のレコードは、位置3で確認されます。](https://phishdestroy.io/tgwitness/assets/evidence-checkpoint-animated.svg?v=e68f4e7be4b9) **ジャーナルが拡大しても、参照位置は変わりません。**チェックポイントが 「3件のレコード、ヘッダー h3」と指定している場合、4件のレコードを含むエクスポートでも、3番目の位置にある h3 と一致すれば通過できます。 最新のヘッダーは h4 であり、これが異なることが想定されます。2件のレコードのみを含むエクスポートは失敗します。 [静的チェックポイント図](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-checkpoint-static.svg) チェックポイントの署名を検証した後、以下を要求してください: Nexport ≥ Ncheckpoint and hexport[Ncheckpoint] = Hcheckpoint エクスポートはチェックポイントの範囲を超える場合があります。保持された境界において整合性が保たれている必要があります。 コレクターキーはチェックポイントに署名するため、コレクターは別のチェックポイントに署名することも可能です。 受信者がアーカイブ前に別のチャネルを通じてそれを取得した場合にのみ、レコードは紐付けられます。 証拠としての最低要件には、第三者からの外部時刻情報も必要です。 実際の検証者は、各イベントのシーケンス、前のリンク、ハッシュ、および 署名もチェックします。最終的に保存された先頭部分のみを比較すると、保存されたハッシュが更新されていない、改ざんされた内部 レコードを見逃すことになります。 ## 証人の居場所 フローチャート · コレクター/アカウントセッション/キー A → 読み取り専用チェックポイントのエンドポイント; Witness / 固定されたコレクターキー / 独自のキー B → 個別の署名付き証言記録; Witness / 固定されたコレクターキー / 独自のキー B → 読み取り専用チェックポイントのエンドポイント (確認を依頼する); 読み取り専用チェックポイントのエンドポイント → Witness / 固定されたコレクターキー / 独自のキー B (署名付き回答); Witness / 固定されたコレクターキー / 独自のキー B → 署名付きTGW1投稿を配信するチャンネル (Bot API / 独自のトークン) · ホスト A · ホスト B · コレクター/アカウントセッション/キー A · 読み取り専用チェックポイントのエンドポイント · Witness /固定されたコレクターキー /独自のキー B · 個別の署名付き証言記録 · 署名付きTGW1投稿を配信するチャンネル · 確認を依頼する · 署名付き回答 · Bot API / 独自のトークン **図表をテキストで記述** 1. コレクター/アカウントセッション/キー A → 読み取り専用チェックポイントのエンドポイント 2. Witness / 固定されたコレクターキー / 独自のキー B → 個別の署名付き証言記録 3. Witness / 固定されたコレクターキー / 独自のキー B → 読み取り専用チェックポイントのエンドポイント (確認を依頼する) 4. 読み取り専用チェックポイントのエンドポイント → Witness / 固定されたコレクターキー / 独自のキー B (署名付き回答) 5. Witness / 固定されたコレクターキー / 独自のキー B → 署名付きTGW1投稿を配信するチャンネル (Bot API / 独自のトークン) Witnessは、ロールバック、同じ件数での異なるヘッド、変更された鍵、無効な回答、欠落した応答を記録します。以前のすべての記録が変更されていないことを確認するには、エクスポートを保持済みのチェックポイントと比較してください。別のホスト上のWitnessは、コレクターのホスト障害を共有しません。別の運用者を置くと、さらに独立性が高まります。検証ツールはWitness鍵がコレクター鍵と異なることを確認し、保管者の鍵管理記録がその鍵を誰が保持しているかを示します。Telegramは公開チャンネルの各投稿に日付を付け、`verify.py --channel https://t.me/s/…` はその日付を外部時刻として読み取ります。 ウィットネスは、コレクターが報告したジャーナルの状態を証明します。制御された 配信テストを使用して、どの Telegram アクションが収集アカウントに到達したかを測定してください。 [ウィットネスの設定を](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/)参照してください。 ## 既知のアクションに対するテストの実施 管理されたグループ、個別の収集用アカウント、および新しいマーカーを使用してください。意図的に送信、 編集、削除を行い、各段階の間で記録が正しく行われているかを確認してください。結果を検証する前に、 想定される動作とカットオフを定義してください。 R = |observed∩expected| / |expected| Δ t = treceipt - taction 想定されたアクションのみがカウントされます。重複する受信記録は 分子を増やしません。分母はゼロ以外でなければなりません。受信記録が欠落している場合、測定された 遅延はありません。クロックの不確実性を明記してください。Telegramは正確な削除時刻を提供しないため、 ご自身で管理した削除アクションの時刻を使用してください。 5/6 (83.3%) といった結果は、テスト対象のアクションについて示すものであり、Telegramの全トラフィックの完全性を示すものではありません。 ## ワークフローを選択してください [調査の完全な手順は](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/)、 チャンネル、グループ、ボット、プライベートチャットにまたがるインシデントを例に解説しています: 1. 専用の収集アカウントで、アカウント全体の調査モードを有効にし、 アクセス可能なチャットを一覧表示します。メインアカウントには、選択したチャットまたはフォルダを使用します。 2. ジャーナルのスナップショット、チャットごとの完全な履歴、および保存された添付データを取得できます。 3. リアルタイムの変更や、パネルとの意図的なやり取りを、その記録とともに保存します。 4. 引用された記録や人物プロフィールを通じて、数値の送信者ID、返信の関係性、繰り返される宛先、およびファイルの ハッシュを追跡します。 5. Case Board にソースにリンクされたメモやコレクションを追加してください。タイムスタンプと明示的な空白期間の両方を含めた、チャット横断的な タイムラインを再構築してください。 6. 他のアカウントのワークスペースを比較しつつ、それぞれの起源と鍵を分離して管理します。 7. 署名付きジャーナル、プロフィール、履歴のエクスポートデータを、ケースノートとともにまとめ、検証してください。 ウェブサイトの `/docs/cases/` ガイドには、インタラクティブなケースマップや、 ボットをめぐる紛争、削除されたメッセージ、参加者の名前変更に対応したバリエーションが含まれています。Case Board は、ワークスペース内にメモやコレクションを管理します。グループエクスポートでは、個別の ワークスペースパッケージをまとめて収集しますが、ワークスペース間の相関分析や統合タイムラインの作成は、 引き続きアナリストの業務となります。 [検証完了事項および残りの作業](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/) · [エクスポートと検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#investigation-handoff) · [まずは1つのアカウントから始めましょう](https://phishdestroy.io/tgwitness/ja/docs/reference/quickstart/) --- # Telegram · レポートの設定と検証 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/ レポートフィルター、8種類のデザイン、コンテンツのプリセット、保存された変更履歴、および署名付きエクスポートに含まれる評価。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) レポートフィルター、8種類のデザイン、コンテンツのプリセット、保存された変更履歴、および署名付きエクスポートに含まれる評価。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [調査](https://phishdestroy.io/tgwitness/ja/docs/reference/investigation/) ![調査](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) 選択した観察事項を、案件に関する読みやすい報告書にまとめます。その内容には、案件の課題、 範囲、保存された変更点、図表、調査結果、およびソースの参照先が含まれます。各レポートは、 受領者が提供された資料を確認し、その収集範囲を 検証する手段を提供します。 「**信頼の根拠**」セクションは、ジャーナル、引き継ぎ、チャット、アカウント、および共有レポートに記載されています。ジャーナルおよび引き継ぎのPDFは、署名済みの`report.json`と同じ評価を使用します。ZIPマニフェストは、署名済みのマニフェスト内に`case_assessment`を含んでいます。この評価は、エクスポートされた資料と共に渡されます。元の観察結果には、既存の署名が保持されます。 ## 文書の形式と読み順 ### レポートスタジオ **[エクスポート] → [設定]** を開き**、プレビューを表示してください**。**[データ] → [デザインと内容] → [プレビュー]** の順に進めてください: 1. ワークスペース全体を使用するか、チャット、投稿者、UTC 基準の監視 期間およびイベントタイプを選択してください。カタログを読み込んでチャットや投稿者を検索するか、 Telegram ID を入力してください。投稿者フィルターは記録された送信者 ID と照合されます。送信者が記載されていない 削除通知は、投稿者フィルターには一致しません。 2. ページデザインを選択した後、グラフ、参加者ラベル、トランスクリプト、および ご自身の調査結果を選択してください。デザインを変更しても、これらの選択内容は保持されます。 3. プレビューを作成します。プレビューには、実際の件数、アクティビティ、参加者、サンプル レコード、保存された変更内容、および欠落しているメッセージ番号の範囲が表示されます。選択内容を変更すると、 プレビューは最新ではなくなります。HTML、署名付きPDF、 署名付きJSON、または証拠用ZIPファイルをダウンロードする前に、必ず保存してください。 データプレビューでは、初期サンプルではなく、完全かつ安定したログのプレフィックスがカウントされます。 表示されているサンプル行および長いリストのみが範囲に含まれており、省略された件数が 表示されます。後日のエクスポートでは新しい安定版スナップショットが取得されるため、収集が継続されている場合、 数値が増加する可能性があります。範囲、件数、およびソースの識別情報は、 署名付きレポートに含まれます。フォームを開いたりプレビューしたりしても、保存はされません。 **管轄に関するガイダンス。** 「ドキュメントの詳細」の下にある**「管轄に関するガイダンス・オプション」** を開き、管轄区域および民事/商事手続きまたは刑事手続きを選択してください。付録には、 法的根拠、出典リンク、作成上の注意事項、および調査状況が記載されています。 現地語による 収集の安全対策に関する要約および説明は任意です。デフォルトでは、 管轄区域は選択されていません。これらの選択はワークスペースに属し、 保存されたレイアウト設定や暗黙の共有・コピーのデフォルト設定からは除外されます。 [「デフォルト設定」、「サポートされているレポート」、および「調査の制限」](https://github.com/phishdestroy/TgWitness/blob/main/docs/JURISDICTION_GUIDANCE.md) を参照してください。 **受取人用のコピーを選択してください。** グラフおよびトランスクリプトには、選択された記録が使用されます。 完全性、保管、および網羅性は、ソースジャーナル全体を記述するものです。証拠用ZIPファイルには、 元の記録と添付ファイルが含まれています。受取人が選択された許可されたデータのみを受け取る必要がある場合は、[最小限の引き渡し](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#handover-extract) を行ってください。 ### 編集内容、削除箇所、およびIDの欠落を確認してください 編集履歴では、保存された**「変更前」**と**「変更後」**のテキストが表示され、変更された 単語がハイライトされます。削除履歴では、通知前に保存された最新のバージョンが表示されます。それ以前の コンテンツがキャプチャされていない場合は、レポートにその旨が記載されます。編集または削除のみを選択した場合、 以前のバージョンは、フィルターの外側で明示的にラベル付けされたコンテキストとして 引き続き利用可能です。 関連性のないメッセージは、これらの履歴には追加されません。 **未観測のメッセージIDとは**、選択されたチャット内の既知の番号と 日付から導出されたIDの範囲との間に生じるギャップのことです。番号を 未観測と宣言する前に、すべての既知のソースレコードがチェックされます。別の作成者、イベントタイプ、または日付を 除外しても、誤ったギャップが生じることはありません。隣接する保存済みメッセージはコンテキストとしてラベル付けされます。欠落している 番号は未観測の位置を示します。削除通知および再チェックの失敗は、 それぞれ独自のイベントタイプとして報告されます。 ### デザインを選択してください ジャーナルおよび単一チャットの HTML レポートと署名付き PDF レポートには、9 種類のページデザインがあります。いずれも同じ記録と計算を使い、表紙、タイポグラフィ、章見出し、表、余白が異なります。 | デザイン | 文章のスタイル | | --- | --- | | クラシック | 暗い色の表紙で、各セクションに番号が振られた従来の書類形式。 | | 編集上の注意事項 | 枠付きのセリフ体タイトルページ、広い余白、そして細い章見出し欄。 | | 概要 | ネイビー色の背表紙、短い見出し、行間を狭くした表を備えたコンパクトな表紙。 | | 分析 | アンケート形式の表紙、モジュール式の図表プレート、等幅フォントの図表。 | | 技術 | 罫線入りの記録簿、番号付き参照レール、および正確な比較表。 | | 概要 | パノラマ風の表紙、ゆとりのある余白、そして目立つ要約図。 | | シリーズを読む | セクション見出しと、調査結果、範囲、変更点、観察記録をまとめた章構成。 | | 元帳と証拠余白 | 章には番号を付け、余白を広く確保し、図表は正確に再現し、メッセージのトランスクリプトは別紙として記載してください。 | | プロファイル概要 | 主要な数値、観測されたプロファイル、チャット記録へのリンク付きの検索可能なセクション。 | デザインはワークスペースごとに保存され、署名付きエクスポートマニフェストに記録されます。 HTMLはオフラインでも動作し、ライトテーマとダークテーマに対応しており、狭い画面 や右から左への言語にも適応します。ネイティブPDFはバンドルされたフォントを使用します。エディトリアルデザインには、 バンドルされたSIL Open Font Licenseに基づくNoto Serifが含まれています。読み取りシリーズおよび 「Ledger & margin」は、アカウント概要、アカウントチャット、コピーの共有にも適用されます。 中国語、日本語、韓国語のPDFについては、サーバー上に適切なフォント( Noto Sans CJKなど)がシステム全体にインストールされているか、`TGWITNESS_FONT_DIR`に配置されている必要があります。 利用できない場合、ZIPファイルにはHTMLおよびJSON形式のレポートが保存されます。 これら2つのデザインには、JavaScriptを使用せずに閲覧可能なジャーナルが含まれています。大規模な エクスポートの場合、このビューには8 MiBの入力制限内で最大500件の完全なレコードが表示されます。 レポートには制限数が明記されており、完全なビューアおよびソースレコードへのリンクが掲載されています。 アカウントディレクトリおよび関係インデックスは、その同じ閲覧サンプルについて記述しており、 すべての参加者を網羅しているわけではありません。フルジャーナルチャートは、個別に明記された範囲を維持しています。 ### コンテンツを選択してください | 目次(事前設定) | デフォルトで含まれるもの | | --- | --- | | 案件資料(推奨) | アクティビティ、観察時間、参加者、チャット、および記録のトランスクリプト。 | | 概要 | 参加者の順位や会話記録を含まないアクティビティの概要。 | | アクティビティのレビュー | アクティビティ、観察時間、参加者、チャットおよびその構成については、出典の参照と正確な数値を明記してください。 | | カスタムレポート | 図表、トランスクリプト、プレビューを自由に組み合わせてください。 | プリセットを変更しても、デザイン、ケースの詳細、および記述された分析内容は保持されます。整合性チェック、カバレッジ、読み方の注記、および検証手順は、すべてのデザインに維持されます。チャートやトランスクリプトが非表示になっても、ZIPファイル内のソースレコードは変更されません。 オプションの「**検査メモ**」には、レポート作成者が記述した質問、方法、所見、および 結論が含まれます。所見には、ソースファイルと記録番号を 明記してください。署名により、これらの作成者による記述がレポートと共に 保存され、ソースの観察内容と作成者の解釈が識別可能なまま維持されます。 簡略化された引き継ぎでは、これらの非公開メモや完全な診療記録は省略されます。診療記録および 検査の選択項目は、診療記録レポートに適用されます。 期間ごとのアクティビティ、UTC に基づく曜日・時間ごとのヒートマップ、参加者ランキング、チャット ランキング、および記録の構成を選択します。5~30 のランク付けされたグループと、中立的な参加者の エイリアスまたはアカウント ID を選択します。送信元が不明なユーザーおよび残りの参加者は、別々の 行として表示されます。エイリアスはグラフにのみ影響し、ソースレコードには引き続き実名が含まれます。 デザインプレビューは、未保存の下書きから、本番用の表紙、検証、 チャートコンポーネントを使用して更新されますが、最初の 50,000 件のソースレコード内の一致に限定されます。以下のデータプレビューは 選択範囲全体を計算します。これは明示的に 署名されておらず、編集内容は保存されません。「表紙」および「チャート」ボタンでセクションを切り替えることができます。 これは完全なPDFプレビューではありません。**「レポート設定を保存」を選択すると**、その選択内容が 今後のエクスポートに適用されます。既存の署名済みファイルは変更できません。PDFでは、選択された表紙、 タイポグラフィ、章のレイアウト、およびHTMLや署名済みJSONと同じ集計結果が使用されます。 信頼性評価、カバレッジ、および検証手順は常に残ります。チャートや読み取り可能なトランスクリプトを非表示にしても、ZIPファイルから正本となるソース行が削除されることはありません。無効化されたチャート系列は分析用JSONから除外されます。ソースレコードの開示を制限するには、最小化エクスポートを使用してください。 データ選択フィルターはジャーナルのレポートに適用されます。アカウントのエクスポートと共有用エクスポートは、それぞれ独自の取得範囲と開示範囲を保ちます。選択では、チャット全体、作成者、UTC の日付、記録の種類、個々のメッセージを指定できます。チャットで**選択**によって選んだメッセージは**選択したメッセージ**に入ります。レポートはそれらのメッセージと、全体を選択したチャットのメッセージ記録を対象とし、選んだメッセージ番号を**選択されたデータ**に一覧表示します。欠落したメッセージ番号とその前後の記録は、全体を選択したチャットについてのみ報告されます。チャット一覧の下にある**メッセージ番号を追加**を使うと、チャットを開かずにメッセージを追加できます。1 行に 1 チャットで、チャット ID、コロン、メッセージ番号を書くか、個々のメッセージへの `t.me/c/…` リンクを指定します。 共有されたデザインや図表の設定は、新しいチャット/アカウントのエクスポートおよびアカウント 共有のプレビューに反映されます。アカウント/共有の言語設定およびプライバシー設定は独立したままです。 非公開のケースおよび調査メモは、これらのエクスポートにはコピーされません。アカウントおよび 共有レポートは、署名付きアーカイブマニフェストによって保護されたHTML形式のままです。 ジャーナル、 最小化されたジャーナルの引き継ぎ、およびシングルチャットキットも、署名付きPDFを提供します。 ### グラフが示す内容 ログアクティビティおよびヒートマップは、UTC 基準のコレクター観測時刻に基づき、新規、履歴、復元、編集、削除、および 再確認時に欠落**している観測を**カウントします。ハートビート および添付ファイルの受信確認は除外されます。 参加者ランキングでは、新規、履歴、 および復元されたメッセージの観測のみをカウントします。送信者は、編集者または 削除者として扱われません。重複する観測は、同じTelegramメッセージを表している場合があります。 ログ分析では、種類ごとのカウント、最初のレコードおよび最後のレコードへの参照、およびソースファイル「 `events.jsonl`」のSHA-256ハッシュ値が保持されます。図表には、HTMLおよびPDF形式で正確な数値が含まれます。日単位のバケットは、 記録された日数が366日を超えると月単位に切り替わり、グラフではこれらを最大36の 等幅の間隔にまとめます。 10万を超える固有の識別子、または1,200ヶ月分を超えると、 該当するグラフは利用できなくなりますが、正確な総計は引き続き利用可能です。 スナップショットおよびアカウント共有のグラフでは、記録されたメッセージ時刻に基づき、 対象に含まれる非サービスメッセージの行のみがカウントされます。共有集計値は、 情報隠蔽およびフィルタリング後に算出されます。これらのグラフでは、最大90の等幅UTC日付区間を使用し、 最大10,000件のグループ化値を保持します。超過分は明示的に記載され、調整されます。 最後の区間はより短くなる場合があります。不明または不正確な日付は、時間チャートには含まれません。 空白の区間は観測データが含まれていないことを意味します。欠落部分についてはカバレッジを参照してください。これらの グラフは保存されたアクティビティを示しています。送信元が不明なものは別のカテゴリとして扱われ、 各チェックは個別に報告されます。 `analytics.json` が含まれている場合、アーカイブの署名付きファイルハッシュによって保護されます。 ジャーナル `report.json` には、選択された同じ集計値が埋め込まれています。署名の検証により 変更されたバイトが検出されます。数値を確認するには、 `report_analytics.Analytics` および `selected` を使用してジャーナルの集計値を再計算するか、 `snapshot_analytics.collect` および `project` を使用してスナップショットの集計値を再計算してください。 ### 異常の指標 **プレビュー。**証拠レポートには、 登録されたプロセッサ(`tgwitness/metrics/`、メトリクスごとに1ファイル)によって計算された**「異常指標」**セクションが追加されます。レポートには、実行されたすべての プロセッサとそのバージョン名が記載され、各プロセッサのテーブルの下にその計算方法が表示されるため、 `events.jsonl` ファイルと `tgwitness.metrics.run` を使用して計算を再現することができます。 | プロセッサ | 表示内容 | | --- | --- | | `first_time_posters_over_time` v1 | UTC日あたりの初回投稿者数およびメッセージ数。フラグを立てるには、少なくとも5人の初回投稿者と、その中央値の3倍の投稿者数が必要であり、メッセージ量は中央値の1.5倍以下でなければなりません。ベースラインは、7日間のウォームアップ期間を経て、過去14暦日以内に少なくとも7日間の観測データを使用します。 | | `service_vs_message_ratio` v1 | チャットごとに保存されたメッセージ番号は個別に管理されており、サービスメッセージによって使用される割り当て分があります。これは番号付けの仕組みを説明するものであり、特定の番号が欠落している理由を説明するものではありません。 | | `join_leave_per_month` v1 | 月ごとの参加、離脱、削除または利用停止について、1人、1チャット、1変更、1日につき1件ずつ記載されています。 | | `pinned_per_month` v1 | チャット状態のスナップショット間で追加または削除された、サービスメッセージの固定、固定解除通知、および固定されたメッセージを月ごとに集計します。 | **[その他のツール] → [パラメータ] → [レポート指標] では**、プロセッサと表示行数を選択できます。 これはフィルタリングされたレポートにも適用されます。日次および月次の表には直近の行が表示され、サービス別シェア 表では、保存されたメッセージ数に基づいてチャットがランク付けされます。合計値はすべての行を対象としています。 ソースのチェックアウトから、同じ架空のジャーナルを使って上記の 9 種類すべてのデザインを生成します: ``` python tools/build_report_styles.py --output test-results/report-styles ``` 生成された`index.html`を開き、完全なHTMLレポート、署名付きPDF、および ZIPファイルを比較してください。すべてのデザインは同じソースジャーナルを使用しています。 各実行ごとに新しい出力ディレクトリを使用することで、以前に署名されたサンプルが保持されます。 ![架空のHTML資料](https://phishdestroy.io/tgwitness/assets/dossier-en.png?v=62db26820986) HTMLページは、ケースの概要と主要指標から始まります。番号付きの証拠マップは、 各調査結果、それを裏付ける事実、制限事項、および独立したレビューへとリンクしています。検索可能な 記録と安定した記録参照情報は、オフラインビューアでも引き続き利用可能です。 デザインは、狭い画面や、JavaScriptを使用しないテーマおよびブラウザにも対応しています。 署名済みのPDFには、専用のA4サイズ表紙、レポート参照番号およびQRコード、エグゼクティブ サマリー、証拠マップ、番号付き調査結果、およびドキュメントのブックマークが含まれています。そのページの ヘッダーとフッターには、レポートの識別情報が記載されています。QRコードは資料を識別するものであり、 独立した検証結果を示すものではありません。ブラウザからの印刷物は、この 暗号的に署名されたPDFとは別物です。 観察タイムラインでは、記録された観察期間と中断が 同じUTC軸上に配置されます。空白部分は観測範囲を意味するものではなく、詳細な表には 正確な間隔が保持されています。ZIPファイルには、読み取り可能なレポート、署名付きJSON、 ソースレコード、および検証手順が含まれています。 開発環境がインストールされた状態で、新規の架空の英語/ロシア語/ドイツ語の資料一式を作成してください: ``` python tools/build_dossier_example.py --output test-results/my-new-dossier ``` 各言語ディレクトリには、`report.html`、`report.pdf`、`report.json`、および `dossier.zip`が含まれています。既存のサンプルディレクトリは上書きされることはありません。作成にあたっては、Telegram アカウント、外部のタイムスタンプサービス、ネットワーク接続は一切使用されません。 ![架空の署名済みPDFの最初の3ページ](https://phishdestroy.io/tgwitness/assets/dossier-pdf.png?v=30a8d283dcc2) ## 具体的な事例の読み方 1,200件のエントリがあり、エントリ1,000でタイムスタンプの検証に成功したジャーナルの場合、 レポートでは、そのタイムスタンプの範囲外にある200件の後のエントリが特定されます。タイムスタンプは チェックポイントが存在していた時期の上限を確定します。各メッセージは、Telegramからの独自の 送信時刻を保持しています。他の3つのタイムスタンプファイルが検証に失敗するか、検証できない場合、 それらは別個にカウントされ、肯定的な結論を導き出すことはできません。 有効なタイムスタンプは、以下のすべてのチェックを満たす必要があります。そのインプリントが チェックポイントと一致すること、その署名がスタンプが押された時点で信頼できるTSAルートに連鎖していること、そして チェックポイントの署名、鍵、カウント、およびヘッドが、ジャーナルのプレフィックスと完全に一致すること。 単にタイムスタンプを解析したり、OTSの受領証を持っているだけでは不十分です。読み取り側は 、信頼できるTSAルートを独自に選択し、検証を繰り返さなければなりません。OTSには 独自のビットコイン確認チェックが必要です。 | レポートのステータス | 意味 | | --- | --- | | エクスポート時に確認済み | エクスポート担当者は記載されたチェックを実施しましたが、独立した再確認が依然として必要です。 | | 記録済み;確認が必要 | 基礎となる観察内容やオペレーターの陳述は記録されますが、これらは独立した確認ではありません。 | | 本翻訳の対象外 | この主張を裏付ける証拠は本文にはありません。ただし、他の場所に存在しないとも明記されていません。 | | 独自に検証されていません | 本レポートは、独立した検証結果を提供するものではありません。 | | 不完全または利用不可 | 資料または必要な確認事項が欠落している、不完全である、または確認に失敗しています。 | 記録された収集範囲と併せて、各チェック項目を個別に確認してください。 ## 強力な構成において保持すべき事項 1. 収集に依存する前に、別の信頼できるチャネルを通じて コレクターの鍵のフィンガープリントを保持してください。その参照情報を、エクスポートされたデータの署名鍵と比較してください。 2. 個別にタイムスタンプが付けられたチェックポイント、および使用されている場合は、コレクターの管理範囲外にある ウィットネス・ジャーナルを保持してください。それらを エクスポートされたジャーナルと比較し、その以前の境界を確認してください。 3. 記録の取得範囲、欠落部分、フィルタ、制限、および収集時の変更点を記載してください。 実際の申し立てに関連する欠落期間について説明し、検出されなかった メッセージID、削除通知、および再確認に失敗したケースを明確に区別してください。 4. 元のZIPファイルとそのハッシュ値を保持してください。各保持者、転送、日付 および目的を記録してください。それらに関連付けられたオペレーターの陳述およびケースノートも保持してください。 5. 機密性の高いVMについては、見積もり、チャレンジ、 Intel証明書チェーン、測定値、正確なソース、および鍵の取り扱い条件を保存し、独立して検証してください。 検証済みのアーティファクトとともに、アテステーションの検証結果も保管してください。 各モードにおける取得、 アーカイブの完全性、時刻、および収集範囲のチェックについては、「[検証範囲」](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope)を参照してください。 ## 受領者によるレビュー 信頼できる TgWitness のインストール環境と、独自に入手したフィンガープリントを使用してください: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca tsa-root.pem python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/WITNESS_CHANNEL --require-witness python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --check-drand ``` 2番目と3番目のコマンドは、証拠としての最低要件を満たすことができます。検証済みのタイムスタンプ、 またはTelegramがウィットネスの投稿に設定した日付により、最後の記録の外部時刻が得られます。 ウィットネスのZIPファイルは、独立して信頼できるソースから入手されなければなりません。その鍵 および出所情報も保持してください。コマンド、ツールのバージョン、出力、検証済みの入力 ハッシュ、および未解決の疑問点を保持してください。ビーコンの検証は別のオンラインチェックであり、 レポートレンダラーは、単にレポートを表示するためだけにサービスに連絡することは決してありません。 特定のメッセージに関する紛争については、アーカイブの参照情報、権威ある ファイルおよび記録の参照情報を引用した上で、関連する時間的範囲、範囲の欠落、 選択基準、および裏付けとなる資料について記述してください。共有用コピーについては、記録された 変換内容およびソースアーカイブへの参照情報も確認してください。非公開フィルターおよびID マッピングは、公開評価の対象外となります。 署名付きPDFの検証により、対象バイトの変更が検出されます。元の デジタルファイルと検証結果を、スクリーンショットや印刷された閲覧用コピーとともに保管してください。 --- # Telegram · アカウントのエクスポート Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/account-export/ アカウントが現在閲覧可能な内容をエクスポートします:スコープ、再開可能なジョブ、署名付きアーカイブ、および最小化された共有コピー。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) Translation coverage: this edition includes material from the English original. アカウントが現在閲覧可能な内容をエクスポートします:スコープ、再開可能なジョブ、署名付きアーカイブ、および最小化された共有コピー。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [証拠と検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) ![証拠と検証](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) アカウントのエクスポートを行うと、そのアカウントの取得スロットが確保されます。アーカイブの検出、ダウンロード、検証、およびパッケージ化が行われている間も、 ライブ観測は継続できます。 競合する取得を開始する前に、別の履歴またはエクスポートジョブを一時停止してください。 アーカイブを一時停止しても観測は継続され、観測を一時停止してもアーカイブジョブは維持されます。 異なるアカウントでのエクスポートは同時に実行できます。承認待ちの「テイクアウト専用」ジョブは そのアカウントを解放するため、承認待ちの間に別の通常セッションでのエクスポートを開始 することができます。一方、アクティブな取得処理中は、そのアカウントが引き続き予約されたままとなります。 インストール管理者として、「**ホーム」→「マイアカウントのエクスポート」**、または「**エクスポート」→「Telegramアカウント」→「アカウントエクスポートの設定」**を選択してください。 必要に応じてサインインし、権限範囲を確認した上で、明示的にエクスポートを開始してください。継続的な観測は必須ではありません。**「保存された観測データ」**は、既存の日誌を個別にエクスポートしたものであり、そのZIPファイルには、日誌フィルターの設定にかかわらず、すべてのソースが含まれます。各ワークスペースには、独自のジョブ、署名用ID、およびストレージがあります。無制限の通常エクスポート権限を含む、発行済みのパネルアクセス権限では、これらのアカウント全体のルートを開くことはできません。 送信者およびテキストフィルターは、**送信者またはメッセージ本文でフィルタリング**の下に展開されます。**アカウントデータと接続方法**には、オプションのアカウントカテゴリと「Takeout」/「通常セッション」の選択項目が含まれており、閉じている場合でもその概要にはアクティブな選択項目が表示されます。これらのセクションを閉じても設定は保持されます。エクスポートおよびレポートの下書きは、ビューを切り替えても現在のパネルセッション内に残りますが、ブラウザを再読み込みしても保存されません。既存の仕事は、どちらのエクスポートオプションからでもアクセス可能です。 このワークフローは、接続されたアカウントから現在アクセス可能なデータをエクスポートします。デフォルトの**「自動」**モードでは、[Telegram Takeout](https://core.telegram.org/api/takeout) から開始され、削除されたチャンネル、保存された連絡先、その他のアカウントデータを含め、現在の状態でアクセス可能な履歴が返されます。Telegram が Takeout の開始前に待機期間を設けている場合、「自動」モードは直ちに通常のセッションへと移行します。ジャーナルには `account_export.transport` 、署名付きインベントリには使用された方法が明記され、変更点は「省略」としてリストされます。「**Telegram Takeout セッションのみ」**では承認を待つだけであり、「**通常セッションのみ**」では Takeout を一切要求しません。シークレットチャットは「[シークレットチャット」](https://phishdestroy.io/tgwitness/ja/docs/reference/secret-chats/)モジュールによってリアルタイムで記録され、編集内容はリアルタイム監視によって記録されます。通常セッションのカバー範囲は異なり、サポートされていないカテゴリも記録されます。 **「ホーム」→「すべてをエクスポート」**を選択すると、すべてのチャットの種類、すべての添付ファイルの種類、プロフィール、連絡先、プロフィール写真、ストーリー、セッションのメタデータ、その他のアカウントデータが、すべての形式(Telegram DesktopのJSONおよびHTMLビューを含む署名付きTgWitnessアーカイブ)でエクスポートされます。**「エクスポート対象を選択」を選択すると、**同じデフォルト設定が適用された以下のフォームが開きます。 Takeoutは、Telegram Desktopでも使用されている公式のエクスポートAPIです。TgWitnessは、 独自の取得データから直接、Desktop互換のJSONを出力できます。他者の アーカイブをインポートする必要はありません。チャットIDおよびメッセージIDは、どちらの転送方式でも利用可能です。 エクスポート速度およびTakeoutの承認遅延は、Telegramがアカウントに設定している制限、 およびチャットが公開されているか転送可能かによって異なります。速度を比較する前に、同じ範囲およびメディア設定で測定を行ってください。 明示的に選択された最大20個のチャットIDについては、通常APIによるエクスポートでは、アカウントの完全なダイアログ一覧を検討する前に、それらのピアを 直接解決します。したがって、ダイアログ一覧に存在しない場合でも、 公開チャンネルは、参加することなくエクスポートすることができます。 キャッシュされていないピアについては、通常のインベントリが使用されます。 アーカイブフィルターは引き続き適用されます。Telegramがダイアログを返さず、 アーカイブされたチャットが除外されている場合、アーカイブ状態が不明なものは省略として記録されます。 Takeoutは、範囲分割によるインベントリ処理手順を維持します。どちらのパスもチャットに参加したり、 転送権限を変更したりすることはありません。 デスクトップ互換のJSONでは、Telegramが`left`とマークしたチャンネルは、 `left_chats`の下に表示されます。これには、アカウントが参加していない読み取り可能なパブリックチャンネルも含まれます。 `FLOOD_WAIT`と`FLOOD_PREMIUM_WAIT`の両方とも、サーバーが要求した全期間にわたってリクエストを一時停止します。 アカウントの期限は再接続や再起動後も維持され、後に行われるより短い待機時間によって その期限を短縮することはできません。再試行回数には上限があり、キャンセルしてもシールされたページは保持され、 レート制限を回避するためにAPI認証情報がローテーションされることはありません。プレミアムの購入は行われません。 ## 収集対象を選択する | 設定 | 意味 | | --- | --- | | 目的 | この買収が必要な理由を記録してください。不要な名前や機密性の高い案件の詳細はここに記載しないでください。 | | レポート言語 | 読み取り可能なレポートのラベルの言語を選択してください。元のメッセージ本文は変更されません。翻訳されていないテンプレートのラベルには英語が使用されます。言語は、署名付きジョブのオプションで固定されます。 | | チャットの種類 / チャットID | 選択したすべての種類、またはリストにあるチャットのみ。「保存済みメッセージ」はプライベートチャットに属します。アーカイブされたチャットは個別に選択可能です。 | | 日付 | UTC。パネルの「開始日」と「終了日」の暦日はいずれも含まれます。APIでは、開始日と終了日を含む `from_utc` および除外 `to_utc`を採用しており、パネルは「Through」の翌日の開始時刻を送信します。境界が空の場合、その側は制限されません。 | | 送信者ID | リストされた送信者からのメッセージのみ。リストが空の場合は、すべての送信者からのメッセージが含まれます。 | | テキストには以下が含まれます | 大文字小文字を区別しないリテラルフレーズは、「OR」で一致します。送信者/日付/自身のメッセージに関する条件は、「AND」で組み合わされます。 | | 自身のメッセージ | 送信したメッセージのみを保存します。 | | メディアの種類 | 添付ファイルのカテゴリを選択するか、すべてをクリアしてメッセージファイルのダウンロードを回避してください。 | | ファイル/メディアの合計制限 | ファイルごとのMiBおよびダウンロード済みメディアの合計GiB。テキスト、受信確認、読み取り可能なレポート、およびZIPのオーバーヘッドには、追加のディスク容量が必要です。 | | アカウントのカテゴリ | プロフィール、連絡先、プロフィール写真、ストーリー、セッションのメタデータ、その他のTakeoutデータには、それぞれ個別の制御機能があります。 | **「Minimize」**コレクションプリセットは、ファイルおよびアカウントのメタデータを無効にします。送信者/コンテンツフィルターは、メッセージページの保持およびメディアのダウンロードの前に適用されます。Telegramは、これらのフィルターを評価するために必要なメッセージを含むAPI履歴ページを引き続き送信します。つまり、フィルタリングを行っても、選択されていないメッセージがプロセスのメモリに入らないことが保証されるわけではありません。ワークスペース内で行われるその他の継続的な監視については、それぞれ独自の範囲および保持設定が適用されます。 プロフィール写真の履歴、ストーリー、セッションのメタデータ、その他のアカウントデータは、デフォルトで選択されています。事件の調査でメッセージのみが必要な場合は、これらを無効にし、プロフィールや連絡先も除外してください。添付ファイルやメタデータが不要な場合は、取得時にそれらを除外することで、このエクスポートに別のプライベートコピーが保存されるのを防ぐことができます。 写真のペイロードは、メタデータおよびハッシュマニフェストで識別される静止画像バリアントを使用します。これには、アニメーションアバターバリアントを含む写真も含まれます。そのアニメーションは、選択された静止画像に置き換えられることはありません。観測されたサイズより短い、または長いペイロードは添付ファイルの失敗として記録され、ファイル参照の更新中に表現が変更された場合は拒否されます。これらの失敗により、メッセージレコードは保持されたまま、アーカイブは不完全な状態となります。 独立した検証では、署名された長さが観測されたサイズや表現と矛盾する保存済み添付ファイルも拒否されます。これには、古いアーカイブ内のものも含まれます。 専用のメディア接続が一時的に失敗した場合、添付ファイルの読み取りには 標準のファイル接続が使用されます。1分後、ダウンロードを継続しながら、 バックグラウンドで専用ルートの再試行が行われます。この復旧処理では、設定された 接続制限が維持され、各データセンターごとに個別に適用されます。Telegramのフラッド による待機や認証失敗は、引き続き伝播します。 ## メッセージ番号とアクティビティマップ 各アカウントのアーカイブには `message-gaps.json` および `map.html`が含まれています。チャンネルやスーパーグループでは、チャットごとにメッセージに番号が振られているため、エクスポートされた最初のメッセージと最後のメッセージの間に存在しない番号は、すべてそのチャット内のメッセージとなります。 プライベートチャット、ボット、および基本グループは、アカウント全体で1つの番号シーケンスを共有しています。そこで欠落している番号は、いずれかのチャットに属していたものです。そのチャットは、エクスポートされた返信やピンが当該番号を指し示している場合に特定されます。そうでない場合は、隣接するメッセージ間の時間帯にどのチャットがアクティブであったかを推定し、残りはエクスポートに含まれていないチャットに帰属させます。 各実行には、その時間枠、隣接するメッセージ、チャットごとのシェア、および信頼度ラベルが含まれます。範囲が限定されている場合(フィルター、選択されていないチャットなど)は、その旨が明記されます。これは、範囲が限定されていると、欠番に選択範囲外のメッセージが含まれてしまうためです。 `map.html` カレンダー、時間軸上のチャット、メッセージおよび欠落番号の曜日・時間ごとのグリッドを表示し、すべてのチャットと最長の連続メッセージのリストをテーブル形式で示します。チャットページには、独自のカレンダー、グループの時間軸上の参加者一覧、およびメッセージが欠落しているトランскриプト上のマークが表示されます。 `verify.py` 再計算を行います `message-gaps.json` 署名付きページから再計算を行い、変更されたファイルは拒否します。 アクティビティマップには、最大のチャネルおよびスーパーグループのギャップが一覧表示され、その 番号範囲や隣接するメッセージの時刻も含まれています。範囲を開くと、ページ分割されたトランスクリプト内の そのマークされた位置にジャンプします。これらのマークは、保存された隣接項目間の 欠落番号を記録したものです。削除イベント、その時刻、およびメッセージの本文は、 保存された記録からのみ取得されます。画面が小さい場合、幅の広い表はカード内でスクロールします。 長いトランスクリプトには、メッセージの日付範囲とカレンダーが記載されたページ索引が含まれています。 月を選択すると、キャプチャされたページの順序に従って、その月の最初の記録が開きます。月のカウントには UTC 形式で記録されたメッセージの日付が使用されます。日付のない記録もトランスクリプトに残ります。ページ ナビゲーションには、最初のページ、最後のページ、および近隣のページが含まれており、メッセージ セクションを直接開くこともできます。この索引は、JavaScript なしでもオフラインで動作します。 ## 概要、対応範囲、検証 各ジョブでは、オプションとアカウントの識別情報が固定されます。インベントリとキャプチャされたページには署名が付与され、ページレシートにはハッシュ値、カーソル位置、時刻、添付ファイルの結果、および直前のレシートが記録されます。コミットされたページのみが進行状況に反映されます。再起動/再開時には、処理を続行する前にこれらの記録がチェックされます。アカウントの変更、署名済みページの変更、またはレシートチェーンの不整合がある場合は拒否されます。取得処理の途中でオプションを編集することはできません。別の範囲を処理する場合は、別のジョブを開始してください。 「一時停止」は、実行中のアカウント操作を中断します。アプリケーションを再起動しても、未完了の作業は明示的に再開できるよう残されます。有効期限が切れた Takeout セッションは明示的な再開が必要であり、Telegram の分割範囲を変更すると、新たな取得が必要になる場合があります。「再開」では以前の観測結果が保持されるため、長時間実行されたエクスポートは単一の原子的なスナップショットとはなりません。取得中は、その他のアカウント変更操作や競合するエクスポートがブロックされます。ワークスペースを削除する前に、パッケージングが完了するまで待ってください。 履歴書には以下の内容が記載されています **保存されたエクスポートデータの確認中…** 直ちに処理を開始し、Telegramに接続する前にバックグラウンドで保存されたコンテンツの整合性を確認します。検証中もパネルは利用可能な状態を維持します。「一時停止」は、検証ワーカーが安全に処理を完了するのを待ってからアカウントを解放します。また、起動直後や再開直後に押しても機能します。ストレージの処理速度が遅い場合、この待ち時間が長くなる可能性があります。整合性チェックに失敗した場合は、失敗したジョブに説明文を付記して残し、ファイルは保持されます。 Telegramが、インベントリ、履歴、または添付ファイルの取得中にアカウントの認証を終了した場合、ジョブは一時停止し、未完了のページは完了としてマークされません。同じアカウントに再接続して再開すると、最後に保存されたページから続行できます。利用できないメッセージのプレースホルダーは、履歴カーソルを前進させますが、読み取りを終了させることはありません。つまり、利用可能な古いメッセージは引き続きリクエストされ、プレースホルダーは取得済みのメッセージや削除が確認されたメッセージとして表示されることはありません。 The panel distinguishes a completed selected scope from a partial archive, and records omissions and failed reads. How the report shows coverage, gaps and missing message numbers: [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). Deliberately excluded files are different from failed or unavailable files. Inspect coverage even when integrity verification succeeds. No local reader can prove Telegram returned every message that ever existed. 生成済みのZIPファイルは、繰り返しダウンロードやHTTP範囲指定ダウンロードが可能のままです。アカウントアーカイブには、`manifest.json`、`manifest.sig`、署名付き`job.json`、`inventory.json`、`receipts/`、権威ある`data/*.jsonl`、選択された`media/`、読み取り可能なHTML、および検証ツールが含まれています。独立したチャネルを通じてコレクターのフィンガープリントを固定し、信頼できるインストール環境を使用して検証を行ってください。 パネルはアーカイブを`tgwitness-account-export-EXPORT_ID.zip`として保存します。シール付きキャプチャでは、証拠アーカイブ内に`account-export.zip`として格納されます。お手元のファイル名を使用してください: ``` python -m tgwitness.verify tgwitness-account-export-EXPORT_ID.zip --fingerprint TRUSTED_SHA256 ``` 展開後のコンテンツが4 GiBを超えるアーカイブについては、明示的に適切な `--max-gib`。パネルは、宣言された展開後のサイズと公開されたZIPダイジェストを使用して、認証済みで完全なローカルアーカイブを検証します。一方、外部CLIは独自のサイズ制限を維持します。読み取り可能なHTMLを開く前に検証を行ってください。アーカイブに同梱された検証ツールは便利ですが、独自に入手した検証ツールを使用することで、証拠と共に提供される実行可能コードを信頼する必要がなくなります。 Ed25519署名およびSHA256ハッシュは、コレクターが関連するバイトをコミットした後の変更を検出します。その結果を、記録された収集範囲、取得間隔、外部タイムスタンプの受領記録、および選択されたデプロイメントで利用可能な出所検証と併せて確認してください。後の観測結果は個別に記録され、以前にキャプチャされたバージョンが保持されます。 ## 弁護士やその他の受取人向けの開示資料を準備する 完成したエクスポートファイルをダウンロードした後は、元のZIPを保持し、 `index.html` 開いてください。レポートには、その範囲、対象範囲、および 制限事項が説明されています。レコードの参照には、アーカイブ参照、ドキュメントパス、および レコード番号が組み合わされているため、受信者はHTMLや印刷物上で同じエントリを特定できます。 具体的な使用例については、[架空のレポートを開く](https://phishdestroy.github.io/TgWitness/demo/report/)をご覧ください。 アカウントのエクスポートが完了したら、**「共有用コピーを作成」**を選択します。これにより、別の署名付き派生ファイルが生成されます。元のZIPは変更されず、非公開のままです。受信者が完全な内容を受け取る権限を持っていない限り、縮小された派生ファイルと一緒に送信しないでください。レポートの言語は別途選択してください。言語や選択設定を変更した場合は、作成前に再度プレビューを行う必要があります。 1. 開示目的を入力し、日付、送信者ID、およびリテラルテキストの条件を選択します。 2. 身元情報を保持するか、リストされた参加者のみを公開するか、全員を仮名化するかを選択できます。いずれの仮名化モードでも、チャットID/タイトルおよびメッセージIDも置き換えられます。仮名は、1つの開示範囲内では固定されますが、個別に作成された開示範囲間では変更されます。 3. メッセージ本文を保持するか、完全に省略するか、またはマスク対象として具体的な名前やフレーズを追加できます。プライベートモードでは、このツールは既知の非表示送信者名や別名、トークン単位の送信者ID、ダイレクトチャット名、リンク、メールアドレス、電話番号のような文字列もマスクします。既知の名前との照合では、Unicodeの大文字小文字の変換(case folding)が処理され、 `Straße`/`STRASSE`。一般的なグループ/チャンネルのタイトルは、メッセージ本文から自動的に削除されません。既知の身元マスクの制限を超えた場合は、ソースのエクスポート範囲を狭めるか、テキストを省略してください。このツールは、以降の名前を黙ってスキップすることはありません。これらは最善を尽くしたルールであり、一般的な匿名化ではありません。 4. 受信者が必要としない限り、ファイルは除外してください。含まれるオリジナルファイルは、画像、音声、テキスト、メタデータをそのまま保持します。これらはツールによって**not**のように匿名化されます。 5. カウント数、警告、および変換後のメッセージのサンプルをプレビューし、作成を明示的に確認してください。サンプルは、12 メッセージまで、各メッセージは 2,000 文字までです。これはサンプルであり、結果の完全なレビューではありません。設定を変更するには、再度プレビューを行う必要があります。プレビューは 15 分後に失効し、その管理者セッションおよび元の ZIP に紐付けられています。作成後は再利用できません。新しいプレビューを作成すると、同じジョブおよびセッションにおける以前のプレビューは無効になります。 6. 生成された完全な結果を `index.html` を `messages.jsonl` をローカルで確認してください。不要な情報が含まれている場合は、除外条件を厳格化した新しい開示情報を作成してください。署名済みのZIPをその場で編集しないでください。 ### 選択により除外されたメッセージ **プレビュー。**開示情報が不完全な場合、そのように表示されます。少なくとも1つの開示済みメッセージを含むすべてのチャット内では、選択範囲から除外されたメッセージがマーカーとして表示されます。 `[withheld by selection — rule: sender]` (または `text`, `period`)。「**選択範囲から除外されたメッセージ**」を選択してください:連続する非開示メッセージの各ブロックごとに1つのマーカー(デフォルト)、またはメッセージごとに1つのマーカー。マーカーにはルールとカウントのみが含まれ、テキスト、送信者、日付、ファイルは一切含まれません。開示されたメッセージがないチャットは完全に除外されるため、このパッケージはその存在を明らかにしません。 「開示された返信」とは、その返信が何に対して行われたかを示すものです。具体的には、このコピーに含まれるメッセージ、選択によって非開示とされたメッセージ、あるいはソースエクスポートに含まれていないメッセージ(エクスポート前に削除されたか、そもそもエクスポートされなかったかのいずれか。エクスポートデータからは区別できません)です。 開示された返信が回答対象とする除外されたメッセージには、常に独自のマーカーが付与されるため、その返信は、なぜ空であるかを説明するレコードを指し示します。これら3つの状態は、ソースエクスポートに属する削除や収集の欠落とは区別されます。 書式は `messages.jsonl` (フォーマット `tgwitness-account-disclosure-v2`)では、各メッセージには `state`: `disclosed`、または `withheld` で `rules` および `count`。公開された返信には `reply_to` 対象を伴う `id` と。開示された返信には `state` (`disclosed`, `withheld`, `not_in_source`)。マニフェストには、公開されたメッセージ、チャット、メディア、および `withheld` メッセージをカウントします。 `verify.py` コンテンツを含むマーカーや、パッケージ内に存在しないレコードを指す返信は拒否されます。バージョン1のパッケージは従来通り検証されます。 この最小化された形式では、構造化されたアカウントプロフィール、連絡先、アバター、セッション、ストーリー、Telegramの生データオブジェクト、転送ヘッダー、返信の引用、連絡先カード、位置情報メタデータは省略されます。また、元のJSONLファイル、非公開フィルター設定、仮名化キー、およびIDマップも除外されます。選択されたテキスト、明示的に保持されたID、および含まれるファイルには、これらのフィルターで使用されたものと同じ名前、ID、またはフレーズが含まれている可能性があります。これらについては別途確認が必要です。 プライバシーポリシーと仮名化キーは、そのジョブ用のローカル保管庫に暗号化された状態で保持されます。ジョブを削除すると、関連する非公開開示記録も消去されます。公開ポリシー記録には、フィルタ値ではなくフィルタの件数が記録されます。明示された目的はマニフェストおよびHTML上で公開されます。明示的な非公開基準、および仮名化モードにおける既知の隠された身元情報も、メッセージ本文が省略されている場合を含め、そこでマスクされます。目的の記述には不必要な個人情報を含めないようにしてください。身元を特定できない文脈については記載したままにしておいても構いません。 そのマニフェストには、派生ファイル、公開ポリシー、および元のZIPファイルのハッシュ値が紐付けられています。検証を行うことで完全性を確認でき、ソースがローカルで提供されている場合は、ソースとのリンクが一致していることも確認できます。パネルは、共有用コピーを`tgwitness-disclosure-DISCLOSURE_ID.zip`という名前で保存します: ``` python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 --evidence tgwitness-account-export-EXPORT_ID.zip ``` ソースのリンクは、開示資料がどのアーカイブとどのコレクター鍵に由来するかを示します。開示資料には選択した内容だけが含まれます。選択内容と識別情報の削除は、元のエクスポートと照らし合わせて確認してください。 ## 共有とホスト型キャプチャ 受信者が必要とするメッセージとファイルを選択し、共有するコピー全体を確認した上で、ソースは別途保管してください。受信者がその正確なコピーを特定・検証できるよう、送信した ZIP ファイルのハッシュ値を記録してください。選択された識別子は仮名化されますが、含まれるテキストおよび元のファイルは引き続き確認対象となります。 GitHub Actionsは、Takeoutまたは通常のAPIを介したアカウント全体および選択したチャットのエクスポートに加え、1つのチャットに関するイベントログのエクスポートをサポートしています。[ホスト型キャプチャガイド](https://phishdestroy.io/tgwitness/docs/capture/)では、設定の確認方法と120分という制限について説明しています。ホスト型キャプチャから生成された共有コピーを検証するには、そのソースハッシュを元のアーカイブと照合し、[モード固有のチェック](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope)を用いてそのアーカイブの認証情報を確認してください。 [証拠の形式](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) · [事例レポート](https://phishdestroy.io/tgwitness/ja/docs/reference/case-reports/) --- # Telegram · 証拠の形式 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/ 署名付きZIPファイルの内容、記録の種類、処理の受領確認、ユーザープロフィール、オフサイトコピー、およびオフライン検証について。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) Translation coverage: this edition includes material from the English original. 署名付きZIPファイルの内容、記録の種類、処理の受領確認、ユーザープロフィール、オフサイトコピー、およびオフライン検証について。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![証拠と検証](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitnessは、アカウントから閲覧可能なTelegramの観測結果を署名付きジャーナルに保存します。 受信者は、保存された記録、添付ファイル、およびレポートを信頼できる コレクターキーに対して検証し、最後の記録に関する外部時刻を第三者から確認し、 ジャーナルを以前に保持していたチェックポイントと比較することができます。 このページでは、引き継ぎのために保持すべきフォーマット、チェック項目、および資料について説明します。 Windows ユーザーは、**VERIFY.cmd** から開始できます。このツールは、元の ZIP ファイルと独自に入手したキーのフィンガープリントの入力を求め、解説付きの 結果を表示し、検証記録を別途保存します。セットアップや信頼性の制限については、[検証ランチャーおよび ポータブルランタイムを](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md)参照してください。 **このページでは** - [署名対象](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#what-is-signed) - [チャットエクスポートの比較](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#comparing-chat-exports) - [調査の引き継ぎ](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#investigation-handoff) - [引き継ぎ要約](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#handover-extract) - [読みやすいレポート](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#readable-reports) - [イベントの正規化](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#event-canonicalization) - [アクターのセマンティクス](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#actor-semantics) - [対象範囲:連続性、欠落、および観測されていないID](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids) - [作成者](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#producer) - [人物プロフィール](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#people-profiles) - [独立した証人](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#independent-witness) - [マニフェストとチェックポイント](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#manifest-and-checkpoints) - [検証範囲](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope) - [添付ファイル](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#attachments) - [永続的な収集および処理レシート (0.2)](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#durable-collection-and-process-receipts-02) - [RFC 3161 の準備および応答の検証 (0.2)](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02) - [証拠モードにおけるオプションのレコード:drand および Telegram デバイス](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices) ## 署名とは | 資料 | 保護 | 保存すべき内容 | | --- | --- | --- | | 運用上のイベントを含む、ジャーナルへのすべての記録 | イベントごとに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署名も付いています([参照。読み取り可能なレポート:](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#readable-reports))。 | 受信したファイルと信頼済み鍵のフィンガープリント、およびそれらが指す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](https://phishdestroy.io/tgwitness/ja/docs/reference/case-board/)Boardにおけるソースにリンクされたメモや収集データをサポートします。移管および保管記録は、ケース 資料とともに保管してください。 [実際の受入手順](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md)を用いて、意図した収集設定を確認してください。 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の手順](https://phishdestroy.io/tgwitness/ja/docs/reference/timestamp/)に従い、リクエスト、チェックポイント、信頼された 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 のレコードと認証済み最終レコード)を使用しています。暗号化された メタデータレコードには内部ファイル名が保存されているため、ダウンロードしたコンテナは名前を変更可能です。 検証が成功すると、信頼されたコレクター キーおよび保持された境界に対する完全性が確立されます。実施されたチェックに関する 信頼の前提条件および[検証結果](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/)については、[検証範囲を](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope)参照してください。 ## 引き継ぎ要約 署名付き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` に記載されます。選択した言語のレポートは、英語の原本を認証翻訳または宣誓翻訳とともに提出するよう勧める注記で始まります。[裁判所向けレポートの翻訳](https://phishdestroy.io/tgwitness/ja/docs/reference/translation/)を参照してください。 チャンネルまたはスーパーグループ内では、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を保持します。これらの記録は、キャプチャされた バージョンおよび[パネル操作の](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#own-actions)レシートと併せて参照してください。 プライベートチャットおよび通常のグループの削除通知には、メッセージ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](https://phishdestroy.io/tgwitness/ja/docs/reference/accounts/#witness-probe). While [strict chosen chats](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#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](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). **プレビュー。** `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シーケンスを](https://core.telegram.org/api/updates#message-id-sequences)文書化しています。 これらの番号は観測結果を記述するものであり、削除通知、再チェック、および管理ログ記録は、 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の取得証明](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)または [Intel TDX測定](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/)(有効になっている場合)によって個別に確認されます。プロデューサーフィールドが 存在する以前に作成されたアーカイブは引き続きサポートされており、レガシーレコードとして識別されます。 各`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://phishdestroy.io/tgwitness/ja/docs/reference/witness/)を参照してください。 公開アドレス `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](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md#sealed-evidence) は、その 証明検証ツールと承認済みポリシーを使用して、取得ダイジェストを認証します。 ## 検証範囲 検証では、アーカイブおよびその作成に使用された収集モードがチェックされます。 ケースに合致する信頼境界を持つモードを選択し、その検証用入力を保持してください。 | 収集モード | 検証者が確認する内容 | 検証用入力データと信頼境界 | | --- | --- | --- | | ローカルワークスペース | 署名、ハッシュチェーン、マニフェスト、および添付ファイルのバイトデータを記録する | 受信者が保持するコレクターのフィンガープリントおよび第三者からの外部時刻:検証済みのRFC 3161またはOpenTimestampsのレシート、あるいはt.meから読み込まれたウィットネスの投稿。保持されているチェックポイントおよびウィットネスの記録は、検証を裏付けるものです。 | | 独立したウィットネスを備えたローカルワークスペース | アーカイブの整合性チェックに加え、ウィットネスが保持している以前のジャーナルプレフィックスとの整合性も確認する | Witnessのフィンガープリントと記録。保管者の鍵管理記録が、Witness鍵を誰が保持しているかを示します。`--channel https://t.me/s/…`を使うと、Telegramが投稿に付けた日付が外部時刻になります | | [GitHub Actionsのキャプチャ](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | アーカイブのダイジェスト、承認済みワークフローおよびコレクターのコミット、ホスト型ランナー、新しいセッション/キーの起源、および内部アーカイブの整合性に関する GitHub による証明 | 信頼できる検証者ポリシー、呼び出し元リポジトリ、および GitHub 認証バンドル。収集は固定されたワークフローの下で実行されます。 | | [クラウド展開](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/) | プロバイダのライフサイクルおよびアクセス記録、ファイアウォールおよびCloudflareの状態、さらにコレクターの署名付き実行記録 | プロバイダおよびCloudflareへの読み取り専用クエリ。個々のチェックの利用可否はプロバイダによって異なります。 | | [Intel TDX 機密 VM](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) | 署名およびプラットフォームの状態を引用し、コレクターのステートメント、コンポーズ、OSの測定値と関連付ける | Intelのトラストチェーンおよび想定される導入時の測定値。必要なすべてのTDXチェックの結果を保持すること。 | 「シールド取得」では、承認された収集者が、検証済みの環境内での認証済み Telegram接続を通じてデータを受信します。アテステーションによりアーカイブは その実行に紐付けられるため、検証の対象には取得プロセスだけでなく、その後のファイルの完全性も含まれます。 これは、承認されたコードおよび上記に記載されたプラットフォームの信頼チェーンに依存しています。 GitHubでのキャプチャ検証には、実行環境内で作成されたセッションが必要であり、 インポートされたセッションによるキャプチャは拒否されます。 実行レシートには、コレクターのバージョン、ファイルのハッシュ値、および起動時の設定が記録されます。GitHub の出所情報とTDX測定値により環境チェックが行われ、 [検証レコード](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/)にはテスト対象の構成が特定されます。 ### メッセージの出所 Telegramは、公式アプリを含むすべてのクライアントに対し、 MTProtoセッション内でメッセージを配信します。セッションの認証キーはTelegramの 固定サーバーキーに対してネゴシエーションされ、すべての更新データは そのキーの下で暗号化され、整合性チェックを経て受信されます。コレクターは、アカウントの認証済み セッションを通じてメッセージを受信し、各メッセージが到着するたびに、チャット、 メッセージ、送信者の識別子、およびTelegramが各メッセージに設定した日付を付記して、ジャーナルに記録します。GitHubでは ActionsによるキャプチャおよびIntel TDXのデプロイメントにおいて、アテステーションは、そのセッションと 署名キーを承認されたコレクターの実行に紐付けます。 ジャーナルには、認証キーの出所が記録されます。電話やQRコードによるログイン、 あるいはセッションファイルからの独立したログインでは、`account.authorized`に `key_origin: "created"`が書き込まれます。インポートされた`.session`、TData、またはJSONキーでの収集では、 `imported`が書き込まれます。インポートされたキーは、その出所にかかわらず存在します。認証済みデプロイメントは インポートされたキーを拒否します。 レコードのTelegramにおける出所は、アカウントの認証済み接続、 ジャーナル内の接続およびキャプチャ記録、ジャーナルエントリと照合された キャプチャされたMTProtoフレーム([`tgwitness/forensics/`](https://github.com/phishdestroy/TgWitness/tree/main/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、単調時間、およびキューの状態が含まれます。 実行レシートは、個別に署名されたステートメントとしてダウンロードすることも可能です。実行環境の検証には、 「[検証範囲」](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope)で説明されている 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 の証拠([署名証明書の失効](https://phishdestroy.io/tgwitness/ja/docs/reference/timestamp/#signing-certificate-revocation))も検証します。 [手順](https://phishdestroy.io/tgwitness/ja/docs/reference/timestamp/)と[検証結果](https://phishdestroy.io/tgwitness/ja/docs/reference/verification/)を参照してください。 ## 証拠モードにおけるオプションの記録: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](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/#cloudflare-as-an-outside-witness))を経由して解決されるサーバーの場合、各 コピーでは、前回のコピー以降に 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と比較することができます。 --- # Telegram · 裁判所向けレポートの翻訳 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/translation/ どのファイルが原本か、認証翻訳とともに何を提出するか、翻訳者が保持する用語。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) どのファイルが原本か、認証翻訳とともに何を提出するか、翻訳者が保持する用語。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [証拠と検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) ![証拠と検証](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitnessは25の言語でレポートを作成しています。英語版が原文です。その他の言語版は 機械翻訳によるもので、一部については用語の確認が行われています。これらはオペレーターが レポートを読みやすくするための補助的なものであり、公認の翻訳ではありません。 ## どのような書類を提出すべきか 英語の原本と、裁判所の公用語への公認翻訳文または宣誓翻訳文を裁判所に提出してください。宣誓翻訳者は、 現地の専門用語や裁判所文書に求められる形式上の要件を熟知しています。 レポートの言語が英語でない場合、証拠資料、チャット記録、および引き継ぎ用ZIPファイルには、 そのレポートの英語版原本も含まれています: `report.en.html` また `report.en.pdf`、または `chat.en.html` および `chat.en.pdf` が添付されます。これらは、 選択された言語のレポートと同じ鍵で暗号化・署名されており、署名付きマニフェストにSHA-256ハッシュ値とともに記載され、 `report.original`でリストされます。英語でエクスポートされたレポート自体が原本となります。選択された 言語のレポートは、同じ推奨事項で開き、英語版のファイル名を指定します。 翻訳を行う前に、原文とアーカイブの内容を照合してください: ``` python -m tgwitness.verify report.en.html --fingerprint KEY --evidence tgwitness-evidence.zip ``` `README.txt` 各アーカイブの最後には、「**翻訳者向け」**というセクションがあり、そこには元のファイル名が記載され、 以下の用語が繰り返されています。[ナラティブおよび専門家プロトコル](https://github.com/phishdestroy/TgWitness/blob/main/docs/NARRATIVE.md)には、同じ 推奨事項が記載されています。 ## 文字通りのままのもの - ファイル名、コマンド、ハッシュ、鍵のフィンガープリント、Telegram ID、メッセージ番号、およびURL。 - 時刻:ISO 8601形式のUTC。記載されたままの形式で表記してください。ローカルタイムゾーンに変換しないでください。 - 取得したメッセージ:原文のまま引用し、翻訳は別途記載し、 「翻訳」と明記してください。 ## 利用規約 | 用語 | 意味 | 次のように訳さないでください | | --- | --- | --- | | ジャーナル | コレクターによって保持される、署名付きでハッシュチェーン化されたレコードのシーケンス | 日記、定期刊行物、雑誌 | | 記録 | 日記の署名入り記述が1つ。これについては、文中を通じて一貫して1つの単語で表記すること | 注、記事 | | 観察 | 記録された時点で収集家が受け取ったもの | 内容の実在性に関する調査結果 | | コレクター | オペレーター自身のTelegramアカウントを通じて監視を行っていた「TgWitness」プロセス | アイテムの収集 | | データ収集 | Telegramからの更新情報の受信と記録 | コレクション、セット、編集版 | | 削除のお知らせ | Telegramでメッセージが削除されたことを知らせる通知。誰が削除したかは表示されない | 特定の人物による、実証済みの削除 | | 再確認時に欠落している | Telegramで再度確認したところ、そのメッセージは表示されなくなっていました。「削除済み」か、このアカウントからは表示されなくなっていたようです。 | 削除済み | | メッセージ番号なし | エクスポートにメッセージが含まれていない番号:以前に削除されたか、このアカウントでは一度も表示されたことがない | メッセージが見つからない、メッセージが消えた | | ギャップ | 観察が行われなかった期間 | 何も起こらなかったという証拠 | | 以前のバージョン | 編集前のテキスト。両方のバージョンが保存されます。 | 訂正、改ざん | | チェックポイント | 過去最多となった同誌の要約に署名が入った | 物理的な意味での制御点 | | タイムスタンプサービス(TSA) | 独立したRFC 3161準拠のタイムスタンプサービス | 権限、政府機関、認証局 | | タイムスタンプ付き領収書 | 特定の時刻までにチェックポイントが存在していたことを示す、タイムスタンプ・サービスの応答、あるいはOpenTimestampsのレシート | 証拠、事実の立証 | | シール | レポートファイルに埋め込まれたEd25519署名 | 役人の印章 | | 署名鍵のフィンガープリント | 別の信頼できるチャネルを通じて取得した公開鍵のSHA-256ハッシュ値 | 生体認証(指紋) | | 目撃者 | チェックポイントを管理または確認する独立した当事者またはサービス | 法廷で証言している人 | | 引継ぎ要約 | 第三者のために作成された日誌の一部で、他者の情報は最小限に抑えられている | エクスポートを完了する | | 最小化されたレコード | 非表示のフィールドに名前が付けられ、そのハッシュ値に置き換えられたレコード | 削除または黒塗りされた記録 | --- # Telegram · 独立した証人 Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/witness/ 独自の鍵とボットを使用してWitnessを実行し、署名済みのチェックポイントをチャンネルに公開し、エクスポートしたデータと照合してください。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 独自の鍵とボットを使用してWitnessを実行し、署名済みのチェックポイントをチャンネルに公開し、エクスポートしたデータと照合してください。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [証拠と検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) ![証拠と検証](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) [エクスポートと検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) · [高信頼性](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/) · [パネルガイド](https://phishdestroy.io/tgwitness/ja/docs/reference/panel/#extras) ウィットネスは、コレクターとは別に署名付きチェックポイントを保持します。ウィットネスは、 コレクターの署名とジャーナルの連続性を検証し、その結果を自身の鍵で署名して、 Telegramチャンネルに公開します。コレクターのウィットネスエンドポイントへの読み取り専用アクセス権を持つ 別のサーバー上で実行してください。 技術的な結果には、保持されたジャーナルのプレフィックス、チャレンジ応答、署名チェック、Merkleの包含/整合性チェック、署名付きの連続性の結果が含まれます。別の保管者が運用するWitnessについては、保管者の情報と鍵管理記録を、そのフィンガープリントとともに保持してください。鍵の分離と保管の分離は、構成の別々の部分を表します。検証ツールは、2つ目の鍵がジャーナルのヘッドをどの記録まで保持したかを報告し、保管者の鍵管理記録がその鍵を誰が保持しているかを示します。Witnessジャーナルは補助的なチェックであり、証拠としての最低要件は第三者による時刻です。チャンネル投稿は外部時刻を加えます。Telegramが各公開投稿に日付を付け、検証ツールがその日付を自ら読み取ります。 フローチャート · コレクター → ウィットネス (署名付きチェックポイント:記録数 + 先頭ハッシュ); ウィットネス → Witnessジャーナル、独自の鍵; ウィットネス → Telegramチャンネル (独自のボットを介して署名付きで投稿されました); 証拠 ZIP → verify.py; Witnessジャーナル、独自の鍵 → verify.py; Telegramチャンネル → verify.py (t.me/s ページをリアルタイムで閲覧、またはデスクトップへエクスポート) · コレクター · ウィットネス · Witnessジャーナル、独自の鍵 · Telegramチャンネル · 証拠 ZIP · verify.py · 署名付きチェックポイント:記 · 録数 + 先頭ハッシュ · 独自のボットを介して署名付き · で投稿されました · t.me/s · ページをリアルタイムで閲覧、 · またはデスクトップへエクスポ · ート **図表をテキストで記述** 1. コレクター → ウィットネス (署名付きチェックポイント:記録数 + 先頭ハッシュ) 2. ウィットネス → Witnessジャーナル、独自の鍵 3. ウィットネス → Telegramチャンネル (独自のボットを介して署名付きで投稿されました) 4. 証拠 ZIP → verify.py 5. Witnessジャーナル、独自の鍵 → verify.py 6. Telegramチャンネル → verify.py (t.me/s ページをリアルタイムで閲覧、またはデスクトップへエクスポート) **このページでは** - [Witnessが保持するもの](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/#what-the-witness-holds) - [チェックおよび記録の対象](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/#what-it-checks-and-records) - [ウィットネスの実行](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/#run-a-witness) - [複数のワークスペース向けの公開証明ページ](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/#public-proof-page-for-several-workspaces) - [検証](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/#verify) ## Witnessが保持するもの | Witnessには | このツールには決して | | --- | --- | | 1つのワークスペース用の読み取り専用**ウィットネストークン** | コレクターのTelegramセッションまたはAPI認証情報 | | 独自のEd25519鍵とジャーナル | コレクターの保管庫、署名鍵、またはパネルトークン | | 独自のTelegramボットトークン | メッセージの内容:ヘッダーには記録件数とハッシュ値が含まれます | トークンは「**その他のツール」→「エクストラ」→「独立したウィットネス**」で作成され、一度だけ表示され、 SHA-256としてのみ保存されます。これは`GET /api/witness/head`というエンドポイントを正確に1つだけ開き、このエンドポイントは新たに 署名されたチェックポイントに加え、署名済みのコンテンツを含まない収集カウンターおよび運用状態を返します。 このトークンでは、パネルを開いたり、メッセージの内容を読み取ったり、設定を変更したりすることはできず、 パネル用トークンもここでは受け入れられません。トークンの無効化は同じページで行います。コレクターは、 新しいウィットネスキーがチェックを開始した時刻(`witness.seen`)を記録し、トークンごとの最後のチェック日時を表示します。 2.5のインターバル以内にチェックが行われていないウィットネスは、期限切れとしてマークされます。 新しいウィットネスは、 各ポーリングごとにランダムなチャレンジを送信します。キャプチャステートメントは、コレクターの署名の下でそれを反映します。カウンターは 正確なチェックポイントに紐付けられており、署名付きウィットネス投稿に含まれます。レガシーヘッドは スタンドアロンのウィットネスによって引き続き受け入れられます。ジャーナルの増分のみは、決して新しいメッセージとしてカウントされることはありません。 ## チェックおよび記録の対象 一定の間隔(デフォルトでは10分ごと)ごとに、witnessは以下の処理を行います: 1. ヘッド自体を取得します(コレクターはこれをプッシュしたりスキップしたりすることはできません); 2. コレクターの署名、固定されたコレクターキー(`--collector-fingerprint`、 または最初に検出されたキー)、非減少するカウント、および変更されていないカウントにおける変更されていないヘッドを検証します。 マークル包含証明および整合性証明は、増加するジャーナルが 保持されているチェックポイントを拡張していることを検証します。連続性証明が一度使用されると、その削除は拒否されます。 3. 自身のジャーナルに署名付きレコードを追加します:`witness.anchor`(ステータス:`ok`、 `key_changed`、`rollback`(以前よりレコード数が少ない)、`fork`(長さは同じですが、 ヘッダーが異なる)、または`invalid`(検証に失敗した)、あるいは`witness.no_response`( コレクターが応答しなかった場合)); 4. TgWitnessが 稼働中でBot APIにアクセス可能な間は、「no answer」を含め、署名付きの結果をチャンネルに投稿します。投稿ID(`witness.posted`)が記録され、 投稿に失敗した場合も同様に記録されます(`witness.post_failed`)。 投稿は次のような形式になります。最後の行には署名付きの記述が含まれています: ``` TgWitness witness #42 · journal head Collector 3fa9c2d1e0b4a7f6: 18234 records Head 9b1f…c07e 2026-10-28T19:40:00.123+00:00 TGW1.eyJhdCI6…. ``` ## witnessを実行する Telegramボット(@BotFatherで作成してください)、そのボットが 管理者となっているチャンネル、および証人からアクセス可能なコレクターのアドレス(プライベートネットワーク外で HTTPS経由)が必要となります([導入手順の](https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/)「HTTPSプロファイル」を参照してください)。 開く **[その他のツール] → [エクストラ] → [独立したウィットネス] → [設定]** パネル内。3つのステップで、 読み取り専用アクセス、チャネルと間隔の設定、そしてウィットネスの起動が行われます。公開 ポリシー、オプションのHTTP/SOCKS5プロキシ、およびカスタムBot APIアドレスは **詳細設定**。このフォームは ダウンロードします `witness.json` このワークスペースのコレクターキーが固定された状態で。新しく 作成された読み取り専用トークンを **アクセスファイルを保存** as `witness-token.txt`; それを、および `bot-token.txt` witnessホスト上で作成されたbot-token.txtを、そのJSONファイルの隣に配置してください。コレクターはボットトークンを受け取ることはありません。 ダウンロードによってサービスが起動されたり、メッセージが公開されたりすることはありません。ホストされたプロジェクトのウィットネスは 暗黙的に登録されません。 ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json python -m tgwitness.witness fingerprint --config witness.json ``` 最初のコマンドは、ネットワークリクエストや鍵の 生成を行わずに、設定ファイルと秘密ファイルを確認します。JSON内のパスはそのファイルを基準とした相対パスであり、CLI/環境のパスは 作業ディレクトリを基準とした相対パスです。 ウィットネスのフィンガープリントは、ホストの外に保持してください。コレクターの 「last-poll」インジケーターはリクエストの確認のみを行います。公開については、Proof によって報告されるか、 ウィットネス・ジャーナルおよびチャンネルで確認してください。 パネルがSSHトンネルの背後に配置されている場合は、[このCaddyの例](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.witness.example)に従い、 別のHTTPSホスト名上で、スコープが限定されたwitnessエンドポイントのみを公開してください。 その場合、デフォルトのワークスペースでは`https://witness.example.org`が使用され、その他のワークスペースでは `https://witness.example.org/profiles/ID`が使用されます。トークンは引き続き必要となります。パネルおよびその その他のAPIルートは、その仮想ホストによって転送されません。 定期的にチェックポイントが公開される設定には「`all`」をお選びください。5分間隔の場合、ワークスペース1つあたり1日約288件の 投稿となります。「`changes`」および「`problems`」では、一部のチェックポイントを意図的に非公開としています。 MTProxyは、コレクター側のTelegramクライアント用です。WitnessのHTTPポーリングおよびTelegramのHTTPS Bot APIは、それぞれ独自のダイレクト/HTTP/SOCKS5ルート([Bot API](https://core.telegram.org/bots/api))を使用します。 **コレクターの隣に、Docker を使用して**(同じホスト上で — 独立したプロセスとキーですが、 オペレーターは同じです):`.env` に値を入力し、プロファイルを起動してください。 ``` TGWITNESS_WITNESS_TOKEN=tgww_... TGWITNESS_WITNESS_BOT_TOKEN=123456:ABC... TGWITNESS_WITNESS_CHANNEL=@your_witness_channel # another workspace: TGWITNESS_WITNESS_COLLECTOR=http://tgwitness:8787/profiles/ docker compose --profile witness up -d docker compose logs witness # prints the witness key fingerprint ``` 掲載されている画像を使用する場合は、`docker compose --project-directory . -f deploy/compose/compose.image.yaml --profile witness up -d` をご使用ください。 **他者のサーバー上**(分離管理)では:リポジトリをそこにコピーし、 `TGWITNESS_WITNESS_COLLECTOR=https://your-collector.example.org` に加えて上記の3つの値を `.env`に設定してから、 ``` docker compose --project-directory . -f deploy/compose/compose.witness.yaml up -d ``` または、Docker を使用しない場合: ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --bot-token-file bot-token.txt --channel @your_witness_channel ``` ### Discordに公開する ウィットネスは、Telegramの代わりにDiscordチャンネルに投稿することもできます。Discordで、 **「チャンネルの編集」→「統合」→「Webhook**」を開き、Webhookを作成してそのURLをコピーします。 パネル内のステップ2で、**「Discord Webhook・あなたのチャンネル」**を選択します。ウィットネスホスト上で、 そのURLを `discord-webhook.txt` の横に `witness.json`の横に保存してください。このURLは コレクターには決して送信されません。 ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --discord-webhook-file discord-webhook.txt ``` ウィットネスには1つのパブリッシャー(TelegramチャンネルまたはDiscordウェブフックのいずれか一方)があり、両方を兼ねることはできません。投稿 には同じ署名付きステートメントが含まれ、誰に対してもpingを送信することはできません。Discordの 2,000 文字を超える投稿は、短い行に置き換えられ、完全なチェックが `witness-check.txt` として添付されます。各投稿IDは`witness.posted` として記録されます。`verify.py --channel` はTelegramチャンネルのみを読み取るため、Discordの場合はウィットネスのジャーナルを保持してください。そこにはすべての チェックが記録されています。Discordの投稿からは、検証者に外部時刻は提供されません。 ### オプション | オプション | 環境 | デフォルト | 意味 | | --- | --- | --- | --- | | `--interval` | `TGWITNESS_WITNESS_INTERVAL` | 10 | チェック間隔(分):1~1440 | | `--timeout` | `_TIMEOUT` | 30 | コレクターおよびBot APIの応答待ち時間は数秒、5~600 | | `--post` | `_POST` | `all` | `all`:すべてのチェック;`changes`:新たな課題または問題;`problems`:問題と未回答のみ | | `--title` | `_TITLE` | `TgWitness witness` | 各チャンネルの投稿の冒頭部分 | | `--collector-fingerprint` | `_COLLECTOR_FINGERPRINT` | – | 最初の回答を鵜呑みにするのではなく、コレクターキーを固定してください | | `--proxy` | `_PROXY` | 直接 | `socks5://host:port` または `http://host:port` | | `--bot-api` | `_BOT_API` | `https://api.telegram.org` | Bot APIのアドレス(例:ローカルのBot APIサーバー) | | `--data-dir` | `_DATA` | `witness-data` | Witnessキーとジャーナル | | `--config` | `_CONFIG` | – | 上記のいずれかのオプションを含むJSONファイル | コレクターアドレス、トークン、チャンネルは以下から取得されます `--collector`, `--token` または `--token-file`, `--bot-token` または `--bot-token-file`, `--discord-webhook-file` および `--channel`、 または `_COLLECTOR`, `_TOKEN`, `_TOKEN_FILE`, `_BOT_TOKEN`, `_BOT_TOKEN_FILE`, `_DISCORD_WEBHOOK_FILE` および `_CHANNEL`、これにより、プロセス一覧から秘密情報が除外されます。 設定ファイルでは、アンダースコア付きのオプション名に加え、`texts` を使用します。これは、 チャンネルの投稿文を置き換えるものです: ``` {"collector": "https://your-collector.example.org", "token_file": "witness-token.txt", "bot_token_file": "bot-token.txt", "channel": "@your_witness_channel", "interval": 5, "timeout": 30, "post": "changes", "title": "Partner witness", "texts": {"ok": "journal head", "no_response": "no answer from the collector", "records": "records"}} ``` `texts`キー:`ok`、`key_changed`、`rollback`、`fork`、`invalid`、`no_response`、`collector`、 `records`、`head`。コマンドラインの設定が環境変数より優先され、環境変数がファイルの設定より優先されます。 未知のオプションやテキストキーは、無視されるのではなく、メッセージを表示してウィットネスを停止させます。 記述内容は検証には一切影響しません。verify.py は、すべての 投稿の最後に署名付きトークンをチェックします。`--post changes`や`problems`を使用した場合でも、投稿されなかったチェックは依然として ウィットネス・ジャーナルに残っており、`verify.py`はそれらを「未投稿」として一覧表示します。開始レコードには ポリシー名が記載されます。すべてのチェックは依然としてジャーナルに表示されるため、投稿数が少ないということは、Telegramによる日付の付与回数が 少なくなるだけであり、チェックの数が減るわけではありません。 チャンネルがなくても、Witnessは引き続きジャーナルを保持します。Witnessのキーフィンガープリント (`python -m tgwitness.witness fingerprint`)は別の場所に保管してください。 ## 複数のワークスペースの公開証明ページ `python -m tgwitness.proof` witnessesは一度に最大32のワークスペースを管理し、各ワークスペースの最新の署名済みチェック結果を 読み取り専用ページとして提供します。各ワークスペースには、dataフォルダ内に独自のwitnessキーと ジャーナル、および固定されたコレクターキーが割り当てられます。Telegramチャンネルへの投稿は、 ワークスペースごとに任意です。まずは [proof.config.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proof.config.example)から始めてください: | 分野 | 意味 | | --- | --- | | `title` | ページタイトル(1~100文字) | | `data_dir` | ファイルに関連付けられたWitnessの鍵とジャーナル。デフォルト `proof-data` | | `interval`, `timeout` | チェック間隔(分単位:1~1440、デフォルトは5);待機時間(秒単位:5~600、デフォルトは20) | | `workspaces[].id`, `label` | 短い小文字のエイリアスと表示名 | | `workspaces[].collector` | コレクターのアドレス。その他のワークスペースは「」で終わります。 `/profiles/` | | `workspaces[].collector_fingerprint` | 必須。ワークスペースごとに異なります。 | | `workspaces[].token_file` | そのワークスペースの読み取り専用ウィットネストークンを含むファイル | | `workspaces[].channel`, `bot_token_file` | オプション:各チェック結果をチャンネルに投稿する | | `workspaces[].proxy`, `bot_api` | オプションのルートおよびBot APIアドレス | ``` python -m tgwitness.proof --config proof.json --check-config python -m tgwitness.proof --config proof.json --host 127.0.0.1 --port 8790 ``` 最初のコマンドは、接続を開くことなくファイルとトークンファイルの有効性を検証します。 このページは GET および HEAD メソッドのみに応答します: - `/` すべてのワークスペースが表示されます。2.5 インターバルの間、チェックが入っていないワークスペースは「stale(古くなった)」とマークされます。 - `/api/proof` JSONと同じ内容を返します。 - `/api/proof/` 最新の署名付きステートメントをダウンロードします(`tgwitness-public-proof-v1`): ウィットネス記録番号とハッシュ、ステータス、固定されたコレクターキー、チェックポイント、収集 カウンター、およびチャンネルへの投稿が成功したかどうか。これらは、そのワークスペースのウィットネスキーによって署名されています。 - `/healthz` ワークスペースのモニターが停止すると、503エラーが返されます。 [Caddyfile.proof.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.proof.example) のように、ページに独自のホスト名を割り当ててください。検証のために、 ワークスペースのウィットネス・ジャーナルを `python -m tgwitness.witness export --data-dir proof-data/ --out witness.zip` でエクスポートし、 以下に説明する通りに使用してください。 ## 検証 証人側では、そのジャーナルをエクスポートします: ``` python -m tgwitness.witness export --out witness.zip # Docker (add -f deploy/compose/compose.witness.yaml on a witness server): docker compose exec witness python -m tgwitness.witness export --out /witness/witness.zip docker compose cp witness:/witness/witness.zip . ``` その後、どこからでも、コレクターの署名付きZIPファイルとパブリックチャンネルのアドレスを使用して: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/your_witness_channel ``` `--channel`は、Telegram Desktopからのエクスポート(*「チャット履歴をエクスポート」*→「JSON」を選択すると `result.json`が生成されます)や、ページの保存コピーも受け付けます。これらは投稿内容を検証しますが、 外部時刻は提供しません。 `verify.py`は、ウィットネスのジャーナル(チェーンと署名)を検証した後、**ウィットネスが確認したすべてのヘッドが エクスポートされたジャーナルに含まれているか**を確認します。つまり、そのカウント位置にあるレコードは、正確に そのハッシュ値を持たなければなりません。 一致しないヘッドは検証に失敗します — ジャーナルは、 ウィットネスがそれを確認した後に変更されたことになります。また、エクスポート後に確認されたヘッド、ウィットネスが 記録した異常、失敗した応答、この エクスポートに一致するチェックポイントが存在する期間(「XからYまでウィットネス済み」)、およびギャップも報告されます。それ以降のチェックポイントは、それらの期間を延長しません。 結果には、最後の一致したレコード番号と、一致するチェックポイントのない 後続のレコード数が含まれます。 エクスポート自身の鍵で署名された回答のみがカウントされます。ウィットネスが 一度も確認したことのない鍵で署名されたエクスポートは「未確認」として報告され、`--fingerprint`を指定しない限り、その 署名者は未固定のままとなります。`--channel`を指定した場合、署名されたすべての投稿はウィットネスのジャーナルと レコードごとに一致する必要があります。変更された投稿は検証に失敗し、欠落している投稿は一覧表示されます。トークンが 一致することでコンテンツの真正性が認証されますが、日付は署名されたトークンの範囲外となります。 有効な`https://t.me/s/…`または`https://telegram.me/s/…`アドレスがあれば、検証者は 検証時にページから各投稿の日付を読み取ります。 Telegramがその日付を設定します。 編集された投稿の日付は使用されません。エクスポートヘッドにおける投稿の最も早い日付は、 証拠の最小条件を満たす最後のレコードの外部 時刻となります。提供された`result.json`、保存されたページ、または他のWeb アドレスなど、その他のソースからの日付は、独立した時刻ではなく、提供されたメタデータです。結果には、その投稿 日付の出典が明記されています(`post_date_verification`)。 ### 証人付きエクスポートの境界が必要です 立会人の立会いのもとで作成された最終記録を含める必要がある引き継ぎの際は、`--require-witness`を追加してください: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness ``` これには、独立して保持されたウィットネスのフィンガープリント、 コレクターキー以外のキー、およびこのエクスポートの正確な末尾に位置する一致するチェックポイントが必要です。より早いプレフィックスのみを カバーするチェックポイントでは不十分です。収集を一時停止し、ウィットネスに 最終状態を観察させ、ジャーナルへのさらなる書き込みが行われる前にエクスポートしてください。ジャーナルが変更された場合は、別のチェックポイントを保持し、 その状態をエクスポートしてください。後のチェックポイントだけでは、より短いエクスポートの最終ハッシュを検証することはできません。 `--channel`も指定されている場合、主張された投稿の欠落や空のマッチセットがあると、この 厳格なチェックに失敗します。このフラグがない場合でも、通常の整合性チェックでは、 アーカイブ自体が破損していなければ、証人による確認を受けていないレコードを報告するだけで、アーカイブそのものは拒否されません。 ウィットネス・ジャーナルとその固定キーは別々に保管してください。オンライン検証ではチェックポイント間の連続性が確認され、 オフライン検証では保持されているすべてのチェックポイントが エクスポートデータと比較されます。連続性の証明がないレガシー・ヘッドについては、オフライン比較の結果が保持され、 オンライン連続性検証なしにレポートされます。レポートには、ウィットネスのダウンタイムおよび 間隔ごとの公開失敗が一覧表示されます。 ### デイリーシールおよび利用不可のタイムスタンプカレンダー ウィットネスは、前日のUTC時点のジャーナルの境界を封印し、 その署名付き封印のハッシュをOpenTimestampsに送信します。カレンダーへの送信は未確定の証拠であり、 独立して検証されたビットコインのコミットメントのみが、検証者において確認されます。 すべてのカレンダーが失敗した場合、署名付きシールと失敗した試行は ジャーナルに残ります。1時間ごとのメンテナンスパスは、再起動後や日付変更後を含め、 その元のレコードを再試行します。最大32個のシールをスキャンし、最大 2件の未送信データを送信し、1パスあたりの再試行に最大60秒を費やします。 永続的なカーソルが古いシールを順番に処理します。保持された送信データは、 既存のプルーフアップグレードパスに従います。 再試行を行っても、シールが書き換えられることはなく、元の日付が変更されることも、 カレンダーがそれより早く受信したと主張されることもありません。後に行われたビットコインのコミットメントは、依然として後発の外部 確認として扱われます。欠落している証明は`none`のままとなり、保留中の証明は、 検証者が独自に確認を行うまで`pending`のままとなります。 --- # Telegram · タイムスタンプ Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/timestamp/ 署名付きチェックポイントにおけるRFC 3161タイムスタンプ:認証機関に送信される内容と、応答の検証方法について。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt) 署名付きチェックポイントにおけるRFC 3161タイムスタンプ:認証機関に送信される内容と、応答の検証方法について。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [証拠と検証](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/) ![証拠と検証](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitnessは、RFC 3161リクエストを作成し、タイムスタンプ認証機関(TSA)からの応答を検証します。 この手動手順では、TSAの選択もデータの送信も行われませんが、証拠モードでは、 スケジュールに従ってその両方を実行します([証拠形式](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02))。作成されたリクエストは、 **まだタイムスタンプの証明とはなりません**。 ## 証拠が示すもの フローチャート · アカウントに関する所見 → 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..ocsp`または`.crl`として保存され、応答とともにエクスポートされます。取得に失敗しても タイムスタンプの生成は遅延しません。`anchor.completed`レコードには、その理由とともに`unavailable`として記載されます。 `verify.py`は、OCSP応答の署名(発行者によるもの、または発行者がOCSP署名目的で付与したレスポンダー証明書によるもの )、証明書ID、ステータス、および 応答がgenTime以降に発行されたか、その時点でまだ有効であったか(nextUpdate)を確認します。CRLについては、 発行者の署名、同じ時間枠、およびシリアル番号がリストにないことを確認します。 その後、`signing certificate not revoked as of