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

# 数据源授权

XpertAI 支持多种外部数据源的连接。为了确保数据安全与访问控制，系统提供了灵活的授权机制，使知识流水线能够安全地访问和导入数据。
在 XpertAI 中，数据源授权可以通过 **系统集成** 或 **默认环境变量** 实现，支持多种授权方式，包括 **API Key** 与 **OAuth**。

***

## 数据源授权机制概述

XpertAI 的授权体系由两部分构成：

1. **默认环境变量授权**
   在系统部署或工作区环境中，可以通过环境变量预设各类 API Key，知识流水线在运行时将自动使用这些凭据完成授权，无需人工绑定。

2. **系统集成授权**
   XpertAI 提供统一的系统集成入口，管理员或开发者可在此配置外部服务的 API Key 或 OAuth （开发中）授权信息。
   系统集成支持多种认证模式，包括企业 API Key、OAuth Client，以及未来将支持的服务账号与签名令牌等方式。

<img src="https://mintcdn.com/xpertai/CUk-Ab9Rv7YWeJmd/public/img/ai/pipeline/pipeline-plugin-system-integration.png?fit=max&auto=format&n=CUk-Ab9Rv7YWeJmd&q=85&s=dedc166df39ff7003e52786671b42299" alt="pipeline integrations" width="844" height="1010" data-path="public/img/ai/pipeline/pipeline-plugin-system-integration.png" />

***

## 数据源授权入口

在 XpertAI 中，你可以通过以下两种方式配置数据源授权：

### 方式一：通过知识流水线编排界面

进入知识流水线编排界面，添加所需的数据源节点。
在右侧面板中点击 **绑定**，系统会自动检测该数据源是否存在有效授权：

* 若已配置系统集成或环境变量，将自动连接；
* 若无授权信息，将提示前往系统集成页面进行授权。

***

### 方式二：通过系统设置界面

点击左下角设置，选择 **系统集成**，进入系统集成配置页面。
选择需要授权的系统，点击 **配置**，即可为该系统添加或更新授权凭据。

***

## 支持的数据源与授权方式

| 数据源        | 默认环境变量 | API Key | OAuth |
| ---------- | ------ | ------- | ----- |
| Firecrawl  | ✅      | ✅       |       |
| 飞书文档（Lark） | ✅      | ✅       | ✅     |

> 更多第三方数据源（如 OneDrive、Notion、Google Drive）将在后续版本中支持。

***

## 授权方式说明

### 1. API Key 授权

API Key 是最常见的授权方式，适用于需要直接调用外部接口的集成服务。
用户可在相应服务平台生成 API Key 并通过以下两种方式配置：

* **方式 A：环境变量授权**
  将 API Key 写入系统环境变量（如 `LARK_APP_ID`、`LARK_APP_SECRET`）。流水线运行时将自动识别使用。

* **方式 B：系统集成配置**
  前往 **系统设置 → 系统集成**，选择对应系统并点击 **添加 API Key**。
  输入密钥后点击 **保存**，授权信息将被安全加密存储，状态显示为 **已连接**。

***

### 2. OAuth 授权 （开发中）

OAuth 是一种标准化授权协议，适用于用户需通过登录方式访问云端文档或企业资源的场景。
XpertAI 支持两种 OAuth 授权模式：

#### 模式 A：默认客户端（系统内置）

对于 SaaS 版本的 XpertAI，部分主流数据源（如飞书文档）已由官方预置 OAuth 客户端配置。
用户仅需点击授权并确认权限范围，即可一键完成授权。

#### 模式 B：自定义客户端

对于自建部署或未预置的数据源，可在第三方平台注册并获取 OAuth Client 参数（`Client ID` 与 `Client Secret`）。
随后在 **系统设置 → 系统集成 → 添加 OAuth** 页面中填写并保存，即可完成授权。
