> ## 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-Hans/reference/glossary#%E8%AE%A1%E5%88%92%E8%B4%9F%E8%B4%A3%E4%BA%BA) | 选择数据源，在 Living Security 中进行连接，启用数据流，并验证结果 |
| [**系统管理员**](/zh-Hans/reference/glossary#%E7%B3%BB%E7%BB%9F%E7%AE%A1%E7%90%86%E5%91%98) | 在源系统中创建或批准凭据和权限范围 |
这些角色可以由同一人担任。在 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 界面。身份数据应在员工队伍中生成预期的人员和身份；安全数据源的数据应出现在该提供商对应文档所述的功能中。
在入门引导中，旅程图的 **验证身份数据正在流动** 和 **验证集成数据正在流动** 任务会根据已摄取的数据完成。请勿以已保存的连接代替这些验证结果。
## 同步详情页
在 **设置** → **集成** → **同步** 中，打开任意同步，即可在一处查看其配置和运行历史。
详情页显示：
| 部分 | 包含内容 |
| - | - |
| **标题区** | 同步名称、状态标识和集成提供商 |
| **统计信息** | 模型、上次同步、已完成的运行次数和记录总数 |
| **运行历史** | 近期运行及其状态、时间和记录数 |
| **操作** | **刷新**、**暂停** / **简历** 和 **立即同步** |
当同步处于活动状态时，使用 **立即同步** 可触发立即运行。已暂停的同步必须先恢复，才会开始新的计划运行或手动运行。
当集成列出活动数据流时，您也可以从其连接详情页打开同步。
## 连接操作
连接详情页提供该集成所支持的操作：
| 操作 | 效果 |
| - | - |
| **立即同步** | 请求对所选数据流立即运行 |
| **暂停数据流** | 停止该数据流的新运行，同时保留连接 |
| **暂停连接** | 停止受支持的连接活动，但不删除配置 |
| **简历** | 重新启动已暂停的数据流或连接 |
| **重新授权** | 在凭据或授权同意发生变化后重新进行身份验证 |
| **删除** | 经确认后删除连接配置 |
删除连接与删除已从该连接摄取的数据不同。如果数据保留行为会影响您的决定，请查阅提供商指南或联系支持团队。
## 自定义推送源
当某个系统向 Living Security 发送数据，而不是通过目录连接器进行轮询时，请使用 **自定义推送源**。
1. 从 **目录** 底部创建该数据源。
2. 在自定义推送区域下打开其详情页。
3. 选择目标数据流。
4. 手动批量上传请使用 **上传 CSV**，自动发送方请使用 **通过 API 推送**。
5. 发送后，预览文件或负载，并查看该数据源的运行历史。
有关完整的端点、身份验证、负载、重试和验证约定，请参阅 [自定义推送源 API](/zh-Hans/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.