GitHub Issues

この一度限りのセットアップ ワークスペースごとに Aikido組織内の全員がGitHub Issuesで直接Issueを作成できるようにします

以下のユースケースに対応しています：

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

すべてのIssueは、それぞれのリポジトリに自動で作成されます。この機能を無効にしたい場合は、ご連絡ください。

この連携はGitHub.com向けです。データ所在地テナントを持つGitHub Enterprise Cloudをご利用の場合（SUBDOMAIN.ghe.com）、次を使用してください GitHub Enterprise Cloud Issues の統合を代わりに使用してください。

前提条件

• GitHubアカウントは組織アカウントである必要があります
• GitHub内でIssuesを有効にする必要があります

AikidoアプリをGitHub Issuesに接続

1. 次へ移動します： 連携設定 Aikido アプリ内で。
2. 「Task Trackers」セクションで「GitHub Issues」を選択します
3. 組織内にIssues Appをインストールする (インストールリンク）。これは組織を選択するために必要です。 ​

   

   GitHubのIssue追跡連携のセットアップには、認可と組織の設定が必要です。
4. 組織とリポジトリを選択してください ​

   

   ユーザー選択インターフェースを備えたAikido Issuesのインストールプロンプト。
5. 正常にインストールされると、GitHubのページ上部に通知が表示されます。 Aikidoに戻る。

   

   指定されたユーザーアカウントで「Aikido Issues」が更新されたことを確認する通知。
6. 組織を選択してください モーダル内で ​

   

   設定で組織を選択するためのドロップダウンメニュー。
7. 「保存」をクリックします。 ステータスは次に変更されます 接続済み。

   

   GitHubのIssue追跡連携が正常に接続され、使用できる状態になりました。
8. モーダルを閉じて、GitHub Issues連携ページを開きます。既定では、すべてのIssueは「Default Repo」に同期されます。 お問い合わせください 各リポジトリにIssueを自動同期したい場合。

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

低優先度のセキュリティ修正としてラベル付けされた、aws/aws-sdk-phpの軽微なアップグレード用のGitHub Issueを開く。

Aikido経由でGitHub Issuesにタスクを作成するためのオプション

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

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

手動タスク作成

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

   

   「Assignee」列と追加ボタン、オプションボタンを表示するタスク管理インターフェース。

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

   

   タスク管理アクションのドロップダウンメニュー: 作成、スヌーズ、無視、リンクをコピー、重大度を調整。
2. ポップアップモーダルで必要な詳細を入力します。

   

   プロジェクト、担当者、説明フィールドを含む新しいGitHub Issueタスクを作成するフォーム。
3. GitHub Issues で新しく作成されたタスクは、Aikido の Issue 詳細の「Tasks」タブ（サイドパネル）にリンクされます。

低優先度のAWS SDK PHPアップグレードタスクを表示するタスク管理ダッシュボード。

自動タスク作成

Aikidoはタスクを自動的に作成します 毎時、一括で。 現時点では、これを手動でトリガーするオプションはありません。

1. に移動してください GitHub 連携 設定ページ
2. 「Autocreation」を有効にするには、トグルを オンにします。
3. 自動タスク作成の条件を定義します。

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

• オン/オフ： 自動作成を有効または無効にします。オフの場合、しきい値は実質的に なし.
• 重大度しきい値： の問題に対してチケットを作成します 重大, 高, 中、または 低 以上。たとえば、 高 は、次のものに対してチケットを作成します 高 に設定し、 重大.
• 問題タイプ： すべての問題タイプでチケットを作成するか、次のような特定のタイプに限定します では、アンカーは通常、CVE やアドバイザリに関連付けられた脆弱なシンボル（特定の関数、クラス、メソッド、またはモジュール）です。, SAST, シークレット, クラウド, IaC, マルウェア、または ライセンス.
• 1日の上限： 1日に作成されるチケットの最大数を設定します。既定値は 25です。一部のプランでは、より高い上限に対応しています。
• チケット作成モード： 問題グループごとに1件のチケットを作成するか、場所またはスコープごとに個別のチケットを作成します。場所別モードでは、より多くのチケットが作成される場合があります。
• スコープ： 場所別モードでのみ利用できます。すべてのリポジトリまたはクラウド、マッピング済みのリポジトリまたはチームのみ、あるいは include / exclude リストを使って特定のリポジトリまたはクラウドを対象にします。

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

GitHub で Issue を自動的にクローズする

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

---