> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 設定整合
> 準備提供者憑證、連接受支援的系統、啟用其資料串流，並驗證首次成功同步。
本指南說明適用於 **設定 → 集成 → 目錄** 下所列整合的一般設定流程。各提供者專屬的欄位、權限與驗證步驟，請參閱該提供者「目錄」卡片上連結的設定指南。
## 先決條件
| 角色 | 職責 |
| - | - |
| [**計畫負責人**](/zh-Hant/reference/glossary#%E8%A8%88%E7%95%AB%E8%B2%A0%E8%B2%AC%E4%BA%BA%EF%BC%88program-owner%EF%BC%89) | 選擇來源、在 Living Security 中連接來源、啟用串流並驗證結果 |
| [**系統管理員**](/zh-Hant/reference/glossary#%E7%B3%BB%E7%B5%B1%E7%AE%A1%E7%90%86%E5%93%A1%EF%BC%88system-administrator%EF%BC%89) | 在來源系統中建立或核准憑證與範圍 |
這些角色可由同一人擔任。在 Living Security 中輸入憑證的人員，必須具備允許管理整合的管理員角色；請勿僅因假設存在權限範圍受限的設定角色，就邀請來源系統管理員加入 Living Security。
開始之前：
* 選擇連線所屬的 Living Security 組織與環境。
* 開啟提供者的目錄指南，並蒐集其所需的範圍、重新導向 URL 及允許清單要求。
* 若由不同人員建立與輸入憑證，請使用貴組織核准的機密共享流程。
* 切勿透過電子郵件或支援工單傳送密碼、用戶端密鑰、私密金鑰或存取金鑰的值。
## 1. 準備提供者憑證
開啟 **設定 → 集成 → 目錄**，找到該提供者，並在建立憑證之前閱讀其設定指南。
提供者的驗證方式可能使用 OAuth 同意、API 權杖、用戶端 ID 與密鑰、服務帳戶，或提供者支援的其他方法。請僅建立該提供者指南中所列的憑證與範圍。
請勿複製其他提供者的權限，也不要「以防萬一」而授予廣泛的寫入權限。
缺少權限通常會產生明確的 401 或 403 錯誤，可加以修正；
過度授權則會帶來可避免的風險。
## 2. 連接提供者
前往 **設定 → 集成 → 目錄** 並選擇提供者。
選擇 **連接**。請完成 OAuth 流程，或輸入連線對話方塊中要求的欄位。
各個值的來源請參閱提供者指南。
如適用，請在提供者的同意畫面中核准。驗證成功後，Living Security 會在 **已連接** 下開啟或列出新的連線。
若提供者拒絕驗證，請先停止，並在繼續之前修正憑證、租用戶、區域、重新導向 URL 或來源系統權限。
## 3. 啟用資料串流
在 **設定 → 集成 → 已連接** 下開啟該連線。Living Security 會探索該提供者可用的同步範本，並將其列為串流。
1. 檢視每個串流的名稱與用途。
2. 僅啟用您的計畫所需的串流。
3. 讓不相關的串流保持暫停。
4. 可用時，請使用 **立即同步** 要求執行第一次同步。
並非每個提供者都提供相同的串流或排程控制。請依照連線上顯示的控制項操作，不要預期會有通用的頻率、範圍、欄位對應、草稿或啟用精靈。
## 4. 驗證首次執行
僅憑連線驗證成功，並不能證明資料正在流動。
確認連線狀態正常，且未要求重新授權。
確認所需的串流已啟用，而非處於暫停狀態。
開啟該串流、連線的同步連結，或 **設定** → **集成** → **同步**。請等待取得成功的最終結果，並在可用時檢視提供者錯誤與記錄筆數。
開啟相關的 Living Security 介面。身分資料應在員工中產生預期的人員與身分；安全來源資料則應顯示於該提供者所記載的功能中。
就入門引導而言，旅程地圖中的 **Verify Identity Data Flowing** 與 **Verify Integration Data Flowing** 任務會根據已擷取的資料完成。請勿以已儲存的連線取代這些驗證結果。
## 同步詳細資料頁面
在 **設定** → **集成** → **同步** 中，開啟任一同步即可在同一處檢視其設定與執行記錄。
詳細資料頁面會顯示：
| 區段 | 內容 |
| - | - |
| **標頭** | 同步名稱、狀態標章與整合提供者 |
| **統計資料** | 模型、上次同步、已完成的執行次數與記錄總數 |
| **執行記錄** | 近期執行的狀態、時間與記錄筆數 |
| **操作** | **刷新**、**暫停** / **履歷** 與 **立即同步** |
當同步處於啟用狀態時，請使用 **立即同步** 觸發即時執行。已暫停的同步必須先恢復，才會開始新的排程執行或手動執行。
當整合列出作用中的串流時，您也可以從其連線詳細資料頁面開啟同步。
## 連線操作
連線詳細資料頁面提供該整合所支援的操作：
| 操作 | 效果 |
| - | - |
| **立即同步** | 要求對所選串流立即執行 |
| **暫停串流** | 停止該串流的新執行，但保留連線 |
| **暫停連接** | 停止受支援的連線活動，但不刪除設定 |
| **履歷** | 重新啟動已暫停的串流或連線 |
| **重新授權** | 在憑證或同意變更後重複驗證 |
| **刪除** | 經確認後刪除連線設定 |
刪除連線與刪除已從該連線擷取的資料並不相同。若資料保留行為會影響您的決定，請參閱提供者指南或聯絡支援團隊。
## 自訂推送來源
當系統是將資料傳送至 Living Security，而非透過目錄連接器進行輪詢時，請使用 **自訂推送來源**。
1. 從 **目錄** 底部建立來源。
2. 在自訂推送區域下開啟其詳細資料頁面。
3. 選擇目的地串流。
4. 手動批次請使用 **上傳 CSV**，自動化傳送端則使用 **透過 API 推送**。
5. 傳送後，預覽檔案或酬載，並檢視該來源的執行記錄。
如需完整的端點、驗證、酬載、重試及驗證規範，請參閱[自訂推送來源 API](/zh-Hant/integrations/custom-push-source)。請勿從較舊的 Unify 整合指南推斷這些細節。
來源詳細資料頁面的上傳工具可接受最大 100 MB 的來源 CSV 檔案。上傳前，儀表板會在用戶端將其分割為每個請求不超過 10 MB 且不超過 10,000 列的請求。此來源專屬的上傳工具與用於身分和活動範本的一般 **集成 → 上傳** 頁面是分開的。
## 疑難排解
| 症狀 | 檢查項目 |
| - | - |
| `401 Unauthorized` | 憑證值、到期、撤銷、提供者租用戶及重新授權狀態 |
| `403 Forbidden` | 所需的提供者角色、範圍、管理員同意及來源系統存取原則 |
| 連線立即失敗 | 重新導向 URL、區域、來源 URL、網路或 IP 允許清單要求 |
| 連線正常但未發生任何執行 | 所需串流已啟用，且提供者提供該串流 |
| 執行成功但未傳回任何記錄 | 來源帳戶能看到預期的對象範圍，且提供者端的任何篩選條件正確 |
| 資料出現在錯誤的人員名下 | 各已連接來源之間的身分屬性與別名一致 |
| 資料停止更新 | 串流或連線已暫停、憑證已過期，或最近一次執行失敗 |
聯絡 [Living Security 支援團隊](mailto:support@livingsecurity.com)時，請提供組織、提供者、連線名稱、串流、最近一次執行時間及可見的錯誤。請勿提供機密資訊。
## 相關內容
已連接、目錄、同步、操作與上傳的參考資料。
了解支援的屬性，以及可用時的對應方式。
透過重新授權或刪除來管理現有的整合。
完成身分與安全資料的驗證任務。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.