Confluence Cloud Microsoft Graph 连接器
Confluence Cloud Microsoft Graph 连接器允许组织为 Confluence 内容编制索引。 配置连接器并索引 Confluence 站点中的数据后，最终用户可以在Microsoft搜索中搜索这些内容。
本文适用于 Microsoft 365 管理员或配置、运行和监视 Confluence Cloud 连接器的任何人。 它补充了Microsoft 365 管理中心文章中设置Microsoft Graph 连接器中提供的一般说明。 如果尚未执行此操作，请阅读整篇文章以了解常规设置过程。
下面列出了安装过程中的每个步骤，以及一条说明，指示应遵循常规设置说明或仅适用于 Confluence Cloud 连接器的其他说明，包括有关 故障排除 和 限制的信息。
开始之前
你必须是组织的 Microsoft 365 租户的管理员，以及组织的 Confluence 站点的管理员。
重要
- Atlassian 正在弃用一组 confluence 云 API (V1 版本) ， (V2 版本) 发布新的 API。 你可以 在此处 或 此处阅读有关其公告的信息。 其中一些已弃用的 v1 API 仅由连接器用于 OAuth 连接 。 因此，发布此更改后，现有 Confluence 连接 () 可能会停止工作。 此更改计划于 1 月 24 日进行。
- 迁移到新 v2 API 的更改将于 2023 年 12 月发布给所有客户。 发布此版本后，需要重新对现有连接进行身份验证。 与以前的 v1 API 相比，新的 v2 API 还需要更多范围 (，) 在重新身份验证期间需要提供。 需要新的范围集 (完整列表) –
read:group:confluence、、read:user:confluence、Read:space:confluenceRead:permission:confluenceread:content-details:confluence、read:audit-log:confluenceread:content.metadata:confluence和 。read:page:confluence
步骤 1：在Microsoft 365 管理中心中添加连接器
按照常规 设置说明进行操作。
步骤 2：命名连接
按照常规 设置说明进行操作。
步骤 3：配置连接设置
若要连接到 Confluence 站点，请使用站点 URL。 Confluence 云站点 URL 通常类似于 https://< organization_name.atlassian.net/>。 可以选择基本身份验证或 OAuth 2.0 (建议) 向 Confluence 站点进行身份验证。
提示
确保服务 帐户有权查看 要编制索引的 Confluence 内容。
基本身份验证
输入帐户的用户名 (通常为电子邮件 ID) 和 API 令牌，以便使用基本身份验证进行身份验证。若要了解有关生成 API 令牌的详细信息，请参阅 Atlassian 的文档，了解如何 管理 Atlassian 帐户的 API 令牌。
OAuth 2.0 (建议)
在 Confluence Cloud 中注册应用，以便Microsoft搜索应用可以访问该实例。 若要了解详细信息，请参阅 Atlassian 支持文档，了解如何 启用 OAuth 2.0。
以下步骤提供了有关如何注册应用的指南：
- 使用 Atlassian Confluence 管理员帐户登录到 Atlassian 开发人员控制台。
- 单击“创建”，然后选择 。
OAuth 2.0 integration - 为应用程序提供适当的名称并创建新应用。
-
Permissions从左侧导航窗格导航到 。 单击 “添加”。Confluence API添加后，单击“ 配置”、“ 编辑范围 ”，然后选择以下范围。
| 范围名称 | 代码 | 说明 |
|---|---|---|
| 查看内容详细信息 | read:content-details:confluence |
对满足条件的内容进行爬网 |
| 查看组 | read:group:confluence |
访问内容的组权限 |
| 查看用户详细信息 | read:user:confluence |
访问单个用户详细信息以支持权限 |
- 单击保存。
-
Authorization从左侧导航窗格导航到 。 为 M365 企业版添加回调 URL，https://gcs.office.com/v1.0/admin/oauth/callback为 M365 政府版添加https://gcsgcc.office.com/v1.0/admin/oauth/callback回调 URL，并保存更改。 -
Settings从左侧导航窗格导航到 。 你将从此页面获取Client ID和Secret。
使用 客户端 ID 和 机密完成连接设置步骤。
步骤 4：选择属性并筛选数据
在此步骤中，可以在 Confluence 数据源中添加或删除可用属性。 Microsoft 365 默认选择了几个属性。
在此处选择的属性列表可能会影响在 Copilot for Microsoft 365 中筛选、搜索和查看结果的方式。
| Source 属性 | Label | 说明 |
|---|---|---|
| 作者 | authors |
参与/协作处理数据源中项的人员的名称。 |
| CreatedByName | createdBy |
数据源中项的最近编辑者的姓名。 |
| CreatedOn | createdDateTime |
在数据源中创建项的日期和时间。 |
| IconUrl | iconUrl |
项的关联图标 URL。 |
| 标题 | title |
要在搜索和其他体验中显示的项的标题。 |
| UpdatedByName | lastModifiedBy |
数据源中项的最近编辑者的姓名。 |
| UpdatedOn | lastModifiedDateTime |
上次在数据源中修改项的日期和时间。 |
| URL | url |
数据源中项的目标 URL。 |
使用 Confluence 查询语言 (CQL) 字符串，可以指定同步页面的条件。 它类似于 SQL Select 语句中的 Where 子句。 例如，可以选择仅为过去两年修改的页面编制索引。 若要了解如何创建自己的查询字符串，请参阅 使用 CQL 进行高级搜索。 默认情况下，连接器将为所有博客和页面编制索引。
提示
可以使用 CQL 筛选器为 特定时间后修改的内容 编制索引， lastModified >= “2018/12/31”
使用预览结果按钮验证所选属性和 CQL 字符串的示例值。
步骤 5：管理搜索权限
Confluence Cloud Microsoft Graph 连接器支持对 所有人 或 只有有权访问此数据源的人员可见的搜索权限。 如果选择“ 所有人”，则索引数据将显示在所有用户的搜索结果中。 如果选择“ 仅有权访问此数据源的人员”，则索引数据将显示在有权访问这些数据源的用户的搜索结果中。
在 Confluence Cloud 中，用户和组的安全权限是使用空间权限和页面限制定义的。 页面级别限制（如果存在）将优先于空间权限。
如果没有页面限制，连接器将检查空间级别权限 -
- 如果空间启用了“匿名用户”访问，则内容将对租户中的所有用户可见。
- 如果未启用“匿名访问”，则会遵循空间级别权限。
- 如果未定义空间级别权限，则租户中的任何用户都看不到内容。
重要
权限仅在空间和页面级别进行管理，并且不会考虑父页权限。
如果选择“仅有权访问此数据源的人员”，则需要进一步选择 Confluence 站点具有Microsoft Entra ID预配用户还是非 AAD 用户。
若要确定哪个选项适合你的组织，请执行以下操作：
- 如果 Confluence 用户的电子邮件 ID 与 Microsoft Entra ID 中用户的 UserPrincipalName (UPN) 相同，请选择“Microsoft Entra ID”选项。
- 如果 Confluence 用户的电子邮件 ID 不同于 userPrincipalName (UPN) Microsoft Entra ID，请选择“非 AAD”选项。
注意
- 如果选择Microsoft Entra ID作为标识源的类型，连接器会将从 Confluence 获取的用户Email ID 直接映射到 Microsoft Entra ID 中的 UPN 属性。
- 如果为标识类型选择“非 AAD”，请参阅 映射非 Azure AD 标识 以获取有关映射标识的说明。 可以使用此选项提供从 Email ID 到 UPN 的映射正则表达式。
- 汇报管理访问权限的用户或组仅在完全爬网中同步。 增量爬网当前不支持处理权限更新。
步骤 6：分配属性标签
按照常规 设置说明进行操作。
步骤 7：管理架构
按照常规 设置说明进行操作。
步骤 8：选择刷新设置
按照常规 设置说明进行操作。
注意
对于访问权限更新，将仅应用计划的完全爬网。
步骤 9：查看连接
按照常规 设置说明进行操作。
发布连接后，需要自定义搜索结果页。 若要了解如何自定义搜索结果，请参阅 自定义搜索结果页。
步骤 10：设置搜索结果页
发布连接后，需要使用垂直和结果类型自定义搜索结果页。 若要了解如何自定义搜索结果，请查看如何 管理垂直 和 结果类型。 还可以使用 Confluence 云连接器 的示例结果布局 。 复制粘贴结果布局 JSON 以开始使用。
限制
Confluence 云连接器在其最新版本中具有以下已知限制：
- Confluence Cloud 连接器不为附件文件和注释编制索引。
- 索引服务器和数据中心部署将作为单独的连接器发布。
疑难解答
发布连接后，可以在管理中心的“数据源”选项卡下查看状态。 若要了解如何进行更新和删除，请参阅 管理连接器。 可 在此处找到常见问题的故障排除步骤。
如果你有任何其他问题或想要提供反馈，请通过 Microsoft Graph 与我们联系 |支持