Confluence 本地Microsoft图形连接器
Confluence 本地Microsoft Graph 连接器允许组织为 Confluence 服务器或数据中心内容编制索引。 配置连接器并索引 Confluence 站点中的数据后，最终用户可以在Microsoft搜索和智能 Microsoft 365 Copilot 副驾驶®中搜索这些内容。
本文适用于Microsoft 365 名管理员，他们负责配置、运行和监视 Confluence 本地Microsoft Graph 连接器。 它补充了在 Microsoft 365 管理中心 中设置 Microsoft Graph 连接器中提供的一般说明。
优点
-
增强的搜索功能：用户可以询问有关 Copilot 中 Wiki 内容的自然语言问题，例如：
- 汇总体系结构文档
- 如何获取对门户的访问权限
- 汇总体系结构文档
-
语义搜索支持：用户可以执行自然语言查询以获取准确的响应。
- 兼容性：支持 8.0 以上的 Confluence 版本。
先决条件
- 安装 GCA [Graph 连接器代理]：确保 GCA 安装在与数据源相同的网络中的 Windows 计算机上，可通过 Confluence URL 访问。 可以在 Graph 连接器代理Microsoft查找详细信息
- 安装插件：从 Atlassian 市场下载并安装 confluence 安装程序上的 confluence 本地插件。 从 Microsoft Graph 连接器 Confluence 本地插件获取插件 |Atlassian 市场
- 身份验证：确保具有具有正确访问权限的身份验证凭据。
重要
建议：Confluence 全局管理员应创建连接
谁是 confluence 全局管理员？
Confluence 管理员是已被授予完全管理权限的用户。
- 若要检查：转到“管理”>“常规配置>”“全局权限”
- 查找已启用所有权限的 Confluence-administrators 组，包括 - 可以使用、个人空间、创建空间 () 、Confluence 管理员和系统管理员。
- 创建令牌的任何用户都必须是此组的成员
入门
1. 显示名称
显示名称用于标识 Copilot 中的每个引用，帮助用户轻松识别关联的文件或项。 显示名称还表示受信任的内容。 显示名称也用作 内容源筛选器。 此字段存在默认值，但你可以将其自定义为组织中的用户可识别的名称。
2. Confluence 本地 URL
若要连接到 Confluence 本地数据，需要组织的 Confluence 实例 URL。 组织的 Confluence 实例 URL 通常类似于“https://contoso.atlassian.net”。
3. 图形连接器代理 (GCA)
若要为 Confluence 服务器或数据中心内容编制索引，必须安装并注册连接器代理。 有关详细信息 ，请参阅安装 Microsoft Graph 连接器代理 。 你必须是组织的 Microsoft 365 租户的管理员，以及组织的 Confluence 站点的管理员。
注意
GCA 可以安装在不同的 Windows 计算机上，并且无需与本地服务器的计算机位于同一台计算机上。 计算机可以帮助生成可用于设置的应用 ID 和机密。 必须确保 GCA 计算机在爬网期间处于打开阶段。 可以在 常见问题解答部分 找到常见 GCA 重新分配问题的解答。
4.安装 Confluence 本地插件
验证是否已安装 Microsoft Graph 连接器 Confluence 本地插件。 无需为每个 confluence 连接器安装插件;如果已将其安装在 Confluence 实例中，则可以跳过此步骤进行后续 Confluence 本地连接。
- 从 Microsoft Graph 连接器 Confluence 本地插件下载应用 |Atlassian Marketplace。
- 登录到 confluence 系统
- 单击“设置”图标 -> 单击“管理应用
- 单击上传应用
- 选择下载的文件，并继续
注意
8.0 以上的 confluence 版本支持插件。
5.身份验证类型
若要对 Confluence 本地内容进行身份验证和同步，请选择 以下三种受支持的方法之一 ：
a. 基本身份验证
若要对实例进行身份验证，请输入 Confluence 帐户的用户名和密码。
b. OAuth1.0a
生成公钥/私钥对并在 Confluence 本地站点中创建应用程序链接，以便连接器代理可以访问实例。 若要了解详细信息，请参阅 Atlassian 开发人员文档中的步骤 1 ，了解如何配置 OAuth 1.0a。
c. OAuth 2.0 (建议)
以下步骤提供了有关如何注册应用 配置传入链接的指导。
- 转到管理 > 常规配置 > 应用程序链接。
- 选择“创建链接”
- 选择“外部应用程序”，然后选择“传入”作为方向。
- 填写
- 重定向 URL：
https://gcs.office.com/v1.0/admin/oauth/callback - 范围：
) 如果你是 Confluence 全局管理员，则支持以下范围之一：管理员或读取。
b) 如果你是其他类型的 Confluence 管理员，请提供管理员范围
- 使用客户端 ID 和机密完成连接设置步骤。
6. 向有限受众推出
如果要先在 Copilot 和其他搜索图面中验证此连接，然后再将此连接部署到有限的用户群，然后再将它扩展到更广泛的受众。 若要了解有关有限推出的详细信息， 请单击此处。
此时，已准备好为 ServiceNow Knowledge 创建连接。 可以单击“创建”按钮，Microsoft Graph 连接器将从 Confluence 帐户启动索引页。
对于其他设置，如访问权限、数据包含规则、架构、爬网频率等，我们根据最适合 Confluence 数据的方式设置默认值。 默认值如下所示：
| 用户 | |
|---|---|
| 访问权限 | 仅有权访问数据源中内容的人员。 |
| 映射标识 | 使用 Microsoft Entra ID 映射的数据源标识。 |
| 内容 | |
|---|---|
| 包含/排除空间 | 全部 |
| 管理属性 | 若要检查默认属性及其架构，请单击此处 |
| 同步 | |
|---|---|
| 增量爬网 | 频率：每 15 分钟 |
| 完全爬网 | 频率：每天 |
如果要编辑这些值中的任何一个，则需要选择 Custom Setup 选项。
自定义设置
自定义设置适用于想要编辑默认表中所列设置的默认值的管理员。 单击 Custom Setup 选项后，会看到另外三个选项卡 -“用户”、“内容”和“同步”。
用户
访问权限
Confluence 本地Microsoft Graph 连接器支持对“所有人”或“仅有权访问此数据源的人员”可见的搜索权限。 如果选择“所有人”，则所有用户的搜索结果中将显示索引数据。 如果选择“仅有权访问此数据源的人员”，则索引数据将显示在有权访问这些数据源的用户的搜索结果中。 在本地 Confluence 中，使用空间权限和页面限制定义用户和组的安全权限。 Confluence 本地Microsoft Graph 连接器应用内容限制 API 提供的有效权限
如果选择“仅有权访问此数据源的人员”，则需要进一步选择 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 数据源中添加或删除可用属性。 Microsoft 365 选择一些属性。 默认情况下，连接器将为所有空格编制索引。 但是，可以选择使用空间筛选器选项包含或排除特定空间。
输入要包含或排除的空间键列表，并看到结果预览。 输入空格键：每个 Confluence 空间都有一个空间键，该键是构成该空间 URL 的一部分的简短唯一标识符。 若要获取空间密钥，请联系 confluence 管理员。有关详细信息，请访问： 空格键
页面筛选器
在此步骤中，可以指定文档索引的日期范围。 参数如下：
- 上次创建日期：创建文档的日期。 仅对在此日期之后修改的文档编制索引。
- 上次修改日期：修改文档的日期。 仅对在此日期之后修改的文档编制索引。
重要
- 确保日期按时间顺序排列。 “上次创建日期”不应晚于“上次修改日期”。
- 如果未指定日期，则将考虑所有文档进行索引编制。
管理属性
在这里，可以在 Confluence 本地数据源中添加或删除可用属性。 将架构分配给属性 (定义属性是可搜索的、可查询的、可检索的还是可精简的) 。 此外，还可以更改语义标签，并向 属性添加别名。 默认属性如下所示：
| Source 属性 | 标签 | 架构 |
|---|---|---|
| 作者 | authors | 查询、检索 |
| 内容 | 搜索 | |
| CreatedByName | 创建者 | 搜索、查询、检索 |
| CreatedOn | 创建日期时间 | 查询、检索 |
| Id | 查询、检索 | |
| PageTree | 取回 | |
| SpaceName | 搜索、查询、检索 | |
| 标题 | title | 搜索、检索 |
| UpdatedByName | lastModifiedBy | 取回 |
| UpdatedOn | lastModifiedDateTime | 查询、检索、优化 |
| URL | url | 取回 |
预览数据
使用“预览结果”按钮验证所选属性和筛选器。
注意
请注意，预览版仅遵循空间级筛选。
同步
刷新间隔确定数据在数据源和 Graph 连接器索引之间同步的频率。 有两种类型的刷新间隔 - 完全爬网和增量爬网。 有关更多详细信息， 请单击此处。 如果需要，可以从此处更改刷新间隔的默认值。
查看并测试连接
对于 MS 搜索，如果需要自定义搜索结果页。 若要了解如何自定义搜索结果，请参阅 自定义搜索结果页。
限制
- 不为博客、附件文件或批注编制索引。
- 仅索引当前页;已存档页面将被排除。
- 本地 Confluence 不支持 CQL[Confluence 查询语言]，但我们支持空间和页面级别筛选器
疑难解答
发布连接后，可以在管理中心的“数据源”选项卡下查看状态。 若要了解如何进行更新和删除，请参阅 管理连接器。 可 在此处找到常见问题的故障排除步骤。
如果遇到问题或想要提供反馈，请联系 Microsoft Graph |支持。