SFTPを経由したServiceNowインポートのインストールガイド

このガイドは、SSHファイル転送プロトコル（SFTP）を介したServiceNowインポートのインストールおよび設定に関する包括的な情報を提供します。また、基本的な保守ガイドも含まれています。

前提条件

• このページの設定手順は、ServiceNow認定の専門家によって実行される必要があります。

このページは、Nexthink技術、ServiceNow技術、およびビジネスルール、スクリプティング、基本的なセキュリティ用語などの基本概念について詳細な理解を持っている読者を対象としています。

ここに含まれている情報は予告なく変更される可能性があり、誤りがないことは保証されていません。 エラーを発見した場合は、Nexthinkサポートポータルを介して報告してください。

このソフトウェアと関連資料は、使用と開示に制限を含むライセンス契約の下で提供され、知的財産法によって保護されています。 ライセンス契約で明示的に許可されている場合を除き、法律で許可されている場合を除いて、本ソフトウェアのいかなる部分も使用、コピー、翻訳、放送、修正、ライセンス、配信、公開、表示することはできません。

相互運用性のために法律が要求する場合を除き、本ソフトウェアのリバースエンジニアリング、逆コンパイル、逆アセンブルは禁止されています。

SFTPを介したServiceNowインポートの概要

SFTPを介したServiceNowのインポートにより、Nexthinkの顧客はNexthink InfinityからエンドユーザーITデータをServiceNowプラットフォームに統合することができます。

SFTPを介したServiceNowのインポートを設定することにより、システムがServiceNowにデータを登録するためのデバイス、ユーザー、ソフトウェアパッケージ、その他の構成アイテム（CI）に関する情報を選択することができます。 また、このシステムは、これらの構成アイテム（CI）間の関係をServiceNowにインポートすることができます。

この統合は、Nexthinkから対応する情報が提供される変換マップのデフォルトセットを提供し、事前定義されたマッピングを提供します。 この統合により、特定のCIタイプに関連付けられた特定のフィールドのインポートを利用することができます。

デフォルトのマッピングに加えて、統合の柔軟な設計により、未保護の変換マップによって埋め込まれるさまざまなCMDB ServiceNowテーブルおよびフィールドを設定することができます。

インストールガイドラインについては、このページの[初期設定](servicenow-import-via-sftp-installation-guide.md#servicenowimportviasftpinstallationguide-initialconfiguration)セクションに移動してください。

含まれる主なServiceNowコンポーネント

カスタムテーブルインベントリ

このアプリケーションは、インポートセットを管理するためのステージングテーブルとして使用する8つのカスタムテーブルを作成します。 これらのテーブルをサブスクリプションに割り当ててはなりません。

以下にカスタムテーブルの割り当てに関する詳細情報を参照してください:

ラベル	名前
インポートセットソフトウェア	x_nexsa_sftp_import_set_software
インポートセットユーザー	x_nexsa_sftp_import_set_user
インポートセットワークステーション	x_nexsa_sftp_import_set_workstation
インポートセットワークステーション - ソフトウェア	x_nexsa_sftp_import_set_workstation_software
インポートセットユーザー - ワークステーション	x_nexsa_sftp_import_set_user_workstation

データエクスポート機能で使用するNQLクエリ

Nexthink Infinity Data Export機能は、前のセクションでリストされているすべてのインポートセットテーブルを作成するために使用されるCSVファイルを生成しました。 これは次のクエリを使用して実行されました:

CIタイプ	クエリー
ワークステーション	devices\n| where hardware.machine_serial_number != "" and (hardware.type == laptop or hardware.type == desktop)\n| include cpus\n| compute num_of_cores = number_of_cores.count(), number_of_cpus = count(), freq = frequency.sum()\n| include disks\n| compute disk_capacity = capacity.sum()\n| list group_name, entity, hardware.manufacturer, hardware.model, operating_system.architecture, hardware.machine_serial_number, name, hardware.memory, num_of_cores, number_of_cpus, freq, disk_capacity, operating_system.name, operating_system.build\n
Windows Server	Not supported yet\n
ユーザー	users\n| where name !in ["*Local*"]\n
ソフトウェア	package.installed_packages\n| list package.name, package.version, package.publisher\n
ユーザー-ワークステーション関係	session.connects during past 7d\n| where hardware.type == laptop or hardware.type == desktop\n| summarize c1 = count() by device.name, user.name, user.ad.full_name\n| list device.name, user.name, user.ad.full_name\n
ワークステーション-ソフトウェア関係	package.installed_packages\n| where (device.hardware.type == desktop or device.hardware.type == laptop)\n| list package.name, package.version , package.publisher , device.name, device.hardware.type\n
ユーザー-WindowsServer関係	session.connects during past 7d\n| where hardware.type != laptop and hardware.type != desktop\n| summarize c1 = count() by device.name , user.name , user.ad.full_name\n| list device.name , user.name , user.ad.full_name\n
WindowsServer-ソフトウェア関係	Not supported yet\n

インポートセット、データソース、変換マップ、およびスケジュールされたインポート

Nexthink CMDBポピュレータ統合は、インポート可能なCIタイプと関係ごとに1つのインポートセットテーブル、データソース、変換マップ、およびスケジュールされたインポートを提供します。

データソース

データソースは、データがインポートセットに挿入される前にどこからどのように取得されるかを定義します。 変換マップとともに、それらはシステムがインポートセットから宛先テーブルへのマッピングプロセス中にデータをどのように変換するかを定義します。

インポートセット

インポートセットは、インポートプロセス中に使用されるSpecial Nowの特別なタイプのテーブルです。 それらはステージングエリアとして機能し、データソースからの生データを受け取り、それをServiceNowターゲットテーブルに送信します。

変換マップ

変換マップは、インポートセット内のフィールドと既存のServiceNowテーブル内のフィールドの間の関係を決定するフィールドマップのセットです。 このプロセスの一環として、インポートセットにインポートした任意のデータを変更、切断、または変換し、要件に応じて最終テーブルに結果のデータを保存することも可能です。

スケジュールされたインポート

スケジュールされたインポートは、システムが一定の間隔でインポート操作を実行することを指定します。これは、毎日、週ごと、周期的、または異なる時間枠として定義できます。 デフォルトでは、統合が提供するスケジュールされたインポートは非アクティブになっていますが、異なるスクリプトがプログラム的にそれらを実行します。 以下のセクションで詳細情報を入手してください。

役割

SFTPを介したServiceNowインポートは、新しいロールx_nexsa_sftp.managerを作成してアプリケーションを管理します。

役割	タスク
x_nexsa_sftp.manager	インポートセットテーブルにデータを挿入。

適用するインスタンスに既存のアクセス制御リスト（ACL）がある場合、一部を変更してx_nexsa_sftp.managerロールを含める必要があるかもしれません。 これを変更しない場合、初期セットアップ時にいくつかのシステムテーブルとそれに関連するレコードを表示できない可能性があります。

その他のServiceNowコンポーネント

参照フィールドと選択フィールド

システムは、CMDBの各列が特定のタイプのデータを含むように設定されています。 特定の方法で動作する二つのタイプがあります。

例えば、文字列フィールドでは、システムが何の結果もなく到来するデータを挿入して保存することができます。 ただし、参照および選択フィールドの場合、システムはこれらを異なるテーブル内の別のレコードに関連付けます。

例えば、cmdb_ci_computerテーブルのフィールド「Manufacturer」は、標準「core_company」テーブル内の特定のレコードを参照しています。そのため、「manufacturer」フィールドに情報を挿入するには、システムは参照する既存のレコードを「core_company」テーブル内に持っている必要があります。

一方、選択フィールドは同じ方法で動作しますが、この場合、sys_choiceテーブルに選択を作成する必要があります。

デフォルトで、このアプリケーションに含まれる変換マップは、Nexthinkが新しいデータを受信する際に、sys_choiceおよびすべての参照テーブルにレコードを作成します。 つまり、CSVファイルで受け取られたメーカーが「core_company」テーブルに存在しない場合、システムは変換が参照テーブルに挿入できるようにそれを作成します。

ビジネスルール

アプリケーションにビジネスルールを定義していない場合でも、システムはServiceNowインスタンスに以前に定義されているルールすべてを尊重するように変換マップを構成します。

変換マップ「ビジネスルール実行」設定詳細

各インスタンスは独自のビジネスルールを持っています。 Nexthinkは、ターゲットテーブルにデータを挿入する際にこれらのルールをバイパスすることをお勧めしません。インポートプロセス中に予期しない、または好ましくない動作が現れる可能性があるからです。

変換スクリプト

変換マップの中には、Nexthinkから受け取ったデータを変換した後にいくつかのフィールドを埋め込むものがあります。 以下のテーブルを参照してください:

変換マップ	ソースフィールド	ターゲットフィールド	変換
ワークステーション	u_device_operating_system_name	os	オペレーティングシステム情報を取得
ワークステーション	u_device_opera_g_system_build	os_version	オペレーティングシステムのバージョンを取得
ワークステーション	u_device_hardware_memory	ram	バイトをメガバイトに変換
ワークステーション	u_disk_capacity	disk_space	バイトをギガバイトに変換
ユーザー-ワークステーション	該当なし	type	cmdb_rel_personテーブルに関係タイプを挿入
ワークステーション-ソフトウェア	該当なし	name	ソフトウェアとCI名に基づいて関係名を設定
ワークステーション-ソフトウェア	該当なし	software	ソフトウェア名とバージョンに基づいて製品名の値を設定

SFTP経由でのServiceNowインポートのインストール - 初期設定

アプリケーションインストールプロセス

アプリケーションパッケージは、アップデートセットフォーマットでのみ利用可能です。 インストールするには、以下の手順に従ってください:

1. システムアップデートセット > 取得済みアップデートセットモジュールに移動します。

2. XMLからアップデートセットのインポート関連リンクをクリックします。

3. アプリケーションのアップデートセットXMLファイルをアップロードします。

4. アップデートセットテーブルで、ServiceNow import via SFTPアップデートセットをクリックします。

5. アップデートセットのプレビューボタンをクリックし、プレビューが終了するのを待ちます。

6. アップデートセットのコミットボタンをクリックし、処理が終了するのを待ちます。

7. アップデートセットステータスはコミット済みに切り替わります。

役割の割り当て

管理者権限を持っているユーザー、または_x_nexsa_sftp.manager_ロールを持っているユーザーだけが、アップデートに含まれるインポートセットテーブルに書き込むことができます。 スケジュールされたインポートを実行するユーザーには、前述のいずれかのロールを提供することが重要です。

さらに、ターゲットテーブル（コンピュータ、ソフトウェア、人関係）への書き込み能力は他のルールの影響を受ける可能性があります。 データインポート担当者が以下のすべてのターゲットテーブルに書き込むアクセス権を持っていることを確認してください。

• コンピュータ [cmdb_ci_computer]

• ソフトウェア [cmdb_ci_spkg]

• ユーザー [sys_user]

• 人関係 [cmdb_rel_person]

• ソフトウェアインスタンス [cmdb_software_instance]

916KB

x_nexsa_sftp_i1.0.0.xml

Open

クロススコープのパーミッション

システムは、前のセクションで詳細に説明されているすべてのターゲットテーブルを、クロススコープのパーミッションを組み込んだ状態で設定しており、ServiceNowがSFTPを通じてこれらのすべてにレコードを書き込み、生成できるようにしています。

しかし、インポートプロセス中にシステムが次のエラーを引き起こす可能性がある状況が発生することがあります:

[読込|書込|作成] 操作が、スコープ『ServiceNow Import via SFTP』からテーブル '{table_name}' で拒否されました。 『ServiceNow Import via SFTP』アプリケーションは、クロススコープアクセス特権を宣言する必要があります。 アプリケーション管理者に連絡してアクセスリクエストを更新してください。

その場合、影響を受けたテーブル設定を編集して、アプリケーションアクセス設定で必要な操作を許可することで問題を解決してください。

たとえば：

アプリケーションアクセスの権限

データソース設定

このアプリケーションは、利用可能な各CIタイプと関係に対して事前に設定されたデータソースを含んでいます。 デフォルトでは、これらのデータソースはカスタムテーブルインベントリセクションで開示されたテーブルにデータを入力します。 さらに、システムはSFTPサーバーから取得されたCSVファイルを取得するようにそれぞれ設定されています。

他のフィールドはデフォルトでは空です。SFTPに関連する情報を入力する必要があります。

データソース フォーム

データソースを設定するには、ServiceNow Import via SFTP > データソースモジュールに移動し、必要なデータソースをクリックします。 以下にリストされたすべてのフィールドを設定してください。

フィールド	詳細
サーバー	SFTPサーバーのDNS
ポート	サーバーにアクセスするポート（デフォルトではポート22）
ファイルパス	インポートされるCSVファイルに到達するための絶対パス
ユーザー名	SFTPサーバーのユーザー名
[パスワード]	上記のユーザーのパスワード
CSVデリミタ	デリミタとして使用される記号（デフォルト値: “,“）

ServiceNow Import via SFTPインストール - オプション設定

変換マップ設定

すべてのデータソースにリンクされた変換マップが、いくつかの事前設定とともに作成されています。 これらは基本的に、インポートセットテーブルでインポートされたカラムをターゲットテーブルのフィールドとマッピングし、必要に応じていくつかの変換を許可するように設定されています。

フィールドマップの詳細

上記のスクリーンショットでは、_u_device_entity フィールド_のスタンディングテーブルに保存されているすべてのデータが、ターゲットテーブルの_位置_フィールドに転送されることがわかります。

一方、システムは変換スクリプトによって他のカラム（例: os や os_version）にデータを記録します。

ソーススクリプトの例

新しいフィールドマッピングを作成するか、既存のフィールドマップを編集する必要がある場合は、ServiceNowの標準手順に従ってください:

• フィールドマップの作成 | ServiceNow

• マッピングオプション | ServiceNow

スケジュールされたインポート設定

スケジュールインポートセクションで説明しているように、特定の間隔でインポート手続きを実行するようにシステムをスケジュールできます。

そのためには、ServiceNow Import via SFTP > スケジュールインポートモジュールに移動します。 このモジュールには、8つの異なるCIタイプごとの事前定義されたスケジュールジョブがあります。 設定フォームにアクセスするには、変更する予定のスケジュールインポートをクリックします。

スケジュールされたインポート設定

以下の表は、フォーム内の各設定フィールドを詳細に説明します:

フィールド	詳細
アクティブ	システムがスケジュールされたインポートを実行するかどうかを制御します。 有効化するためにはボックスをチェックしてください。
実行	システムがインポートを実行する頻度。 このフィールドでの選択に応じて、下のフィールドが変わることがあります。
実行するユーザー	インポートジョブが使用するユーザーの資格情報の名前。 指定しない場合、インポートジョブはゲストユーザーとして実行されます。

上記の表で最も重要な設定は アクティブ 設定です。 このフィールドをアクティブにすると、スケジュールインポートの日付や間隔の詳細を設定するための新しいフィールドが 実行 フィールドの下に表示されます。 これらのオプションの詳細については、ServiceNowのドキュメンテーションで確認してください。