> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/hajimeni/task-management-systems/all-supported-task-trackers/servicenow.md).
# ServiceNow
この一度きりの設定 *ワークスペースごとに* Aikido組織の全員がServiceNowで直接課題を作成できるようになります。
以下のユースケースに対応しています：
* **チケットの自動作成**：セキュリティ問題をシームレスに追跡できるよう、チケットを自動的に作成してServiceNowに送信します。
* **チケットの手動追加**：セキュリティ問題のチケットを手動でServiceNowに追加し、重大な脆弱性に的を絞って対応できます。
{% hint style="info" %}
Aikidoは現在、チケットを次の項目に送信しています： **Incident** ServiceNowのテーブルです。追加のテーブルへの対応はサポート経由でリクエストできます。
{% endhint %}
### 前提条件：ServiceNowでOAuthアプリを登録する
Aikidoを接続する前に、ServiceNowインスタンスでOAuthアプリケーションを登録して、 **クライアントID** と **クライアントシークレット**.
{% stepper %}
{% step %}
**OAuth 2.0プラグインを有効化する**
ServiceNowインスタンスにログインし、まだ有効になっていない場合はOAuth 2.0プラグインを有効化します。
{% endstep %}
{% step %}
**OAuthのシステムプロパティを有効にする**
の `sys_properties` テーブルで、システムプロパティ `com.snc.platform.security.oauth.is.active` を `true`.
{% endstep %}
{% step %}
**アプリケーションレジストリを開く**
次へ移動します： **System OAuth > Application Registry**.
{% endstep %}
{% step %}
**新しいOAuthエンドポイントを作成する**
クリック **新規**、次に **外部クライアント向けのOAuth APIエンドポイントを作成します**.
{% endstep %}
{% step %}
**アプリケーションを設定する**
次の項目を設定します：
* **名前**：一意の名前（例： `Aikido`)
* **クライアントID**：ServiceNowによって自動生成されます
* **クライアントシークレット**：ServiceNowによって自動生成されます
* **リダイレクトURI**: `https://unify.apideck.com/vault/callback`
* **リフレッシュトークンの有効期間**：リフレッシュトークンが有効な秒数
* **アクセストークンの有効期間**：次の値に設定します `3600`
* **スコープ制限**：次の値に設定します **広範囲スコープ**
{% hint style="info" %}
デフォルトでは `厳格なスコープ設定` にするとAPI呼び出しが失敗します。
{% endhint %}
{% endstep %}
{% step %}
**保存して認証情報をコピーする**
クリック **送信**、その後レコードを再度開いて **クライアントID** と **クライアントシークレット** 値をコピーします。
{% endstep %}
{% endstepper %}
{% hint style="info" %}
注：チケットの作成は、統合を設定したユーザーに紐づきます。ServiceNow内に、Incidentテーブルへの書き込み権限を持つ専用の「Aikido」ユーザーを作成することを推奨します。
{% endhint %}
### AikidoアプリをServiceNowに接続する
{% stepper %}
{% step %}
**統合を開く**
次へ移動します： [統合設定](https://app.aikido.dev/settings/integrations) Aikidoアプリ内で。「Task Trackers」セクションの **ServiceNow**.
{% endstep %}
{% step %}
**認証情報を入力する**
ServiceNowの **インスタンス名**, **クライアントID**と **クライアントシークレット**を入力し、次に **「保存」**.
{% hint style="info" %}
あなたのServiceNow **インスタンス名** は管理URLのサブドメインです（例： `dev394641` の `https://dev394641.servicenow.com`).
{% endhint %}
{% endstep %}
{% step %}
**接続を承認する**
クリック **「承認」** をクリックして、AikidoにあなたのServiceNowインスタンスへのアクセスを許可します。
{% endstep %}
{% step %}
**確認**
クリック **「保存」** をもう一度押して設定を完了します。これでAikidoはServiceNowに接続されました。
{% endstep %}
{% endstepper %}
### Aikido経由でServiceNowにタスクを作成するオプション
AikidoからServiceNowへ新しいタスクを作成する方法は2つあります。
#### 1. 手動でのタスク作成
1. フィード内の任意の課題にカーソルを合わせ、 ***+*** の **割り当て列。** または、最後の列の三点アイコンをクリックしてアクションメニューを開くこともできます。課題がグループ化されている場合、三点アイコンのアクションメニューはすべてのサブ課題で利用できます。\
\
2. ポップアップモーダルで必要な詳細を入力します。\
\
3. ServiceNowで新しく作成されたタスクは、Aikidoの課題詳細の「Tasks」タブにリンクされます。
#### 2. 自動タスク作成
{% hint style="info" %}
Aikidoはタスクを自動的に作成します **1時間ごとに一括で。** 現時点では、これを手動で実行するオプションはありません。
{% endhint %}
1. へ移動 [ServiceNow統合](https://app.aikido.dev/settings/integrations/tasktracker) 設定
2. 「**自動作成**」を有効にするには、トグルを **オンにします。**
3. 自動タスク作成の条件を定義します。
自動作成モーダルで、これらすべての設定を構成できます:
* **オン/オフ:** 自動作成を有効または無効にします。オフの場合、しきい値は実質的に `なし`.
* **重大度しきい値:** 以下の問題についてチケットを作成します `重大`, `高`, `中`、または `低` 以上。たとえば、 `高` ～のチケットを作成します `高` および `重大`.
* **問題タイプ:** すべての問題タイプについてチケットを作成するか、次のような特定のタイプに制限します `SCA`, `SAST`, `シークレット`, `クラウド`, `IaC`, `マルウェア`、または `ライセンス`.
* **1日あたりの上限:** 1日に作成されるチケットの最大数を設定します。既定値は `25`です。一部のプランでは、より高い上限に対応しています。
* **チケット作成モード:** 問題グループごとに1件のチケットを作成するか、場所またはスコープごとに別々のチケットを作成します。場所ごとのモードでは、より多くのチケットが作成される場合があります。
* **スコープ:** 場所ごとのモードでのみ利用できます。すべてのリポジトリまたはクラウド、マッピング済みのリポジトリまたはチームのみ、あるいは含める/除外するリストを使用して特定のリポジトリまたはクラウドを対象にします。
4. Aikidoは、設定した1日あたりのタスク上限に達するまで、毎時ServiceNowチケットを自動生成します。
### ServiceNow同期
Aikidoはいくつかのフィールドを自動的にServiceNowへ同期します：
* SeverityはServiceNowの「Priority」フィールドにマッピングされます
* 担当者は双方向で同期されます（そのためServiceNowでの更新はAikidoにも反映されます）
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.aikido.dev/docs/docs-ja/hajimeni/task-management-systems/all-supported-task-trackers/servicenow.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.