ServiceNow コネクタ V2.0

にサインイン AWS Management Console し、 Amazon Kendra コンソールを開きます。

左側のナビゲーションペインで、[インデックス] を選択し、インデックスのリストから使用するインデックスを選択します。

[使用開始] ページで、[データソースを追加] を選択します。

データソースの追加ページで、ServiceNow コネクタを選択し、コネクタの追加を選択します。バージョン 2 (該当する場合) を使用している場合は、「V2.0」タグが付いた ServiceNow コネクタを選択します。

[データソースの詳細を指定] ページで、次の情報を入力します。

1. [名前と説明] の [データソース名] に、データソースの名前を入力します。ハイフン (-) は使用できますが、スペースは使用できません。

2. (オプション) [説明] - オプションで、データソースの説明を入力します。

3. デフォルト言語 - インデックスのドキュメントをフィルタリングする言語を選択します。特に指定しない限り、言語はデフォルトで英語に設定されます。ドキュメントのメタデータで指定された言語は、選択した言語よりも優先されます。

4. タグで新しいタグを追加する - リソースを検索およびフィルタリングしたり、 AWS コストを追跡したりするためのオプションのタグを含めます。

5. [Next (次へ)] を選択します。

[アクセスとセキュリティの定義] ページで、次の情報を入力します。

1. ServiceNow host - ServiceNow host URL を入力します。入力するホスト URL の形式は です。your-domain.service-now.com.

2. ServiceNow version - ServiceNow インスタンスのバージョンを選択します。ローマ、サンディーゴ、東京、その他から選択できます。

3. 承認 - ACL があり、それをアクセスコントロールに使用する場合は、ドキュメントのアクセスコントロールリスト (ACL) 情報をオンまたはオフにします。ACL は、ユーザーとグループがアクセスできるドキュメントを指定します。ACL 情報は、ユーザーまたはそのグループのドキュメントへのアクセスに基づいて検索結果をフィルタリングするために使用されます。詳細については、「User context filtering」を参照してください。

4. 認証 - 基本認証と Oauth 2.0 認証のどちらかを選択します。

5. AWS Secrets Manager secret - 既存のシークレットを選択するか、新しい Secrets Manager シークレットを作成して ServiceNow 認証情報を保存します。新しいシークレットの作成を選択すると、 AWS Secrets Manager シークレットウィンドウが開きます。ウィンドウで、以下の情報を入力します。

   1. [シークレット名] - シークレットの名前。シークレット名には、プレフィックスAmazonKendra-ServiceNow-」が自動的に追加されます。

   2. 基本認証を使用する場合 - ServiceNow アカウントのシークレット名、ユーザー名、パスワードを入力します。

      OAuth2.0 認証を使用する場合 - ServiceNow アカウントで作成したシークレット名、ユーザー名、パスワード、クライアント ID、クライアントシークレットを入力します。

   3. シークレットを保存して追加します。

6. Virtual Private Cloud (VPC） — VPC の使用を選択できます。その場合は、サブネットと VPC セキュリティグループを追加する必要があります。

7. ID クローラー - Amazon Kendraの ID クローラーを有効にするかどうかを指定します。ID クローラは、ドキュメントのアクセスコントロールリスト (ACL) 情報を使用して、ユーザーまたはそのグループのドキュメントへのアクセスに基づいて検索結果をフィルタリングします。ドキュメントに ACL があり、ACL の使用を選択した場合は、 Amazon Kendra ID クローラをオンにして検索結果のユーザーコンテキストフィルタリングを設定することもできます。それ以外の場合、ID クローラがオフになっていると、すべてのドキュメントをパブリックに検索できます。ドキュメントのアクセスコントロールを使用し、ID クローラがオフになっている場合は、API PutPrincipalMapping を使用してユーザーコンテキストフィルタリングのためにユーザーおよびグループのアクセス情報をアップロードできます。

8. IAM role - 既存の IAM ロールを選択するか、新しい IAM ロールを作成してリポジトリ認証情報にアクセスし、コンテンツにインデックスを作成します。

   注記

   IAM インデックスに使用される ロールは、データソースには使用できません。既存のロールがインデックスまたは FAQ に使用されているかどうかが不明な場合は、エラーを避けるために新しいロールの作成を選択します。

9. [Next (次へ)] を選択します。

[同期設定の構成] ページで、次の情報を入力します。

1. [ナレッジ記事] の場合は、以下のオプションから選択してください。

   • [ナレッジ記事] - ナレッジ記事にインデックスを作成することを選択します。

   • [ナレッジ記事の添付ファイル] - ナレッジ記事の添付ファイルにインデックスを作成することを選択します。

   • ナレッジ記事のタイプ - ユースケースに基づいて、Word フィルタークエリに基づいて、公開記事のみとナレッジ記事から選択します。 ServiceNow ServiceNow フィルタークエリに基づいて記事を含めるを選択した場合は、 ServiceNow アカウントからコピーされたフィルタークエリを入力する必要があります。フィルタークエリの例は次のとおりです。workflow_state=draft^EQ, kb_knowledge_base=dfc19531bf2021003f07e2c1ac0739ab^text ISNOTEMPTY^EQ, article_type=text^active=true^EQ.

     重要

     パブリック記事のみのクロールを選択した場合、 は ServiceNow でパブリックアクセスロールが割り当てられたナレッジ記事のみを Amazon Kendra クロールします。

   • [簡単な説明フィルターに基づいて記事を含める] - 特定の記事を含めるか除外する正規表現パターンを指定します。

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 がクロールする MBs でファイルサイズの制限を指定します。Amazon Kendra は、定義したサイズ制限内のファイルのみをクロールします。デフォルトのファイルサイズは 50MB です。最大ファイルサイズは 0MB より大きく、50MB 以下である必要があります。

   • [添付ファイルの正規表現パターン] - カタログ、ナレッジ記事、インシデントの特定の添付ファイルを含めたり除外したりする正規表現パターンを追加します。最大 100 のパターンを追加できます。

5. [同期モード] - データソースのコンテンツが変更されたときのインデックスの更新方法を選択します。データソースを Amazon Kendra と初めて同期すると、デフォルトですべてのコンテンツがクロールされ、インデックスが作成されます。同期モードオプションとして完全同期を選択しなくても、最初の同期が失敗した場合は、データの完全同期を実行する必要があります。

   • 完全同期: データソースがインデックスと同期するたびに、既存のコンテンツを置き換えて、すべてのコンテンツを意図的にインデックス化します。

   • 新規、変更、削除された同期: データソースがインデックスと同期するたびに、新規、変更、削除されたコンテンツのインデックスのみを作成します。 Amazon Kendra は、データソースのメカニズムを使用して、前回の同期以降に変更されたコンテンツの変更とインデックスコンテンツを追跡できます。

6. 同期実行スケジュールで、頻度 - データソースコンテンツを同期してインデックスを更新する頻度を選択します。

7. [Next (次へ)] を選択します。

[フィールドマッピングを設定] ページで、次の情報を入力します。

1. デフォルトのフィールドマッピング - インデックスにマッピングする Amazon Kendra 、生成されたデフォルトのデータソースフィールドから選択します。

2. [フィールドを追加] - カスタムデータソースフィールドを追加して、マッピング先のインデックスフィールド名とフィールドデータタイプを作成します。

3. [Next (次へ)] を選択します。

[確認と作成] ページで、入力した情報が正しいことを確認し、[データソースを追加] を選択します。このページで情報の編集を選択することもできます。データソースが正常に追加されると、データソースが [データソース] ページに表示されます。