所有頁面
本頁內容

安全性:agent token、瀏覽器 session 與中繼金鑰 0.9.27 新增

一個中繼只有一個為它負責的人:你。自 0.9.27 起,其他所有與中繼溝通的東西,都有一個範圍較小、屬於自己的憑證。agent 得到自己的 token,每個瀏覽器持有一個 session 而不是中繼 token,配對的中繼則用金鑰登入。本頁說明每一種憑證可以做什麼、你在 Settings → Security(設定 → 安全性)中會看到什麼,以及還有哪些缺口。中繼到底會暴露什麼,請見安全性概覽。

誰持有什麼 #

憑證 誰持有它 它能開啟什麼
中繼 token 你,保存在你的密碼管理器中。中繼只保存它的雜湊 一切。你用它讓瀏覽器登入,也用它配對中繼
瀏覽器 session 每個已登入的瀏覽器,存放在它的 cookie 中,並在頁面的儲存空間中有一把證明金鑰 你在網頁介面中能做的事
agent token 每個 session(OAR_AGENT_TOKEN),以及 oar 指令 agent 需要的路由,不包含任何屬於你的路由
中繼金鑰 配對的中繼,每個方向一把金鑰 只有中繼之間互相呼叫的路由
登入連結 你把它交給的人,只能使用一次,10 分鐘內有效 一個新的瀏覽器 session

agent 可以做什麼,哪些屬於你 #

每個 session 的環境都會得到 OAR_AGENT_TOKEN,這是一個綁定到該 session 對話的 token。session 的 worker、它的 CLI 和它的工具,以及 OAR 自己的 agent 工具,都用它呼叫中繼。agent 再也無法在任何地方找到中繼 token:環境、命令列、config.json、記錄或對話紀錄中都沒有。

agent token 可以:

  • 讀取 session、設定和用量;
  • 對 session 傳送提示、停止、封存、壓縮和重新啟動 session,以及執行它自己的回合;
  • 提出它自己的提問卡片和計畫卡片;
  • 使用 relay_tool、中繼事件和排程;
  • 使用檔案、磁碟機、git 和上傳檔案,以及它自己對話的預覽;
  • 把 session 移入既有的群組,或從群組中移出;
  • 附上原因將中繼重新啟動排入佇列,並取消它。

以下只屬於你,agent token 會得到 403 AUTH_PERSON_REQUIRED:

  • 回答或關閉任何提問卡片,包括另一個對話的一般提問卡片、Safety check(安全檢查)、核准卡片或計畫卡片。relay_tool 的 answer_question 會顯示 Only the person can answer questions; ask them in the relay UI;
  • Inbox;
  • 設定、供應商登入、配對、推播裝置和分享連結;
  • 刪除 session,以及建立、重新命名或刪除群組;
  • 立即重新啟動、單純的關閉、更新和安裝;
  • 網頁介面的即時連線。

session 的 token 只能代表該 session 行事:relay_tool 會拒絕針對另一個對話的呼叫(AUTH_CONVERSATION_MISMATCH),而 agent 只能透過 relay_tool 的 create_session 啟動新的 session,那裡會套用你的 Allow(允許)和 session 數量上限。agent 設定 owner_approved 時,中繼會忽略它。

你在中繼主機上執行的腳本使用同樣的 token:在 session 中,使用 Authorization: Bearer $OAR_AGENT_TOKEN;在 session 之外,oar agent-token 會印出一個 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 只能開啟瀏覽器自行載入的附件、產生的圖片和媒體(見這些防護的限制)。在瀏覽器中清除網站資料會移除這把金鑰:那個瀏覽器就要重新登入。
  • 金鑰只留在中繼。 頁面只會把證明金鑰送到中繼自己的位址(包括連接埠)的 /api/ 底下。agent 放在回覆中、來自另一個位址的圖片,包括來自中繼主機另一個連接埠的圖片,絕不會收到它,在檢視器中也沒有 🖍️。
  • 依路徑開啟的檔案。 頁面依路徑開啟的檔案(圖片、影片、下載,或在新分頁中開啟的 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。

  1. 在已登入的瀏覽器上,開啟 Settings → Security → Sign in another device(設定 → 安全性 → 登入另一台裝置),然後按 Make a sign-in link(產生登入連結)。
  2. 在另一台裝置上開啟這個連結,或按 Show QR code(顯示 QR 碼),再用那台裝置的相機掃描。

這個連結(…/?signin=…)會讓一個瀏覽器登入,只能使用一次,10 分鐘內有效。分頁會顯示它還剩多少時間。最先開啟它的人就會登入,所以請只在只有你看得到的地方顯示或傳送它。QR 碼會在一分鐘後、你離開頁面或關閉 Settings 時、連結被使用或過期後,以及按下 Hide QR code(隱藏 QR 碼)時再次隱藏。新的連結會讓前一個失效,中繼重新啟動也會讓它失效。

在中繼主機上,oar url --sign-in 會在終端機中印出這樣的連結和它的 QR 碼,使用的是手機能連到的位址。中繼在 10 分鐘內最多產生 3 個這樣的連結,而新的連結會取代前一個,前一個就此失效;指令會告訴你這一點。對於以這種方式登入的瀏覽器,瀏覽器清單會顯示 from the terminal (oar url --sign-in)。

在瀏覽器中以同一個主機名稱、不同連接埠連到的兩個中繼(host:3333、host:3334)會共用一個登入 cookie,並互相把對方登出。請給每個中繼各自的主機名稱。

中繼 token #

中繼 token 是本人的憑證:請把它保存在你的密碼管理器中。中繼只保存它的雜湊,放在資料目錄的 relay-secrets.json 中;見機密存放在哪裡。新的 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_AGENT_TOKEN。在終端機中,oar setup --new-token 會在你輸入 NEW 之後做同樣的事,並重新啟動中繼。

由 0.9.26 或更舊版本透過 oar copilot 啟動的中繼,或用手動 --token 啟動的中繼,會把舊 token 留在看管它的處理程序的命令列上,直到它被停止並重新啟動一次為止。請在產生新的 token 之前這麼做;見升級說明。

更新到 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:例如有人把 authToken 放回 config.json,或 relay-secrets.json 被變更。如果是你做的,就關閉它;否則請產生新的 token。只有你自己已登入的頁面會顯示它,分享的檢視絕不會。

中繼從不提供的檔案 #

不論使用哪種憑證,包括中繼 token,OAR 的檔案路由絕不會提供或變更中繼自己的檔案:relay-secrets.json、資料庫(oar.db 及其 -wal 和 -shm 檔案、它的備份,以及正在寫入的備份)和 config.json。它們會回應 403 FILE_PROTECTED。檔案瀏覽器無法重新命名、移動或刪除它們,也無法對含有其中之一的資料夾這麼做,而媒體庫絕不會提供訊息中提到的這些檔案。指向它們的連結或硬連結也會被拒絕。這只是把它們排除在檔案路由之外:agent 自己的 shell 仍然可以讀取它們(見這些防護的限制)。

配對的中繼 #

配對的中繼不再保存彼此的中繼 token。兩邊都是 0.9.27 或更新版本時,配對只會使用另一個中繼配對連結中的 token 一次,用來交換金鑰。從此以後,每個中繼都用自己的金鑰登入另一個,而這把金鑰只能開啟中繼之間互相呼叫的路由:絕不包括設定、檔案、配對、session 的計費,或回答卡片或 ask 提問(403 REMOTE_RELAY_PEER_SCOPE)。更換中繼的 token 不再會破壞以金鑰配對的關係。之前就已配對的中繼,在兩者都執行 0.9.27 後大約一分鐘內就會自行改用金鑰。

  • 雙向。 勾選 Also add this relay there(同時在對方新增此中繼)時,每個中繼都會從另一個得到一把金鑰。
  • 單向。 取消勾選時,連結中的 token 只在記憶體中用於這次新增,絕不保存。另一個中繼會給這一個一把僅接收金鑰,並把它列為 Inbound only(僅接收):它絕不會呼叫此中繼,而它的 Remove(移除)會立即撤銷這把金鑰。在這裡,那一列會顯示 One way(單向)。
  • 新增期間的 token。 兩邊都是 0.9.27 時,連結中的 token 只在新增進行期間保存在記憶體中,一旦有金鑰可用,就絕不會寫入資料庫。只有結束時沒有可用金鑰的新增(較舊的中繼,或交換失敗)才會保存它,直到有金鑰可用為止。這樣保存後又刪除的 token,可能仍然可以在資料庫的閒置頁和它的 oar.db-wal 中讀到,直到 SQLite 重新使用它們為止;如果這對你很重要,請更換那個中繼的 token。
  • 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_RELAY_PEER_KEY_REQUIRED)。每次拒絕都會被記錄下來,並在那個中繼的列上計數,N refused claims since start,而每個中繼的第一次拒絕都會在 Inbox 中放一則通知。
  • 身分變更時會被暫停。 中繼一旦有了金鑰,或此中繼持有來自它的金鑰,它的位址和中繼 id 就會被固定下來。如果它們改變了,或另一個中繼在它的位址上回應,它的金鑰會被撤銷,此中繼不會把為它保存的任何東西(它給此中繼的金鑰,或 token)傳給它,而在你於它那一列按 Confirm(確認)之前,也不會核發任何新的金鑰。把位址改回它取得金鑰時的那個位址,就能解除單純由位址變更造成的暫停。

配對中繼的問題要在那個中繼上、登入那裡之後回答。Inbox 會以唯讀方式顯示它們,附上 Open there;如果那個中繼執行 0.9.27,還會有選項按鈕,在小視窗中於那裡開啟問題;見提問與 Inbox。

對敏感檔案的編輯 #

Claude、Claude API 和 DeepSeek session 在編輯 Claude Code 標記為敏感的檔案之前會詢問你,因為那裡的變更可能會改變 git、shell 或某個工具的行為:例如 .bashrc 之類的 shell 啟動檔、.npmrc,以及 .git/ 或 .claude/ 底下的任何東西等等。這樣的編輯會在每種中繼模式中(包括 autopilot)於一張 Safety check 卡片上等待,卡片上有檔案和完整的變更,以及 Allow once(僅允許一次)和 Deny(拒絕)。只有你能回答它:agent token 和配對中繼的金鑰都會被拒絕。它絕不會允許超過那一次的編輯,而沒有回答的卡片會讓檔案維持不變。監看這個 session 的 agent 或配對中繼,只會得到卡片固定的第一行和 File: 那一行,絕不會得到變更內容。

讀取這樣的檔案,或透過中繼傳送它,都不會詢問;以 Claude Code 不會標記的方式寫入它的指令也不會。這張卡片是對 agent 編輯的檢查,不是沙箱。

這些防護的限制 #

agent token 把 agent 的工具和你的工具分開。它們不是沙箱:agent 以與中繼相同的作業系統使用者身分執行,而那個使用者仍然可以做到以下這些事。

  • 變更中繼的檔案。 agent 可以寫入 relay-secrets.json、config.json、資料庫或中繼的程式碼,然後把重新啟動排入佇列,藉此安裝一個它自己的 token。中繼只會察覺到這件事:它在啟動時會把 token 的雜湊與資料庫中的副本比較,並回報 The relay token was changed outside OAR。同時編輯兩者的 agent 就能避開這一點。它也能從同一個檔案產生任何 session 的 agent token。檔案路由會拒絕這些檔案,但 agent 的 shell 不使用檔案路由。
  • 使用終端機的途徑。 oar setup --new-token 和 oar url --sign-in 的終端機檢查只是增加麻煩,不是界線:agent 可以偽造終端機,或用 oar agent-token 呼叫那個路由。以這種方式進行的登入,會像上面所說的那樣通知其他每個瀏覽器,並在瀏覽器清單中顯示「via the terminal」。請把這樣的瀏覽器登出,然後更換 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 本身仍然能開啟一切,不論誰持有它。