# 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-<commit>.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サイトのシナリオでは、架空のリクエスト、メッセージ、ファイルを使用して パネルのワークフローを実演しています。これはインターフェースの例であり、プロトコルおよび取得のチェックについては、 検証レコードに日付付きの個別の結果が記載されています。
