# Azure DevOps Boards

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

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

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

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

1. Aikidoアプリ内の[Integration Settings](https://app.aikido.dev/settings/integrations)に移動します。
2.  「Task Trackers」セクションで「Azure DevOps Boards」を選択します\
    認証のために、モーダルで追加情報の入力が求められます:

    * **UserID**​: これはあなたの**メールアドレス**です
    * **Access Token**: Azure DevOps内で確認できます。スコープとして、「**Work Items**」で「**Read & write**」を選択できます。
    * **Organisation** _**Name**_**:** 組織の名前で、URLで確認できます <mark style="color:red;">URLのプレフィックス https://... を含めず、組織名のみを入力してください</mark>\
      <br>

    ![ユーザーID、トークン、組織の入力を求めるAzure DevOps連携のセットアップ画面。](https://help.aikido.dev/_assets/963dc25af008/ucarecdn-d8185da7-4270-4757-983c-2f49135d8433.png)
3. 認証情報を正しく入力したら、保存を押してモーダルを閉じます。\
   ​
4.  Azure DevOps Boards連携ページを開き、自動作成の設定を管理します。\
    ​

    ![Azure DevOps Boards連携のセットアップ: リポジトリのマッピング、自動作成の有効化、デフォルトのタスクタイプの設定。](https://help.aikido.dev/_assets/25ec8d1a68dc/azure-devops-boards_6ca66041-0504-4364-9a0c-281eee90ffa3.png)

## AikidoからAzure DevOps Boardsでタスクを作成するオプション <a href="#options-for-task-creation-in-azure-devops-boards-via-aikido" id="options-for-task-creation-in-azure-devops-boards-via-aikido"></a>

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

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

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

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

    ![追加ボタンとオプションボタンがあるタスク割り当てテーブルのセクション。](https://help.aikido.dev/_assets/cf2cd1ea323f/asana_a6b1ac3d-ef37-454a-a531-b366d190f292.png)

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

    ![タスク管理と重大度調整のオプションがあるアクションのドロップダウンメニュー。](https://help.aikido.dev/_assets/afbae3479a22/ucarecdn-a9b48cf3-8614-447c-b1dd-252ae08967c8.png)
2.  ポップアップモーダルに必要な詳細を入力します。\
    ​

    ![プロジェクト、担当者、スコープ、概要、説明のフィールドがあるAzure DevOps Boardsのタスク作成フォーム。](https://help.aikido.dev/_assets/3fbc7af7ca9a/ucarecdn-636e8271-d106-4556-9e2f-fb9c1cc51345.png)

    ​
3. Boardsで新しく作成されたタスクは、Aikidoの課題詳細の「Tasks」タブ(サイドパネル)にリンクされます。

![優先度の高いタスク: @babel/traverseのマイナーアップグレード、担当者はaaron aikidodev。](https://help.aikido.dev/_assets/9dc4546ea61e/ucarecdn-803ed3f1-1548-49b0-ba58-64e153b91f1a.png)

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


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

1. [Azure DevOps Boards Integration](https://app.aikido.dev/settings/integrations/tasktracker)の設定ページに移動します
2. 「**Change auto creation**」を選択します
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がこれらの設定に基づいてBoardsのチケットを自動的に生成します 🚀

***