Kandji ServiceNow アプリのインストール
アプリがまだインストールされていない場合は、ServiceNow インスタンスに Kandji ServiceNow アプリをインストールします。インストールにより、連携に必要な依存関係がテナントに追加されます。1
ServiceNow ストアにアクセスする
ServiceNow ストアに移動します。
2
Kandji ServiceNow アプリを検索する
ストアで Kandji を検索し、Kandji ServiceNow app を見つけます。
3
Kandji ServiceNow アプリをインストールする
Get を選択して Kandji ServiceNow アプリをインストールします。求められた場合は ServiceNow ストアにサインインします。使用するアカウントには、Integration Hub ストアアプリをインストールする権限が必要です。
OAuth アプリの作成
Iru Endpoint は、グラントタイプ Resource Owner Password Credentials (ROPC) の ServiceNow OAuth API クライアントを使用して、インスタンスのアクセストークンとリフレッシュトークンを取得します。ServiceNow Zurich 以降のリリースでは、外部クライアント用の OAuth API エンドポイントを作成する際に Scope Restriction を Broadly scoped に設定してください。このフィールドがより狭いスコープに設定されていると、Iru Endpoint からのインバウンド API 呼び出しが OAuth client does not have unrestricted access to unscoped APIs is not allowed などのエラーで失敗する場合があります。詳細については、ServiceNow KB2731346 を参照してください。
1
ServiceNow にアクセスする
ServiceNow の管理者アカウントを使用して、ServiceNow テナント (.service-now.com) にログインします。
2
System OAuth に移動する
Filter navigator で System OAuth を検索します。
3
Application Registry を開く
Application Registry を選択します。
4
OAuth エンドポイントを作成する
Create an OAuth API endpoint for external clients を選択します。
5
OAuth アプリを設定する
OAuth アプリに名前を付けます (例:
kandji_oauth_api)。6
リダイレクト URL を設定する
Redirect URL フィールドに https://kandji.io を入力します。
7
設定を送信する
送信 を選択します。
8
OAuth アプリにアクセスする
作成した OAuth アプリに戻ります。
9
Client ID をコピーする
Client ID を選択してコピーします。
10
Client Secret を表示する
南京錠アイコンを選択して Client Secret を表示します。
11
Client Secret をコピーする
Client Secret をコピーします。独自のクライアントシークレットを設定した場合は、更新 を選択して保存します。
サービスアカウントの追加
サービスアカウントのユーザー認証情報は、Iru Endpoint で ServiceNow 連携を設定するために使用されます。Web サービスへのアクセス権があり、cmdb_read、import_transformer、rest_api_explorer のロールを持っていれば、任意の ServiceNow ユーザーアカウントを使用できます。可能な場合は、この連携専用のサービスアカウントを作成してください。
1
ServiceNow にアクセスする
ServiceNow の管理者アカウントを使用して、ServiceNow テナント (.service-now.com) にログインします。
2
ユーザーに移動する
Filter navigator で ユーザー を検索します。
3
User Administration を開く
User Administration で ユーザー を選択します。
4
新しいユーザーを作成する
New を選択して新しいユーザーを追加します。
5
ユーザーの詳細を設定する
ユーザーにわかりやすい名前を入力します (例:
kandji_rest_api_user)。ユーザー名を安全な場所にコピーします。Iru Endpoint で連携を設定する際に必要になります。- 必要に応じて、組織で必要なその他の情報を入力します。
6
Web サービスアクセスを設定する
Web service access only を選択します。
7
ユーザー作成を送信する
送信 を選択します。
8
ユーザーのパスワードを設定する
作成したユーザーを開き、Set Password を選択します。
9
パスワードを生成する
生成 を選択して新しいパスワードを作成します。
10
パスワードをコピーする
新しいパスワードをコピーします。
11
パスワードを保存する
Save Password を選択します。パスワードを安全な場所に保管してください。ServiceNow 連携を設定する際に Iru Endpoint に入力します。
12
パスワードダイアログを閉じる
閉じる を選択して Users ページに戻ります。
13
ユーザーロールにアクセスする
ユーザーページのまま、Roles に移動します。
14
ロールを編集する
編集 を選択します。
15
必要なロールを追加する
サービスアカウントユーザーに次のロールを追加します。
- cmdb_read
- import_transformer
- rest_api_explorer
16
ロールの割り当てを確認する
合計 6 つのロールが表示されるはずです。直接追加した 3 つと、継承された 3 つです。
17
ユーザー設定を保存する
ユーザーの作成を完了するには、保存 を選択します。
トラブルシューティング
Kandji が Discovery Source であることを確認する
1
Dictionary にアクセスする
ServiceNow で、Filter navigator に Dictionary と入力します。
2
Dictionary を開く
System Definition で Dictionary を選択します。
3
Discovery Source を検索する
Dictionary Entries で Column name を選択し、discovery_source と入力します。
4
CMDB テーブルを選択する
cmdb_ci テーブルを選択します。
5
Choices タブにアクセスする
下にスクロールして Choices タブを選択します。
6
Kandji を確認する
Kandji が一覧に表示されていることを確認します。表示されない場合は、ラベル Kandji を検索します。
Kandji が Discovery Source として表示されない場合
Kandji ServiceNow アプリのインストール後に Kandji が discovery source として表示されない場合は、kandji_fix_script を手動で実行します。1
Fix Scripts にアクセスする
ServiceNow で、Filter navigator に Fix Script と入力します。
2
Fix Scripts を開く
System Definition で Fix Scripts を選択します。
3
Fix Script を検索する
Fix Scripts で 名前 を選択し、kandji_fix_script と入力します。
4
Fix Script を選択する
kandji_fix_script レコードを開きます。
5
Fix Script を実行する
Run Fix Script を選択します。
6
バックグラウンドで実行する
Run Fix Script モーダルで Proceed in Background を選択します。
考慮事項
サービスアカウント
アクセスと変更の監査を容易にするため、対話型ユーザーを再利用するのではなく、この連携専用のアカウントを使用することをお勧めします。
OAuth
Zurich 以降では、OAuth アプリを作成する際に Scope Restriction を Broadly scoped に設定してください (OAuth アプリの作成を参照)。リダイレクト URL を
https://kandji.io に設定し、クライアント認証情報を安全に保管してください。ロール
サービスアカウントには cmdb_read、import_transformer、rest_api_explorer が必要です。
検出ソース
インストール後、Dictionary の cmdb_ci の discovery source の選択肢に Kandji が表示されることを確認してください。
トラブルシューティング
discovery source または同期に問題があるように見える場合は、kandji_fix_script fix script を実行し、サービスアカウントに上記の 3 つのロールがあることを確認してください。
関連記事
ServiceNow 連携: 概要
インベントリが Iru Endpoint から ServiceNow のテーブルと変換にどのように流れるか、また有効な場合に SAM Pro データがどのように流れるかを説明します。
ServiceNow 連携: Iru Endpoint の設定
OAuth アプリとサービスアカウントで Iru Endpoint を接続し、ServiceNow の準備ができた後に連携を管理します。