コンテンツにスキップ
Aikido Docs 日本語版

GitHub Issues

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

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

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

前提条件

Section titled “前提条件 ”
  • GitHubアカウントが組織アカウントである必要があります
  • GitHub内でIssuesが有効化されている必要があります

AikidoアプリとGitHub Issuesの接続

Section titled “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. **「Save」をクリックします。ステータスが「Connected」**に変わります。

    GitHubのissue追跡インテグレーションが正常に接続され、利用可能な状態。

  8. モーダルを閉じて、GitHub Issuesインテグレーションページを開きます。デフォルトでは、すべてのissueが「Default Repo」に同期されます。issueを対応するリポジトリに自動同期したい場合はお問い合わせください。

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

aws/aws-sdk-phpのマイナーアップグレードに関するオープン状態のGitHub issue。優先度の低いセキュリティ修正としてラベル付けされている。

AikidoからGitHub Issuesへのタスク作成オプション

Section titled “AikidoからGitHub Issuesへのタスク作成オプション ”

AikidoからGitHub Issuesに新しいタスクを作成するには、2つの方法があります

  1. Aikidoの画面から手動でタスクを作成する
  2. Aikidoの自動作成機能によって新しいタスクを自動生成する

手動でのタスク作成

Section titled “手動でのタスク作成 ”

  1. Feed内の任意のissueにカーソルを合わせ、「Assignee」列の***+***をクリックします。
    ​

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

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

    作成・スヌーズ・無視・リンクのコピー・重要度調整のタスク管理アクションを含むドロップダウンメニュー。

  2. ポップアップモーダルで必要な項目を入力します。
    ​

    プロジェクト・担当者・説明の項目を含む新しいGitHub issueタスクを作成するフォーム。

    ​

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

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

タスクの自動作成

Section titled “タスクの自動作成 ”
  1. GitHubインテグレーションの設定ページに移動します
  2. トグルを**「On」**にクリックして、必ず「Autocreation」を有効にしてください。
  3. タスクの自動作成の条件を定義します。

自動作成用のモーダルでは、以下の設定をすべて構成できます。

  • On/Off — 自動作成の有効/無効を切り替えます。オフの場合、閾値は実質的にNoneに設定されます。
  • 重要度の閾値 — Critical、High、Medium、Low以上のissueに対してチケットを作成します。例えばHighを指定すると、HighとCriticalのチケットが作成されます。
  • issueの種類 — 全てのissueの種類、またはSCA、SAST、Secrets、Cloud、IaC、Malware、Licenseなど特定の種類に限定してチケットを作成します。
  • 1日あたりの上限 — 1日に作成するチケットの最大数を設定します。デフォルトは25です。プランによってはより高い上限がサポートされます。
  • チケット作成モード — issueグループごとに1件のチケットを作成するか、ロケーションまたはスコープごとに個別のチケットを作成するかを選択します。ロケーションごとのモードでは、より多くのチケットが作成される場合があります。
  • スコープ — ロケーションごとのモードでのみ利用可能です。全てのリポジトリ・クラウドを対象にするか、マッピング済みのリポジトリ・チームのみを対象にするか、または含める・除外するリストを指定して特定のリポジトリ・クラウドを対象にするかを選択できます。
  1. これらの設定に基づき、Aikidoが自律的にGitHub Issuesを生成します 🚀

GitHubでのissueの自動クローズ

Section titled “GitHubでのissueの自動クローズ”

Aikidoは、関連する脆弱性がAikido側で解消された場合（例えばスキャンで再検出されなくなった場合や、手動で解決済みとマークした場合）、リンクされたGitHub issueを自動的にクローズできます。GitHub issueがクローズされるのは、そのリンクに対応するオープンまたはスヌーズ中のAikido issueが残っていない場合のみです（無視されたissueはクローズをブロックしません）。この機能を利用するには、AikidoのfindingにリンクされたGitHub issueが必要です。