Ctrlk
Changelog NotificationsAPIAikido login
For the complete documentation index, see llms.txt. This page is also available as Markdown.

GitHub Enterprise Cloud Issues

この一度限りのセットアップ ワークスペースごとに Aikido 組織内の全員が、GitHub Enterprise Cloud で直接 issue を作成できるようにします データ所在地 テナント（SUBDOMAIN.ghe.com).

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

  • 手動でのチケット追加：セキュリティ issue チケットを GitHub Issues に手動で同期します。

  • チケットの自動作成：指定した GitHub Issue リポジトリにチケットを自動作成してプッシュします。

この統合は データ所在地対応の GitHub Enterprise Cloud テナント（SUBDOMAIN.ghe.com）。GitHub.com をご利用の場合は、 GitHub Issues の統合を代わりに使用してください。

GitHub.com とは異なり、GitHub Enterprise Cloud のデータ所在地テナントでは、OAuth アプリをテナント上で直接独自に登録する必要があります。そのため、設定は 2 つの部分に分かれます。まずテナント上で OAuth アプリを登録し、その後 Aikido で接続します。

前提条件

  • GitHub Enterprise Cloud のデータ所在地テナント（SUBDOMAIN.ghe.com).

  • あなたは オーナー 接続したい GitHub 組織のオーナーである必要があります。1 つの接続につきサポートされる組織は 1 つだけです。

  • テナント上で OAuth アプリを登録する権限。

  • GitHub 内で Issues を有効にしておく必要があります。

ステップ 1: テナントに OAuth アプリを登録する

  1. 次の URL で GitHub Enterprise Cloud テナントにログインします https://SUBDOMAIN.ghe.com （例: https://octocorp.ghe.com).

  2. 右上の プロフィール画像 をクリックし、 設定.

  3. 左側のサイドバーで、 開発者設定.

  4. クリック OAuth Apps、その後クリックします 新しい OAuth App.

  5. アプリケーションの詳細を入力します:

    • アプリケーション名：意味のある名前（例: Aikido 統合).

    • ホームページ URL：会社の Web サイトまたは製品 URL（例: https://aikido.dev).

    • 認証コールバック URL：次のように設定します https://unify.apideck.com/vault/callback.

  6. クリック アプリケーションを登録.

ステップ 2: Client ID と Client Secret をコピーする

  1. アプリの設定ページで、 クライアントID.

  2. クリック 新しい client secret を生成 して、値をすぐにコピーします。

client secret はすぐにコピーしてください。GitHub で表示されるのは 1 回だけで、再度見ることはできません。

ステップ 3: Aikido アプリを GitHub Enterprise Cloud に接続する

  1. 次へ移動します： 連携設定 Aikido アプリ内で。

  2. 「Task Trackers」セクションで、 GitHub Enterprise Cloud の issues.

  3. モーダルで、次を入力します:

    • テナントのサブドメイン： SUBDOMAIN の部分 SUBDOMAIN.ghe.com テナント。

    • クライアントID：ステップ 2 の Client ID。

    • クライアントシークレット：ステップ 2 の Client Secret。

  4. クリック 保存。ステータスは 未認証.

  5. クリック 認証と表示されます。GitHub の認証画面にリダイレクトされます。アクセス権を確認し、 認証.

  6. モーダルに戻ったら、 組織 のドロップダウンを開いて組織を選択します。ドロップダウンは認証後に表示され、あなたは オーナー 組織の

  7. クリック 保存である必要があります。ステータスは次のように変わります 接続済み.

  8. モーダルを閉じて、GitHub Enterprise Cloud Issues Integration ページを開きます。デフォルトでは、すべての issue が「Default Repo」に同期されます。 GitHub リポジトリにマッピング を使って個別のリポジトリをマッピングします。

すべての Aikido Issue に送信される Default Label を設定できます。これらは同期され、GitHub に表示されます。

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

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

  1. Aikido インターフェースから手動でタスクを作成する

  2. Aikido の自動作成機能を使って新しいタスクを自動作成する。

手動タスク作成

  1. フィード内の任意の課題にカーソルを合わせ、次をクリックします： + の 担当者列。 または、最後の列の三点リーダーをクリックしてアクションメニューを開きます。issue がグループ化されている場合、三点リーダーのアクションメニューはすべてのサブ issue で利用できます。

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

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

自動タスク作成

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 がリンクされている必要があります。

最終更新

役に立ちましたか？