参考文献 / セットアップ
Telegram · アカウントとセッション形式
電話番号、QRコード、または認証キーでログインし、Telethon、Pyrogram、またはTelegram Desktopのセッションをインポートして、複数のアカウントを運用できます。
TgWitnessは、Telethonを使用して、MTProto経由でTelegramのユーザーアカウント(ボットではありません)としてログインします。 各アカウントは、独自のワークスペース(APIおよびコマンドラインツールでは「ワークスペース」と呼ばれます)内に存在し、 独自のセッション、ソース、ジャーナル、および署名鍵を持っています。
セッションファイル、セッション文字列、および認証キーはアカウントの認証情報です。これらを 所持している者は誰でも、そのアカウントとして行動することができます。これらにはメッセージ履歴は含まれていません。
[!警告] 専用のアカウントを使用してください。Telegramは、クライアントや目的を問わず、 過剰とみなされるリクエスト量に対してアカウントを制限し、永久に利用停止にする可能性があり、 それらの制限については一部しか公開されていません。個人用やその他の重要なアカウントではなく、 観測用に用意されたアカウントを接続し、専用の アカウントでAPI ID / APIハッシュを作成してください。
- 概要
- ご利用開始前に:API ID および API ハッシュ
- 電話番号 · QRコード · 認証キー + DC ID
- アカウントファイル: Telethon .session · Pyrogram .session · セッションとJSONのペア · TData · StringSession · 認証キーとDCを1行にまとめる · アカウントのJSON
- お手持ちのものを特定する · サポートされていない形式
- 複数のアカウント · アカウントファイルの安全な保管 · トラブルシューティング
概要#
| 現在お持ちのもの | 「アカウントの追加」タブ | また、以下も必要となります |
|---|---|---|
| 電話番号およびログインコードへのアクセス | 電話 | 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 カタログから決定論的なデバイス/OS ペアを使用します:
デスクトップ 2040、Android 6、Android X 21724、iOS 10840、macOS 2834、および Web 2496。
Android のソースビルド ID 4 も、
Telegram Android の BuildVars で特定される通り、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 アルゴリズム
(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が発生すると、それ以降のリクエストは停止され、結果が欠落している場合は「不明」のままとなります。
ネットワークチェックがスキップされていても、ローカルチェックは結果を報告できます。
「厳格なチャット選択」が有効になっている場合、現在の
認証情報は要求されず、そのチェックは「スキップ」として表示されます。
ログイン後、および新しい接続が行われるたびに、TgWitnessはそのアカウントの「センシティブ
コンテンツ」設定を読み取ります。 この設定がオフになっており、Telegramが変更を許可している場合、TgWitnessは設定をオンに切り替えます。
これにより、Telegramがセンシティブ(18+)とマークしたコンテンツが保存され、
account.content_settingsが記録されます。この設定はアカウントに紐づいており、すべての
Telegramアプリに適用されます。「厳格なチャット選択」が有効な場合は設定が変更されません。ログイン前にその設定をオンにしてください。
1つのワークスペースへの接続を復元する同時リクエストは、そのワークスペースのクライアントを共有し、 接続の確立が完了するのを待ちます。リクエストが失敗またはキャンセルされた場合、 次のリクエストが再試行できるようになります。接続の確立中に、保存された認証情報、クライアント、または認証状態が 変更された場合、以前のリクエストは「接続準備完了」と報告するのではなく、停止します。
FloodWaitの診断情報には、失敗したTLメソッド、Takeout/rangeラッパー、
サーバーが要求した待機時間、およびtelegram.backoff内の有効期限が保持されます。
接続の詳細には、リクエストが一時停止している間のメソッドと有効期限が表示されます。
この診断情報には、そのクライアントが
作成されてからのメソッドごとのクライアント呼び出しカウンターが含まれます。これらはネストされたピア解決を個別にカウントしますが、パケット
やTelethonの内部リトライ試行はカウントしません。現在のカウンターは、ステータスAPIの
collector.rpc_activityとしても利用可能です。 リクエスト引数、ユーザー名、アクセス
ハッシュ、例外テキストは含まれません。最後の診断情報と完全な期限は
再起動後も保持されます。メソッドレコードのない以前の待機は、
遡って特定することはできません。ソースレビューのエクスポート制限および
ディスカバリーと履歴取得の違いについては、そちらを参照してください。
official_app=TrueまたはFalseは、Telegramの現在の認証フラグです。いずれの
値も、アカウントが制限されているか、信頼されているか、あるいは監視下にあるかを決定するものではありません。
既存の証拠モードのaccount.devicesスナップショットは、引き続きすべての
ログイン済みデバイスの履歴として残ります。接続診断情報には、現在のデバイスの説明のみが保持されます。
接続前に、アドバイザリチェックにより、APIプラットフォーム、言語パック、 デバイス/OSおよびアプリバージョンの形式、モバイルシステムのロケール、ならびにTelethonの実際の スキーマ層が、審査済みのカタログベースラインと照合されます。警告はサーバー ログおよびアカウントステータスのメタデータに表示されますが、インポートされた値を置き換えたり、 スキーマ層を変更したりすることは決してありません。異なる層が検出された場合は互換性を確認するシグナルとなり、アカウントの 独自の接続ステータスによって正常に機能しているかどうかが示されます。 Telegramは、どのクライアントプロファイルが使用されていても、 自社側で制限を決定します。接続が切断されたアカウントのステータスでは、 別のデバイス記述を生成する代わりに、保存されたプロファイルが使用されます。
代わりに独自のアプリケーションを使用するには:
- my.telegram.org を開き、ご自身が所有する任意の電話番号でログインしてください。 認証コードはSMSではなく、Telegramアプリに届きます。
- API開発ツールをお選びください。
- アプリケーションを作成します:タイトルと短縮名(5~32文字)を任意で指定し、プラットフォームは「デスクトップ」を選択してください。 URLと説明は空欄のままでも構いません。
- 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にプロキシ経由で接続する必要がある場合は、まず「 その他のツール」→「アカウント」→「設定」→「接続設定」→「接続経路の変更」で設定を行ってください。
電話番号#
- [その他のツール] → [アカウント] → [電話番号] タブを開き、国際形式で番号を入力してください。
例:
+44 7700 900123。スペースやハイフンは自動的に削除されます。 - 「続行」をクリックしてください。API ID およびハッシュは空欄のままでも構いません。
- Telegramが送信するコードを入力してください。通常はTelegramアプリ宛てですが、SMSを送信するかどうかはTelegramが決定します。
- アカウントに二段階認証が設定されている場合は、そのパスワードを入力してください。これはパネル トークンでも、デバイスのパスコードでもありません。
- ログイン後に表示されるアカウントIDを確認し、ソースを選択してください。
ログインコードおよび2段階認証(2FA)のパスワードは、ディスクに書き込まれることはありません。
QRコード#
この機能は、アカウントがすでにスマートフォンや別のコンピュータでログインされている場合に使用してください。
- 「QRコード」タブ → QRコードを表示します。API ID および ハッシュは空欄のままでも構いません。
- ログイン済みのデバイスで:[設定] → [デバイス] → [デスクトップデバイスをリンク] を選択し、コードをスキャンして 確認してください。
- Telegramから要求があった場合は、TgWitnessに2FAパスワードを入力してください。
QRコード画像はローカルで生成されます。コードには有効期限があります。「別のQRコードを生成」 を押して、再試行してください。パネルをロックしたり、ワークスペースを切り替えたり、別のログインを開始したりすると、 生成中のコードはキャンセルされます。
認証キー + DC ID#
認証キー(Auth Key)とは、すべてのTelegramセッションの基盤となる256バイトの認証情報であり、 512文字の16進数で表記され、データセンター番号DC 1~5が併記されています。
- 「Auth key」タブ。キーをすべて貼り付けてください。「
…」を含む短縮されたキーでは機能しません。 - キーとともに提供されたDC IDを選択してください。
- 必要に応じてユーザーIDを入力してください。Telegramが 異なるアカウントであると報告した場合、TgWitnessは接続を拒否します。
- Press Connectアカウント。
認証キー(512文字)は、APIハッシュ(32文字)とは異なります。同じキーは JSON形式でもインポート可能です。「アカウントJSON」をご参照ください。
アカウントファイル#
「アカウントを追加」→「ファイル」を開き、1つのアカウントに属するファイルを最大4つ(合計8 MiB)選択して、「ファイルを確認」を押してから、「アカウントを接続」を押してください。ファイルを選択したり、 セッションのテキストを貼り付けたりしても、何も送信されません。「ファイルを確認」を押すと、ファイルがTgWitnessサーバーに送信され、 サーバーはログインせずにファイルを読み取り、見つかったセッションを表示します。
「ファイル」、「認証キー」、および「一括インポート」フォームでは、接続前に並行セッションに関する警告が表示されます。 デフォルトでは、インポートされた認証情報は再利用されます。ここでそのキーが使用されている間は、元の クライアントを閉じたままにしてください。「ファイル」および「認証キー」では、 後述する「独立した認証情報の作成」も利用可能です。一括インポートでは引き続き ダイレクトモードが使用されます。電話および対話型QRログインでは、個別の認証情報が作成されます。 インポートフォームでは警告の見出しが常に表示されたままですが、ファイルやキー/セッション文字列が指定されると、 その詳細説明が自動的に展開されます。読み終えた後は折りたたむことが できるため、スマートフォン上でもファイルピッカーや接続操作をそのまま利用できます。
検証済みのデプロイメント(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 エラーデータベース 関連付け
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:<n>:<token>をグループに送信し、
probe.sentを記録します。ウィットネスはack:<n>:<token>で応答し、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」を参照してください。
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」に関するドキュメントをご参照ください。
- Telegram Desktopを完全に終了してください。
-
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>:<DC id> のような生の認証情報が記載されています。
例えば、a1b2…ef:5 などです。その行を「パスコード」または「セッションテキスト」の下に貼り付け、
テキストファイルとして読み込むか、アカウント 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>:<DC id>。ファイル名ではありません。 |
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 id>形式の認証キー
および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つの ワークスペースに割り当てることはできません。
- メインパネルのトークンにより、すべてのワークスペースを管理します。付与されたアクセス権限により、他のユーザーを特定のアカウントやチャットに限定し、個別の権限やセッション制限を設定することができます。
- アカウントはワークスペースの名前を変更したり、追加されたワークスペースを、そのセッション、ジャーナル、 ソース、および署名鍵とともに削除したりします。メインのワークスペースはパネルから削除することはできません。
一括インポートとアカウントグループ#
「アカウント」→「アカウントのインポート」を使用して複数のアカウントを追加し、ベース名でファイルを紐付け、 各ログイン結果を確認できます。各アカウントには独自のワークスペースが割り当てられます。
グループは、関連するアカウントをまとめて管理しますが、セッション、鍵、
証拠は統合されません。「Accounts」の「グループ」を開くと、そのページが表示されます。 /groups/<id>:
- アカウント:各メンバーの接続経路、観察内容、最後のメッセージが表示され、 「すべて開始」および「すべて一時停止」の機能があります。
- 要確認:ログアウトされたアカウント、利用できないアカウント、または 接続、取り込み、ソース、メディアに問題があるアカウント。各名称をクリックすると、そのカードが表示されます。
- 複数のアカウントが閲覧できるチャットには、 共有ソース、それらを閲覧しているアカウント、および 利用可能なワークスペースの閲覧期間(最大7日間)における中断が表示されます。N個のアカウントでのエクスポートでは 、チャンネルまたはスーパーグループのエクスポートが各アカウントに分割され、1つのアーカイブに署名されます。
- グループのエクスポート:各アカウントの署名付きエクスポートが以下に格納された1つのZIP
accounts/、manifest.json各アカウントのSHA-256およびキーのフィンガープリントを列挙し、メイン ワークスペースによってmanifest.signature.json。各アカウントのアーカイブは、python -m tgwitness.verifyおよびそのアカウントの信頼済みフィンガープリントを使用して、各アカウントのアーカイブを個別に検証してください。
メンバーはグループの設定を共有しますが、各アカウントは独自の設定値を保持することもできます。 共有設定、 インポートおよびグループのガイド、 ならびにMTProxyプールダッシュボードをご覧ください。
ログアウト#
その他のツール → アカウント → 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には複数のアカウントがありました。「サポートされていない形式」をご覧ください。 |
| 選択されたファイルには、さまざまなアカウントやAPI認証情報が記載されています。 | 1つのアカウントのファイルのみを選択してください。 |
| JSONには、サポートされているAPIの認証情報や承認情報が含まれていません | アカウントのJSON内のフィールド名をご確認ください。 |
| APIメタデータのみ | このJSONにはセッションが含まれていません。「.session」ファイルを追加するか、電話番号またはQRコードをご利用ください。 |
| Auth Key HEXには、512文字の16進数文字すべてが含まれている必要があります | キーが切り詰められているか、…が含まれています。 |
| アカウントIDがインポートされたアカウントと一致しません | このファイルのユーザーIDは、Telegramが報告しているものとは異なります。このファイルは別のアカウントのものです。 |
| このアカウントはすでに別のワークスペースに属しています | アカウントを2回追加するのではなく、そのワークスペースを開いてください。 |
| 関連していますが、「その他のツール」→「ソース」のチャットリストにプライベートグループが表示されていません。 | メンバーシップを確認してください。ピッカーは最初の1,000件のダイアログを検査します。「その他のツール」→「パラメータ」で上限を引き上げてください。 |
| プロキシ接続に失敗しました | ルートとIPモードを確認してください。自動MTProxyは、動作する別のエントリを試行します。「アドレスを非表示」は待機状態となり、「Direct」は最後の手段として、設定された遅延時間の後に直接接続を試みます。ルーティングモードを参照してください。 |