> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ServiceNow 連携: ServiceNow の設定

> Kandji ServiceNow アプリをインストールし、OAuth 認証情報とサービスアカウントを作成して、Iru Endpoint 連携の discovery source 設定を確認します。

### Kandji ServiceNow アプリのインストール

アプリがまだインストールされていない場合は、ServiceNow インスタンスに Kandji ServiceNow アプリをインストールします。インストールにより、連携に必要な依存関係がテナントに追加されます。

<Steps>
  <Step title="ServiceNow ストアにアクセスする">
    [ServiceNow ストア](https://store.servicenow.com/sn_appstore_store.do#!/store/home)に移動します。
  </Step>

  <Step title="Kandji ServiceNow アプリを検索する">
    ストアで **Kandji** を検索し、**Kandji ServiceNow app** を見つけます。
  </Step>

  <Step title="Kandji ServiceNow アプリをインストールする">
    **Get** を選択して Kandji ServiceNow アプリをインストールします。求められた場合は ServiceNow ストアにサインインします。使用するアカウントには、Integration Hub ストアアプリをインストールする権限が必要です。
  </Step>
</Steps>

### OAuth アプリの作成

Iru Endpoint は、グラントタイプ **Resource Owner Password Credentials (ROPC)** の ServiceNow OAuth API クライアントを使用して、インスタンスのアクセストークンとリフレッシュトークンを取得します。

<Note>
  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](https://support.servicenow.com/kb?id=kb_article_view\&sysparm_article=KB2731346) を参照してください。
</Note>

<Steps>
  <Step title="ServiceNow にアクセスする">
    ServiceNow の管理者アカウントを使用して、ServiceNow テナント ({yourtenant}.service-now\.com) にログインします。
  </Step>

  <Step title="System OAuth に移動する">
    **Filter navigator** で **System OAuth** を検索します。
  </Step>

  <Step title="Application Registry を開く">
    **Application Registry** を選択します。
  </Step>

  <Step title="OAuth エンドポイントを作成する">
    **Create an OAuth API endpoint for external clients** を選択します。
  </Step>

  <Step title="OAuth アプリを設定する">
    OAuth アプリに名前を付けます (例: `kandji_oauth_api`)。
  </Step>

  <Step title="リダイレクト URL を設定する">
    **Redirect URL** フィールドに [**https://kandji.io**](https://kandji.io) を入力します。
  </Step>

  <Step title="設定を送信する">
    **送信** を選択します。
  </Step>

  <Step title="OAuth アプリにアクセスする">
    作成した OAuth アプリに戻ります。
  </Step>

  <Step title="Client ID をコピーする">
    **Client ID** を選択してコピーします。
  </Step>

  <Step title="Client Secret を表示する">
    南京錠アイコンを選択して **Client Secret** を表示します。
  </Step>

  <Step title="Client Secret をコピーする">
    **Client Secret** をコピーします。独自のクライアントシークレットを設定した場合は、**更新** を選択して保存します。
  </Step>
</Steps>

### サービスアカウントの追加

サービスアカウントのユーザー認証情報は、Iru Endpoint で ServiceNow 連携を設定するために使用されます。

<Note>
  Web サービスへのアクセス権があり、**cmdb\_read**、**import\_transformer**、**rest\_api\_explorer** のロールを持っていれば、任意の ServiceNow ユーザーアカウントを使用できます。可能な場合は、この連携専用のサービスアカウントを作成してください。
</Note>

<Steps>
  <Step title="ServiceNow にアクセスする">
    ServiceNow の管理者アカウントを使用して、ServiceNow テナント ({yourtenant}.service-now\.com) にログインします。
  </Step>

  <Step title="ユーザーに移動する">
    **Filter navigator** で **ユーザー** を検索します。
  </Step>

  <Step title="User Administration を開く">
    User Administration で **ユーザー** を選択します。
  </Step>

  <Step title="新しいユーザーを作成する">
    **New** を選択して新しいユーザーを追加します。
  </Step>

  <Step title="ユーザーの詳細を設定する">
    ユーザーにわかりやすい名前を入力します (例: `kandji_rest_api_user`)。ユーザー名を安全な場所にコピーします。Iru Endpoint で連携を設定する際に必要になります。

    * 必要に応じて、組織で必要なその他の情報を入力します。
  </Step>

  <Step title="Web サービスアクセスを設定する">
    **Web service access only** を選択します。
  </Step>

  <Step title="ユーザー作成を送信する">
    **送信** を選択します。
  </Step>

  <Step title="ユーザーのパスワードを設定する">
    作成したユーザーを開き、**Set Password** を選択します。
  </Step>

  <Step title="パスワードを生成する">
    **生成** を選択して新しいパスワードを作成します。
  </Step>

  <Step title="パスワードをコピーする">
    新しいパスワードをコピーします。
  </Step>

  <Step title="パスワードを保存する">
    **Save Password** を選択します。パスワードを安全な場所に保管してください。ServiceNow 連携を設定する際に Iru Endpoint に入力します。
  </Step>

  <Step title="パスワードダイアログを閉じる">
    **閉じる** を選択して Users ページに戻ります。
  </Step>

  <Step title="ユーザーロールにアクセスする">
    ユーザーページのまま、**Roles** に移動します。
  </Step>

  <Step title="ロールを編集する">
    **編集** を選択します。
  </Step>

  <Step title="必要なロールを追加する">
    サービスアカウントユーザーに次のロールを追加します。

    * cmdb\_read
    * import\_transformer
    * rest\_api\_explorer
  </Step>

  <Step title="ロールの割り当てを確認する">
    合計 6 つのロールが表示されるはずです。直接追加した 3 つと、継承された 3 つです。
  </Step>

  <Step title="ユーザー設定を保存する">
    ユーザーの作成を完了するには、**保存** を選択します。
  </Step>
</Steps>

### トラブルシューティング

#### Kandji が Discovery Source であることを確認する

<Steps>
  <Step title="Dictionary にアクセスする">
    ServiceNow で、**Filter navigator** に **Dictionary** と入力します。
  </Step>

  <Step title="Dictionary を開く">
    System Definition で **Dictionary** を選択します。
  </Step>

  <Step title="Discovery Source を検索する">
    Dictionary Entries で **Column name** を選択し、**discovery\_source** と入力します。
  </Step>

  <Step title="CMDB テーブルを選択する">
    **cmdb\_ci** テーブルを選択します。
  </Step>

  <Step title="Choices タブにアクセスする">
    下にスクロールして **Choices** タブを選択します。
  </Step>

  <Step title="Kandji を確認する">
    **Kandji** が一覧に表示されていることを確認します。表示されない場合は、ラベル **Kandji** を検索します。
  </Step>
</Steps>

#### Kandji が Discovery Source として表示されない場合

Kandji ServiceNow アプリのインストール後に **Kandji** が discovery source として表示されない場合は、**kandji\_fix\_script** を手動で実行します。

<Steps>
  <Step title="Fix Scripts にアクセスする">
    ServiceNow で、**Filter navigator** に **Fix Script** と入力します。
  </Step>

  <Step title="Fix Scripts を開く">
    System Definition で **Fix Scripts** を選択します。
  </Step>

  <Step title="Fix Script を検索する">
    Fix Scripts で **名前** を選択し、**kandji\_fix\_script** と入力します。
  </Step>

  <Step title="Fix Script を選択する">
    **kandji\_fix\_script** レコードを開きます。
  </Step>

  <Step title="Fix Script を実行する">
    **Run Fix Script** を選択します。
  </Step>

  <Step title="バックグラウンドで実行する">
    Run Fix Script モーダルで **Proceed in Background** を選択します。
  </Step>
</Steps>

これで、Kandji が ServiceNow の discovery source の選択肢として表示されるはずです。

## 考慮事項

<CardGroup cols={2}>
  <Card title="サービスアカウント" icon="user">
    アクセスと変更の監査を容易にするため、対話型ユーザーを再利用するのではなく、この連携専用のアカウントを使用することをお勧めします。
  </Card>

  <Card title="OAuth" icon="key">
    **Zurich** 以降では、OAuth アプリを作成する際に **Scope Restriction** を **Broadly scoped** に設定してください ([OAuth アプリの作成](#creating-an-oauth-app)を参照)。リダイレクト URL を `https://kandji.io` に設定し、クライアント認証情報を安全に保管してください。
  </Card>

  <Card title="ロール" icon="shield">
    サービスアカウントには **cmdb\_read**、**import\_transformer**、**rest\_api\_explorer** が必要です。
  </Card>

  <Card title="検出ソース" icon="magnifying-glass">
    インストール後、Dictionary の **cmdb\_ci** の discovery source の選択肢に **Kandji** が表示されることを確認してください。
  </Card>

  <Card title="トラブルシューティング" icon="wrench">
    discovery source または同期に問題があるように見える場合は、**kandji\_fix\_script** fix script を実行し、サービスアカウントに上記の 3 つのロールがあることを確認してください。
  </Card>
</CardGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="ServiceNow 連携: 概要" icon="book-open" href="/ja/endpoint/integrations/servicenow/servicenow-integration-overview">
    インベントリが Iru Endpoint から ServiceNow のテーブルと変換にどのように流れるか、また有効な場合に SAM Pro データがどのように流れるかを説明します。
  </Card>

  <Card title="ServiceNow 連携: Iru Endpoint の設定" icon="plug" href="/ja/endpoint/integrations/servicenow/servicenow-integration-iru-endpoint-configuration">
    OAuth アプリとサービスアカウントで Iru Endpoint を接続し、ServiceNow の準備ができた後に連携を管理します。
  </Card>
</CardGroup>