ServiceNow 连接器 V2.0

登录 AWS Management Console 并打开Amazon Kendra 控制台。

在左侧导航窗格中，选择索引，然后从索引列表中选择要使用的索引。

在入门页面上，选择添加数据来源。

在添加数据源页面上，选择ServiceNow 连接器，然后选择添加连接器。如果使用版本 2（如果适用），请选择带有 “V2.0” 标签的ServiceNow 连接器。

在指定数据来源详细信息页面上输入以下信息：

1. 在名称和描述中，在数据来源名称中输入您的数据来源的名称。可以包含连字符，但不能包含空格。

2. （可选）说明 - 为数据来源输入说明。

3. 使用默认语言-选择一种语言来筛选文档中的索引。除非另行指定，否则语言默认为英语。在文档元数据中指定的语言会覆盖所选语言。

4. 在标签中，用于添加新标签-包括可选标签以搜索和筛选您的资源或跟踪您的 AWS 成本。

5. 选择下一步。

在定义访问权限和安全性页面上，请输入以下信息：

1. ServiceNow 主机 —输入 ServiceNow主机 URL。您输入的主机 URL 的格式是 your-domain.service-now.com。

2. ServiceNow 版本-选择您的 ServiceNow 实例版本。您可以选择 “罗马”、“圣地亚哥”、“东京” 或 “其他”。

3. 授权-如果您有 ACL 并想将其用于访问控制，请打开或关闭文档的访问控制列表 (ACL) 信息。ACL 指定了用户和群组可以访问哪些文档。ACL 信息用于根据用户或用户组对文档的访问权限来筛选搜索结果。有关更多信息，请参阅用户上下文筛选。

4. 身份验证-在基本身份验证和 Oauth 2.0 身份验证之间进行选择。

5. AWS Secrets Manager s@@ ecret —选择现有密钥或创建新 Secrets Manager 密钥来存储您的 ServiceNow 身份验证凭证。如果您选择创建新密钥，则会打开 AWS Secrets Manager 密钥窗口。在窗口中输入以下信息：

   1. 密钥名称 - 密钥的名称。前缀 “AmazonKendra-ServiceNow-” 会自动添加到您的密钥名称中。

   2. 如果使用基本身份验证，请输入您帐户的密码名称、用户名和密码。 ServiceNow

      如果使用 OAuth2.0 身份验证，请输入您在账户中创建的密钥名称、用户名、密码、客户端 ID 和客户端密钥。 ServiceNow

   3. 保存并添加您的密钥。

6. 虚拟私有云（VPC）- 您可以选择使用 VPC。如果是这样，则必须添加子网和 VPC 安全组。

7. I Amazon Kendra dent@@ ity Crawler-指定是否开启身份搜寻器。Identity Crawler 使用文档的访问控制列表 (ACL) 信息，根据用户或其群组对文档的访问权限筛选搜索结果。如果您的文档有 ACL 并选择使用您的 ACL，则也可以选择开启身份爬网程序来配置搜索结果 Amazon Kendra的用户上下文筛选。否则，如果身份搜寻器已关闭，则可以公开搜索所有文档。如果您想对文档使用访问控制并且身份搜寻器已关闭，则可以使用 PutPrincipalMappingAPI 上传用户和群组访问信息以进行用户上下文筛选。

8. IAM ro le —选择现有 IAM 角色或创建新 IAM 角色来访问您的存储库凭据和索引内容。

   注意

   IAM 用于索引的角色不能用于数据源。如果您不确定是否将现有角色用于编制索引或常见问题解答，为了避免出错，请选择创建新角色。

9. 选择下一步。

在配置同步设置页面上，请输入以下信息：

1. 对于知识文章，请选择以下选项：

   • 知识文章 - 选择为知识文章编制索引。

   • 知识文章附件 - 选择为知识文章附件编制索引。

   • 知识文章的类型-根据您的用例，根据 ServiceNow 筛选查询，在 “仅限公开文章” 和 “知识文章” 之间进行选择。如果您选择 “包含基于 ServiceNow 筛选查询的文章”，则必须输入从您的 ServiceNow账户中复制的筛选查询。筛选查询示例包括：workflow_state=draft^EQ、kb_knowledge_base=dfc19531bf2021003f07e2c1ac0739ab^text ISNOTEMPTY^EQ、article_type=text^active=true^EQ。

     重要

     如果您选择仅抓取公开文章，则仅 Amazon Kendra 抓取中分配了公共访问角色的知识文章。 ServiceNow

   • 基于简短描述筛选条件包含文章 - 指定正则表达式模式以包含或排除特定文章。

2. 对于服务目录项：

   • 服务目录项 - 选择为目录项编制索引。

   • 服务目录项附件 - 选择为服务目录项附件编制索引。

   • 活动服务目录项 - 选择为活动目录项编制索引。

   • 非活动服务目录项 - 选择为非活动目录项编制索引。

   • 筛选查询-根据您的 ServiceNow 实例中定义的筛选器选择包含服务目录项目。筛选条件查询示例包括：short_descriptionLIKEAccess^category=2809952237b1300054b6a3549dbe5dd4^EQ、nameSTARTSWITHService^active=true^EQ。

   • 根据简短描述筛选条件包含服务目录项 - 指定正则表达式模式以包括特定的目录项。

3. 对于事件：

   • 事件 - 选择为服务事件编制索引。

   • 事件附件 - 选择为事件附件编制索引。

   • 活动事件 - 选择为活动事件编制索引。

   • 非活动事件 - 选择为非活动事件编制索引。

   • 活动事件类型 -根据您的使用案例，选择所有事件、未解决的事件、未解决 - 未分配的事件或已解决的事件。

   • 筛选查询-根据您的 ServiceNow 实例中定义的筛选器选择包含事件。筛选条件查询示例包括：short_descriptionLIKETest^urgency=3^state=1^EQ、priority=2^category=software^EQ。

   • 根据简短描述筛选条件包含事件 - 指定包含特定事件的正则表达式模式。

4. 对于其他配置：

   • ACL 信息 - 默认情况下，包含所选实体的访问控制列表。取消选择访问控制列表将公开该类别中的所有文件。对于未选择的实体，ACL 选项会自动停用。对于公开文章，ACL 不适用。

   • 对于最大文件大小 — 指定 Amazon Kendra 将抓取的文件大小限制（以 MB 为单位）。Amazon Kendra 只会抓取您定义的大小限制范围内的文件。默认文件大小为 50MB。最大文件大小应大于 0MB 且小于或等于 50MB。

   • 附件正则表达式模式 - 添加正则表达式模式以包含或排除目录、知识文章和事件的某些附加文件。最多可以添加 100 个模式。

5. 同步模式 - 选择在数据来源内容发生变化时更新索引的方式。首次与同步数据源时， Amazon Kendra 默认情况下会对所有内容进行抓取和索引。如果初始同步失败，即使您没有选择完全同步作为同步模式选项，也必须对数据进行完全同步。

   • 完全同步：对所有内容进行新索引，每次数据源与索引同步时都会替换现有内容。

   • 新增、已修改、已删除的同步：每次数据源与索引同步时，仅索引新内容、修改内容和已删除内容。 Amazon Kendra 可以使用数据源的机制来跟踪内容更改并索引自上次同步以来更改的内容。

6. 在 “同步” 运行计划中，“频率”-选择同步数据源内容和更新索引的频率。

7. 选择下一步。

在设置字段映射页面上，请输入以下信息：

1. 默认字段映射-从 Amazon Kendra 生成的默认数据源字段中选择要映射到索引的字段。

2. 添加字段 - 添加自定义数据来源字段以创建要映射到的索引字段名称和字段数据类型。

3. 选择下一步。

在查看和创建页面上，请检查输入的信息是否正确，然后选择添加数据来源。您也可以选择在此页面上编辑信息。成功添加数据来源后，您的数据来源将显示在数据来源页面上。