参考文献 / セットアップ
Telegram · アクセスと権限
アカウントやチャットへのアクセス範囲を限定し、権限を選択し、セッションやIPアドレスを制限し、アクセス権を取り消すことができます。
レビュー担当者には1つのチャットへのアクセス権を、アナリストには案件のエクスポート権限を、 オペレーターには選択したアカウントの管理権限を付与します。各ユーザーには独自のトークンが割り当てられます。メイン パネルのトークンは管理者が保持します。
2つの適用範囲、2つの異なる役割#
収集範囲によって、アカウントが記録する対象(選択したチャット、Telegramの フォルダ、またはアカウント全体)が決まります。アクセス範囲によって、記録された アカウントやチャットのうち、他のユーザーが閲覧・利用できるものが決まります。アクセス権を付与しても、 Telegramのチャットに参加したり、収集を開始したり、Telegramアカウントの権限が付与されたりすることはありません。
アクセス権限では、選択したワークスペース、その中の選択したチャット、すべての ワークスペース、 またはアカウントグループ内のすべてのアカウントを開くことができます。「すべてのワークスペース」には、 後から追加されたワークスペースも含み、将来追加されるアカウントも対象となります。グループへのアクセス権も、 そのグループに後から追加されるアカウントを対象とします。ケースを特定のワークスペースに限定したい場合は、 そのワークスペースを明示的に選択してください。
アクセス権を付与する#
- メイン管理者としてサインインし、「その他のツール」→「アクセス」を開いてください。
- 「アクセス権を付与する」の項目で、ログ上で識別できる名前を入力してください。
- ワークスペースを選択し、必要に応じて個々のチャットを選択してください。
- この人物が実行しうる行動を選択してください。「表示」は常に含まれます。
- 必要に応じて、有効期限、ログイン/セッション制限、および許可されるアドレスを設定してください。
- 「アクセスを作成」をクリックしてください。トークンを今すぐコピーしてください。トークンは一度しか表示されません。
- パネルアドレスとトークンを非公開で送信してください。受信者は、通常のサインインページでそのトークンを入力します。 あなたのメインパネルトークンやTelegramのセッションは必要ありません。
発行されたトークンが表示されたパネルを別のブラウザセッションで開き、 表示されているチャットや許可されている操作を確認してから、相手にお渡しください。
アクセス名は暗号化されたローカルストレージに保持され、管理者パネルによって解決されます。 新しいアクセスおよびワークスペース作成の監査記録からは名前が省略されますが、既存の署名付き記録は元のフィールドを維持します。
権限を選択してください#
テキストのみの公開デモを行う場合は、通常の レビュアーアクセスではなく、「公開ショーケース」を使用してください。これにより、明示的に選択された公開チャンネル、保持された編集および 削除履歴、署名付き統計情報が表示され、作成者フィールドは伏せられ、ファイルは API境界で閉じられます。ショーケースを作成して検証してください。
| 利用許諾 | 本ツールの機能 |
|---|---|
view |
閲覧可能なチャット、キャプチャされたメッセージ、プロフィール、ファイル、およびフィルタリングされたジャーナル記録をご確認いただけます。これらは常に含まれています。 |
export |
許可されたチャット履歴および資料をエクスポートできます。ワークスペース全体の証拠データをエクスポートするには、そのワークスペース全体へのアクセス権が必要です。 |
sources |
ソース、スナップショット、プロファイルの取得を管理します。チャット限定のアクセス権限では、許可されたチャットに対してのみ操作が可能であり、アカウント全体のソース検出およびスコープ設定は非公開のままとなります。 |
collect |
コレクターの起動または停止を行います。収集操作はアカウントに影響を与えるため、ワークスペース全体へのアクセス権が必要です。 |
interact |
アクセス範囲内で、サポートされているTelegramの操作を行ってください。「チャット限定」のアクセス権限では、アカウント全体のリンクプレビュー機能はご利用いただけません。 |
settings |
収集設定、タイムスタンプ、通知、オフサイトコピー、およびパラメータを変更できます。ワークスペース全体へのアクセス権が必要です。 |
account |
Telegramへのログインおよびログアウト、接続経路の管理が可能です。ワークスペース全体へのアクセス権が必要です。 |
board.read |
ケースボードのメモは、許可されたワークスペースおよびチャット内でのみ閲覧してください。 |
board.write |
ブックマーク、ハイライト、スライス、コメント、および「開く」「レビュー」ステータスを追加できます。また、board.read も必要です。 |
board.manage |
コレクション、チームの最終ステータス、および他の参加者のカードを管理します。また、ボードへの読み書き権限も必要です。 |
オフサイトレプリカの復旧キーをダウンロードできるのは、メイン管理者だけです。
settingsまたはaccountへのアクセス権限を委任しても、そのキーは付与されません。
権限と適用範囲は同時に確認されます。権限にチェックを入れても、 チャット限定のアクセス権の場合、他のチャットが開かれたり、ワークスペース全体での操作が可能になったりすることはありません。 並行してエクスポートを行う場合、アクセス権限は、選択されたすべての アカウントにおいて、エクスポート対象のチャットをカバーしている必要があります。付与されたアクセス権限では、新しいアクセス権限の作成、他者の セッションの管理、または管理者コンソールの起動は行えません。
3つの便利な設定方法#
| 人物 | 範囲 | 権限 |
|---|---|---|
| レビュー担当者 | ある事例の記録されたチャット | view |
| 引き継ぎの準備を行うアナリスト | 調査およびエクスポート対象のチャット | view、export;Telegramを通じて対応する必要がある場合にのみ、interactを追加してください。 |
| 収集オペレーター | 選択されたワークスペース全体 | view、sources、collect。settingsまたはaccountは、必要な場合にのみ追加してください。 |
「Access」フォームの初期プリセットには、「Case Board」も含まれています。レビュー担当者は閲覧のみ、アナリストは閲覧および書き込みが可能、 オペレーターは管理が可能です。プリセットは編集可能であり、既存の権限は 自動的に拡張されることはありません。継承されるチャット範囲およびエクスポート時のプライバシーについては、「Case Board」を参照してください。
制限とセッション#
| 設定 | 仕組み |
|---|---|
| 並行セッション | 同時接続セッション数を1~100に制限します。上限に達した場合は、次のログインを拒否するか、最も古いセッションを終了します。 |
| ログインが可能です | トークンを使用してセッションを開始できる回数を制限します。許可された最後のログインが使用されたからといって、既存のセッションが終了することはありません。 |
| 有効期限: | アクセス権には絶対的な有効期限が設定されています。有効期限が切れたアクセス権では、ログインやリクエストの継続はできません。 |
| 一定時間操作がない場合の記録 | セッションの非アクティブ状態によるタイムアウトは、5分から30日まで設定可能です。リクエストが成功するとタイムアウト時間が延長されます。また、開いているパネルはポーリングを行うことで、アクティブ状態を維持することができます。 |
| 許可されたアドレス | 特定のIPアドレスまたはCIDRサブネットを受け入れます。「first-sign-in binding」が有効になっていない限り、空欄のままにするとすべてのアドレスを受け入れます。 |
| 初回ログイン時に紐付ける | 初回ログインに成功すると、そのアクセスに対する許可済みアドレスが確定します。 |
IPアドレスとは、アプリケーションから認識されるクライアントのアドレスを指します。リバースプロキシや トンネルの背後にある場合は、IPルールに依存する前に「開いているセッション」に表示されるアドレスを確認してください。 そうしないと、複数のユーザーがプロキシのアドレスを共有しているように見える可能性があります。
アクセスの変更または取り消し#
「アクセス許可」の下にあるエントリを編集して、その適用範囲、権限、または制限を変更します。 適用範囲および権限の変更は、その後のリクエスト( すでに開かれているセッションからのリクエストを含む)で反映されます。アクセス権を取り消すと、そのセッションは終了し、 発行されたトークンは使用できなくなります。また、開いているセッションについては、管理者が アクセス権全体を取り消すことなく、個々のセッションを終了させることもできます。
保存されたエクスポートコピーには、作成者、ワークスペース、チャット範囲、および必要な権限が保持されます。
付与されたアクセス権は、その権限が有効である間のみ、自身のコピーを一覧表示またはダウンロードできます。
ケースボードを含むコピーには、さらに board.readが必要です。管理者はすべてのコピーを取得できます。
このメタデータやグループバンドルを含まない古いコピーは、管理者のみがアクセス可能です。ダウンロードチケット
および準備済みのファイル応答は、ファイルの準備完了後、データを送信する前にアクセス権限を再確認します。
管理者を含め、各アクセス権限はワークスペースごとに10件の保留中のダウンロードチケットを保持できます;
ワークスペース全体の上限は1,000件です。チケットは120秒後に失効し、1回限りの使用となります。
アクセス権の取り消しを行っても、すでに誰かがダウンロードしたファイルを復元することはできません。ログアウト、 パネルのロック、またはセッションの終了を行っても、実行中のコレクターは停止しません。
管理者が確認できる内容#
レビュー担当者およびアナリストには、プロキシエンドポイント、
プール診断情報、サーバーパス、または生の接続エラーを含まない収集進捗情報が提供されます。接続診断には、
ワークスペース全体に対するaccount権限が必要です。通知の閲覧、
オフサイトコピー、およびパラメータ設定には、settings権限が必要です。
ブラウザ上の完全なUser-Agent文字列は、アクセスセッションには保持されません。アップグレード を行うと、変更可能なセッションキャッシュからもこれらが削除されます。パネルプロセスのログでは、 IPリテラル、URLの認証情報、およびラベル付き秘密情報がマスクされます。ローカルサービスのログや 以前に署名されたジャーナルレコードは書き換えられません。アクセスルールおよび署名済み サインインレコードでは、引き続きクライアントアドレスが使用されます。
メインキーを置き換える#
[その他のツール] → [アクセス] → [マイリミット] → [管理者キーの再発行] を使用するか、パネルが実行中の状態で管理対象のインストール環境から
tgwitness token rotate を実行してください。
同僚トークンで開かれたセッションを含め、既存のすべてのブラウザセッションが終了します。
リクエストを行ったブラウザには新しいセッションが割り当てられます。新しい管理者キーは、非表示にする前に保存してください。
発行済みの同僚トークンは、別途取り消されるまで有効です。
TGWITNESS_TOKEN を使用しているインストール環境では、その環境設定を変更し、再起動する必要があります。
リクエストとプロキシの境界#
このAPIでは、クライアントおよび認証情報ファミリー(
panel、archive/MCP、witness)ごとに、1分あたり最大600件のリクエストが許可されます。認証のクールダウン時間は、これらのファミリーごとに個別に設定されます。
1分間に10回の認証拒否があると、1秒から
最大5分までの指数関数的なクールダウンが開始されます。クールダウン期間中に認証に失敗すると、クールダウン時間が延長されます。10分間
認証に失敗しなければ、延長されたクールダウン時間はリセットされます。認証拒否時にはHTTP 429が返され、
Retry-Afterが返されます。制限はメモリ内にあり、1つのpanelプロセス内のワークスペース間で共有されます。
再起動するとリセットされます。ライブストリームは、ベアラートークンあたり4つ、panelプロセスあたり32
個に制限されています。ストリームを開く際も、APIリクエストの割り当てが消費されます。
リクエスト本文の受信期限は60秒ですが、ログイン、デモアクセス、
アーカイブAPI、およびwitness-headパスでは10秒に、MCPトランスポートでは8秒に短縮されます。各アプリケーションでは、
クライアントアドレスごとに4つの未完了の本文が許可されており、予約済み
ルート割り当ての全体上限は32 MiBおよび64 MiBです。 ボディのないリクエストは、これらのスロットを消費しません。サイズ超過のボディには
413が返され、タイムアウトしたボディには408が返され、クライアントの容量超過には429が返されます。 Retry-After: 1。
ボディの全体容量が枯渇した場合は、503を返します。 Retry-After.
実際のTCPピアが
TGWITNESS_TRUSTED_PROXIES(カンマ区切りのIPまたはCIDR)に属していない限り、転送されたIPヘッダーは無視されます。
TGWITNESS_PROXY_HEADERをx-forwarded-forまたはcf-connecting-ipに設定してください。XFFは、
最も近いプロキシから最初の信頼できないピアに向かって順に処理されます。 形式が不正または重複した
信頼済みアドレスのメタデータは拒否されるため、許可リストに登録されたプロキシ
アドレスを継承することはできません。管理対象のクイックトンネルは
ローカルの Cloudflare コネクタを信頼し、独自ドメインの設定ではローカルの Caddy を信頼します。
ダイレクトデプロイメントは、デフォルトではプロキシを信頼しません。Uvicornを自分で起動する場合は、
この境界が実際のピアを受け取れるよう、Uvicornのプロキシヘッダー処理を無効にしてください。
TGWITNESS_PANEL_ALLOWED_IPSは、管理者を含むすべてのパネルへのアクセスを、
指定されたIPアドレスまたはCIDRに制限します。インストーラのルーティングIDプローブはパブリック状態のままであり、
アカウントデータは返されません。許可リストを有効にする前に、
必要なローカル管理ルートを追加してください。管理対象インストールのSTART-HEREガイドには、
サービスの設定および復旧手順が含まれています。
APIのwsクエリセレクタは、リクエストパス内でワークスペースを特定する必要があります。
不明、不一致、または重複するセレクタは、404エラーで拒否されます。
パネルスクリプトおよびスタイルには、SHA-384整合性メタデータが含まれています。インポートマップは、 import-mapの整合性をサポートするブラウザにおいて、ローカルにインポートされたJSモジュールも対象とします。 動的に生成される言語応答は別途扱われます。これらのチェックは、 配信されたページに対するアセットの置換を検出します。ページ自体とそのハッシュは パネルサーバーから提供されるため、そのサーバーおよび配信経路を保護してください。
この開始以降のログには、プロセスログとすべての ワークスペースからのジャーナルアクティビティ(ログイン、拒否、経路変更、オペレーターの操作など)が組み合わされています。これは、 現在のプロセス用のインメモリコンソールであり、すべてのメッセージの恒久的なコピーではありません。 頻繁に発生するメッセージイベントは、コンソールを埋めることなく、ジャーナルに保存されます。
アクセス権の付与、変更、取り消し、およびセッションの開始・終了の際にも、
署名付きaccess.*ジャーナル記録が生成されます。これらの記録にはトークンは含まれません。
発行されたトークンおよびセッション認証情報は、ハッシュ化された状態で暗号化された保管庫に保持されます。
保留中のQRサインインは、それを開始したパネルセッションに属します。 そのセッションを終了または 取り消すか、メインパネルトークンをローテーションすると、サーバー上のその保留中のQR クライアントがキャンセルされます。これは、ブラウザが独自の キャンセルリクエストを送信できない場合にも適用されます。トークンのローテーションにより、メインパネルトークンを直接 使用して開始されたQRサインインもキャンセルされます。別の操作を待機しているQRリクエストは、開始前に 再度アクセスを確認します。完了済みのTelegram認証および別のパネルセッションによって開始された保留中のサインインは 維持されます。
メイン管理者および信頼境界
メイントークンには制限が課されません。これを使用してブラウザにログインすると、 管理者が設定したセッション制限の対象となるセッションが作成されます。メイントークンを 直接送信するスクリプトは、完全なアクセス権を維持し、ブラウザセッションとしてカウントされません。
これは、1つのインストール環境におけるアプリケーションレベルのアクセス制御です。すべてのワークスペースは サーバープロセスを共有しており、ホスト管理者からの隔離は行われていません。メイン トークン、Telegramセッション、署名鍵、およびデータディレクトリは秘密に保持してください。ウィットネストークンは 独立したチェックポイント/健全性認証情報であり、パネルアクセストークンではありません。