アカウントとセッション形式

TgWitnessは、Telethonを使用して、MTProto経由でTelegramのユーザーアカウント（ボットではありません）としてログインします。 各アカウントは、独自のワークスペース（APIおよびコマンドラインツールでは「ワークスペース」と呼ばれます）内に存在し、 独自のセッション、ソース、ジャーナル、および署名鍵を持っています。

セッションファイル、セッション文字列、および認証キーはアカウントの認証情報です。これらを 所持している者は誰でも、そのアカウントとして行動することができます。これらにはメッセージ履歴は含まれていません。

[!警告] 失っても構わないもの以外は使用しないでください。個人用やその他の重要なアカウントを接続すること、および 大切なアカウントでAPI IDやAPIハッシュを作成することは、 強くお勧めしません。 これは、TgWitnessが未検証であるということではありません。Telegramは、 クライアントや目的を問わず、同サービスが「過剰」とみなすリクエスト量に対して、 予測不能な形でアカウントを制限・永久停止しており、適切なドキュメントも提供されていません。多くの停止措置は 取り消すことができません。 専用のアカウントをご利用ください。テストが円滑に進むかどうかは、ソフトウェアではなく Telegram次第であり、今後の動作については一切保証されません。

• 概要
• ご利用開始前に：API ID および API ハッシュ
• 電話番号 · QRコード · 認証キー + DC ID
• アカウントファイル: Telethon .session · Pyrogram .session · セッションとJSONのペア · TData · StringSession · アカウントのJSON
• お手持ちのものを特定する · サポートされていない形式
• 複数のアカウント · アカウントファイルの安全な保管 · トラブルシューティング

概要#

TgWitnessは、ファイル名ではなく内容によってファイルを識別します。ファイル名を変更しても、 そのファイルが変換されることはありません。

ご利用開始前に：API ID および API ハッシュ#

Telegram APIアプリケーションを作成しなくてもログインできます。ペアが入力されていない場合、 インポートされていない場合、またはワークスペースにすでに保存されていない場合、TgWitnessは組み込みの 50組の公開APIペア（tgwitness/api_pool.py）のプールからランダムな順序でペアを選択します。 Telegramがペアを拒否した場合 （API_ID_INVALID、API_ID_PUBLISHED_FLOOD、UPDATE_APP_TO_LOGIN）、次のペアが試され、 1回のサインインにつき最大8つまで試行されます。拒否されたペアは、再起動されるまでスキップされます。サインインに使用されたペアは アカウントとともに保存され、そのアカウントで再利用されます。API IDとAPIハッシュは、Telegramに対してアプリケーションを識別するものであり、 それ自体ではアカウントの認証を行いません。

代わりに独自のアプリケーションを使用する場合（登録したアカウントがリスクにさらされます。「 なぜ組み込みのAPIプールなのか？」をご参照ください）：

1. 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種類の認証情報が関係しています：

Telegramにプロキシ経由で接続する必要がある場合は、まず「 アカウント」 →「設定」→「接続設定」→「接続経路の変更」で設定を行ってください。

電話番号#

1. 「アカウントを開設」を選択し、「電話」タブで、国際形式の番号を入力してください。 例：+44 7700 900123。スペースやハイフンは自動的に削除されます。
2. 「続行」をクリックしてください。API ID およびハッシュは空欄のままでも構いません。
3. Telegramから送信されるコードを入力してください（通常はTelegramアプリ宛てですが、SMSでの受信は保証されません）。
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」をご参照ください。

アカウントファイル#

「アカウントを追加」→「ファイル」を開き、1つのアカウントに属するファイルを最大4つ（合計8 MiBまで）選択し、「アカウントを接続」を押してください。

• ファイルは、TgWitnessサーバー上のメモリ内で変換されます。アップロードされたデータは保存されず、 ZIPファイルはディスクに解凍されず、外部サービスへの接続も行われません。
• 生成されたセッションは、その後Telegramで照合されます。ファイルにユーザーIDが記載されている場合、 そのIDはTelegramが報告するアカウントと一致している必要があります。
• 異なるアカウントや異なるAPI認証情報を記述したファイルは、 いずれか1つを選択する代わりに、拒否されます。
• 「パスコード」または「セッションテキスト」には、TDataのローカルパスコードフィールドがあり、ここに StringSessionを貼り付けたり、ログインせずにファイルを読み込んだりすることができます（Telegramに 接続することなくフォームに入力できます）。

Telethon .session#

まず、そのファイルを作成したプログラムを閉じてください。その隣に「my_account.session-journal」または 「my_account.session-wal」が存在する場合、データベースは確定されていません。元のクライアントを 適切に開いてから閉じてください。これらのサイドカーファイルを削除すると、破損したコピーが残ってしまう可能性があります。

Pyrogram .session#

保存されたユーザーIDは、ログイン時にTelegramと照合されます。

セッションとJSONのペア#

アカウントは、多くの場合、 447700900123.sessionや447700900123.jsonのように、同じ名前の2つのファイルとして配布されます。両方を一度に選択してください。

• JSONから、TgWitnessはapp_id/api_idおよびapp_hash/api_hashを使用するため、 通常、APIの認証情報を入力する必要はありません。
• phone、device、sdk、app_version、lang_pack、または保存済みの twoFAパスワードなどの他のフィールドは無視されます。アカウントに2FAが設定されている場合、TgWitnessは2FAの入力を求めます。
• JSONファイル単体では、単なるメタデータに過ぎません。セッションファイルがない場合は、携帯電話 またはQRコードによるログインを続行してください。

Telegram Desktop (TData)#

TDataとは、Telegram Desktopアプリケーション（desktop.telegram.orgから入手できるクロスプラットフォーム アプリ）のtdataフォルダのことです。

インポートするには：

並行セッションに関する警告です。TDataをインポートすると、Telegram Desktopの認証 キーが再利用されます。独立したログインが作成されるわけではありません。そのキーをDesktopと TgWitnessで同時に使用しないでください。TelegramはAUTH_KEY_DUPLICATEDを使用して認証を無効化することがあり、 その場合、新しいログインを行うまで両方のコピーが使用できなくなります。

デスクトップ版を、トレイプロセスを含めて完全に終了し、 TgWitnessがインポートされたセッションを使用している間は、そのインスタンスを閉じたままにしておいてください。 終了してください。ログアウトしたり、セッションを取り消したりしないでください。 セッションの取り消しは、インポートされたコピーも無効にしてしまいます。両方のクライアントを実行する必要がある場合は、 携帯電話またはQRコードでTgWitnessにサインインし、独自の認証を作成してください。専用の アカウントの使用をお勧めしますが、クローンされたキーを並行して使用しても安全であるとは限りません。

これは、インポートされた.sessionファイル、StringSessionテキスト、およびAuth Key HEXにも適用されます。 独自に作成された認証情報を持つ他のクライアントは、ログイン状態を維持できます。 Telegramの「AUTH_KEY_DUPLICATED」に関するドキュメントをご参照ください。

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の 文字列は異なる形式を使用しています。

アカウントのJSON#

.json で終わるファイル内に、最大 64 KiB の JSON オブジェクトが 1 つ含まれています。

別名と本名の両方が記載されている場合は、それらが一致している必要があります。例：

{ "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配列）は受け付けられません。

お手持ちのものを特定する#

サポートされていない形式#

複数のアカウント#

アカウント選択ボタンの横にある「+」を押すか、 「アカウント」→「設定」→「接続設定」→「ワークスペース」を開き、ラベルを入力して サインインしてください。

• メインワークスペースを含め、ワークスペースの数に制限はありません。各ワークスペースには、独自のセッション、プロキシ ルート、情報源、キャプチャポリシー、ジャーナル、署名鍵、チェックポイント、およびエクスポート設定があります。
• 表示されているワークスペースを切り替えても、他のワークスペースは一時停止されません。
• ジャーナルは、それを作成したアカウントに紐付けられたままとなります。別の アカウントでログインするには別のワークスペースが必要となり、1つのアカウントを2つの ワークスペースに割り当てることはできません。
• メインパネルのトークンにより、すべてのワークスペースを管理します。付与されたアクセス権限により、他のユーザーを特定のアカウントやチャットに限定し、個別の権限やセッション制限を設定することができます。
• アカウントはワークスペースの名前を変更したり、追加されたワークスペースを、そのセッション、ジャーナル、 ソース、および署名鍵とともに削除したりします。メインのワークスペースはパネルから削除することはできません。

一括インポートとアカウントグループ#

アカウント → アカウントのインポート で複数のアカウントを追加し、拡張子を除く名前でファイルを組み合わせ、各ログインの結果を確認できます。各アカウントには独立したワークスペースがあります。グループはセッション、鍵、証拠を統合せずに、テンプレートから選択した設定をコピーできます。インポートとグループのガイドとMTProxy プールのダッシュボードをご覧ください。

ログアウト#

「アカウント」→「Telegramからログアウト（監視を一時停止）」を選択すると、Telegramにセッションの終了が要求されます。 これにより、アカウントの「設定」→「デバイス」からもそのセッションが消え、ワークスペースの保管庫からも セッションが削除されます。ジャーナル、ソース、設定、および署名鍵は残され、 ジャーナルにはログアウトの記録が残ります。 ワークスペースは引き続きそのアカウントに属しており、 そのアカウントのみが再度接続できます。Telegramから応答がない場合でも、セッションは ここから削除され、パネルにその旨が表示されます。Telegramの「設定」→「デバイス」からセッションを終了してください。

テレソンセッションをオフラインで変換する#

このパネルは、.sessionファイルを直接インポートします。オフラインで StringSessionファイルに変換するには、プロジェクトフォルダから以下のコマンドを実行してください：

.venv\Scripts\python.exe -m tgwitness.sessions account.session --out account.tgwitness-session   # Windows

.venv/bin/python -m tgwitness.sessions account.session --out account.tgwitness-session          # Linux/macOS

このコンバーターは、Telethon SQLite のみ（最大 64 MiB）を読み込み、入力データを一切変更せず、 ネットワークリクエストも行わず、既存の出力ファイルの上書きも拒否します。

アカウントファイルの安全な保管#

• .session、TData ZIP、StringSession、認証キー、およびアカウントのJSONはすべて、 パスワードと同様に扱ってください。TgWitnessは、インポートされた認証情報を暗号化された保管庫に保存します。そのため、 その後、元のファイルを削除しても問題ありません。
• 同じ認証情報を2つのプログラムで同時に実行しないでください。Telegramによって認証情報が無効化される可能性があります （AUTH_KEY_DUPLICATED）、その結果、両方のプログラムが動作しなくなります。
• 有効期限が切れた、または取り消されたセッションは、変換によって復活させることはできません。再度ログインしてください。

トラブルシューティング#

関連項目：プロキシおよび暗号化に関する接続とセキュリティ、 およびログイン後に収集されるデータの収集方法について。