> 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で直接Issueを作成できるようになります。
以下のユースケースがサポートされています:
* **チケットの自動作成**: セキュリティ課題をシームレスに追跡できるよう、チケットを自動的に作成してServiceNowに送信します。
* **手動チケット追加**: セキュリティ課題のチケットを手動でServiceNowに追加し、重大な脆弱性に重点的に対応できるようにします。
{% hint style="info" %}
Aikidoは現在、チケットを **Incident** テーブルに送信しています。追加テーブルのサポートはSupport経由でリクエストできます。
{% endhint %}
### 前提条件: ServiceNowでOAuthアプリを登録する
Aikidoを接続する前に、ServiceNowインスタンスでOAuthアプリケーションを登録し、 **Client ID** および **Client Secret**.
{% 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`)
* **Client ID**: ServiceNowによる自動生成
* **Client Secret**: ServiceNowによる自動生成
* **リダイレクトURI**: `https://unify.apideck.com/vault/callback`
* **Refresh Tokenの有効期間**: リフレッシュトークンが有効な秒数
* **Access Tokenの有効期間**: 設定値: `3600`
* **スコープ制限**: 設定値: **広範なスコープ**
{% hint style="info" %}
デフォルトでは `厳格なスコープ` にするとAPI呼び出しが失敗します。
{% endhint %}
{% endstep %}
{% step %}
**保存して認証情報をコピーする**
クリック **送信**、その後レコードを再度開いて **Client ID** および **Client Secret** 値をコピーします。
{% 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の **インスタンス名を入力し**, **Client ID**、そして **Client Secret**、次にクリック **"保存"**.
{% 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. フィード内の任意のIssueにカーソルを合わせ、 ***+*** を **assign列でクリックします。** または、最後の列にある三点アイコンをクリックしてアクションメニューを開けます。Issueがグループ化されている場合、三点アイコンのアクションメニューは各サブIssueで利用できます。\
\
2. ポップアップモーダルで必要な詳細を入力します。\
\
3. ServiceNowで新しく作成されたタスクは、AikidoのIssue詳細の'Tasks'タブにリンクされます。
#### 2. タスクの自動作成
{% hint style="info" %}
Aikido はタスクを自動的に作成します **1時間ごとに一括で。** 現時点では、これを手動でトリガーするオプションはありません。
{% endhint %}
1. 次へ移動 [ServiceNow連携](https://app.aikido.dev/settings/integrations/tasktracker) 設定
2. 『**Autocreation**』を有効にするには、トグルを **オンにします。**
3. 自動タスク作成の条件を定義します。
これらの設定はすべて、自動作成モーダルで設定できます:
* **オン/オフ** — 自動作成を有効または無効にします。オフの場合、しきい値は実質的に `なし`.
* **重大度しきい値** — 次の重大度以上の問題に対してチケットを作成します `重大`, `高`, `中`、または `低` 以上。たとえば、 `高` は、次のチケットを作成します `高` および `重大`.
* **問題タイプ** — すべての問題タイプに対してチケットを作成するか、次のような特定のタイプに制限します `SCA`, `SASTでは、`, `シークレット`, `クラウド`, `IaC`, `マルウェア`、または `ライセンス`.
* **1日あたりの上限** — 1日に作成されるチケットの最大数を設定します。既定値は `25`です。一部のプランでは、より高い上限をサポートしています。
* **チケット作成モード** — 問題グループごとに1件のチケットを作成するか、ロケーションまたはスコープごとに個別のチケットを作成します。ロケーション別モードでは、より多くのチケットが作成される場合があります。
* **範囲** — ロケーション別モードでのみ利用できます。対象は、すべてのリポジトリまたはクラウド、マッピング済みのリポジトリまたはチームのみ、あるいは include/exclude リストを使った特定のリポジトリまたはクラウドにできます。
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.