ServiceNow Request Catalog コネクター

ServiceNow リクエストカタログ コネクタは、ServiceNow Service Catalog および Employee Profile モジュールと安全かつ構成可能な連携を提供します。 ソフトウェアのプロビジョニング、アクセス変更、機器の発注などの一般的なユースケースをサポートし、サービスリクエストの自動取得、検証、および送信を可能にします。 既存の ServiceNow のワークフローや承認プロセスと連携することで、このコネクターはインシデント管理を超えてカタログ主導のリクエストまで対応範囲を拡張し、ServiceNow を記録システムとして維持します。

コネクタにより、Spark は利用可能な ServiceNow カタログ項目に基づいて関連するサービスリクエストを推奨し、ユーザーがリクエストの履行を進める際のガイドを提供します。 Managing Spark data inputs のドキュメントを参照してください。

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

Nexthink が ServiceNow のリクエストカタログからアイテムを取得できるようにするには、ServiceNow で適切なアクセス権を持つ専用のインテグレーションアカウントを設定する必要があります。

Nexthink がリクエストカタログのデータを取得する際は、次の ServiceNow API エンドポイントを呼び出します。

GET /api/sn_sc/servicecatalog/items

ServiceNow は、この API が返すカタログアイテムを、リクエストを行うユーザーの権限に基づいて制御します。 つまり、Nexthink が使用する ServiceNow アカウントは、認証できるだけでなく、適切なカタログアイテムを閲覧できるよう正しく構成されている必要があります。

リクエストカタログの取得に使用される ServiceNow 認証情報を構成するには、以下の手順に従ってください。

1. ServiceNow 管理コンソールで Nexthink インテグレーション用の専用のアクティブな ServiceNow ユーザーアカウントを作成し、API 認証を有効にします。
2. ServiceNow のロール管理で、snc_internal など必要最小限の API アクセスロールのみを Nexthink インテグレーションユーザーに割り当てます。
3. Nexthink コネクタ用の専用の ServiceNow ユーザー条件レコードを作成し、Nexthink インテグレーションユーザーを含めます。 Nexthink ユーザー条件を適用します。

   • カタログレベル：Nexthink がカタログ内のアクセス可能なすべてのアイテムを取り込む場合。
   • カテゴリレベル：Nexthink が選択したカテゴリのアイテムのみを取り込む場合。
   • カタログアイテムレベル：Nexthink が特定のアイテムのみを取り込む場合、またはアイテムレベルの可視性を明示的に制御する必要がある場合。
4. 対象となるカタログ、カテゴリ、またはカタログアイテムの設定内にある Available For セクションで Nexthink User Criteria を構成します。
5. Nexthink統合ユーザーには、管理者ロールまたは書き込みアクセス権を持つロールを割り当てないでください。

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

ServiceNow Request Catalog コネクタの設定

コネクタを設定する前に、各ServiceNowカタログ項目にわかりやすいタイトルと詳細な説明があることを確認してください。 Sparkは、このテキストに照らして従業員のリクエストを照合します。 短いタイトルのみで説明がない項目は、照合精度を低下させます。

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

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

一般タブ

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

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

  • 資格情報: コネクタ資格情報 ページで事前設定された資格情報を選択します。 資格情報は、標準的な従業員と同じユーザー条件の割り当てを持つ専用のインテグレーションユーザーのものである必要があり、API が全従業員に表示されるカタログ項目のみを返すようにします。 このコネクタは、OAuth 2.0、Basic Auth、および Bearer の認証方式をサポートしています。

パラメータ タブ

• クエリ（任意）: 単一の全文検索文字列。 コンテンツセクションには、以下のようなものがあります。

  • "keyboard" と入力すると、"keyboard" キーワードを含むカタログ項目を取得します。
  • "keyboard OR mouse" と入力すると、"keyboard" または "mouse" のキーワードを含む項目を取得します。
• 外部リンク: リクエスト項目にリンクするために使用される ServiceNow のホスト名で、コネクタの資格情報で設定された URL と一致することがよくあります。
• カスタムヘッダー: OAuth 2.0 認証方式において、Client Credentials や Authorization Code などの追加資格情報を含めるためにカスタムヘッダーを使用します。 デフォルトのOAuth 2.0認証メカニズムを超えて追加の認証方法が必要な場合に便利です。 OAuth 2.0 - クライアント認証情報またはOAuth 2.0 - 認証コード認証に追加情報を含めるには、カスタムヘッダーを追加を選択します。

テスト結果パネル

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

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

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

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

サンプルレコードを使用して、返されるカタログ項目に、たとえばタイトルだけでなく、詳細な説明が含まれていることを確認してください。

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