ServiceNow チケット コネクタ

ServiceNow Tickets コネクターは、ServiceNow に記録されたインシデントおよびリクエストタイプのチケットとの、安全で設定可能な統合を提供します。 リクエストタイプのチケットは、ServiceNow のサービス/リクエストカタログから作成される項目です。たとえば、カタログの設定に応じて、権限のリクエストやハードウェアのリクエストなどがあります。 このコネクターは、過去のインシデントおよびリクエストデータを取り込み、新規および更新されたチケットをストリーミングし、分析とインサイトを強化します。 すぐに使用できるマッピングが含まれており、セットアップを迅速化し、一貫したデータ統合を実現します。

ServiceNow Tickets コネクタは、エスカレーションされたチケットから Spark が継続的に学習できるようにします。 Managing Spark data inputs のドキュメントを参照してください。

コネクタの認証情報の設定

Nexthink が ServiceNow インスタンスからチケット情報を取得できるようにするには、適切なアクセスレベルを持つ専用の統合アカウントを ServiceNow に設定します。 このコネクターは、ServiceNow Table API を介してインシデントおよびリクエストデータを読み取ります。

チケットの取得に使用する ServiceNow 認証情報を設定するには、以下の手順に従ってください：

1. ServiceNow Admin Console で、Nexthink 統合用の専用の有効な ServiceNow ユーザーアカウントを作成します。 API 認証用にアカウントを有効にします。
2. ServiceNow Roles 管理で、Nexthink 統合ユーザーに読み取り専用ロールを割り当てます。 既存のロールを使用するか、x_nexthink_ticket_reader などの専用ロールを作成します。
3. incident テーブルおよび request テーブルに対して、テーブルレベルの読み取り Access Control Lists（ACL）を設定します。 これにより、読み取り専用ロールは Table API を介してこれらのテーブルにアクセスできます。
4. コネクターが必要とするチケットフィールドに対して、フィールドレベルの読み取り ACL を設定します。
5. Nexthink 統合ユーザーに、管理者ロールまたは書き込みアクセスロールを割り当てないでください。

機密情報を含む可能性があるチケットも含め、Nexthink に公開するチケットのみに読み取り専用ロールのスコープを限定してください。

コネクターの認証情報の詳細については、コネクタ資格情報ドキュメンテーションを参照してください。

ServiceNow Tickets コネクターの設定

Nexthink web インターフェース から:

1. Administration > Inbound connectors に移動します。
2. ページの右上隅にある 新しいコネクタ ボタンをクリックします。
3. ServiceNow Tickets を選択します。

一般タブ

• Name: コネクタにとって意味のある名前です。 この名前は管理ページに表示されます。
• NQL ID：NQL クエリで ServiceNow コネクタを参照する際に使用される、コネクタ固有の識別子です. 提案された NQL ID は最初に変更できますが、コネクタを保存すると以後は変更できなくなります。
• Description: コネクターの目的と動作に関する簡潔な説明です。
• スケジューリング:

  • 繰り返し：実行時刻と繰り返しを設定します。 実行は予定された時刻に開始され、その後1時間にわたって分散して行われます。
• 接続:

  • 資格情報: コネクターの資格情報ページから事前設定済みの資格情報を選択します。 このコネクタは、OAuth 2.0 と Basic Auth の認証方法をサポートしています。 詳細については、コネクタ資格情報ドキュメンテーションを参照してください。

パラメータ タブ

• レコードタイプ: ServiceNow から収集するチケットタイプを定義します。 Incidents と Requests の両方がデフォルトで選択されています — 少なくとも1つは選択する必要があります。
• クエリ（任意）: Nexthink に取り込まれる ServiceNow のインシデントおよびリクエストをフィルタリングします。 sysparm_query 文字列を入力して、状態、カテゴリ、割り当てグループなどのフィルター条件を指定します。
• 開始日: コネクターによってデータの同期を開始する日付を選択します。
• カスタムヘッダー: OAuth 2.0 認証方式において、Client Credentials や Authorization Code などの追加資格情報を含めるためにカスタムヘッダーを使用します。 デフォルトのOAuth 2.0認証メカニズムを超えて追加の認証方法が必要な場合に便利です。 OAuth 2.0 - クライアント認証情報またはOAuth 2.0 - 認証コード認証に追加情報を含めるには、カスタムヘッダーを追加を選択します。

Nexthink は、PII の削除を含め、取り込み前にすべてのチケットコンテンツをサニタイズします。 チケットのテキストは要約されます。元の文面は Nexthink に保存されず、アクセスすることもできません。 チケットに機密性の高いコンテンツが含まれている場合、その要約は空のままとなります。 取り込まれたチケットデータは、tickets NQL テーブルで利用できます。 詳細については、NQLデータモデルを参照してください。

Applications モジュールの Efficiency ダッシュボード 用に ServiceNow コネクタを構成する際は、インシデントではなく サービスリクエストのみ が集計対象となる点に注意してください。 コネクターパラメーターでインシデントのみが選択されている場合、データは表示されません。

テスト結果パネル

テスト結果パネルは、サポートされているコネクタでのみ利用可能です。 コネクタの可用性はライセンスに依存します。

右側の Test results パネルを使用すると、実際のデータでコネクターをオンデマンドで実行し、レスポンスやエラーを確認できます。 テストパネルは、セットアップ時のデバッグと検証をより迅速に行うのに役立ち、試行錯誤を減らして、より信頼性の高いマッピングを実現します。

API を呼び出し、認証情報を検証し、対象のエンドポイントへの接続性を確認するには、Run test ボタンを選択します。

レスポンスのステータスコードや時間といった基本情報に加えて、パネルの下部にはレスポンスのサンプルレコードも表示されます。

エラーが発生した場合、問題の診断に役立てるためにシステムは API のレスポンスを表示します。