OpenCore文档与知识连接器

Confluence

以 Markdown 格式查看

索引内容

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 Tokenconfluence_username: <CONFLUENCE_USERNAME> 和 confluence_access_token: <CONFLUENCE_API_TOKEN>Cloud 手工认证会组合使用用户名和 Token。
Server 或 Data Center Personal Access Tokenconfluence_username: <CONFLUENCE_USERNAME> 和 confluence_access_token: <CONFLUENCE_PERSONAL_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://<TENANT>.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 或更高版本上。

相关页面