GitHub

​

セットアップ

現在、CorgeaはCorgea GitHub Appを通じてGitHubリポジトリをサポートしています。 このページでは、Corgeaが脆弱性をスキャンし、修正用のプルリクエストを作成できるようにGitHub Appを設定する方法を説明します。 GitHub Appは、Integrationsページまたは問題ページから、次の手順でインストールできます。

​

GitHubでCorgeaを使う

これでCorgeaとGitHubの接続は完了です。GitHub Appはすべてのプルリクエストをスキャンして修正案を提示します。また、Corgeaから脆弱性を修正するプルリクエストを作成できます。 GitHub Team Syncが有効な場合、Corgeaは連携済みGitHubチームのメンバーを最新の状態に保てます。プロジェクトとの関連付けを取り込み直さずにメンバーだけを更新するには、Content AccessページのSync membershipを使います。詳細はGitHub Team Syncを参照してください。

​

プルリクエストのスキャン

Corgeaは各プルリクエストをスキャンし、実行可能な修正案を提案します。 ドラフトのプルリクエストは、レビュー可能としてマークされるまでスキャンされません。ドラフトではないプルリクエストは、作成時と更新がプッシュされたときにスキャンされます。 プルリクエストへのコメントは、差分に含まれる行にのみ追加されます。問題が複数行にまたがる場合、影響を受けるコード範囲内で最初に変更された行にコメントが付けられます。 同じプルリクエストへの新しいプッシュで別のスキャンが開始されると、実行中の古いスキャンは停止されます。停止中にエラーが発生しても、古いスキャンは失敗として扱われず、キャンセル済みのままになります。

​

Corgeaからプルリクエストを作成

Corgeaの各問題ページから、その問題を修正するプルリクエストを作成できます。 「Create Pull Request」ボタン（ブランチアイコン）をクリックします。作成されたプルリクエストが新しいタブで開きます。 ポップアップブロッカーを無効にする必要があるかもしれません。

​

GitHubの権限

Corgea GitHubアプリをインストールすると、以下の権限を付与するよう求められます。

​

メタデータとリポジトリフックの読み取り権限

• メタデータ:基本的なリポジトリ情報にアクセスし、リポジトリを特定・追跡
• リポジトリフック:プルリクエストとプッシュイベントを受け取り、自動的にセキュリティスキャンをトリガーします

​

チェック、コード、問題、プルリクエストの読み取り・書き込み権限

• チェック:プルリクエストに対してチェックランを作成・更新し、セキュリティの検出結果を報告し、マージブロックポリシーを強制します
• コード:セキュリティ解析のためにリポジトリのソースコードを読み取り、修正プルリクエストを作成する際にコミットを書き込みます
• 問題:セキュリティの検出結果にコンテキストを提供するため、問題のメタデータを読み取ります
• プルリクエスト:プルリクエストのメタデータを読み込み、Corgeaが生成したセキュリティ修正を含むプルリクエストを作成または更新します

​

ユーザー権限

​

メールアドレスの読み取り権限

認証と通知のために、GitHubアカウントとCorgeaアカウントを関連付ける目的で使用します。

​

トラブルシューティング