Confluence Cloud Microsoft Graph 连接器
Confluence Cloud Microsoft Graph 连接器允许组织为 Confluence 内容编制索引。 配置连接器并索引 Confluence 站点中的数据后，最终用户可以在Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®中搜索这些内容。
本文适用于Microsoft 365 名管理员，他们负责配置、运行和监视 Confluence Cloud Microsoft Graph 连接器。 它补充了在 Microsoft 365 管理中心 中设置 Microsoft Graph 连接器中提供的一般说明。
优点
-
增强的搜索功能：用户可以询问有关 Copilot 中 Wiki 内容的自然语言问题，例如：
- 汇总体系结构文档
- 如何获取对门户的访问权限
- 汇总体系结构文档
-
语义搜索支持：用户可以执行自然语言查询以获取准确的响应。
先决条件
- 你必须是组织的 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:confluenceread:content-details:confluence、Read:space:confluence、read:content.metadata:confluenceRead:permission:confluenceread:audit-log:confluence和 。read:page:confluence
入门
1. 显示名称
显示名称用于标识 Copilot 中的每个引用，帮助用户轻松识别关联的文件或项。 显示名称还表示受信任的内容。 显示名称也用作 内容源筛选器。 此字段存在默认值，但你可以将其自定义为组织中的用户可识别的名称。
2. Confluence 云 URL
若要连接到 Confluence 站点，请使用站点 URL。 Confluence 云站点 URL 通常类似于 https://< organization_name.atlassian.net/>。
3.身份验证类型
若要对 Confluence On-prem 中的内容进行身份验证和同步，请选择 以下两种受支持的方法之一 ：
提示
确保服务 帐户有权查看 要编制索引的 Confluence 内容。
a. 基本身份验证
输入帐户的用户名 (通常为电子邮件 ID) 和 API 令牌，以便使用基本身份验证进行身份验证。若要了解有关生成 API 令牌的详细信息，请参阅 Atlassian 的文档，了解如何 管理 Atlassian 帐户的 API 令牌。
b. OAuth 2.0 (建议)
在 Confluence Cloud 中注册应用，以便Microsoft搜索应用和智能 Microsoft 365 Copilot 副驾驶®可以访问该实例。 若要了解详细信息，请参阅 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从左侧导航窗格导航到 。 为 Microsoft 365 Government 添加Microsoft 365 企业版https://gcs.office.com/v1.0/admin/oauth/callback的回调 URL，https://gcsgcc.office.com/v1.0/admin/oauth/callback并保存更改。 - 从左侧导航窗格导航到“设置”。 可从此页面获取 客户端 ID 和 机密 。
使用 客户端 ID 和 机密完成连接设置步骤。
6. 向有限受众推出
如果要先在 Copilot 和其他搜索图面中验证此连接，然后再将此连接部署到有限的用户群，然后再将它扩展到更广泛的受众。 若要了解有关有限推出的详细信息， 请单击此处。
此时，已准备好为 ServiceNow Knowledge 创建连接。 可以单击“创建”按钮，Microsoft Graph 连接器将从 Confluence 帐户启动索引页。
对于其他设置，如访问权限、数据包含规则、架构、爬网频率等，我们根据最适合 Confluence 数据的方式设置默认值。 默认值如下所示：
| 用户 | |
|---|---|
| 访问权限 | 仅有权访问数据源中内容的人员。 |
| 映射标识 | 使用 Microsoft Entra ID 映射的数据源标识。 |
| 内容 | |
|---|---|
| 包含/排除空间 | 全部 |
| 管理属性 | 若要检查默认属性及其架构，请单击此处 |
| 同步 | |
|---|---|
| 增量爬网 | 频率：每 15 分钟 |
| 完全爬网 | 频率：每天 |
如果要编辑这些值中的任何一个，则需要选择 Custom Setup 选项。
自定义设置
自定义设置适用于想要编辑默认表中所列设置的默认值的管理员。 单击 Custom Setup 选项后，会看到另外三个选项卡 -“用户”、“内容”和“同步”。
用户
访问权限
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 获取的用户的电子邮件 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 默认选择了几个属性。 在此处选择的属性列表可能会影响在智能 Microsoft 365 Copilot 副驾驶®中筛选、搜索和查看结果的方式。
| Source 属性 | 标签 | 说明 |
|---|---|---|
| 作者 | authors |
参与/协作处理数据源中项的人员的名称。 |
| CreatedByName | createdBy |
数据源中项的最近编辑者的姓名。 |
| CreatedOn | createdDateTime |
在数据源中创建项的日期和时间。 |
| IconUrl | iconUrl |
项的关联图标 URL。 |
| 标题 | title |
要在搜索和其他体验中显示的项的标题。 |
| UpdatedByName | lastModifiedBy |
数据源中项的最近编辑者的姓名。 |
| UpdatedOn | lastModifiedDateTime |
上次在数据源中修改项的日期和时间。 |
| URL | url |
数据源中项的目标 URL。 |
预览数据
使用“预览结果”按钮验证所选属性和筛选器。
同步
刷新间隔确定数据在数据源和 Graph 连接器索引之间同步的频率。 有两种类型的刷新间隔 - 完全爬网和增量爬网。 有关更多详细信息， 请单击此处。 如果需要，可以从此处更改刷新间隔的默认值。
查看并测试连接
对于 MS 搜索，如果需要自定义搜索结果页。 若要了解如何自定义搜索结果，请参阅 自定义搜索结果页。
如果遇到问题或想要提供反馈，请联系 Microsoft Graph |支持。