TgWitness參考資料 / 設定
存取與權限
針對帳戶和聊天室設定權限範圍、選擇權限、限制連線數與 IP 位址，並撤銷存取權限。
可授予審閱者存取單一聊天室的權限、分析師匯出個案的權限，或 操作員對選定帳戶的控制權。每位使用者皆擁有專屬的憑證。主 控制面板的憑證則由管理員持有。
兩個應用範圍，兩種不同的任務#
收集範圍決定了帳戶的記錄內容：選定的聊天室、Telegram 資料夾或整個帳戶。存取範圍則決定其他使用者能查看及使用哪些 已記錄的帳戶與聊天室。授予存取權限並不代表加入 Telegram 聊天室、啟動資料收集，亦不會授予 Telegram 帳戶權限。
一次存取權限可開啟選定的工作區、其中選定的聊天室，或所有 工作區。所有工作區（包括日後新增的工作區）亦涵蓋未來的 帳戶。若案件應僅限於特定工作區，請明確選取該等工作區。
授予某人存取權限#
- 請以主要管理員身分登入，並開啟「存取權限」頁面。
- 在「授予某人存取權限」下方，請輸入一個您在日誌中能認出的名稱。
- 請選擇工作區，並在必要時選擇個別聊天室。
- 請選擇此人可能採取的行動。選項中始終包含「檢視」。
- 請根據需求設定有效期限、登入／會話限制及允許的地址。
- 按下「建立存取權限」。請立即複製該代碼：此代碼僅顯示一次。
- 請私下傳送控制台位址和代碼。收件者只需在 標準登入頁面輸入該代碼；無需您的主控制台代碼或 Telegram 會話。
請在另一個瀏覽器視窗中開啟包含已發行代幣的面板，並在移交前檢查 可見的聊天室及允許執行的操作。
選擇權限#
| 授權 | 功能說明 |
|---|---|
view |
查閱獲准的聊天紀錄、擷取的訊息、個人檔案、檔案以及經過篩選的日誌記錄。這些內容始終包含在內。 |
export |
可匯出獲准的聊天紀錄及檔案。若要匯出整個工作區的證據，則需具備該工作區的存取權限。 |
sources |
管理來源、快照及個人檔案擷取。受限於特定聊天室的存取權限僅能針對允許的聊天室進行操作；全帳戶範圍的來源偵測與範圍設定則保持關閉狀態。 |
collect |
啟動或停止收集器。由於收集操作會影響該帳號，因此需要整個工作區的存取權限。 |
interact |
請在存取範圍內執行受支援的 Telegram 互動。僅限聊天室的存取權限無法使用全帳戶範圍的連結預覽功能。 |
settings |
可變更資料收集設定、時間戳記、通知、異地備份及各項參數。需具備整個工作區的存取權限。 |
account |
登入或登出 Telegram，並管理連線路徑。需具備整個工作區的存取權限。 |
權限與範圍會一併進行檢查。勾選某項權限並不會開啟 其他聊天室，也不會為僅限特定聊天室的存取權限解鎖工作區範圍的操作。 若要進行並行匯出，存取權限必須涵蓋每個已選取 帳戶中的匯出聊天室。已授予的存取權限無法建立新的存取權限、管理他人的 會話，亦無法開啟管理員控制台。
三種實用的設定方式#
| 人物 | 範圍 | 權限 |
|---|---|---|
| 審閱者 | 某個案例的聊天記錄 | view |
| 分析師正在準備交接事宜 | 待調查與匯出的聊天紀錄 | view、export；僅當需透過 Telegram 進行操作時，才需新增 interact |
| 資料擷取操作員 | 精選完整工作區 | view、sources、collect；僅在需要時才添加 settings 或 account |
這些是您透過權限核取方塊進行設定的範例，並非固定角色。
限制與會話#
| 設定 | 運作原理 |
|---|---|
| 平行會議 | 將同時連線數限制在 1 至 100 之間。達到上限時，將拒絕下一次登入，或終止最舊的連線。 |
| 允許登入 | 限制使用該憑證成功建立會話的次數。即使已使用最後一次允許的登入次數，現有會話也不會因此終止。 |
| 有效期至 | 存取權限設有絕對有效期限。過期的存取權限將無法登入或繼續發出請求。 |
| 無活動的分鐘數 | 會話閒置超時設定，範圍為 5 分鐘至 30 天。成功請求將延長此時間；開啟的面板可透過輪詢機制維持其活躍狀態。 |
| 允許的網址 | 接受特定的 IP 位址或 CIDR 子網。若未填寫，則允許任何位址，除非已啟用「首次登入綁定」功能。 |
| 綁定至首次登入 | 首次成功登入後，系統將為該次存取設定允許的位址。 |
IP 是指應用程式所偵測到的客戶端位址。若位於反向代理伺服器或 隧道之後，請在依賴 IP 規則之前，先檢查「開放連線」中顯示的位址： 否則可能會出現多名使用者看似共用同一代理伺服器位址的情況。
變更或撤銷存取權限#
在「存取權限」下編輯一項條目，以變更其範圍、權限或限制。 範圍與權限的變更將在後續請求中生效，包括 來自已開啟會話的請求。撤銷存取權限將終止其會話 並使已發行的憑證失效。開啟的會話亦允許管理員 在不撤銷整個存取權限的情況下，終止個別會話。
撤銷操作無法召回他人已下載的檔案。登出、 鎖定面板或結束會話，均不會停止正在運行的收集器。
管理員可查看的內容#
自啟動以來，此日誌會將程序日誌與每個 工作區的日誌活動整合：登入、拒絕、路由變更及操作員動作。這是一個 針對當前程序的內存控制台，而非每則訊息的永久副本。 頻繁發生的訊息事件會保留在日誌中，而非填滿控制台。
授予、變更及撤銷存取權限，以及啟動或結束會話，亦會產生
經簽名的 access.* 日誌記錄。這些記錄中不包含代幣。
已發行的代幣與會話憑證將以雜湊值形式保留於加密保管庫中。