翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 インスタンスバージョン: London、その他
+ 包含/除外パターン: サービスカタログ、ナレッジ記事、およびその添付ファイル

## 前提条件
<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* です。
+ ServiceNow インスタンスへの Amazon Kendra の接続を許可するユーザー名とパスワードを含む基本認証情報を記録しました。
**注記**  
認証情報とシークレットは、定期的に更新またはローテーションすることをお勧めします。セキュリティに必要なアクセスレベルのみを提供してください。認証情報とシークレットを、データソース、コネクタバージョン 1.0 と 2.0 (該当する場合) で再利用することは推奨**しません**。
+ **オプション:** ユーザー名、パスワード、クライアント ID、クライアントシークレットを識別Amazon Kendraして生成できる OAuth 2.0 認証情報トークンを設定しました。ユーザー名とパスワードは、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\$1knowledge
  + 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 で、また同じインデックスに使用する予定の他のデータソースでも、各ドキュメントが一意であることが確認されていること。インデックスに使用する各データソースには、データソース全体に同じドキュメントが含まれていてはなりません。ドキュメント 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 を使用している場合はロールの ARN を記録しましたIAM。
**注記**  
認証タイプと認証情報を変更する場合は、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>

ServiceNow データソースAmazon Kendraに接続するには、 がデータAmazon Kendraにアクセスできるように、ServiceNow データソースの必要な詳細を指定する必要があります。ServiceNow をまだ設定していない場合は、Amazon Kendra「」を参照してください[前提条件](#prerequisites-v1-servicenow)。

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

**ServiceNow Amazon Kendraに接続するには** 

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 Managersecret** — 既存のシークレットを選択するか、ServiceNow 認証情報を保存する新しいSecrets Managerシークレットを作成します。新しいシークレットの作成を選択すると、[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 ]

**ServiceNow Amazon Kendraに接続するには**

[ServiceNowConfiguration API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html) を使用して以下を指定する必要があります。
+ **データソース URL** - ServiceNow URL を指定します。ホストエンドポイントは、*your-domain.service-now.com* のようになります。
+ **データソースホストインスタンス** - ServiceNow ホストインスタンスのバージョンを `LONDON` または `OTHERS` として指定します。
+ **シークレット Amazon リソースネーム (ARN)** — ServiceNow アカウントで作成した認証情報を含むSecrets Managerシークレットの Amazon リソースネーム (ARN) を指定します。

   基本認証を使用している場合、シークレットは以下のキーを持つ JSON 構造に保存されます。

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

  OAuth 2.0 認証を使用している場合、シークレットは以下のキーを持つ JSON 構造に保存されます。

  ```
  {
      "username": "user name",
      "password": "password",
      "clientId": "client id",
      "clientSecret": "client secret"
  }
  ```
+ **IAMrole** — を呼び出し`CreateDataSource`て、Secrets Managerシークレットにアクセスするためのアクセス許可を IAMロールに提供し、ServiceNow コネクタと に必要なパブリック APIs を呼び出す`RoleArn`タイミングを指定しますAmazon Kendra。詳細については、「[IAM roles for ServiceNow data sources](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 フィールドの名前を指定する必要があります。
  + ナレッジ記事とカタログ項目へのインデックス添付ファイル。
  + 1 つ以上のナレッジベースからドキュメントを選択する ServiceNow クエリを使用します。ナレッジベースは、パブリックまたはプライベートのいずれかです。詳細については、[クエリでインデックス作成するドキュメントを指定する](https://docs.aws.amazon.com/kendra/latest/dg/servicenow-query.html)を参照してください。

------

## 詳細はこちら
<a name="servicenow-v1-learn-more"></a>

ServiceNow データソースAmazon Kendraとの統合の詳細については、以下を参照してください。
+ [Amazon KendraServiceNow Online コネクタの開始方法](https://aws.amazon.com/blogs/machine-learning/getting-started-with-amazon-kendra-servicenow-online-connector/)