安全性:agent token、瀏覽器 session 與中繼金鑰 0.9.27 新增
一個中繼只有一個為它負責的人:你。自 0.9.27 起,其他所有與中繼溝通的東西,都有一個範圍較小、屬於自己的憑證。agent 得到自己的 token,每個瀏覽器持有一個 session 而不是中繼 token,配對的中繼則用金鑰登入。本頁說明每一種憑證可以做什麼、你在 Settings → Security(設定 → 安全性)中會看到什麼,以及還有哪些缺口。中繼到底會暴露什麼,請見安全性概覽。
誰持有什麼 #
| 憑證 | 誰持有它 | 它能開啟什麼 |
|---|---|---|
| 中繼 token | 你,保存在你的密碼管理器中。中繼只保存它的雜湊 | 一切。你用它讓瀏覽器登入,也用它配對中繼 |
| 瀏覽器 session | 每個已登入的瀏覽器,存放在它的 cookie 中,並在頁面的儲存空間中有一把證明金鑰 | 你在網頁介面中能做的事 |
| agent token | 每個 session(OAR_),以及 oar 指令 |
agent 需要的路由,不包含任何屬於你的路由 |
| 中繼金鑰 | 配對的中繼,每個方向一把金鑰 | 只有中繼之間互相呼叫的路由 |
| 登入連結 | 你把它交給的人,只能使用一次,10 分鐘內有效 | 一個新的瀏覽器 session |
agent 可以做什麼,哪些屬於你 #
每個 session 的環境都會得到 OAR_,這是一個綁定到該 session 對話的 token。session 的 worker、它的 CLI 和它的工具,以及 OAR 自己的 agent 工具,都用它呼叫中繼。agent 再也無法在任何地方找到中繼 token:環境、命令列、config.、記錄或對話紀錄中都沒有。
agent token 可以:
- 讀取 session、設定和用量;
- 對 session 傳送提示、停止、封存、壓縮和重新啟動 session,以及執行它自己的回合;
- 提出它自己的提問卡片和計畫卡片;
- 使用
relay_、中繼事件和排程;tool - 使用檔案、磁碟機、git 和上傳檔案,以及它自己對話的預覽;
- 把 session 移入既有的群組,或從群組中移出;
- 附上原因將中繼重新啟動排入佇列,並取消它。
以下只屬於你,agent token 會得到 403 AUTH_:
- 回答或關閉任何提問卡片,包括另一個對話的一般提問卡片、Safety check(安全檢查)、核准卡片或計畫卡片。
relay_的tool answer_會顯示 Only the person can answer questions; ask them in the relay UI;question - Inbox;
- 設定、供應商登入、配對、推播裝置和分享連結;
- 刪除 session,以及建立、重新命名或刪除群組;
- 立即重新啟動、單純的關閉、更新和安裝;
- 網頁介面的即時連線。
session 的 token 只能代表該 session 行事:relay_ 會拒絕針對另一個對話的呼叫(AUTH_),而 agent 只能透過 relay_ 的 create_ 啟動新的 session,那裡會套用你的 Allow(允許)和 session 數量上限。agent 設定 owner_ 時,中繼會忽略它。
你在中繼主機上執行的腳本使用同樣的 token:在 session 中,使用 Authorization: Bearer $OAR_;在 session 之外,oar agent- 會印出一個 token。兩者都不是中繼 token。沒有送出 token 的腳本會得到 401 The relay token is no longer in the config; use OAR_AGENT_TOKEN。
瀏覽器 session #
登入時,會在登入框或透過登入位址,把中繼 token 交換一次,換成該瀏覽器的 session。從此以後,瀏覽器的 cookie 保存的是 session,絕不是 token,而中繼只保存它的雜湊。
- 有效期限。 session 在最後一次使用後 30 天內有效,最長 400 天。中繼最多保留 50 個;新的 session 會把最久沒有使用的那一個擠掉。
- 證明金鑰。 登入也會給頁面第二個祕密,頁面把它保存在自己的儲存空間中,並隨每個請求送出。瀏覽器會把中繼的 cookie 送到中繼主機的每一個連接埠,所以 agent 在那裡執行的 dev server,會在你開啟那個伺服器時收到它。沒有證明金鑰的話,cookie 只能開啟瀏覽器自行載入的附件、產生的圖片和媒體(見這些防護的限制)。在瀏覽器中清除網站資料會移除這把金鑰:那個瀏覽器就要重新登入。
- 金鑰只留在中繼。 頁面只會把證明金鑰送到中繼自己的位址(包括連接埠)的
/底下。agent 放在回覆中、來自另一個位址的圖片,包括來自中繼主機另一個連接埠的圖片,絕不會收到它,在檢視器中也沒有 🖍️。api/ - 依路徑開啟的檔案。 頁面依路徑開啟的檔案(圖片、影片、下載,或在新分頁中開啟的 PDF),會在位址中帶有一個檔案授權
k。頁面用它的證明金鑰索取這個授權。它只能開啟那一個檔案,只能搭配這個瀏覽器的 cookie 使用,最多 10 分鐘,而頁面會視需要更新它,所以長影片可以繼續播放。從頁面複製出來的檔案連結,在那之後就會失效。錯誤或過期的k會得到403 AUTH_,不論路徑為何都是同樣的回答,所以它不會透露任何關於檔案的資訊。FILE_ CAPABILITY - 媒體位址帶有標籤。 媒體庫發出的每個位址都帶有一個標籤
t;沒有標籤的媒體位址會得到404,不論是誰請求,所以複製來的 cookie 無法逐一瀏覽媒體。標籤不會過期,但當relay-被替換時,舊的媒體位址會失效,媒體庫會發出新的位址。secrets. json - 0.9.27 之前的瀏覽器 把 token 保存在 cookie 中。那個 cookie 已經什麼都無法開啟:頁面啟動時,會把這個 cookie 交換一次,換成一個 session 和它的證明金鑰,不需要登入框。更新之前就開著的分頁執行的是舊頁面,需要重新載入一次。
- 已登出。 session 已不再有效的瀏覽器,會在它的登入頁面上顯示 This browser was signed out;你從它回答的通知會顯示 Signed out, open OAR。
- 腳本不會建立 session。 在
Authorization標頭中帶著中繼 token 的請求,會在沒有 session 的情況下以你的身分行事,也絕不會在清單中新增瀏覽器。
Settings → Security #
Settings → Security 處理的是誰可以使用這個中繼。agent 和配對的中繼無法開啟它。
- Browsers signed in(已登入的瀏覽器)列出在此處有 session 的每個瀏覽器,這個瀏覽器排第一個並標示 this browser:它的名稱,取自它回報的瀏覽器和系統,直到你用 Rename(重新命名)改名為止;何時以及如何登入(中繼 token、登入連結、終端機,或是從有 session 之前沿用下來的);最後一次出現的時間;以及它最後的位址。最後一個請求是經由中繼主機上的 proxy 或 tunnel、從中繼自己的主機送達的瀏覽器,會顯示 this host (forwarded for …)(本主機,轉送自 …),括號中是被轉送的位址。
- 某一列上的 Sign out(登出)會立即結束那個瀏覽器的 session,關閉它的即時連線,並停止它的推播通知。Sign out all other browsers(登出其他所有瀏覽器)只保留這一個;Sign out this browser(登出此瀏覽器)會在這裡顯示登入框。每一項都會先詢問。
新登入通知 #
當有瀏覽器用中繼 token、登入連結或終端機登入時,其他每個已登入的瀏覽器都會在登入完成之前收到通知:
- 標題列下方橫幅中的一列,不論有幾次登入:New browser signed in:
, , via … ,附有 Sign it out(將它登出)和 Got it(知道了),或是 3 new browsers signed in (latest: …)。Show all(全部顯示)會在對話上方開啟清單,每個瀏覽器都附有它如何以及何時登入,以及 Sign it out;按一次 Got it 就會把它們全部關閉; - 一則推播通知 New browser signed in,即使裝置開著 App 也會傳送,傳給每一台持有新 session 以外之 session 的裝置。它有一個 Sign it out 動作,點一下會開啟 Settings → Security。5 分鐘內的多則通知會互相取代。開關是 Settings → Notifications(設定 → 通知)中的 A new browser signed in(有新的瀏覽器登入)。
經由中繼主機上的 proxy 或 tunnel、從中繼自己的主機送達的登入,會顯示 this host,括號中是被轉送的位址,絕不會只顯示那個位址。
中繼會保留這些通知 7 天。每個瀏覽器只能為自己關閉它們,所以新的 session 無法對其他瀏覽器隱藏自己的登入。重新登入的瀏覽器會再次看到最近 7 天的通知,包括它已經關閉過的那些。終端機登入的通知,只要那個瀏覽器仍然登入就會保留,不論之後還有多少次登入。
登入另一台裝置 #
你不再需要在手機上輸入中繼 token。
- 在已登入的瀏覽器上,開啟 Settings → Security → Sign in another device(設定 → 安全性 → 登入另一台裝置),然後按 Make a sign-in link(產生登入連結)。
- 在另一台裝置上開啟這個連結,或按 Show QR code(顯示 QR 碼),再用那台裝置的相機掃描。
這個連結(…/)會讓一個瀏覽器登入,只能使用一次,10 分鐘內有效。分頁會顯示它還剩多少時間。最先開啟它的人就會登入,所以請只在只有你看得到的地方顯示或傳送它。QR 碼會在一分鐘後、你離開頁面或關閉 Settings 時、連結被使用或過期後,以及按下 Hide QR code(隱藏 QR 碼)時再次隱藏。新的連結會讓前一個失效,中繼重新啟動也會讓它失效。
在中繼主機上,oar url --sign- 會在終端機中印出這樣的連結和它的 QR 碼,使用的是手機能連到的位址。中繼在 10 分鐘內最多產生 3 個這樣的連結,而新的連結會取代前一個,前一個就此失效;指令會告訴你這一點。對於以這種方式登入的瀏覽器,瀏覽器清單會顯示 from the terminal (oar url --sign-in)。
在瀏覽器中以同一個主機名稱、不同連接埠連到的兩個中繼(host:、host:)會共用一個登入 cookie,並互相把對方登出。請給每個中繼各自的主機名稱。
中繼 token #
中繼 token 是本人的憑證:請把它保存在你的密碼管理器中。中繼只保存它的雜湊,放在資料目錄的 relay- 中;見機密存放在哪裡。新的 token 以 oaro1_ 開頭;舊版本的 token 仍然有效。
- 它只顯示一次。 在終端機中執行的
oar setup會顯示新的 token 一次,附上登入連結和 QR 碼。沒有終端機時(服務、腳本、agent),沒有任何東西會印出 token,因為那些輸出會進入 agent 能讀取的記錄。 oar url不會印出 token。 中繼做不到:它只保存雜湊。- 遺失了嗎? 從仍然登入的瀏覽器讓另一台裝置登入,或更換 token。沒有任何瀏覽器登入時,請在中繼主機的終端機中執行
oar setup --new-。token
產生新的中繼 token #
Settings → Security → Relay token(設定 → 安全性 → 中繼 token)會說明是否已設定 token、中繼只保存它的雜湊,以及它是何時產生或最後一次更換的。Generate new relay token(產生新的中繼 token)會先詢問 The current token stops working at once. Signed-in browsers stay signed in; agents keep working.,然後顯示新的 token 一次:
- 在你按 Show(顯示)之前是隱藏的,附有 Save in password manager(儲存到密碼管理器)、Copy(複製)和 Copy pairing link(複製配對連結);按下 Save in password manager 時,你的密碼管理器會提議以中繼的名稱保存它;
- 舊 token 最後一次被瀏覽器頁面以外的東西(例如腳本或較舊的配對中繼)使用的時間,以及來自哪個位址;
- 仍然用舊 token 呼叫的配對中繼,每一個都附有 Open there(在該處開啟),它會開啟那個中繼的 Settings → Relays(設定 → 中繼),並準備好 Add a relay(新增中繼)讓你貼上配對連結。以金鑰登入的中繼會繼續運作,不會列出。
關閉對話框會把 token 從頁面中移除。貼上之後請清除剪貼簿:剪貼簿歷史記錄會保留它。
立即改變的事:舊 token 會失效。已登入的瀏覽器保持登入,agent、它們的 token 和 session worker 會繼續運作,以金鑰配對的中繼也會繼續運作。送出舊 token 的腳本需要新的 token,更好的做法是改用 OAR_。在終端機中,oar setup --new- 會在你輸入 NEW 之後做同樣的事,並重新啟動中繼。
由 0.9.26 或更舊版本透過 oar copilot 啟動的中繼,或用手動 --token 啟動的中繼,會把舊 token 留在看管它的處理程序的命令列上,直到它被停止並重新啟動一次為止。請在產生新的 token 之前這麼做;見升級說明。
橫幅和 Recommended 點 #
更新到 0.9.27 之後,標題列下方的橫幅會顯示 Your relay token was readable by agents until this version. Generate a new one. Generate new token(產生新 token)會開啟上述的對話框;Dismiss(關閉)會隱藏它,對整個中繼只需一次。在你關閉橫幅之後,只要仍建議換新 token,Security 分頁就會保留一個小點,token 那一列也會有 Recommended(建議)標籤,直到你更換 token 為止。
當 token 在中繼沒有參與的情況下被變更時,橫幅也會顯示 The relay token was changed outside OAR:例如有人把 auth 放回 config.,或 relay- 被變更。如果是你做的,就關閉它;否則請產生新的 token。只有你自己已登入的頁面會顯示它,分享的檢視絕不會。
中繼從不提供的檔案 #
不論使用哪種憑證,包括中繼 token,OAR 的檔案路由絕不會提供或變更中繼自己的檔案:relay-、資料庫(oar. 及其 -wal 和 -shm 檔案、它的備份,以及正在寫入的備份)和 config.。它們會回應 403 FILE_。檔案瀏覽器無法重新命名、移動或刪除它們,也無法對含有其中之一的資料夾這麼做,而媒體庫絕不會提供訊息中提到的這些檔案。指向它們的連結或硬連結也會被拒絕。這只是把它們排除在檔案路由之外:agent 自己的 shell 仍然可以讀取它們(見這些防護的限制)。
配對的中繼 #
配對的中繼不再保存彼此的中繼 token。兩邊都是 0.9.27 或更新版本時,配對只會使用另一個中繼配對連結中的 token 一次,用來交換金鑰。從此以後,每個中繼都用自己的金鑰登入另一個,而這把金鑰只能開啟中繼之間互相呼叫的路由:絕不包括設定、檔案、配對、session 的計費,或回答卡片或 ask 提問(403 REMOTE_)。更換中繼的 token 不再會破壞以金鑰配對的關係。之前就已配對的中繼,在兩者都執行 0.9.27 後大約一分鐘內就會自行改用金鑰。
- 雙向。 勾選 Also add this relay there(同時在對方新增此中繼)時,每個中繼都會從另一個得到一把金鑰。
- 單向。 取消勾選時,連結中的 token 只在記憶體中用於這次新增,絕不保存。另一個中繼會給這一個一把僅接收金鑰,並把它列為 Inbound only(僅接收):它絕不會呼叫此中繼,而它的 Remove(移除)會立即撤銷這把金鑰。在這裡,那一列會顯示 One way(單向)。
- 新增期間的 token。 兩邊都是 0.9.27 時,連結中的 token 只在新增進行期間保存在記憶體中,一旦有金鑰可用,就絕不會寫入資料庫。只有結束時沒有可用金鑰的新增(較舊的中繼,或交換失敗)才會保存它,直到有金鑰可用為止。這樣保存後又刪除的 token,可能仍然可以在資料庫的閒置頁和它的
oar.中讀到,直到 SQLite 重新使用它們為止;如果這對你很重要,請更換那個中繼的 token。db- wal - Settings → Relays 中的 Re-pair(重新配對)只需按一下,就會再次交換金鑰。當此中繼持有的東西在那裡都已無效,或另一個中繼較舊時,它會開啟已填好位址的 Add a relay:貼上那個中繼的配對連結,項目就會原地更新。
- Renew key(更新金鑰)和 Revoke key(撤銷金鑰)作用於單一中繼。金鑰每 30 天會自行更新。被撤銷的金鑰會一直無效,直到你更新它,或直到那個中繼再次透過此中繼的配對連結被新增,這會再給它一把可用的金鑰。只有移除那個中繼並且產生新的中繼 token,才能永久把它擋在外面。
已驗證與未驗證的來源 #
來自配對中繼的提示,會以你在這裡為它取的名稱,指出用金鑰登入它的那個中繼,絕不採用請求中關於它自己的說法。
- 已驗證。 透過金鑰送達的提示。它可以做限制所允許的事。
- 未驗證。 在這裡沒有已確認金鑰的中繼(早於 0.9.27 的 OAR,或金鑰尚未確認)仍然能連到它的 session,但它的提示會顯示 claimed(未驗證)標籤,agent 會在它的標題行中讀到「(unverified)」,而且它什麼都無法開啟:沒有回覆存取權、沒有轉傳額度、不會抑制推播、不能提出 ask 提問或監看。傳送方的 agent 會被告知原因。0.9.27 之前儲存的提示也會被視為未驗證。
- 被拒絕的身分聲明。 自稱是另一個中繼的金鑰會被拒絕(
REMOTE_),任何其他自稱是某個已有金鑰之中繼的憑證也會被拒絕(RELAY_ ORIGIN_ MISMATCH REMOTE_)。每次拒絕都會被記錄下來,並在那個中繼的列上計數,N refused claims since start,而每個中繼的第一次拒絕都會在 Inbox 中放一則通知。RELAY_ PEER_ KEY_ REQUIRED - 身分變更時會被暫停。 中繼一旦有了金鑰,或此中繼持有來自它的金鑰,它的位址和中繼 id 就會被固定下來。如果它們改變了,或另一個中繼在它的位址上回應,它的金鑰會被撤銷,此中繼不會把為它保存的任何東西(它給此中繼的金鑰,或 token)傳給它,而在你於它那一列按 Confirm(確認)之前,也不會核發任何新的金鑰。把位址改回它取得金鑰時的那個位址,就能解除單純由位址變更造成的暫停。
配對中繼的問題要在那個中繼上、登入那裡之後回答。Inbox 會以唯讀方式顯示它們,附上 Open there;如果那個中繼執行 0.9.27,還會有選項按鈕,在小視窗中於那裡開啟問題;見提問與 Inbox。
對敏感檔案的編輯 #
Claude、Claude API 和 DeepSeek session 在編輯 Claude Code 標記為敏感的檔案之前會詢問你,因為那裡的變更可能會改變 git、shell 或某個工具的行為:例如 . 之類的 shell 啟動檔、.,以及 . 或 . 底下的任何東西等等。這樣的編輯會在每種中繼模式中(包括 autopilot)於一張 Safety check 卡片上等待,卡片上有檔案和完整的變更,以及 Allow once(僅允許一次)和 Deny(拒絕)。只有你能回答它:agent token 和配對中繼的金鑰都會被拒絕。它絕不會允許超過那一次的編輯,而沒有回答的卡片會讓檔案維持不變。監看這個 session 的 agent 或配對中繼,只會得到卡片固定的第一行和 File: 那一行,絕不會得到變更內容。
讀取這樣的檔案,或透過中繼傳送它,都不會詢問;以 Claude Code 不會標記的方式寫入它的指令也不會。這張卡片是對 agent 編輯的檢查,不是沙箱。
這些防護的限制 #
agent token 把 agent 的工具和你的工具分開。它們不是沙箱:agent 以與中繼相同的作業系統使用者身分執行,而那個使用者仍然可以做到以下這些事。
- 變更中繼的檔案。 agent 可以寫入
relay-、secrets. json config.、資料庫或中繼的程式碼,然後把重新啟動排入佇列,藉此安裝一個它自己的 token。中繼只會察覺到這件事:它在啟動時會把 token 的雜湊與資料庫中的副本比較,並回報 The relay token was changed outside OAR。同時編輯兩者的 agent 就能避開這一點。它也能從同一個檔案產生任何 session 的 agent token。檔案路由會拒絕這些檔案,但 agent 的 shell 不使用檔案路由。json - 使用終端機的途徑。
oar setup --new-和token oar url --sign-的終端機檢查只是增加麻煩,不是界線:agent 可以偽造終端機,或用in oar agent-呼叫那個路由。以這種方式進行的登入,會像上面所說的那樣通知其他每個瀏覽器,並在瀏覽器清單中顯示「via the terminal」。請把這樣的瀏覽器登出,然後更換 token。token - 取得中繼主機上瀏覽器的 session。 同一台機器、同一個使用者上的瀏覽器,會把它的 cookie 和證明金鑰存放在那個使用者能讀取的地方。兩者合起來就是一個完整的 session:持有它們的人,能在網頁介面中做任何你能做的事,包括產生新的 token。要恢復,請產生新的中繼 token,用它登入,然後按 Sign out all other browsers。單是換新 token 不會讓任何瀏覽器登出。
- 讀取只需 cookie 的內容。 瀏覽器依 id 或雜湊自行載入的附件、產生的圖片和已建立索引的媒體,仍然只需 cookie 就能開啟,不需要證明金鑰,所以主機上另一個連接埠的伺服器只要收到你的 cookie,就能擷取它們。依路徑開啟的檔案不在其中:它們需要證明金鑰或檔案授權。agent token 本來就能讀取以上全部。
- 讀取配對中繼的憑證,也就是此中繼保存在資料庫中的那些,以及它曾經為某個中繼保存過的 token,這個 token 可能殘留在資料庫的閒置頁中。金鑰只能開啟那裡的中繼路由,而在那個中繼上按 Revoke key 就能讓它失效。
- 找到 0.9.27 之前 token 的舊副本:shell 歷史記錄、備份、複製的
config.,或看管某個由舊版json oar copilot或手動--token啟動之中繼的處理程序的命令列,直到那個中繼被停止並重新啟動一次為止。如果之前有 agent 在這個中繼上執行過,請在更新之後產生新的 token。 - 停止中繼。 同一個使用者的處理程序可以結束它,所以
oar指令在停止前的檢查只是一種便利,不是一種保護。
中繼 token 本身仍然能開啟一切,不論誰持有它。