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

# ServiceNow

> ServiceNow ITSM を CloudThinker に接続してインシデント、変更要求、問題、CMDB の管理を行う

ServiceNow ITSM プラットフォームを接続して、CloudThinker エージェントがインシデント、変更要求、問題、CMDB 構成アイテムを管理できるようにします。ServiceNow は専用サービスアカウントの **ユーザー名とパスワード** で認証します。

***

## 対応プラットフォーム

| プラットフォーム            | サポート                         |
| ------------------- | ---------------------------- |
| **ServiceNow**      | Xanadu、Yokohama、およびそれ以降のリリース |
| **ServiceNow ITSM** | すべてのエディション                   |
| **ServiceNow ITOM** | すべてのエディション                   |

<Info>
  ServiceNow は N および N-1 リリースをサポートしています。CloudThinker は ServiceNow REST API を使用しており、最近のすべてのリリースで安定して動作します。
</Info>

***

## 前提条件

* Xanadu 以降のリリースで動作する **ServiceNow インスタンス**。
* 開発者インスタンスの場合：管理者認証情報。
* エンタープライズインスタンスの場合：`itil`、`cmdb_read`、`rest_api_explorer` ロールを持つ専用サービスアカウント。

***

## セットアップ

<Tabs>
  <Tab title="開発者インスタンス">
    <Steps>
      <Step title="インスタンス URL を確認する">
        開発者インスタンスの URL は以下の形式になります：

        ```
        https://devXXXXX.service-now.com
        ```
      </Step>

      <Step title="CloudThinker に接続を追加する">
        **Connections → ServiceNow** に移動し、以下を入力します：

        * **Instance URL**: 開発者インスタンスの URL
        * **Username**: 管理者のユーザー名
        * **Password**: 管理者のパスワード

        **Connect** をクリックします。CloudThinker が認証情報を検証し、**Connected** ステータスを表示します。
      </Step>
    </Steps>
  </Tab>

  <Tab title="エンタープライズインスタンス">
    <Steps>
      <Step title="専用ユーザーを作成する">
        ServiceNow で **User Administration → Users** に移動し、新しいユーザーを作成します：

        * **User ID**: `cloudthinker`
        * **Password**: 強力でユニークなパスワード
        * **Active**: チェック済み
      </Step>

      <Step title="ロールを割り当てる">
        ユーザーに以下のロールを割り当てます：

        * `itil` — インシデント、変更、問題管理のため
        * `cmdb_read` — CMDB の読み取りアクセスのため
        * `rest_api_explorer` — API アクセスのため
      </Step>

      <Step title="インスタンス URL を確認する">
        ServiceNow インスタンスの URL は以下の形式になります：

        ```
        https://your-instance.service-now.com
        ```
      </Step>

      <Step title="CloudThinker に接続を追加する">
        **Connections → ServiceNow** に移動し、以下を入力します：

        * **Instance URL**: ServiceNow インスタンスの URL
        * **Username**: `cloudthinker`
        * **Password**: 設定したパスワード

        **Connect** をクリックします。CloudThinker が認証情報を検証し、**Connected** ステータスを表示します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## 接続の詳細

| フィールド                         | 説明                     | 例                                       |
| ----------------------------- | ---------------------- | --------------------------------------- |
| **SERVICENOW\_INSTANCE\_URL** | ServiceNow インスタンスの URL | `https://your-instance.service-now.com` |
| **SERVICENOW\_USERNAME**      | ServiceNow のユーザー名      | `cloudthinker`                          |
| **SERVICENOW\_PASSWORD**      | ServiceNow のパスワード      | —                                       |

***

## 必要な権限

### 開発者インスタンス

追加設定は不要です — デフォルトの管理者ユーザーがフルアクセスを持ちます。

### エンタープライズインスタンス

| ロール                 | アクセス権                                    |
| ------------------- | ---------------------------------------- |
| `itil`              | インシデント、変更、問題、その他の ITSM タスクテーブルへの完全な CRUD |
| `cmdb_read`         | CMDB 構成アイテムへの読み取り専用アクセス                  |
| `rest_api_explorer` | REST API アクセス                            |

<Tip>
  最小権限の原則に従い、読み取り専用のユースケースでは、完全な `itil` ロールの代わりに必要なテーブルへの読み取り権限のみを持つカスタムロールを作成してください。
</Tip>

***

## エージェントの機能

接続後、エージェントは ServiceNow データの照会と操作を行えます。

| 機能               | 説明                       |
| ---------------- | ------------------------ |
| **インシデント管理**     | インシデントの作成、更新、解決          |
| **変更要求**         | リスク評価を含む変更要求の作成とレビュー     |
| **問題管理**         | 問題レコードの追跡と分析             |
| **CMDB 照会**      | 構成アイテムと依存関係の照会           |
| **ユーザー・グループの検索** | ユーザー、グループ、その割り当てを検索する    |
| **自然言語検索**       | ServiceNow の任意のテーブルを検索する |

### 接続を確認する

```text theme={null}
@alex list all open P1 incidents in ServiceNow and show their priority and status
```

### プロンプト例

```text theme={null}
@alex list all open P1 incidents and #report on any patterns across services
@alex review pending change requests and assess risk
@alex query the CMDB for all production servers and their dependencies
```

***

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

<Accordion title="接続が拒否された">
  ServiceNow インスタンスの URL が正しくないか、インスタンスがメンテナンスモードです。URL がアクセス可能であり、IP 制限が CloudThinker をブロックしていないことを確認してください。
</Accordion>

<Accordion title="認証に失敗した">
  ユーザー名またはパスワードが正しくないか、ユーザーアカウントがロックされています。認証情報を確認し、ユーザーが `rest_api_explorer` または同等の API アクセスロールを持っていることを確認してください。
</Accordion>

<Accordion title="テーブルへのアクセスが拒否された">
  ユーザーがアクセスしているテーブルに必要なロールを持っていません。ACL ルールを確認し、CMDB アクセスには `cmdb_read` が割り当てられていることを確認してください。
</Accordion>

<Accordion title="レート制限">
  ServiceNow は高負荷時に API リクエストをスロットリングする場合があります。429 エラーが発生した場合は同時操作を減らし、ServiceNow 管理者にレート制限設定の見直しを依頼してください。
</Accordion>

***

## セキュリティ

* **最小権限** — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
* **デフォルトで読み取り専用** — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
* **認証情報のローテーション** — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
* **オフボーディング時に失効** — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。

- **専用サービスアカウント** — 共有の管理者アカウントを使用するのではなく、CloudThinker 専用の ServiceNow ユーザーを作成してください。
- **IP 制限** — ServiceNow のアクセスコントロール設定で、CloudThinker の IP に API アクセスを制限することを検討してください。

***

## 関連

<CardGroup cols={2}>
  <Card title="PagerDuty 接続" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/pagerduty.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=cdc34a966d5d46da70c3bc509a2a7492" href="/ja/guide/connections/pagerduty" width="24" height="24" data-path="images/icons/pagerduty.svg">
    インシデント管理とオンコール
  </Card>

  <Card title="Elasticsearch 接続" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/elasticsearch.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c7389cfcd0bc8d303aeeb68bd19199ca" href="/ja/guide/connections/elasticsearch" width="24" height="24" data-path="images/icons/elasticsearch.svg">
    ログを ServiceNow インシデントと相関させる
  </Card>
</CardGroup>