# Jira Cloud

この_ワークスペースごと_の1回限りのセットアップにより、Aikido 組織内の全員が Jira Cloud で直接課題を作成できるようになります。

以下のユースケースがサポートされています：

* **自動チケット作成**：指定した Jira プロジェクトにチケットを自動的に作成・送信し、セキュリティ問題をシームレスに追跡できます。
* **手動チケット追加**：セキュリティ問題のチケットを手動で Jira に追加し、重大な脆弱性に確実に対処できます。

{% hint style="warning" %}
注意：チケットの作成は、インテグレーションを設定したユーザーに紐づけられます。Jira 内にすべてのプロジェクトへの書き込み権限を持つ専用の「Aikido」ユーザーを作成することをお勧めします。
{% endhint %}

## Aikido アプリを Jira に接続する <a href="#connecting-the-aikido-app-to-jira" id="connecting-the-aikido-app-to-jira"></a>

1. Aikido アプリ内の[インテグレーション設定](https://app.aikido.dev/settings/integrations)に移動します。
2. 「Task Trackers」セクションで「Jira Issues」を選択します
3.  Jira の認可を求めるプロンプトが表示されます。\
    ​

    ![Jira へのアクセスが未認可。課題追跡インテグレーションのためにアカウントの認可を求めるプロンプト。](https://help.aikido.dev/_assets/9b724b992587/ucarecdn-7f02a7ff-2d6a-4fd2-859a-690ec2503847.png)
4. Jira アカウントにログインします
5.  Aikido に Jira ワークスペースへのアクセス権限を付与します

    ![Aikido Security が Atlassian Jira アカウントへのアクセスと管理の権限を要求している画面。](https://help.aikido.dev/_assets/de2d04b6e665/ucarecdn-a052e293-4386-42ea-a4ae-4fa3661b2fad.png)
6. 認可されると、Aikido は Jira に正常に接続され、タスク管理機能が強化されます 🚀<br>

<figure><img src="https://help.aikido.dev/_assets/b05b5ddc737f/image-97.png" alt="" width="563"><figcaption></figcaption></figure>

## ​Aikido 経由で Jira にタスクを作成するオプション <a href="#options-for-task-creation-in-jira-via-aikido" id="options-for-task-creation-in-jira-via-aikido"></a>

Aikido から Jira に新しいタスクを作成するには、2つの異なるオプションがあります。

1. Aikido のインターフェースから手動でタスクを作成する
2. Aikido の自動作成機能を使用して新しいタスクを自動的に作成する

## 1. 手動でのタスク作成 <a href="#id-1-manual-task-creation" id="id-1-manual-task-creation"></a>

1.  フィード内の任意の課題にカーソルを合わせ、**担当者列**の _**+**_ をクリックします。

    ![「Assignee」列とエントリを追加または編集するオプションを備えたタスク管理テーブル。](https://help.aikido.dev/_assets/cf2cd1ea323f/asana_a6b1ac3d-ef37-454a-a531-b366d190f292.png)

    または、最後の列にある三点リーダーをクリックしてアクションメニューを開くこともできます。課題をグループ化している場合、三点リーダーのアクションメニューは各サブ課題で利用できます。

    ![タスク管理アクションのメニュー：作成、スヌーズ、無視、リンクのコピー、重大度の調整。](https://help.aikido.dev/_assets/ecd711fdde8d/ucarecdn-38576e60-ea82-4442-88d3-db09a3bbd539.png)
2.  ポップアップモーダルで必要な詳細を入力します。\
    ​

    ![重大なセキュリティ脆弱性の詳細を記載した Jira タスク作成フォーム。](https://help.aikido.dev/_assets/38afe1296760/ucarecdn-2601869d-3437-4823-b410-264c9eb9f8fb.png)
3. Jira で新しく作成されたタスクは、Aikido の課題詳細の「Tasks」タブ（サイドパネル）にリンクされます。

![重大なセキュリティタスク：var\_dump() により機密のユーザー情報が漏洩する可能性があり、対応が必要。](https://help.aikido.dev/_assets/253bf97fa73c/ucarecdn-294591ba-6d3d-4cfc-9cee-0fc1b6c880cd.png)

## 2. 自動でのタスク作成 <a href="#id-2-automated-task-creation" id="id-2-automated-task-creation"></a>


{% hint style="info" %}
Aikido は**1時間ごとに一括で**タスクを自動作成します。現時点では、これを手動でトリガーするオプションはありません。
{% endhint %}

1. [Jira インテグレーション](https://app.aikido.dev/settings/integrations/tasktracker)設定に移動します
2. トグルを**オン**にして、「**Autocreation**」を必ず有効にしてください。
3. 自動タスク作成の条件を定義します。


これらの設定はすべて自動作成モーダルで構成できます。

* **オン/オフ：** 自動作成を有効または無効にします。オフの場合、しきい値は実質的に `None` に設定されます。
* **重大度のしきい値：** `Critical`、`High`、`Medium`、または `Low` 以上の課題に対してチケットを作成します。たとえば、`High` を選択すると、`High` と `Critical` のチケットが作成されます。
* **課題タイプ：** すべての課題タイプに対してチケットを作成するか、`SCA`、`SAST`、`Secrets`、`Cloud`、`IaC`、`Malware`、`License` などの特定のタイプに限定します。
* **1日あたりの上限：** 1日に作成されるチケットの最大数を設定します。デフォルトは `25` です。一部のプランではより高い上限がサポートされています。
* **チケット作成モード：** 課題グループごとに1つのチケットを作成するか、ロケーションまたはスコープごとに個別のチケットを作成します。ロケーションごとのモードでは、より多くのチケットが作成される場合があります。
* **スコープ：** ロケーションごとのモードでのみ使用できます。すべてのリポジトリまたはクラウド、マッピングされたリポジトリまたはチームのみ、または包含リストと除外リストを使用して特定のリポジトリまたはクラウドを対象にします。

<figure><img src="https://help.aikido.dev/_assets/0f792496e2b2/image.png" alt=""><figcaption></figcaption></figure>

4. Aikido は、設定された1日あたりのタスク上限に達するまで、1時間ごとに Jira チケットを自動的に生成します

### Jira 同期情報 <a href="#jira-sync-information" id="jira-sync-information"></a>

Aikido はいくつかのフィールドを Jira に自動的に同期します

* 重大度は Jira の「Priority フィールド」にマッピングされます（一方向）
* 担当者は双方向に同期されます（そのため、Jira での更新も Aikido に反映されます）

***