TgWitness / ドキュメント

テスト済みの内容 →

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

参考文献 / 収集

Telegram · パネルガイド

パネルのすべての画面:チャット、ジャーナル、ソース、エクスポート、エクストラ、保護モード、コードチェック。

TgWitness / ドキュメント · はじめに

はじめに

初期設定と設定 · アカウント · エクスポートと検証 · 事例レポート

各画面の機能、署名済みジャーナルへの書き込み内容、および詳細な ガイドの場所。パネルには一度に 1 つのワークスペースが表示されます。つまり、独自の ソース、ジャーナル、署名鍵を持つ 1 つの Telegram アカウントです。上部バーのアカウントセレクターで ワークスペースを切り替えます。アドレスにはワークスペース情報が含まれます(?ws=…);アドレス、 セレクター、および読み込まれたアカウントが一致しない場合、操作はブロックされたままになります。

「コレクション方法の比較」を使用して、ライブ 観測、全履歴、新規アカウント/チャットのエクスポート、保存済み記録の引き渡しの中から選択してください。 「エクスポート」ページには、ダウンロード操作ボタンの上に、上記と同じ比較表が表示されています。

このページでは

使い方のガイド#

サイドバーには、「ホーム」、「チャット」、「ジャーナル」、 「エクスポート」、「アカウント」、「設定」の 6 つの日常的なセクションがまとめられています。アクセス権限のないセクションは 省略されます。「その他のツール」には、調査および管理ツールが含まれています。 サイドバーの下部にある「外観」を開くと、言語、テーマ、 タイムゾーン、またはインターフェースレベルを変更できます:

レベル サイドバーのセクション
シンプル 日次セクション
標準 また、「その他のツール」の下にある「ケースボード」、「ソース」、「アクセス」、「ドキュメント」も同様です。
エキスパート また、「その他のツール」の下にある「システムマップ」、「ネットワークトポロジー」、「エクストラ」、「アーカイブへの質問」、「パラメータ」、「アカウント」、「システムログ」、「統合」も翻訳してください。

セクション名はすべてのレベルで同じままです。レベルはセクションを非表示にするだけです。非表示にされた機能は引き続き動作し、サーバーが すべての権限を独自にチェックします。レベル、言語、テーマ、タイムゾーンは オペレーターおよびワークスペースごとに保存されます。設定を参照してください。

サイドバー上部の「セクションへ移動」(Ctrl+K、Macの場合は⌘K)を使用して、 #number でチャット、パラメータ、またはジャーナルレコードを検索してください。矢印キーで移動し、Enter キーで開き、 Esc キーで閉じます。

上部バーには以下が含まれます:

  • 通知:ジャーナルから抽出された問題やチャットの変更事項。 すべて既読にするを選択するとカウンターがリセットされ、通知ルールをクリックするとルール設定画面が開きます。 Telegram、Discord、またはメールへの配信設定は、 [Extras] → [Notifications] で行います。
  • 開始/一時停止の制御、接続設定、および Telegram、イベント取り込み、ソース、添付ファイルキューの健全性診断を含むコレクションステータスメニュー。 画面幅が狭い場合は、アクティビティアイコンから開いてください。
  • 「ロック」:このブラウザ上のパネルを閉じます。「コレクション」はサーバー上で引き続き実行されます。

バージョンと保護モードは「外観」の下にあります。保護モードについては、そちらを参照してください。 インストールすると、サインイン後に「ホーム」が開きます。明示的なリンクをクリックすると、指定された 画面が開きます。チャット範囲のレビューアは「チャット」を開きます。アドレス /home, /case-board, /pseudo-secret および /network-topology も、それぞれ対応する画面を開きます。 未知のページアドレスに対しては、HTTP 404が返され、関連するページの候補が表示されます。

デモ用ワークスペースには架空のメッセージが含まれており、Telegramには一切接続されません。 実際のワークスペースを変更するような操作は、ここでは拒否されます。

システムマップには、このインストール環境のアカウント経路、プロキシの状態、 ソケットエンドポイント、暗号化された保管庫、証拠サービス、および観測されたネットワークリクエストが表示されます。 アカウントを選択すると、そのパスを確認できます。利用可能だが無効化されているサービスも表示されたままになります。

ここから始めましょう#

アカウントを切り替えたり、再度ログインしたりすると、概要画面ではそのアカウント固有のグラフと要約がクリアされます。 読み込み中、読み取り失敗、および保存されたレコードがない期間には、それぞれ異なる状態が設定されています。 再試行では、読み取りに失敗した操作が繰り返されます。サーバーが待機を要求した場合、 次の試行時刻が表示されます。更新に失敗した場合は、同じワークスペースについて最後に正常に取得されたデータが保持され、 最終更新時刻がラベルとして付加されます。

接続された各アカウントには、コレクターのハートビート と「最後に受信したイベント」 が別々に表示されます。前者はコレクターの稼働状況、後者は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, 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 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が応答している間にクエリやページが 変更された場合、読み込みが完了すると、新しいビューを上書きすることなく、保存済みのジャーナルが更新されます。 自動読み込みが失敗した場合は、「再試行」が表示されます。 有効になっているすべてのソースを読み込むには、「ソース」→「全履歴」を使用してください。
  • 「チャットのエクスポート」では、表示されている履歴全体を署名付きで chat.json かつ chat.htmlとしてダウンロードします。複数の連携アカウントで作業を分担できます。各アカウントは、それぞれが担当する メッセージ番号の範囲をダウンロードしてその部分を署名し、エクスポートを開始した アカウントがアーカイブ全体に署名します。「1つのチャットをエクスポートする」を参照してください。
  • 「People」には、このチャットに保存されたメッセージを持つすべてのユーザーが表示されます。ユーザープロフィールは、 第三者に関する個人情報であるため、デフォルトではオフになっています。チャットで オンになっている場合、プロフィールには名前とユーザー名の履歴、Telegramのフラグ、アバターのハッシュ、アクティビティ、 誰が誰に返信したか、その他の監視対象チャット、および言及されたウォレット、電話番号、ユーザー名 、リンクが表示されます。 すべての情報は、その記録にリンクしています。「プロフィールのエクスポート」を行うと、署名付きファイルが保存され、 オプションでパスワードZIPを設定できます。プロフィールをオフにすると、プロフィールファイルが削除されます。詳細については、「 ユーザープロフィール」を参照してください。
  • すべての著者を収集する 同じタブ上で、Telegramに対し、チャット内に保存されたメッセージを持つすべてのユーザーのプロフィール、自己紹介、プロフィール 写真、ギフト、および自己紹介リンクの取得をリクエストします。チャンネル やスーパーグループでは、接続されている他のアカウントがこの作業を分担できます。選択された各アカウントは 収集作業に専念し、ユーザー全体を処理し、その作者の保存済みメッセージのいずれかを通じて 作者にアクセスします。別のタスクで忙しいアカウントは処理対象外となり、 空き次第に参加します。 連絡が取れない著者の場合は、チャット自身のアカウントに戻ります。 進行状況には、完了率、残り時間、各アカウントの分担割合が表示されます。 一時停止 勘定科目を解放します。保存された各レコードには、それを読み込んだ勘定科目の名前が記載されており、 各勘定科目がいつ参加し、いつ離脱したかは仕訳帳に記録されます。
  • 今すぐプロフィールを保存するは、チャットやボットのプロファイル(説明、 メンバー、招待リンク、ボットコマンド)のスナップショットを記録します。

読み取り専用、送信、およびシークレット#

メッセージの上にある2つのスイッチは、アカウントと閲覧者を保護します:

  • チャットを開いたときは「読み取り専用」モードが有効になっています。 メッセージを送信したり、ボットの ボタンを押したりするには、この設定をオフにしてください。各操作を行う際、「@アカウントとして送信しますか?」または「このボットボタンを @アカウントとして押しますか?」と確認が表示されます。これは、チャットのメンバーにその操作が表示され、署名済みの ジャーナルに記録されることを示しています。「このチャットでは10分間再確認しない」を選択すると、しばらくの間、この確認が スキップされます。「ケースの証拠」という目標については、パネルおよびAPIにおいて、送信機能は無効になっています。
  • 「Mask secrets」は、パスワード、ログインコード、APIキーや ハッシュ、ボットトークン、セッション文字列、秘密鍵、JWT、またはクレジットカード番号 (カード番号はルーン和で検証されます)のように見える情報を隠します。「Show」を選択すると1つの値が表示され、その表示内容は ジャーナルに記録されます。このブラウザでのマスキングの無効化も記録されます。 表示のみが変更されます。元の記録およびすべてのエクスポートには、全文が保持されます。

選択したメッセージを画像として保存する#

クラウドチャットで、[ ] を選択します。 選択, メッセージに印をつけ、次に 画像として保存. チャット全体を記録するには、[ ] を選択してください。 チャットを画像として保存する チャットツールメニューでは、 保存されている最新の2,000件のメッセージが表示され、それより古いメッセージが除外されている場合はその旨が表示されます。 プレビューでは、 光, ダーク そして クラシック スタイル;長いキャプチャには「前へ」と「次へ」を 使用してください。 署名付きZIPファイルをダウンロード 各ページをPNG形式で保存し、さらに pages.sig.json そして README.txt (署名入りチャットの画像). 最大50件のメッセージを選択できますが、それらはすべて、読み込まれているチャット ウィンドウ内に表示されている必要があります。パネルでは、メッセージを黙って削除するのではなく、 選択範囲が大きすぎる場合は範囲を縮小するよう求められます。

各ページの末尾には、真正性ブロックが表示されます。そこには、ジャーナル記録番号、 チャット内容、レンダリング時刻、ワークスペースキーのフィンガープリント、 verify.py その ページ用のコマンド、およびチャット、キー、レンダリング時刻が記載されたQRコードが含まれます。署名を行うにはエクスポート 権限が必要であり、ジャーナルに export.image_attested 記録がジャーナルに追加されます。

画像には、保存された本文、作成者、メッセージ番号、UTC時刻、返信番号、 添付ファイルのラベル、および保存された編集・削除ステータスが含まれます。ここでは、保存された最新版の本文と 保持されているバージョン数が表示されますが、添付ファイルの内容、インラインボタン、 リアクション、および以前のバージョンの本文は表示されません。 長いメッセージは、 メッセージ番号とパート数を示して次のページに続きます。各ページには、 保存されたメッセージからレンダリングされたものであることが明記されています。PNG画像は視覚的な抜粋です。署名付きレコードや添付ファイルを 引き渡す際は、アーカイブとその検証ツールを使用してください。

レンダリングはTelegramへのリクエストを行わずにブラウザ内で行われます。署名については、 各ページのSHA-256とレコード番号のみがパネルに送信されます。既存の秘密情報マスキング機能により、テキスト、著者名、 および添付ファイルのラベルが保護されます。プレビューには閉じるまでスナップショットが表示され、パネルの ロックやワークスペース/チャットの変更時に消去されます。署名済みのジャーナルおよびレポートの選択内容は 変更されません。レポートの完全なエクスポートについては、症例報告を参照してください。

メッセージを転送する#

チャットの「読み取り専用」をオフにしてから、メッセージの下にある「転送」を選択するか、 最大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で確認してください。 エクスポートと検証を参照してください。

出典#

このワークスペースがどの会話を記録し、そこからどのような情報を保持するかを示します。変更は 今後のアクティビティに適用されますが、保存済みの記録はそのまま残ります。

「チャットリストの更新」は、アカウントのチャットとフォルダを読み込みます。メッセージはダウンロードされません。

範囲#

  • このアカウントが記録する内容 :選択されたチャット (追加したチャットのみ)、 Telegramフォルダ (アカウントのフォルダの一つ。後から追加されたチャットも 含まれる)、または記事全文 (すべてのチャット、および新しいチャット、グループ、プライベートチャット、 ボットが追加されるたびに記録)。調査モード は専用アカウント用です。このアカウントが 閲覧するすべての内容、自身のメッセージやボタン操作を記録し、新しい チャットのプロファイルや以前に表示されたメッセージを即座に保存します。 専用アカウントガイド は、 メインアカウントを決して使用してはならない理由を説明しています。
  • 「厳格:選択したチャットのみ(デフォルトではオフ)」は、Telegramのサービス通知、セッション一覧、および有効化されたチャットの過去のメッセージの読み取りを停止します。機密コンテンツの設定には影響せず、通話に関する更新情報はスキップされます。詳細は「厳格な選択チャット」を参照してください。
  • ソースタイプにより、フォルダモードおよびアカウント全体モードの対象は、チャンネル、グループ、プライベート チャット、ボットに限定されます。「自身のアクション」では、そのアカウント自身のメッセージ、編集、 返信時のキーボード入力などが追加されます。
  • 新しいチャットやボットが表示されたら、そのプロファイルと、指定した数までの 最新の表示可能なメッセージを保存します。
  • 「選択したチャット」には「おすすめ」のマークが付いています。「変更を破棄」を選択すると、フォームは 「スコープを保存」ボタンを押すまで、保存済みのスコープの状態に戻ります。

「疑似シークレット」とは、本アプリに組み込まれた「シークレットチャット」インターフェースのことで、 プロトコルモジュールをインストール後、ボタンひとつでアカウントごとに有効化できます。クラウド上の 監視機能と履歴機能は、それぞれ独自の設定を使用します。 TgWitnessが 実行されていない間は何も記録されません。再起動後は、Telegramがまだ返している情報のみを 追跡し、レポートにはその間の空白期間が表示されます。チャットリストの上限([Parameters]で変更されていない限り1,000件のダイアログ)を超えたチャットは、 次にアクティブになった時点で追加されます。別のアプリ内で押された インラインボットボタンは表示されませんが、ボットの返信は記録されます。

対象となるチャット#

ステータス(有効、一時停止、優先度、除外、未確認の アクセス、無視)やタイプでフィルタリングし、選択した項目に対して有効化、一時停止、優先度の設定または解除、 範囲からの除外、削除などの操作を行うことができます。ステータスバッジには状態のみが表示されますが、操作は 各行のメニューにあり、その機能の説明が記載されています。 一時停止や除外を行う際は、 確認が求められます(一括操作時も同様です)。ソースを削除する際はソース名の入力が求められ、関連する人物 プロフィールが削除されますが、保存された記録はジャーナルに残ります。

アカウントのチャットリストには表示されないが、記録が引き続き届いている状態を示すのは更新の受信(チャットリストには表示されない)であり、それ以外の場合はアクセス未確認です。利用可能なチャットは、選択した項目を追加または一致するすべてを追加とのチャットを追加します。

全履歴#

有効になっているすべてのソースの利用可能な履歴を、「チャット」と「ジャーナル」に読み込みます。 進行状況は再起動後も保持され、添付ファイルはメディア設定に従います。 ソース履歴を参照してください。

記録#

  • 保存する変更内容を選択してください:新しいメッセージ、編集、削除通知、 表示されているリアクション、参加および退出。プリセットを選択するとフォームが変更され、 「記録設定を保存」をクリックすると適用されます。カテゴリを再度有効にしても、 見逃したイベントは復元されません。
  • 利用可能な場合はメディアを保存します:添付ファイルは1ファイルあたりのサイズ制限内でダウンロードし、 ファイルタイプごとに1~2,000 MiBの範囲で設定し、動画の長さを秒単位で制限します(0は制限なしを意味します)。 ダウンロードの試行ごとに、その結果が記録されます。
  • 再確認:優先チャットは数分おきに、その他のチャットはめったに確認しないため、アカウントは TelegramのFloodWait制限に引っかからないようにしています。0に設定するとグループが無効になります。優先チャットは リスト内の星マークでマークしてください。1回の処理で処理するチャット数とチャット間の休止時間は 「パラメータ」で設定できます。コレクションを参照してください。
  • 「保存」バーには、これらの設定が推奨設定と一致しているかどうかが表示されます。「推奨設定に戻す」を選択すると 推奨値が入力され、「録画設定を保存」を選択すると設定が適用され、 「変更を破棄」を選択すると保存済みの設定に戻ります。

エクスポート#

「Downloads」ではファイルの準備を行い、「Build report」ではレポートの表示形式を選択します。

概要 次のような用途にご利用ください ガイド
アカウントのエクスポート そのアカウントが現在閲覧可能なコンテンツの最新スナップショット アカウントのエクスポート
コピーの共有 完成したアカウントエクスポートの簡略版 開示事項
署名済み ZIP 固定されたジャーナルの境界におけるジャーナル、レポート、添付ファイル、および検証ツール エクスポートと検証
HTML、PDF、JSON形式のレポート 封印された読み取り可能なレポート 事例レポート
JSONL、CSV 署名付きのオリジナル記録;数式が破損しないスプレッドシート エクスポートと検証
引き継ぎ要約 受信者が必要とするチャット、期間、および人物のみ 証拠
チャットのエクスポート 署名済みのチャット1件 chat.json および chat.html 1つのチャットをエクスポートする
  • 上記のダウンロードファイルをパスワードで暗号化してください(12文字以上)は、 7-ZipやWinRARで開くことができるAES-256 ZIPを保存します。中の署名付きファイルは変更されていません。 パスワードは保存されません。
  • このワークスペースのセッションキーがインポートされた際、アカウントのエクスポートおよびチャットの エクスポートダイアログには、1行でその旨が表示されます。つまり、そのキーのコピーはTelegramの セッションリストの外にも存在し得るということです。同じ行には「独立した認証を作成」というオプションがあり、 これを選択すると、そのオプションが選択された状態でサインインページが開きます。 アカウントを参照してください。
  • 失敗またはキャンセルされたチャットのエクスポートでは、保存された範囲が保持されます。「1つのチャットをキャプチャまたはエクスポート」 を選択すると、「エクスポートを再開」と「最初からやり直す」が表示されます。「 1つのチャットをエクスポート」を参照してください。
  • 「チャットのエクスポート」では、「これまでに読んだメッセージをダウンロード」を選択すると、ZIPファイルが保存されます。このファイル内の各ページは、 書き込み時に署名されています。その下の行には、署名されたメッセージの数が表示されます。
  • 準備済みのエクスポートには、2 GiB以内のファイルが最大20個と、最新の1個が保存され、 繰り返しダウンロードが可能となっています。各ファイルには、受信者が照合できるようSHA-256ハッシュ値が付与されています。各カードには、ファイルの内容が記載されています: 署名付きアーカイブ(ジャーナル全体とそのレコード数)、レポート、ジャーナルレコード、または引き継ぎ 抽出データ、案件名とID、および作成に使用されたレポートの選択項目(チャット、選択されたメッセージ、日付)です。 「表示」をクリックすると、1つのファイルに複数の種類が含まれている場合、リストが1種類に絞り込まれます。
  • ブラウザが保存ダイアログを拒否した場合、パネルは通常のダウンロードに切り替わります。
  • 署名用IDには、鍵のフィンガープリントが表示されます。「チェックポイントの保存」および 「署名済み実行レシートをダウンロード」を使用すると、コレクターの外部に保存できる記録が得られます。 「タイムスタンプリクエストの準備」は、いかなるサービスにも接続することなく、RFC 3161準拠のリクエストを生成します。

設定、アカウント、接続#

  • 設定:目標、接続、記録対象、およびインターフェース。 初期設定と設定を参照してください。
  • アカウント:各ワークスペースの状態、ソース、イベント、添付ファイルキューが表示されます。 要確認、収集、オフラインまたは一時停止中、または未接続でフィルタリングしたり、選択範囲の一時停止や再開を行ったり、アカウントファイルを一括インポートしたり、 グループを管理したりできます。アカウントを参照してください。
  • アカウント: このアカウントのサインインおよび接続経路。「ダイレクト」、WireGuard プロファイル、独自のプロキシ、パブリックMTProtoプール、またはWARP。経路を準備・確認し、 このアカウント、グループ、またはすべてのアカウントに適用します。詳細は 接続とプロキシ および プロキシ. アカウントのセキュリティ → このアカウントのセッション Telegramのセッションを一覧表示し、1つ またはすべてを終了させ、また — このワークスペースで作成されたキーの場合 — 「Telegramが許可している場合は、これを 唯一のセッションにする」、この操作は、 24 時間 Telegramが要求する24時間経過後に、設定された2段階認証パスワードを一度表示します。詳細は アカウントのセキュリティ. アカウントのセキュリティ → ウィットネス・プローブ 別のワークスペースを使用して、この セッションがリアルタイムで更新を受信していることを確認します。詳細は ウィットネス・プローブ.

一括の一時停止および再開を行うと、確認済みの選択内容は、それが 開かれたセッション内に保持されます。確認または実行が保留中の間は、コントロールは無効なままとなります。 ワークスペースを変更したり、パネルをロックしたりすると、残りのコマンドはキャンセルされます。 実行後、パネルはアカウントの状態を更新します。リクエストが失敗した場合、 サーバーがすでにそのコマンドを適用している可能性があるため、リクエストの失敗として報告されます。 コマンドは自動的に再実行されません。

追加機能#

オプション:収集を開始するには、アカウントと情報源さえあれば十分です。選択したオプションのみ の設定画面が開き、自動的に接続されることはありません。上部の「 保護レベル」カードには、保護モードが表示されます。

カード 追加機能 ガイド
ストレージとディスク容量 バックアップ、古いファイルをクラウドへ移動、削除できない証拠用コピー ストレージ
目的と保護レベル 目標と2つの尺度に対する推奨設定 以下
通知 問題点、変更されたメッセージ、日次サマリー、そして自分専用のコントロールボット 以下
証拠とバックアップ タイムスタンプ、追加のウィットネス、および暗号化されたオフサイトコピー 以下
サーバーは24時間365日稼働しています SSH 機能のないクラウドサーバーで、パネルから作成・削除が可能です。 高信頼性
独立した証人 TelegramチャンネルやDiscordに投稿される署名済みチェック ウィットネス
コードチェック 実行中のプログラムと、GitHub上の公開コミットを比較します 以下

目的と保護レベル#

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のみがこれを利用でき、会話のテキストはワークスペース内に残ります。別のアプリケーションがすでにそのコマンドを受信している場合は、別の ボットを使用してください。 通知およびオペレーターボットを参照してください。

証拠とバックアップ#

  • 独立したタイムスタンプは、各署名付きチェックポイントのSHA-256のみを、5~1,440分ごとにRFC 3161 の認証機関およびOpenTimestampsカレンダーに送信します。受信者は、 証拠として最低限、このようなサードパーティの時刻情報が必要です。Anchorは現在 パスを実行中です。タイムスタンプを参照してください。
  • さらに多くの「ウィットネス」が存在しますが、これらは選択されるまでは非アクティブ状態です。最新の drand ラウンド、Telegram の IP アドレスを含まないログイン済みデバイス一覧、および Cloudflare Gateway のサーバーの DNS クエリログなどです。オプションの記録を参照してください。
  • 暗号化バックアップでは、ジャーナル、ファイル、チェックポイント、チャットのエクスポートデータを S3互換のストレージ(Wasabi、Amazon S3、Backblaze B2、Cloudflare R2、MinIO)にコピーします。 すべてのデータはまずこのマシン上で暗号化されます。暗号化キーをダウンロードし、 別の場所に保管してください。これがないと、バックアップを読み取ることができません。ガバナンスまたはコンプライアンスモードの「オブジェクトロック」機能は、 オブジェクトが設定された日数間削除されないようにします。「オフサイトコピー」を参照してください。

コードチェック#

インストールされたプログラムが公開されているバージョンと一致するかどうかを確認します。

  1. GitHub リポジトリ(公式のリポジトリは既に入力済み)と、タグ、ブランチ、またはコミットを入力してください。
  2. 「Check now」は、このワークスペースの外部リクエスト用ルートを通じて GitHub の API に問い合わせ、 そのコミットのファイル一覧を取得します。そして、測定対象の各プログラム ファイルの git blob ID をコミットと照合します。改行コードが変換された Windows 環境でのチェックアウトでも、照合は成立します。
  3. 結果には、変更されたファイル、追加されたファイル、欠落しているファイル(それぞれ最大50件)が一覧表示され、 ジャーナル記録として保存されます。 source.checked ジャーナル記録として保存されます。

結果は、実行中のプログラムファイルに変更がない間のみ最新のものとして扱われます: 更新後は再度確認してください。トークンは不要で、パブリックリポジトリのみが対象となります; チャットや認証情報はアップロードされません。一致判定はディスク上のコードを識別するものです。これは ハードウェアによる認証ではありません。それについては、Phala Cloudを参照してください。

保護モード#

バージョン番号の横にあるスイッチャーは、選択されているモードと、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レコーダーを接続し、その署名キーを固定し、キャプチャオプションを選択し、 開始・一時停止、スナップショットの撮影、および検証済みの署名付きアーカイブのダウンロードを行います。各レコーダーには、 独自のマニュアルログイン、ルーティング、ジャーナル、およびキーがあります。両方の接続は、初期状態では無効になっています。 英語の「独立キャプチャガイド」を参照してください。

  • アーカイブに問い合わせてみましょう:保存された観察結果を検索し、出典を確認した上で、 それらをAIモデルに送信するかどうかを決定します。アーカイブ分析および ローカルでのOCRと文字起こしを参照してください。
  • パラメータ:収集の制限とペース、再確認、ダウンロード、プロファイル、 通知、エクスポート。「名前で検索」、「変更された値のみを表示」機能、および 「デフォルトを復元…」によるデフォルト設定の下書き作成。パラメータの保存を行うと、 次回使用時からその値が適用され、変更のたびにログ記録が残ります。
  • アクセス権限:レビュー担当者、アナリスト、オペレーターごとに個別のトークンが発行され、選択された ワークスペース、チャット、権限に限定されます。アクセス権限についてはこちらをご覧ください。
  • システムログ :このプロセスが起動してから行った操作(接続、プロキシの変更、 ログイン、拒否、設定の変更)を、IPアドレスを非表示にして記録します。「改行を追跡」機能により、 最新の行が常に表示されます。メッセージはジャーナルにのみ残ります。
  • 連携機能:AI プロバイダー、読み取り専用の MCP 接続、および 署名付き Webhook。
  • Case Board:証拠の横に表示される、チーム専用のメモ、ブックマーク、スライス。 Case Boardを参照。
  • ドキュメント:調査モードのドロワー。 ドキュメント化されたセッションの記録中は、メインサイドバーに移動します。
  • 「エクスポート」内のGitHub Actions capture:あなたのフォークから取得したチャットが1つ表示されています。 シールドキャプチャを参照してください。