> ## Documentation Index
> Fetch the complete documentation index at: https://help.gorelo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 與 1Password 整合

> 將 1Password 與 Gorelo 整合，可跨保管庫同步項目以用於搜尋、嵌入與相關項目，建議使用 MSP 版本與 Service Account Token。

將 1Password 與 Gorelo 整合，可讓你的 1Password 項目在保管庫間同步到 Gorelo，以用於搜尋、嵌入、相關項目等。

我們建議使用 **MSP Edition**\
[**https://1password.com/product/enterprise-password-manager-msp-edition**](https://1password.com/product/enterprise-password-manager-msp-edition)

<Steps>
  <Step title="前往 Settings > Integrations" />

  <Step title="點擊 ⚙️ 齒輪圖示以設定 1Password。" />

  <Step title="填入必填欄位：">
    | 欄位                | 值                                                                                      | 範例                                                                                                                                               |
    | ----------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
    | **URL**           | 在任意 1Password 應用程式中右鍵點擊項目並選擇「Copy Private Link」，貼到此處以自動填入你的 Custom Domain 與 Account ID | `https://start.1password.com/open/i?a=ABCD1EFGH2IJKL3MNOP4QRST5U&v=abcd1234efgh5678ijkl9012mn&i=zyxw9876vuts5432rqpo1098ml&h=acme.1password.com` |
    | **Custom Domain** | 你的 [1password.com](http://1password.com) 子網域，將由你的 1Password 自動填入                       | `acme.1password.com`                                                                                                                             |
    | **Account ID**    | 你的 account ID，將由你的 1Password URL 自動填入                                                  | `ABCD1EFGH2IJKL3MNOP4QRST5U`                                                                                                                     |

    **Service Account Token：**

    * 前往你的 1Password 管理員主控台 > Developer > Service accounts。
    * 點擊右上角的 **New service account**。
    * 輸入 `Gorelo` 作為名稱。
    * 選擇你的保管庫並給予**寫入權限**。
    * 建立帳戶並將 service account token 複製到 Gorelo。

    <Frame>
      <img src="https://mintcdn.com/gorelo/LyPoOoPRjQWsuxm2/images/image-165.png?fit=max&auto=format&n=LyPoOoPRjQWsuxm2&q=85&s=44f21baae0a40ac804a12144ac312695" alt="Image" width="858" height="555" data-path="images/image-165.png" />
    </Frame>
  </Step>

  <Step title="點擊 Connect，Group 對應畫面會出現。">
    Vault mapping 畫面會出現。
  </Step>

  <Step title="將 Gorelo Groups 對應到適當的 1Password Vaults。">
    <Frame>
      <img src="https://mintcdn.com/gorelo/LyPoOoPRjQWsuxm2/images/image-166.png?fit=max&auto=format&n=LyPoOoPRjQWsuxm2&q=85&s=41a2e2774197675bd6dfdfcb665ec80e" alt="Image 166" width="997" height="373" data-path="images/image-166.png" />
    </Frame>
  </Step>

  <Step title="完成時點擊 Map。" />
</Steps>

## 疑難排解

<Accordion title="嘗試同步時，1Password 整合顯示『read only』權限。">
  你的整合可能缺少寫入權限（步驟 3）。要變更保管庫／權限，1Password 要求你**刪除並重新建立 service account**。在新增 Service Account Token 時務必加入寫入權限。
</Accordion>