Skip to main content
Azure DevOpsとCorgeaを連携すると、プロジェクトをスキャンし、Corgeaプラットフォームから直接コード修正のプルリクエストを作成できます。
1

Azure DevOps個人アクセストークンを生成する

Azure DevOpsアカウントにアクセスし、読み書き権限を持つパーソナルアクセストークン(PAT)を生成してください。
個人アクセストークンの作成
トークン権限
2

トークンをCorgeaと連携する

Corgeaの 連携 ページへ進んでください。Azure DevOpsセクション内の「+」ボタンをクリックして、トークンが安全に保存されているか確認してください。
トークンをCorgeaに追加
3

CorgeaでAzure DevOpsプロジェクトを確認

設定後、 プロジェクト ページに移動します。Azure DevOpsプロジェクトはWindowsのアイコンで表示されます。アクション欄の「+」をクリックすると最初のスキャンを開始し、プロジェクト名を選択して「新しいスキャン」をクリックして新しいスキャンを開始します。
検索プロジェクト
4

Azure DevOpsにプルリクエストを作成

CorgeaのAzure DevOpsプロジェクトに関連する任意の問題ページから、その問題を修正するプルリクエストを作成できます。
問題修正用プルリクエスト

​
オプション:Webhook設定

プルリクエストの作成や更新時にスキャンを有効にするには、イベントごとに2つのWebhookを設定してください。プロジェクト用のWebhookを設定するために必要な権限を持っていることを確認してください。
1
Azure DevOpsインターフェースの左下にある「プロジェクト設定」を選択してください。
プロジェクト設定
2
「サービスフック」をクリックしてください。すぐに読み込まれない場合は複数回クリックする必要があるかもしれません。
サービスフック
3
「+」ボタンをクリックして「Web Hooks」を選択してください。
Webhook
4
トリガーイベントとして「プルリクエスト作成」を選択し、任意の設定を設定し、「次へ」をクリックします。
トリガーイベント
5
設定セクションで、プライベートデプロイメントのURLを https://www.corgea.app/azure_webhook/ または https://your_instance.corgea.app/azure_webhook/ として入力してください。
WebhookURL
6
新しいブラウザタブを開き、Corgeaの連携ページに移動し、Azure連携を見つけてください。X-CORGEA-UUIDの値をコピーしてください。
X-Corgea-UUID
7
Azure DevOps Webhookの設定ページに戻り、ヘッダーセクションに以下を入力してください:
  • X-CORGEA-UUID:(コピーしたUUID値)
  • X-WEB-TOKEN:(レガシー/オプション;外部インフラが必要な場合のみ含む)
ヘッダーの設定
8
「終了」をクリックして設定を保存してください。「テスト」ボタンは無視してください。アクセスできないファイルのスキャンを試みる可能性があるからです。
9
同じ手順を繰り返して、「プルリクエスト更新」をトリガーイベントにした2つ目のWebhookを追加します。最初のWebhookと同じURLとヘッダーを使用してください。
プルリクエストがトリガーイベントを更新した
10
プルリクエストを作成または更新してセットアップを検証します。設定が成功すると、Webhook履歴に成功したイベントが表示され、Corgea Scansページで新しいスキャンが https://www.corgea.app/scans/.
Webhookの歴史
Corgea スキャン

​
Azure DevOps プルリクエストコメントへの返信を有効にする

CorgeaはAzure DevOpsのプルリクエストに投稿されたコメントを受信し、返信できます。

​
前提条件

  • 組織でCorgea Agentが有効になっている。
  • Azure DevOpsはCorgeaに接続されています。
  • 連携に使用するPATは Code: Read & write 権限を持っています。
  • Azure DevOpsプロジェクトでサービスフックのサブスクリプションを作成できます。

​
サービスフックの設定

  1. Azure DevOpsでプロジェクトを開きます。
  2. Project settings → Service hooksに移動します。
  3. Create subscription または +を選択します。
  4. Web Hooksを選択し、次に Nextを選択します。
  5. トリガーとして Pull request commented on を選択します。
  6. オプションでフックをリポジトリまたはターゲットブランチに限定する。
  7. WebhookのURLを入力してください:
    • Corgea・クラウド: https://www.corgea.app/azure_webhook/
    • プライベートデプロイ: https://<your-corgea-domain>/azure_webhook/
  8. このHTTPヘッダーを追加します: X-CORGEA-UUID: <your Azure DevOps integration UUID> UUIDはCorgeaの連携ページで確認できます。
  9. Resource details to send を Allに設定。
  10. サブスクリプションをテストし、 Finishを選択します。
サービスフックはプロジェクトごとに異なります。コメントへの返信をサポートするべきすべてのAzure DevOpsプロジェクトに対して、これらの手順を繰り返してください。

​
連携を検証

  1. Corgeaの検出結果を含むプルリクエストを開く。
  2. Corgeaのコメントに直接返信するか、コメント欄でCorgeaに宛ててください。
  3. 確認すること:
    • 配信は Project settings -> Service hooksで成功します。
    • Corgeaは同じコメントスレッドに返信します。

​
トラブルシューティング

  • サービスフックが有効で Pull request commented onを使用していることを確認します。
  • X-CORGEA-UUID が正しいCorgea連携と一致しているか確認してください。
  • Resource details to send が Allに設定されていることを確認してください。
  • Azure DevOps PATが期限切れでなく、アクセス権が Code: Read & write であることを確認してください。
  • 組織でCorgeaエージェントが有効であることを確認してください。
このフローでは、CorgeaアプリケーションはX-WEB-TOKENを使用しません。外部インフラで必要な場合にのみ、このヘッダーを残してください。