Confluence Cloud Microsoft Graph 连接器

Confluence Cloud Microsoft Graph 连接器允许组织为 Confluence 内容编制索引。 配置连接器并索引 Confluence 站点中的数据后，最终用户可以在Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®中搜索这些内容。

本文适用于Microsoft负责配置、运行和监视 Confluence Cloud Microsoft Graph 连接器的 365 名管理员。 它补充了在 Microsoft 365 管理中心 中设置 Microsoft Graph 连接器时提供的一般说明。

优点

• 增强的搜索功能：用户可以询问有关 Copilot 中 Wiki 内容的自然语言问题，例如：
  • 汇总体系结构文档
    
  • 如何获取对门户的访问权限
    
• 语义搜索支持：用户可以执行自然语言查询以获取准确的响应。
  

先决条件

1. 你必须是组织的 Microsoft 365 租户的管理员，以及组织的 Confluence 站点的管理员。
2. 身份验证：确保具有具有正确访问权限的身份验证凭据。

限制

• 不为附件文件或批注编制索引。

重要

• 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:confluenceread:content-details:confluence、Read:space:confluence、 read:content.metadata:confluenceRead:permission:confluenceread:audit-log:confluence和 。read:page:confluence

入门

此视频提供有关添加 Confluence Cloud Microsoft Graph 连接器的分步指南。

1. 显示名称

显示名称用于标识 Copilot 中的每个引用，帮助用户轻松识别关联的文件或项。 显示名称还表示受信任的内容。 显示名称也用作 内容源筛选器。 此字段存在默认值，但你可以将其自定义为组织中的用户可识别的名称。

2. Confluence 云 URL

若要连接到 Confluence 站点，请使用站点 URL。 Confluence 云站点 URL 通常类似于 https://< organization_name.atlassian.net/>。

3.身份验证类型

若要对 Confluence On-prem 中的内容进行身份验证和同步，请选择 以下两种受支持的方法之一 ：

提示

确保服务 帐户有权查看 要编制索引的 Confluence 内容。

a. 基本身份验证
若要使用基本身份验证进行身份验证，请输入用户名 (通常为电子邮件) 和 API 令牌。 若要帮助生成 API 令牌，请参阅 Atlassian 指南。

b. OAuth 2.0 (建议)
在 Confluence Cloud 中注册应用，以便Microsoft搜索应用和智能 Microsoft 365 Copilot 副驾驶®可以访问该实例。 若要了解详细信息，请参阅 Atlassian 支持文档，了解如何 启用 OAuth 2.0。

以下步骤提供了有关如何注册应用的指南：

1. 使用 Atlassian Confluence 管理员帐户登录到 Atlassian 开发人员控制台。

2. 单击“创建”，然后选择 。OAuth 2.0 integration

3. 为应用程序提供适当的名称并创建新应用。

4. Permissions从左侧导航窗格导航到 。 单击 “添加”。Confluence API 添加后，单击“ 配置”和“ 编辑范围 ”，然后选择以下范围。

   范围名称	代码	说明
   查看内容详细信息	read:content-details:confluence	对满足条件的内容进行爬网。
   查看组	read:group:confluence	访问内容的组权限。
   查看用户详细信息	read:user:confluence	访问单个用户详细信息以支持权限。

5. 单击保存。

6. Authorization从左侧导航窗格导航到 。 为 Microsoft 365 Government 添加Microsoft 365 企业版https://gcs.office.com/v1.0/admin/oauth/callback的回调 URL，https://gcsgcc.office.com/v1.0/admin/oauth/callback并保存更改。

7. 从左侧导航窗格导航到“设置”。 可从此页面获取 客户端 ID 和 机密 。

   使用 客户端 ID 和 机密完成连接设置步骤。

6. 向有限的受众推出

如果要先在 Copilot 和其他搜索图面中验证此连接，然后再将此连接部署到有限的用户群，然后再将它扩展到更广泛的受众。 若要了解有关有限推出的详细信息， 请单击此处。

此时，已准备好为 ServiceNow Knowledge 创建连接。 可以单击“创建”按钮，Confluence Cloud Microsoft Graph 连接器将从 Confluence 帐户启动索引页。

对于其他设置，如访问权限、数据包含规则、架构、爬网频率等，我们根据最适合 Confluence 数据的方式设置默认值。 默认值如下所示：

用户
访问权限	仅有权访问数据源中内容的人员。
映射标识	使用 Microsoft Entra ID 映射的数据源标识。

内容
包含/排除空间	全部
管理属性	若要检查默认属性及其架构，请单击此处

同步
增量爬网	频率：每 15 分钟
完全爬网	频率：每天

如果要编辑这些值中的任何一个，则需要选择 Custom Setup 选项。

自定义设置

自定义设置适用于想要编辑默认表中所列设置的默认值的管理员。 单击 Custom Setup 选项后，会看到另外三个选项卡 -“用户”、“内容”和“同步”。

用户

访问权限

Confluence Cloud Microsoft Graph 连接器支持对 所有人 或 只有有权访问此数据源的人员可见的搜索权限。 如果选择“ 所有人”，则所有用户的搜索结果中将显示索引数据。 如果选择“ 仅有权访问此数据源的人员”，则索引数据将显示在有权访问这些数据源的用户的搜索结果中。 在 Confluence Cloud 中，用户和组的安全权限是使用空间权限和页面限制定义的。 页面级限制（如果存在）优先于空间权限。

如果没有页面限制，连接器会检查空间级权限 -

• 如果空间启用了“匿名用户”访问，则内容对租户中的所有用户可见。
• 如果未启用“匿名访问”，则不遵循空间级权限。
• 如果未定义空间级别权限，则租户中的任何用户都看不到内容。

重要

权限仅在空间和页面级别进行管理，不考虑父页权限。

如果选择“仅有权访问此数据源的人员”，则需要进一步选择 Confluence 站点具有Microsoft Entra ID预配用户还是非 AAD 用户。

若要确定哪个选项适合你的组织，请执行以下操作：

1. 如果 Confluence 用户的电子邮件 ID 与 Microsoft Entra ID 中用户的 UserPrincipalName (UPN) 相同，请选择“Microsoft Entra ID”选项。
2. 如果 Confluence 用户的电子邮件 ID 不同于 userPrincipalName (UPN Microsoft Entra ID 用户) ，请选择非 AAD 选项。

注意

• 如果选择Microsoft Entra ID作为标识源的类型，连接器会将从 Confluence 获取的用户的电子邮件 ID 直接映射到 Microsoft Entra ID 的 UPN 属性。
• 如果为标识类型选择“非 AAD”，请参阅 映射非 Azure AD 标识 以获取有关映射标识的说明。 可以使用此选项提供从电子邮件 ID 到 UPN 的映射正则表达式。
• 汇报管理访问权限的用户或组仅在完全爬网中同步。 增量爬网当前不支持处理权限更新。

内容

包含或排除要编制索引的数据

使用 Confluence 查询语言 (CQL) 字符串，可以指定同步页面的条件。 它类似于 SQL Select 语句中的 Where 子句。 例如，可以选择仅为过去两年修改的页面编制索引。 若要了解如何创建自己的查询字符串，请参阅 使用 CQL 进行高级搜索。 默认情况下，连接器为所有博客和页面编制索引。

提示

可以使用 CQL 筛选器为 特定时间后修改的内容 编制索引， lastModified >= “2018/12/31”

使用预览结果按钮验证所选属性和 CQL 字符串的示例值。

管理属性

在此步骤中，可以在 Confluence 数据源中添加或删除可用属性。 默认情况下会选择几个属性。 在此处选择的属性列表可能会影响在智能 Microsoft 365 Copilot 副驾驶®中筛选、搜索和查看结果的方式。

Source 属性	标签	说明
作者	authors	参与/协作处理数据源中项的人员的名称。
CreatedByName	createdBy	数据源中项的最近编辑者的姓名。
CreatedOn	createdDateTime	在数据源中创建项的日期和时间。
IconUrl	iconUrl	项的关联图标 URL。
标题	title	要在搜索和其他体验中显示的项的标题。
UpdatedByName	lastModifiedBy	数据源中项的最近编辑者的姓名。
UpdatedOn	lastModifiedDateTime	上次在数据源中修改项的日期和时间。
URL	url	数据源中项的目标 URL。

预览数据

使用“预览结果”按钮验证所选属性和筛选器。

同步

刷新间隔确定数据源与 Confluence Cloud Microsoft Graph 连接器索引之间的数据同步频率。 有两种类型的刷新间隔 - 完全爬网和增量爬网。 有关更多详细信息， 请单击此处。 如果需要，可以从此处更改刷新间隔的默认值。

查看并测试连接

• 对于测试，可以选择 发布到有限的受众
• 使用索引浏览器搜索和验证索引内容和权限
• 可以在常见问题解答部分找到常见问题的解答

对于 MS 搜索，如果需要自定义搜索结果页。 若要了解如何自定义搜索结果，请参阅 自定义搜索结果页。

如果遇到问题或想要提供反馈，请联系 Microsoft Graph |支持。