跳至主要内容

瀏覽器、憑證與整合

化身需要查網站、登入帳號或使用外部服務時,你可以只把工具開給需要的辦公室。瀏覽器在各辦公室設定;外部帳號與整合集中在 組織 › 連線與憑證。組織的 Veinmesh 金鑰在 組織 › 服務與整合。你自己的 Edgewright、Veinmesh 金鑰在個人入口的 你的金鑰,也在導覽的 服務。都不在這一頁。

開始之前

經理、管理員與擁有者都能管理服務與連線。辦公室設定只作用在你看得到的辦公室;經理只能修改自己建立的憑證,管理員與擁有者可以管理組織的憑證。

替辦公室開啟服務​

例如,查供應商後台的辦公室需要瀏覽器,只討論內部提案的辦公室則可以保持關閉。

  1. 打開辦公室的 設定 › 服務。
  2. 開啟 辦公室瀏覽器,或開啟已連接的整合。
  3. 如果有 Edgewright 研究引擎,可以在這裡啟用;系統會先開啟或確認這間辦公室的研究工作區。

瀏覽器開啟後,辦公室會出現 瀏覽器 分頁。新辦公室的瀏覽器與研究預設關閉;關閉研究只收回使用權,不刪除研究工作區的沿革。研究操作見 Edgewright 是什麼。

備註

瀏覽器開關被拒絕時會恢復原狀並顯示原因。研究操作若顯示無法確認,先重新載入檢查狀態,再重試。

讓化身各用自己的瀏覽器​

兩位化身要登入同一個網站的不同帳號時,使用席位瀏覽器,讓登入狀態分開。

  1. 先開啟 辦公室瀏覽器。
  2. 如果出現 席位瀏覽器(每位成員一個),開啟這個開關。這個標籤裡的「成員」指辦公室裡的化身。

開啟後,每位化身操作自己的瀏覽器,使用獨立的設定檔與登入狀態。關閉時,化身共用辦公室的同一組登入狀態。席位開關只在瀏覽器已開啟、伺服器也提供這項功能時出現。

觀看與接手瀏覽器​

你可以先看化身怎麼操作,需要選出正確訂單或補填資料時,再親自接手。

  1. 在辦公室打開 瀏覽器 分頁。只是觀看,不會取得操作權。
  2. 有席位瀏覽器時,用上方的 瀏覽器 選單挑化身;選 共用 則看辦公室的共用瀏覽器。
  3. 選 接手操作。接手後可以輸入網址、點擊、輸入文字與捲動;畫面上會顯示操作中的倒數時間。
  4. 完成後選 交還操作。如果沒有繼續操作,閒置 15 分鐘也會自動交還;每次操作會重新延長時間。

你接手的這個瀏覽器會暫停化身的操作,不影響其他席位。若別人正在操作,畫面會顯示對方名稱,不能直接搶走操作權。

存入網站密碼或 API 權杖​

先把帳號放進保險庫,再授權給化身,不必把密碼貼進對話。API 權杖是服務用來辨識帳號的機密值,用於 API 呼叫,不是網站密碼。

  1. 打開 組織 › 連線與憑證,在 憑證 選 保險庫。
  2. 填 代稱、顯示名稱、完整的 網站網址,例如 https://support.example.com。
  3. 選 類型:
    • 密碼:填 密碼,需要時填 使用者名稱。
    • API 權杖(伺服器端 API 呼叫):填 權杖;使用者名稱 可留空,只用來區分帳號。
  4. 選 建立。

完成後,憑證出現在清單裡,還需要下一步授權給化身。

注意

密碼與權杖儲存後不會再顯示。網站網址 也決定憑證可以送往哪裡:只限該主機與它的子網域;填 HTTPS 時,不會改用 HTTP 傳送。外部服務的 API 如果在另一個網域,請為那個網址另外建立憑證。

把憑證授權給化身​

例如,只讓負責查訂單的化身使用供應商帳號,並寫明它應該拿來做什麼。

  1. 展開該憑證的 授權。
  2. 在 授權給 選化身,填 用途,例如「查詢本季訂單的交期,不修改訂單」。
  3. 選 授權。

清單會列出化身、用途與授權時間。化身列出自己可用的憑證時,只看到代稱、顯示名稱、網站網址、使用者名稱與用途;看不到密碼或權杖。密碼由系統代填到瀏覽器,API 權杖則由 Soulhall 以 Bearer Authorization 標頭送出,化身讀到的是服務回覆。

備註

用途 是給化身看的說明,不是額外的操作限制。請只授權給真正需要的化身;已解除的化身不在授權選單裡。個人研究金鑰不放在這個保險庫,見研究金鑰。

更換保險庫裡的密碼或權杖​

外部帳號換了密碼或權杖後,把保險庫中的值一起更新。

  1. 在憑證上選 輪替密碼。
  2. 在 新密碼 填新值,選 輪替。API 權杖也用這個操作,填入新的權杖即可。

完成後會顯示 已輪替。。這只更新保險庫,不替你變更外部網站的密碼;介面的按鈕與欄位即使處理 API 權杖,仍顯示「密碼」。

撤銷授權或刪除憑證​

工作結束後,展開憑證的 授權,在該化身旁選 撤銷,就會取消它使用這組憑證的授權。

整組憑證都不再需要時,選 刪除 並確認。憑證、有效授權與儲存的機密值會移除;不是只撤銷其中一位化身。

連接外部服務的工具​

提示

擴充目錄列出現成的連接器,位址與登入方式都已選好。以下步驟用於手動加入。

例如,專案追蹤服務提供搜尋工單的工具時,可以連接一次,再決定哪些辦公室能用。

  1. 打開 組織 › 連線與憑證,在 整合 選 連接。
  2. 填 服務 ID(小寫,使用連字號)、顯示名稱 和 MCP 端點 URL。最後一項是外部服務提供工具的連線網址。
  3. 選連接方式:
    • 登入(OAuth):選 建立,到服務自己的登入頁完成授權,之後會回到 Soulhall。
    • API 金鑰:填 API 金鑰 和 標頭名稱(預設為 Authorization),選 建立。標頭名稱留空時,系統以 Authorization: Bearer … 送出;改填其他名稱時,金鑰會直接放在該標頭。
  4. 確認狀態為 已連接,展開 工具,查看它提供哪些工具。

工具名稱會顯示為 服務ID__工具名稱。看到 等待授權中 或 連線錯誤 時,先完成授權或處理列出的問題,再啟用到辦公室。

替辦公室啟用整合,或中斷連接​

  1. 打開需要這項工具的辦公室,進入 設定 › 服務,開啟該整合。
  2. 外部服務新增或改了工具時,到 組織 › 連線與憑證,在整合上選 重新整理工具。
  3. 整個組織都不再使用時,選 中斷連接。

只有已連接且在該辦公室啟用的整合,才會提供工具給那裡的化身。中斷連接會移除這項組織整合、工具清單與各辦公室的開關,不只是關掉一間辦公室。