GitHub コネクタを作成する (プライベート プレビュー)

GitHub コネクタは、エージェント コード セキュリティに推奨されるオンボード パスです。 これにより、GitHub組織を接続し、簡単なフローを通じてリポジトリをオンボードできます。 リポジトリをオンボードした後は、オンボードされたリポジトリのリモート オンデマンド エージェント スキャンをトリガーできます。

Prerequisites

  • コネクタを作成および管理するために、Microsoft Entra IDのセキュリティ管理者ロールを少なくとも持つMicrosoft Defender ポータルにアクセスします。
  • 接続したいGitHub組織のOrganization Ownerロール。

Note

同じGitHub組織が既にAzure ポータルのGitHub コネクタを介して接続していて、Defender ポータル経由で接続する場合は、最初にAzure ポータル コネクタを切断します。

Azure ポータルの GitHub コネクタが切断されると、そのコネクタに関連付けられている Microsoft Defender for DevOps セキュリティ機能は使用できなくなります。

Defender for DevOpsセキュリティのサポートと前提条件については、「サポートと前提条件」を参照してください。

手順 1: テナントを準備する

GitHub コネクタの作成フローにアクセスするには、テナントでクラウド セキュリティを準備する必要があります。

Defender テナントで Cloud Security が既にアクティブ化されている場合、アクションは必要ありません。 [テナントの準備] オプションは表示されません。GitHub コネクタの作成に直接進むことができます。

テナントが Defender ポータルで Cloud Security を使用していない場合:

  1. クラウド セキュリティ>Overview に移動します。
  2. テナントを準備する を選択します。
  3. テナントの準備状況を確認する。

手順 2: コネクタ ウィザードを開く

  1. Defender ポータルで、MDASH Initiative >Settings に移動します。 MDASH イニシアティブへのアクセスの詳細については、「 エントリ ポイント」を参照してください。

  • Agentic のコードスキャン管理で、ソースコード環境の横にある別の環境を追加を選択し、GitHub を選択します。GitHubコネクタのフローにリダイレクトされます。

  • 必要に応じて、コネクタ名を入力します。 空白のままにすると、既定の名前が自動的に割り当てられます。

  • 次へを選択します。

手順 3: アクセスとアクセス許可を構成する

コネクタは、次の 2 つのアクセス許可レベルを公開します。

  • 読み取り — 既定で選択されており、削除できません。 Defender for DevOpsがリポジトリをスキャンし、変更を加えずにセキュリティの問題を特定できるようにします。
  • 書き込み — 既定で選択され、省略可能です。 GitHub Issue の作成とプル リクエストの作成を有効にします。

読み取り権限

読み取りアクセスには、次のものが含まれます。

  • ソース コードとリポジトリのメタデータ
  • アクション、環境、デプロイメント
  • コミットの状態とマージ キュー
  • パッケージ、ページ、リポジトリ プロジェクト
  • アドバイザリやシークレットを含むセキュリティ関連のデータ

書き込みアクセス（任意）

書き込みアクセスにより、Defender for DevOpsはリポジトリでアクションを実行し、結果を開発者ワークフローに統合できます。 このアクセスには、次の機能が含まれます。

  • 問題と pull request の作成と更新
  • チェック結果とセキュリティ検出結果を投稿
  • Dependabot とシークレット スキャン アラートを管理する
  • リポジトリのメタデータとプロパティを更新する
  • セキュリティ イベントと成果物を書き込む

Note

書き込みアクセスは省略可能であり、Defenderが情報を作成、更新、またはGitHub リポジトリにポストバックする必要があるシナリオでのみ必要です。 セキュリティ スキャンと検出のシナリオには、読み取りアクセスで十分です。

アクセス許可の選択を確認し、[ 次へ] を選択します。

手順 4: GitHub アプリを承認してインストールする

  1. インストールを選択します。 GitHub OAuth ダイアログが開きます。
  2. GitHubにサインインし、オンボードする組織を選択します。
  3. GitHubアプリのインストール画面で、インストールを確認します。 ダイアログが閉じます。
  4. 成功の確認が表示されたら、[ 次へ] を選択します。

Note

GitHub アプリは、Azure ポータルのGitHub コネクタを介して既に接続されているGitHub組織にインストールできません。 このような組織を選択すると、エラーが発生します。 Defender ポータルで同じGitHub組織に接続するには、まず、Azure ポータルで既存のコネクタを削除する必要があります。

手順 5: 確認してアクティブ化する

[ 確認と終了] ページには、フローの概要が表示されます。

  • コネクタの名前
  • アクセス許可スコープ
  • オンボードされているGitHub組織の名前
  • オンボードされるリポジトリの数

[ アクティブ化] を 選択してコネクタをアクティブにします。

GitHub コネクタをアクティブ化すると、オンボードされたリポジトリのオンデマンド エージェント スキャンをトリガーする機能が、最大 1 時間以内に使用できるようになります。

関連するコンテンツ

  • 最終更新: