Kandjiでの統合を完了する前に、ServiceNow 統合ハブに Kandji ServiceNow アプリケーションをインストールし、OAuth API アプリケーションを作成して、ServiceNow コンソールにサービスアカウントユーザーを追加する必要があります。
Kandji ServiceNow アプリのインストール
まだインストールしていない場合は、ServiceNow インスタンスに Kandji ServiceNow Integration Hub アプリをインストールする必要があります。アプリをインストールすると、ServiceNow テナントに必要な依存関係の一部が設定されます。
ServiceNow ストアに移動します。
Kandjiを見つけます。
[取得] をクリックして、Kandji 統合アプリケーションをインストールします。アプリをインストールする前に、ServiceNow ストアへの認証が必要になる場合があります。使用する資格情報には、Integration Hub ストアアプリをインストールする権限が必要です。
OAuth アプリケーションの作成
Kandji は、許可タイプ「リソース所有者パスワード資格情報 (ROPC)」を活用する ServiceNow OAuth API クライアントを使用して、ServiceNow インスタンスと対話するためのアクセストークンとリフレッシュトークンを要求します。
ServiceNow 管理者アカウントを使用して、ServiceNow テナント ({yourtenant}.service-now.com) にログインします。
フィルターナビゲーターで、System OAuth を検索します。
[アプリケーションレジストリ]をクリックします。
「外部クライアント用の OAuth API エンドポイントを作成」をクリックします。
OAuth アプリケーションに名前を付けます。(例:kandji_oauth_api)
「リダイレクトURL」フィールドに「https://kandji.io」と入力します。
「送信」をクリックします。
作成した OAuth アプリに戻ります。
[クライアント ID] を強調表示してコピーします。
南京錠をクリックして 、クライアントシークレット を表示します。
クライアントシークレットを強調表示してコピーするか、オプションで、独自のクライアントシークレットを入力する場合は、必ず [更新 ]をクリックして変更を保存してください。
サービスアカウントの追加
サービスアカウントのユーザー資格情報は、 Kandjiで ServiceNow 統合を設定するために使用されます。
ServiceNow ユーザーアカウントは、Web サービスへのアクセス権があり、cmdb_read、import_transformer、rest_api_explorer の役割が割り当てられている限り使用できます。ただし、一般的には、統合ごとに個別のサービスアカウントを作成することをお勧めします。
ServiceNow 管理者アカウントを使用して、ServiceNow テナント ({yourtenant}.service-now.com) にログインします。
フィルター ナビゲータで、ユーザーを検索します。
「ユーザー管理」で、「 ユーザー」をクリックします。
[ 新規 ] をクリックして、新しいユーザーを追加します。
ユーザーのわかりやすい名前を入力します。(例:
kandji_rest_api_user
)。ユーザー名を安全な場所にコピーします。この資格情報は、 Kandjiで統合を設定するときに使用します。必要に応じて、組織で必要な追加情報を入力します。
必ず Web サービスアクセスのみを選択してください。
「送信」をクリックします。
作成したばかりの新しいユーザーをクリックし、[ パスワードの設定] をクリックします。
[生成] をクリックして、新しいパスワードを作成します。
新しいパスワードをコピーします。
「 パスワードの保存」をクリックします。このパスワードは必ず安全な場所に保管してください。このパスワードは、ServiceNow統合を設定する際に Kandji で使用されます。
「閉じる」をクリックして、「ユーザー」ページに戻ります。
ユーザーページで、 ロールに移動します。
[編集] をクリックします。
次のロールをサービス アカウント ユーザーに追加します。
cmdb_read
import_transformer
rest_api_explorer
合計 6 つの新しいロールが割り当てられている必要があります。3 つが割り当てられ、3 つが継承されます。
ユーザーの作成を完了するには、[ 保存] をクリックします。
トラブルシューティング
Kandjiがディスカバリーソースであることを確認します。
ServiceNow で、フィルター ナビゲータに「Dictionary」と入力します。
「システム定義」で、「 ディクショナリ」をクリックします。
Dicionary Entires 検索で [列名] が選択されていることを確認し、列名にdicovery_sourceを入力します 。
cmdb_ciテーブルをクリックします。
下にスクロールして、[ 選択肢] タブを選択します。
Kandjiが表示されていることを確認します。すぐにKandjiが表示されない場合は、 ラベル Kandjiを検索できます。
Kandji がディスカバリーソースとして表示されない場合
このセクションでは、Kandji Integration Hub アプリケーションのインストール後に Kandji がディスカバリーソースとして自動的に表示されない場合に、kandji_fix_scriptを手動で実行する方法について説明します。
ServiceNow で、フィルターナビゲーターに「Fix Script」と入力します。
「システム定義」で、「 修正スクリプト」をクリックします。
「修正スクリプト」検索で、「 名前 」が選択されていることを確認し、修正スクリプト名 をkandji_fix_script入力します。
kandji_fix_scriptテーブルをクリックします。
「 Fix Script の実行」をクリックします。
「Fix スクリプトの実行」モーダルで、「 バックグラウンドで続行」をクリックします。
これで、ServiceNowで Kandjiがディスカバリーソースの選択肢としてリストされます。
次の記事へ
Kandji ServiceNow 統合の Kandji 設定。