# 存取與權限

Canonical page: https://phishdestroy.github.io/TgWitness/zh-Hant/docs/reference/access/

針對帳戶和聊天室設定權限範圍、選擇權限、限制連線數與 IP 位址，並撤銷存取權限。

可授予審閱者存取單一聊天室的權限、分析師匯出個案的權限，或 操作員對選定帳戶的控制權。每位使用者皆擁有專屬的憑證。主 控制面板的憑證則由管理員持有。

[帳戶設定](https://phishdestroy.github.io/TgWitness/zh-Hant/docs/reference/accounts/) · [連線路徑](https://phishdestroy.github.io/TgWitness/zh-Hant/docs/reference/connection/) · [安全模型](https://phishdestroy.github.io/TgWitness/zh-Hant/docs/reference/security/)

## 兩個應用範圍，兩種不同的任務

**收集範圍**決定了帳戶的記錄內容：選定的聊天室、Telegram 資料夾或整個帳戶。**存取範圍則**決定其他使用者能查看及使用哪些 已記錄的帳戶與聊天室。授予存取權限並不代表加入 Telegram 聊天室、啟動資料收集，亦不會授予 Telegram 帳戶權限。

一次存取權限可開啟選定的工作區、其中選定的聊天室，或所有 工作區。**所有工作區（包括日後新增的工作區）**亦涵蓋未來的 帳戶。若案件應僅限於特定工作區，請明確選取該等工作區。

## 授予某人存取權限

1. 請以主要管理員身分登入，並開啟「**存取權限」頁面**。
2. 在「**授予某人存取權限**」下方，請輸入一個您在日誌中能認出的名稱。
3. 請選擇工作區，並在必要時選擇個別聊天室。
4. 請選擇此人可能採取的行動。選項中始終包含「**檢視**」。
5. 請根據需求設定有效期限、登入／會話限制及允許的地址。
6. 按下「**建立存取權限**」。請立即複製該代碼：此代碼僅顯示一次。
7. 請私下傳送控制台位址和代碼。收件者只需在 標準登入頁面輸入該代碼；無需您的主控制台代碼或 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.*` 日誌記錄。這些記錄中不包含代幣。 已發行的代幣與會話憑證將以雜湊值形式保留於加密保管庫中。

****主要管理員與信任邊界**** 主面板憑證不受任何限制。使用該憑證透過瀏覽器登入所建立的會話， 將受限於管理員所設定的會話限制。直接傳送 主憑證的腳本將保留完整存取權限，且不被計入瀏覽器會話中。 這是單一安裝環境中的應用程式層級存取控制。所有工作區皆共用 伺服器進程；這並非與主機管理員隔離。請將主 憑證、Telegram 會話、簽名金鑰及資料目錄保密。見證憑證 是一種獨立的檢查點／狀態憑證，並非面板存取憑證。