本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# ServiceNow 連接器 V1.0
<a name="data-source-v1-servicenow"></a>

ServiceNow 提供雲端型服務管理系統，可建立和管理組織層級工作流程，例如 IT 服務、票務系統及支援。您可以使用 Amazon Kendra為 ServiceNow 目錄、知識文章及其附件編製索引。

**注意**  
ServiceNow 連接器 V1.0 / ServiceNowConfiguration API 已於 2023 年結束。我們建議您遷移至或使用 ServiceNow 連接器 V2.0 / TemplateConfiguration API。

如需疑難排解您的Amazon KendraServiceNow 資料來源連接器，請參閱 [對資料來源進行故障診斷](troubleshooting-data-sources.md)。

**Topics**
+ [支援的功能](#supported-features-v1-servicenow)
+ [先決條件](#prerequisites-v1-servicenow)
+ [連線指示](#data-source-procedure-v1-servicenow)
+ [進一步了解](#servicenow-v1-learn-more)

## 支援的功能
<a name="supported-features-v1-servicenow"></a>

Amazon KendraServiceNow 資料來源連接器支援下列功能：
+ ServiceNow 執行個體版本：倫敦、其他
+ 包含/排除模式：服務目錄、知識文章及其附件

## 先決條件
<a name="prerequisites-v1-servicenow"></a>

在您可以使用 Amazon Kendra為 ServiceNow 資料來源編製索引之前，請在 ServiceNow 和AWS帳戶中進行這些變更。

**在 ServiceNow 中，請確定您已：**
+ 已建立 ServiceNow 管理員帳戶，並已建立 ServiceNow 執行個體。
+ 已複製 ServiceNow 執行個體 URL 的主機。例如，如果執行個體的 URL 為 *https://your-domain.service-now.com*，您輸入的主機 URL 格式為 *your-domain.service-now.com*。
+ 記下您的基本身分驗證憑證，其中包含允許 Amazon Kendra連線至 ServiceNow 執行個體的使用者名稱和密碼。
**注意**  
建議定期更新或輪換憑證與機密。僅授予作業所需的最低存取層級，以確保自身安全。**我們不**建議您在資料來源以及連接器 1.0 和 2.0 版 （如適用） 之間重複使用登入資料和秘密。
+ **選用：**已設定 OAuth 2.0 憑證字符，可以識別Amazon Kendra和產生使用者名稱、密碼、用戶端 ID 和用戶端秘密。使用者名稱和密碼必須提供 ServiceNow 知識庫和服務目錄的存取權。如需詳細資訊，請參閱 [OAuth 2.0 身分驗證的 ServiceNow 文件。](https://www.servicenow.com/docs/bundle/utah-platform-security/page/integrate/single-sign-on/concept/c_Authentication.html)
+ 新增下列許可：
  + kb\$1category
  + kb\$1 知識
  + kb\$1knowledge\$1base
  + kb\$1uc\$1cannot\$1read\$1mtom
  + kb\$1uc\$1can\$1read\$1mtom
  + sc\$1catalog
  + sc\$1category
  + sc\$1cat\$1item
  + sys\$1attachment
  + sys\$1attachment\$1doc
  + sys\$1user\$1role
+ 已檢查每個文件在 ServiceNow 中以及您計劃用於相同索引的其他資料來源中都是唯一的。您要用於索引的每個資料來源不得包含跨資料來源的相同文件。文件 IDs是索引的全域 ID，且每個索引必須是唯一的。

**在您的 中AWS 帳戶，請確定您有：**
+ [建立Amazon Kendra索引](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html)，如果使用 API， 會記下索引 ID。
+ 為您的資料來源[建立IAM角色](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)，如果使用 API， 會記下IAM角色的 ARN。
**注意**  
如果您變更身分驗證類型和登入資料，則必須更新您的IAM角色以存取正確的AWS Secrets Manager秘密 ID。
+ 將您的 ServiceNow 身分驗證登入資料存放在AWS Secrets Manager秘密中，如果使用 API， 會記下秘密的 ARN。
**注意**  
建議定期更新或輪換憑證與機密。僅授予作業所需的最低存取層級，以確保自身安全。**我們不**建議您在資料來源以及連接器 1.0 和 2.0 版 （如適用） 之間重複使用登入資料和秘密。

如果您沒有現有的IAM角色或秘密，您可以在連線至 ServiceNow 資料來源時使用 主控台建立新的IAM角色和Secrets Manager秘密Amazon Kendra。如果您使用的是 API，則必須提供現有IAM角色和Secrets Manager秘密的 ARN，以及索引 ID。

## 連線指示
<a name="data-source-procedure-v1-servicenow"></a>

若要Amazon Kendra連線至 ServiceNow 資料來源，您必須提供 ServiceNow 資料來源的必要詳細資訊，以便 Amazon Kendra可以存取您的資料。如果您尚未為 設定 ServiceNow，Amazon Kendra請參閱 [先決條件](#prerequisites-v1-servicenow)。

------
#### [ Console ]

**Amazon Kendra連線至 ServiceNow** 

1. 登入 AWS管理主控台並開啟[Amazon Kendra主控台](https://console.aws.amazon.com/kendra/)。

1. 從左側導覽窗格中，選擇**索引**，然後從索引清單中選擇您要使用的索引。
**注意**  
您可以選擇在索引設定下設定或編輯**使用者存取控制**設定。 ****

1. 在**入門**頁面上，選擇**新增資料來源**。

1. 在**新增資料來源**頁面上，選擇 **ServiceNow 連接器 V1.0**，然後選擇**新增資料來源**。

1. 在**指定資料來源詳細資訊**頁面上，輸入下列資訊：

   1. 在**名稱和描述**中，針對**資料來源名稱** - 輸入資料來源的名稱。您可以包含連字號，但不能包含空格。

   1. （選用） **描述** — 輸入資料來源的選用描述。

   1. 在**預設語言** - 選擇語言來篩選索引的文件。除非您另有指定，否則語言預設為英文。文件中繼資料中指定的語言會覆寫選取的語言。

   1. 在**標籤**中，針對**新增標籤** - 包含選用標籤，以搜尋和篩選您的資源或追蹤您的AWS成本。

   1. 選擇**下一步**。

1. 在**定義存取和安全性**頁面上，輸入下列資訊：

   1. **ServiceNow 主機** - 輸入 ServiceNow 主機 URL。

   1. **ServiceNow 版本** - 選取您的 ServiceNow 版本。

   1. 根據您的使用案例選擇**基本身分驗證**和 **Oauth 2.0 身分驗證。**

   1. **AWS Secrets Manager秘密** - 選擇現有的秘密或建立新的Secrets Manager秘密，以存放您的 ServiceNow 身分驗證登入資料。如果您選擇建立新的秘密，則會AWS Secrets Manager開啟秘密視窗。

      1. **機密名稱** - 輸入您的機密名稱。字首「AmazonKendra-ServiceNow-」會自動新增至您的秘密名稱。

      1. 如果使用基本身分驗證 - 輸入 ServiceNow **** 帳戶的**秘密名稱**、**使用者名稱和密碼**。

         如果使用 OAuth2 身分驗證 - 輸入您在 ServiceNow 帳戶中建立的**秘密名稱**、**使用者名稱**、**密碼**、**用戶端 ID** 和**用戶端秘密**。

      1. 選取**儲存並新增機密**。

   1. **IAMrole** - 選擇現有IAM角色或建立新的IAM角色，以存取您的儲存庫登入資料和索引內容。
**注意**  
IAM用於索引的 角色無法用於資料來源。如果您不確定現有角色是否用於索引或常見問答集，請選擇**建立新角色**以避免錯誤。

   1. 選擇**下一步**。

1. 在**設定同步設定**頁面上，輸入下列資訊：

   1. **包含知識文章** - 選擇為知識文章編製索引。

   1. **知識文章類型** - 在**僅包含公有文章**和**根據 ServiceNow 篩選條件查詢包含文章**之間根據您的使用案例進行選擇。如果您**根據 ServiceNow 篩選條件查詢選取包含文章**，則必須輸入從 ServiceNow 帳戶複製的**篩選條件查詢**。

   1. **包含知識文章附件** — 選擇為知識文章附件編製索引。您也可以選取要編製索引的特定檔案類型。

   1. **包含目錄項目** - 選擇索引目錄項目。

   1. **包含目錄項目附件** - 選擇索引目錄項目附件。您也可以選取要編製索引的特定檔案類型。

   1. **頻率** - 與您的資料來源Amazon Kendra同步的頻率。

   1. 選擇**下一步**。

1. 在**設定欄位映射**頁面上，輸入下列資訊：

   1. **知識文章****和服務目錄** — 從Amazon Kendra產生的預設資料來源欄位和您要映射至索引的其他建議欄位映射中選取。

   1.  **新增欄位** - 新增自訂資料來源欄位，以建立要映射的索引欄位名稱和欄位資料類型。

   1. 選擇**下一步**。

1. 在**檢閱和建立**頁面上，檢查您輸入的資訊是否正確，然後選取**新增資料來源**。您也可以選擇從此頁面編輯您的資訊。成功新增資料來源後，您的**資料來源**將顯示在資料來源頁面上。

------
#### [ API ]

**Amazon Kendra連線至 ServiceNow**

您必須使用 [ServiceNowConfiguration API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html) 指定下列項目：
+ **資料來源 URL** - 指定 ServiceNow URL。主機端點看起來應該如下所示：https：//*your-domain.service-now.com*。
+ **資料來源主機執行個體** - 指定 ServiceNow 主機執行個體版本為 `LONDON`或 `OTHERS`。
+ **秘密 Amazon Resource Name (ARN)** — 提供Secrets Manager秘密的 Amazon Resource Name (ARN)，其中包含您在 ServiceNow 帳戶中建立的身分驗證憑證。

   如果您使用基本身分驗證，秘密會存放在具有下列金鑰的 JSON 結構中：

  ```
  {
      "username": "user name",
      "password": "password"
  }
  ```

  如果您使用 OAuth2 身分驗證，秘密會存放在具有下列金鑰的 JSON 結構中：

  ```
  {
      "username": "user name",
      "password": "password",
      "clientId": "client id",
      "clientSecret": "client secret"
  }
  ```
+ **IAMrole**—指定`RoleArn`您何時呼叫 `CreateDataSource` 以提供IAM角色存取Secrets Manager秘密的許可，以及呼叫 ServiceNow 連接器所需的公有 APIs 和 Amazon Kendra。如需詳細資訊，請參閱 [IAM ServiceNow 資料來源的角色](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)。

您也可以新增下列選用功能：
+  **欄位映射** - 選擇將 ServiceNow 資料來源欄位映射至您的Amazon Kendra索引欄位。如需詳細資訊，請參閱[映射資料來源欄位](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html)。
**注意**  
需要文件內文欄位或文件內文對等項目， Amazon Kendra才能搜尋您的文件。您必須將資料來源中的文件內文欄位名稱映射至索引欄位名稱 `_document_body`。所有其他欄位是選用的。
+  **包含和排除篩選條件** - 指定是否包含或排除目錄和知識文章的特定檔案附件。
**注意**  
大多數資料來源使用規則表達式模式，作為包含或排除的篩選規則，稱為篩選條件。若您設定包含篩選條件，則只有符合該條件的內容會被編列索引。任何不符合包含篩選條件的文件都不會編製索引。如果您指定包含和排除篩選條件，則符合排除篩選條件的文件不會編製索引，即使它們符合包含篩選條件。
+ **索引參數** - 您也可以選擇指定是否：
  + 索引知識文章和服務目錄，或兩者。如果您選擇為知識文章和服務目錄項目編製索引，則必須提供映射至Amazon Kendra索引中索引文件內容欄位的 ServiceNow 欄位名稱。
  + 將附件索引至知識文章和目錄項目。
  + 使用 ServiceNow 查詢，從一或多個知識庫中選取文件。知識庫可以是公有或私有。如需詳細資訊，請參閱[使用查詢指定要索引的文件](https://docs.aws.amazon.com/kendra/latest/dg/servicenow-query.html)。

------

## 進一步了解
<a name="servicenow-v1-learn-more"></a>

若要進一步了解Amazon Kendra如何與您的 ServiceNow 資料來源整合，請參閱：
+ [開始使用Amazon KendraServiceNow Online 連接器](https://aws.amazon.com/blogs/machine-learning/getting-started-with-amazon-kendra-servicenow-online-connector/)