> ## 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.

# Thiết lập một tích hợp

> Chuẩn bị thông tin xác thực của nhà cung cấp, kết nối hệ thống được hỗ trợ, bật các luồng dữ liệu và xác minh lần đồng bộ hóa thành công đầu tiên.

Hướng dẫn này trình bày quy trình thiết lập chung cho các tích hợp được liệt kê tại **Cài đặt → Tích hợp → Danh mục**. Các trường, quyền và bước xác thực riêng của từng nhà cung cấp được nêu trong hướng dẫn thiết lập được liên kết trên thẻ Danh mục của nhà cung cấp đó.

## Điều kiện tiên quyết

| Vai trò | Trách nhiệm |
| - | - |
| [**Chủ sở hữu chương trình**](/vi/reference/glossary#ch%E1%BB%A7-s%E1%BB%9F-h%E1%BB%AFu-ch%C6%B0%C6%A1ng-tr%C3%ACnh) | Chọn nguồn, kết nối nguồn đó trong Living Security, bật các luồng dữ liệu và xác minh kết quả |
| [**Quản trị viên hệ thống**](/vi/reference/glossary#qu%E1%BA%A3n-tr%E1%BB%8B-vi%C3%AAn-h%E1%BB%87-th%E1%BB%91ng) | Tạo hoặc phê duyệt thông tin xác thực và phạm vi quyền trong hệ thống nguồn |

Các vai trò này có thể do cùng một người đảm nhiệm. Người nhập thông tin xác thực trong Living Security phải có vai trò quản trị viên cho phép quản lý tích hợp; không mời quản trị viên của hệ thống nguồn vào Living Security chỉ dựa trên giả định rằng có một vai trò thiết lập với phạm vi quyền hạn hẹp.

Trước khi bắt đầu:

* Chọn tổ chức và môi trường Living Security mà kết nối sẽ thuộc về.
* Mở hướng dẫn trong Danh mục của nhà cung cấp và thu thập các phạm vi quyền, URL chuyển hướng và yêu cầu về danh sách cho phép.
* Sử dụng quy trình chia sẻ bí mật đã được tổ chức của quý vị phê duyệt nếu người tạo và người nhập thông tin xác thực là những người khác nhau.
* Không bao giờ gửi mật khẩu, client secret, khóa riêng tư hoặc giá trị khóa truy cập qua email hoặc phiếu hỗ trợ.

## 1. Chuẩn bị thông tin xác thực của nhà cung cấp

Mở **Cài đặt → Tích hợp → Danh mục**, tìm nhà cung cấp và đọc hướng dẫn thiết lập của nhà cung cấp đó trước khi tạo thông tin xác thực.

Việc xác thực với nhà cung cấp có thể sử dụng sự đồng ý OAuth, mã thông báo API, client ID và secret, tài khoản dịch vụ hoặc phương thức khác do nhà cung cấp hỗ trợ. Chỉ tạo những thông tin xác thực và phạm vi quyền được nêu trong hướng dẫn của nhà cung cấp đó.

<Warning>
  Không sao chép quyền từ nhà cung cấp khác và không cấp quyền ghi rộng
  “phòng khi cần”. Việc thiếu quyền thường tạo ra lỗi 401 hoặc 403 rõ ràng
  có thể khắc phục; việc cấp quyền quá mức tạo ra rủi ro không cần thiết.
</Warning>

## 2. Kết nối nhà cung cấp

<Steps>
  <Step title="Mở Danh mục">
    Đi tới **Cài đặt → Tích hợp → Danh mục** và chọn nhà cung cấp.
  </Step>

  <Step title="Bắt đầu kết nối">
    Chọn **Kết nối**. Hoàn tất quy trình OAuth hoặc nhập các trường được yêu cầu
    trong hộp thoại kết nối. Hướng dẫn của nhà cung cấp giải thích nguồn gốc của
    từng giá trị.
  </Step>

  <Step title="Hoàn tất xác thực">
    Phê duyệt màn hình đồng ý của nhà cung cấp khi có. Sau khi xác thực thành công, Living Security mở hoặc liệt kê kết nối mới trong mục **đã kết nối**.
  </Step>
</Steps>

Nếu nhà cung cấp từ chối xác thực, hãy dừng lại và chỉnh sửa thông tin xác thực, tenant, khu vực, URL chuyển hướng hoặc quyền của hệ thống nguồn trước khi tiếp tục.

## 3. Bật các luồng dữ liệu

Mở kết nối tại **Cài đặt → Tích hợp → đã kết nối**. Living Security phát hiện các mẫu đồng bộ hóa có sẵn cho nhà cung cấp đó và liệt kê chúng dưới dạng các luồng.

1. Xem lại tên và mục đích của từng luồng.
2. Chỉ bật những luồng mà chương trình của quý vị cần.
3. Để các luồng không liên quan ở trạng thái tạm dừng.
4. Sử dụng **Đồng bộ hóa ngay** khi có để yêu cầu lần chạy đầu tiên.

Không phải nhà cung cấp nào cũng có cùng các luồng hoặc tùy chọn điều khiển lịch trình. Hãy làm theo các điều khiển hiển thị trên kết nối thay vì kỳ vọng có một trình hướng dẫn chung về tần suất, phạm vi, ánh xạ trường, bản nháp hoặc kích hoạt.

## 4. Xác minh lần chạy đầu tiên

Riêng việc xác thực kết nối không chứng minh rằng dữ liệu đang được truyền.

<Steps>
  <Step title="Kiểm tra tình trạng kết nối">
    Xác nhận kết nối ở trạng thái tốt và không yêu cầu xác thực lại.
  </Step>

  <Step title="Kiểm tra trạng thái luồng">
    Xác nhận luồng cần thiết đã được bật thay vì bị tạm dừng.
  </Step>

  <Step title="Kiểm tra lần chạy gần nhất">
    Mở luồng, liên kết đồng bộ hóa của kết nối hoặc **Cài đặt** → **Tích hợp** → **Đồng bộ hóa**. Chờ kết quả cuối cùng thành công và xem lại các lỗi của nhà cung cấp cũng như số lượng bản ghi khi có.
  </Step>

  <Step title="Xác nhận dữ liệu ở hạ nguồn">
    Mở khu vực liên quan của Living Security. Dữ liệu danh tính sẽ tạo ra những người và danh tính dự kiến trong Lực lượng lao động; dữ liệu từ nguồn bảo mật sẽ xuất hiện trong tính năng được nhà cung cấp đó mô tả.
  </Step>
</Steps>

Đối với quá trình giới thiệu ban đầu, các tác vụ **Verify Identity Data Flowing** và **Verify Integration Data Flowing** của Journey Map được hoàn thành dựa trên dữ liệu đã được nhập. Không dùng một kết nối đã lưu để thay thế cho các kết quả xác minh đó.

## Trang chi tiết đồng bộ hóa

Từ **Cài đặt** → **Tích hợp** → **Đồng bộ hóa**, hãy mở bất kỳ đồng bộ hóa nào để xem cấu hình và lịch sử chạy của nó tại một nơi.

Trang chi tiết hiển thị:

| Phần | Nội dung bao gồm |
| - | - |
| **Tiêu đề** | Tên đồng bộ hóa, huy hiệu trạng thái và nhà cung cấp tích hợp |
| **Thống kê** | Mô hình, lần đồng bộ hóa gần nhất, số lần chạy đã hoàn tất và tổng số bản ghi |
| **Lịch sử chạy** | Các lần chạy gần đây cùng trạng thái, thời gian và số lượng bản ghi |
| **Hành động** | **Làm mới**, **Tạm dừng** / **Sơ yếu lý lịch** và **Đồng bộ hóa ngay** |

Sử dụng **Đồng bộ hóa ngay** để kích hoạt một lần chạy ngay lập tức khi đồng bộ hóa đang hoạt động. Các đồng bộ hóa đang tạm dừng phải được tiếp tục trước khi các lần chạy theo lịch hoặc thủ công mới bắt đầu.

Quý vị cũng có thể mở một đồng bộ hóa từ trang chi tiết kết nối của nó khi tích hợp liệt kê các luồng đang hoạt động.

## Thao tác với kết nối

Trang chi tiết kết nối hiển thị các thao tác được tích hợp đó hỗ trợ:

| Thao tác | Tác dụng |
| - | - |
| **Đồng bộ hóa ngay** | Yêu cầu chạy ngay lập tức cho luồng đã chọn |
| **Tạm dừng luồng** | Dừng các lần chạy mới của luồng đó nhưng vẫn giữ kết nối |
| **Tạm dừng kết nối** | Dừng hoạt động của kết nối được hỗ trợ mà không xóa cấu hình |
| **Sơ yếu lý lịch** | Khởi động lại luồng hoặc kết nối đang tạm dừng |
| **Xác thực lại** | Lặp lại việc xác thực sau khi thông tin xác thực hoặc sự đồng ý thay đổi |
| **Loại bỏ** | Xóa cấu hình kết nối sau khi xác nhận |

Việc loại bỏ một kết nối không giống với việc xóa dữ liệu đã được nhập từ kết nối đó. Hãy xem hướng dẫn của nhà cung cấp hoặc liên hệ bộ phận Hỗ trợ nếu cách lưu giữ dữ liệu ảnh hưởng đến quyết định của quý vị.

## Nguồn đẩy tùy chỉnh

Sử dụng **Custom Push Source** khi một hệ thống gửi dữ liệu đến Living Security thay vì được thăm dò qua một trình kết nối trong Danh mục.

1. Tạo nguồn từ cuối trang **Danh mục**.
2. Mở trang chi tiết của nguồn trong khu vực đẩy tùy chỉnh.
3. Chọn luồng đích.
4. Sử dụng **Tải lên CSV** cho một lô thủ công hoặc **Đẩy qua API** cho trình gửi tự động.
5. Xem trước tệp hoặc payload và xem lại lịch sử chạy của nguồn sau khi gửi.

Để biết đầy đủ về endpoint, xác thực, payload, thử lại và quy ước xác minh, hãy xem [Custom Push Source API](/vi/integrations/custom-push-source). Không suy đoán các chi tiết đó từ hướng dẫn tích hợp Unify cũ hơn.

Trình tải lên trong trang chi tiết nguồn chấp nhận tệp CSV nguồn có dung lượng tối đa 100 MB. Trước khi tải lên, Bảng điều khiển chia tệp phía máy khách thành các yêu cầu có dung lượng không quá 10 MB và không quá 10,000 hàng mỗi yêu cầu. Trình tải lên dành riêng cho nguồn này tách biệt với trang **Tích hợp → Tải lên** chung dành cho các mẫu danh tính và hoạt động.

## Khắc phục sự cố

| Triệu chứng | Kiểm tra |
| - | - |
| `401 Unauthorized` | Giá trị thông tin xác thực, thời hạn, việc thu hồi, tenant của nhà cung cấp và trạng thái xác thực lại |
| `403 Forbidden` | Vai trò, phạm vi quyền, sự đồng ý của quản trị viên và chính sách truy cập hệ thống nguồn mà nhà cung cấp yêu cầu |
| Kết nối thất bại ngay lập tức | URL chuyển hướng, khu vực, URL nguồn, yêu cầu về danh sách cho phép mạng hoặc IP |
| Kết nối ở trạng thái tốt nhưng không có lần chạy nào | Luồng cần thiết đã được bật và nhà cung cấp có cung cấp luồng đó |
| Lần chạy thành công nhưng không trả về bản ghi nào | Tài khoản nguồn có thể thấy đúng tập đối tượng dự kiến và mọi bộ lọc phía nhà cung cấp đều chính xác |
| Dữ liệu xuất hiện ở sai người | Các thuộc tính danh tính và bí danh nhất quán giữa các nguồn đã kết nối |
| Dữ liệu ngừng cập nhật | Luồng hoặc kết nối đang tạm dừng, thông tin xác thực đã hết hạn hoặc lần chạy gần nhất thất bại |

Khi liên hệ [Bộ phận Hỗ trợ Living Security](mailto:support@livingsecurity.com), hãy cung cấp tổ chức, nhà cung cấp, tên kết nối, luồng, thời điểm chạy gần nhất và lỗi hiển thị. Không bao gồm các bí mật.

## Nội dung liên quan

<CardGroup cols={2}>
  <Card title="Tổng quan về Tích hợp" icon="grid-2" href="/vi/integrations/overview">
    Tài liệu tham khảo về đã kết nối, Danh mục, Đồng bộ hóa, Hành động và Tải lên.
  </Card>

  <Card title="Ánh xạ dữ liệu" icon="arrows-left-right" href="/vi/integrations/managing/data-mapping">
    Tìm hiểu các thuộc tính và ánh xạ được hỗ trợ khi có.
  </Card>

  <Card title="Vòng đời tích hợp" icon="route" href="/vi/integrations/managing/lifecycle">
    Vận hành một tích hợp hiện có, bao gồm xác thực lại hoặc loại bỏ.
  </Card>

  <Card title="Giới thiệu ban đầu dành cho quản trị viên" icon="circle-check" href="/vi/getting-started/onboarding">
    Hoàn tất các tác vụ xác minh dữ liệu danh tính và dữ liệu bảo mật.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.