# GitHub Issues

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

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

* **手動チケット追加**：セキュリティ課題のチケットをGitHub Issuesに手動で同期します。
* **自動チケット作成**：指定したGitHub Issueのプロジェクト/リポジトリにチケットを自動的に作成してプッシュします。

{% hint style="warning" %}
すべての課題は、それぞれのリポジトリに自動的に作成されます。この機能を無効にしたい場合は、お問い合わせください。
{% endhint %}

{% hint style="info" %}
この連携はGitHub.com向けです。データレジデンシー付きのGitHub Enterprise Cloudテナント（`SUBDOMAIN.ghe.com`）をご利用の場合は、代わりに[GitHub Enterprise Cloud Issues](https://help.aikidogov.us/docs/docs-ja/getting-started/task-management-systems/all-supported-task-trackers/github-enterprise-cloud-issues)連携を使用してください。
{% endhint %}

### 前提条件 <a href="#prerequisites" id="prerequisites"></a>

* GitHubアカウントが組織アカウントである必要があります
* GitHub内でIssuesが有効になっている必要があります

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

1. Aikidoアプリ内の[連携設定](https://app.aikido.dev/settings/integrations)に移動します。
2. 「Task Trackers」セクションで「GitHub Issues」を選択します
3.  **組織内にIssuesアプリをインストールします**（[インストールリンク](https://github.com/apps/aikido-issues/installations/new)）。これは組織を選択するために必要です。\
    ​

    <img src="https://help.aikidogov.us/_assets/5627287260b3/ucarecdn-bb36cac9-b2e2-49f3-9efc-eccad640cb18.png" alt="GitHub課題追跡連携のセットアップには認可と組織の設定が必要です。" width="375">
4.  組織とリポジトリを選択します\
    ​

    ![ユーザー選択インターフェースを含むAikido Issuesのインストールプロンプト。](https://help.aikidogov.us/_assets/f2babe2d273e/ucarecdn-4563a93d-56a5-4793-9297-dd32eadc05b5.png)
5.  インストールが成功すると、GitHubのページ上部に通知が表示されます。**Aikidoに戻ります。**\
    ​

    ![指定したユーザーアカウントで「Aikido Issues」が更新されたことを確認する通知。](https://help.aikidogov.us/_assets/264795628caa/ucarecdn-6f174321-dada-40f3-938e-635ce3e1a691.png)
6.  モーダルで**組織を選択します**。\
    ​

    <img src="https://help.aikidogov.us/_assets/3c0c05b6a3ee/ucarecdn-869211a2-7d05-499d-95b1-76188d6f4518.png" alt="設定で組織を選択するためのドロップダウンメニュー。" width="375">
7.  **「Save」をクリックします。** ステータスが**Connected**に変わります。

    <img src="https://help.aikidogov.us/_assets/7813e25068be/ucarecdn-1816d0df-29de-4d8e-9d64-da3851964f10.png" alt="GitHub課題追跡連携が正常に接続され、使用可能な状態。" width="375">
8. モーダルを閉じて、GitHub Issues連携ページを開きます。デフォルトでは、すべての課題は「Default Repo」に同期されます。それぞれのリポジトリへの課題の自動同期をご希望の場合は、**お問い合わせください**。

![](https://help.aikidogov.us/_assets/eab9d3473c03/github-issues_62e79607-05a8-4f84-b7f3-77a7009eeb62.png)

すべてのAikido課題に付与されるデフォルトラベルを設定できます。これらは同期され、GitHubに表示されます。​\
​

![優先度の低いセキュリティ修正のラベルが付いた、aws/aws-sdk-phpのマイナーアップグレードに関するオープンなGitHub課題。](https://help.aikidogov.us/_assets/8372fb797fbf/ucarecdn-39e93b13-3513-4384-b079-1b9cba20563e.png)

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

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

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

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

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

    <img src="https://help.aikidogov.us/_assets/cf2cd1ea323f/asana_a6b1ac3d-ef37-454a-a531-b366d190f292.png" alt="追加ボタンとオプションボタンのある「担当者」列を表示するタスク管理インターフェース。" width="327">

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

    <img src="https://help.aikidogov.us/_assets/201350618f90/ucarecdn-7e71f2c8-d4a3-4214-9fc0-26341486d030.png" alt="タスク管理アクション（作成、スヌーズ、無視、リンクのコピー、重大度の調整）を含むドロップダウンメニュー。" width="221">
2.  ポップアップモーダルで必要な詳細を入力します。\
    ​

    <img src="https://help.aikidogov.us/_assets/dadf2d74ffd7/ucarecdn-c876d6f9-e42b-4d14-9e16-6d8f0474d73d.png" alt="プロジェクト、担当者、説明のフィールドを含む新しいGitHub課題タスクを作成するためのフォーム。" width="375">

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

![優先度の低いAWS SDK PHPアップグレードタスクを表示するタスク管理ダッシュボード。](https://help.aikidogov.us/_assets/4a7bc4c9a5bc/ucarecdn-8160a9aa-cc40-4bab-9d96-e0f9f7b3f4c6.png)

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


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

1. [GitHub連携](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.aikidogov.us/_assets/0f792496e2b2/image.png" alt=""><figcaption></figcaption></figure>

4. Aikidoはこれらの設定に基づいて、GitHub Issuesを自動的に生成します 🚀

### GitHubで課題を自動的にクローズする

Aikidoは、関連する脆弱性がAikidoで解決されると、リンクされたGitHub課題を自動的にクローズできます。例えば、スキャンが成功してその脆弱性が報告されなくなった場合や、手動で解決済みにマークした場合などです。GitHub課題は、そのリンクに対してオープンまたはスヌーズ中のAikido課題が残っていない場合にのみクローズされます（無視された課題はクローズを妨げません）。これを適用するには、Aikidoの検出結果にGitHub課題がリンクされている必要があります。

<figure><img src="https://help.aikidogov.us/_assets/f2b4329e4d64/image-309.png" alt=""><figcaption></figcaption></figure>

***