# 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) 参照してください。
