> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.alephant.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server. # Confluence > 通过明确的范围与权限边界配置 Confluence Cloud 或 Server 和 Data Center 索引。 ## 索引内容 Confluence 连接器会索引 Confluence Cloud 或 Confluence Server 和 Data Center 中的页面、页面评论与受支持附件。页面和附件层级会保留下来，用于导航与检索。 请在连接器表单中只选择一种范围： | 范围 | 索引效果 | | ---------- | --------------------------------------------------- | | Everything | 索引凭据可读取的所有页面。 | | Space | 索引一个 Confluence Space Key 中的页面。 | | Page | 索引一个 Page ID，可选是否包含所有后代页面。 | | CQL Query | 索引只返回页面的 CQL 查询结果；OpenCore 会添加自己的更新时间过滤，并继续处理评论和附件。 | CQL 必须只返回 `page` 对象。不要添加 `lastmodified` 过滤器，因为更新窗口由连接器负责。不受支持或过大的附件，以及未启用图像处理时的图像，可能会被跳过。 ## 前置条件 * OpenCore Admin 必须知道来源是 Confluence Cloud 还是 Server 和 Data Center，并持有正确的 Wiki Base URL。 * 凭据必须能够读取所选访问模式需要的全部 Space、页面、评论、附件、用户、用户组和限制信息。 * Confluence Cloud OAuth 需要 `OAUTH_CONFLUENCE_CLOUD_CLIENT_ID`、`OAUTH_CONFLUENCE_CLOUD_CLIENT_SECRET`、正确的 `WEB_DOMAIN` 和部署的 OAuth 状态存储。 * OAuth 只针对 Confluence Cloud 实现。Server 和 Data Center 使用手工创建的 Personal Access Token 凭据。 * 在 Confluence Data Center 9.1 或更高版本上同步源权限时，请使用可读取 REST Space 权限的账号；当前验证会把所需管理员访问视为必需条件。 ## 凭据 | 方式 | OpenCore 凭据值 | 说明 | | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- | | Confluence Cloud OAuth | 无需粘贴 Token。授权后在收尾步骤中选择可访问的 Confluence Site。 | OpenCore 会保存 Access/Refresh Token、所选 Cloud ID、Site 名称和 Wiki URL。OAuth 续期需要继续使用相同的已配置 OAuth 客户端。 | | Cloud API Token | `confluence_username: ` 和 `confluence_access_token: ` | Cloud 手工认证会组合使用用户名和 Token。 | | Server 或 Data Center Personal Access Token | `confluence_username: ` 和 `confluence_access_token: ` | Admin 表单会收集两个字段；非 Cloud 实例运行时采用 Token 认证。 | 只有使用 Scoped Confluence Token 时才启用 **Using scoped token**。该模式会调整 API URL 和认证路径，并使用兼容的 Space Endpoint。 ## 在 OpenCore 中配置 1. 在 Admin 后台打开 **Connectors**，选择 **Confluence**，然后创建或选择凭据。 2. 正确设置 **Is Cloud**。OAuth 凭据会把该值锁定为 Cloud。 3. 输入 Wiki Base URL；Cloud 可以使用 `https://.atlassian.net/wiki` 形式。 4. 仅当手工 Token 属于 Scoped Token 时才启用 **Using scoped token**。 5. 选择 Everything、Space、Page 或 CQL Query，并只填写该范围对应的字段。 6. 选择部署支持的文档访问模式，设置刷新和清理选项，然后创建连接器。 7. 运行首次索引尝试并检查被跳过的附件或权限错误。 ## 权限 Confluence 源权限同步是一项有部署条件的能力。当 **Auto Sync Permissions** 可用且已选择时，OpenCore 可以解析 Space 权限、页面及祖先限制、用户和用户组。Cloud OAuth 会请求内容、权限、用户、用户组、附件、搜索和离线访问的读取 scope。 源权限同步不可用或未选择时，OpenCore 搜索不会自动执行 Confluence 限制。对于受限知识，请使用 **Private** 并显式分配 OpenCore 用户组；只有当所有 OpenCore 账号都可查看已索引页面和附件时，才使用 **Public**。 ## 验证 1. 确认凭据探测能够找到至少一个可访问的 Space。 2. 运行索引尝试，确认所选范围内的页面已经出现。 3. 如果来源中存在评论和受支持附件，检查它们是否可搜索。 4. 确认所选 Space、页面子树或 CQL 结果之外的页面不存在。 5. 如果选择了 Auto Sync Permissions，分别使用一个获准和一个受限的 Confluence 用户测试。 ## 故障排除 | 现象 | 检查项 | | -------------------- | ---------------------------------------------------------------------------- | | 找不到 Space | 检查 Wiki Base URL、Cloud 开关、Token 类型和凭据访问权。 | | OAuth 无法启动或续期 | 检查两个 Confluence OAuth 客户端变量、回调域名和 OAuth 状态存储。 | | CQL 连接器失败或返回意外内容 | 要求 `type=page`，移除 `lastmodified`，并在同一 Confluence 实例中验证查询。 | | 缺少附件 | 检查源权限、文件支持与大小，并确认图像附件是否已启用图像处理。 | | Data Center 上的权限同步失败 | 使用对 REST Space Permissions Endpoint 具有管理员访问权的账号，特别是在 Data Center 9.1 或更高版本上。 | ## 相关页面 * [连接器与索引](/opencore/knowledge/connectors) * [索引设置](/opencore/knowledge/index-settings)