サプライ チェーンのセキュリティについて

GitHub でのサプライ チェーンのセキュリティについて

オープン ソースの使用が急速に進んでおり、ほとんどのプロジェクトは数百ものオープンソース依存関係を利用しています。 これにより、セキュリティ上の問題が浮上します。もしも、使用している依存関係に脆弱性があるとしたら、どうなるでしょうか、 ユーザーをサプライ チェーン攻撃のリスクにさらす可能性があります。 サプライ チェーンを保護するために行うことができる最も重要なことの 1 つは、脆弱な依存関係にパッチを適用することです。

依存関係をサプライ チェーンに直接追加するときは、マニフェスト ファイルまたはロックファイルで指定します。 依存関係は推移的に含めることもできます。つまり、特定の依存関係を指定しなくても、使用している依存関係が別の依存関係を使用している場合は、その依存関係にも依存することになります。

GitHub Enterprise Server は、環境内の依存関係を理解し、それらの依存関係の脆弱性を把握し、修正プログラムを適用するのに役立つさまざまな機能を提供します。

GitHub Enterprise Server のサプライ チェーン機能は次のとおりです。

• 依存関係グラフ
• 依存関係レビュー
• Dependabot alerts
• Dependabot updates
  • Dependabot security updates
  • Dependabot version updates

依存関係グラフは、サプライ チェーンのセキュリティの中心です。 依存関係グラフによって、リポジトリまたはパッケージについて、すべてのアップストリーム依存関係とパブリック ダウンストリーム依存関係が識別されます。 リポジトリの依存関係とそのプロパティの一部 (脆弱性情報など) を、そのリポジトリの依存関係グラフで確認できます。

GitHub の他のサプライ チェーン機能は、依存関係グラフで提供される情報を利用します。

• 依存関係レビューは、依存関係グラフを使用して依存関係の変更を特定し、ユーザーが pull request を確認するときにそれらの変更がセキュリティに及ぼす影響を理解するのに役立ちます。
• Dependabot は、依存関係グラフによって提供される依存関係データと GitHub Advisory Database に公開されているアドバイザリの一覧を相互参照し、依存関係をスキャンし、潜在的な脆弱性が検出されると Dependabot alertsを生成します。
• Dependabot security updates依存関係グラフとDependabot alertsを使用し、リポジトリの依存関係を既知の脆弱性で更新できるようにします。

Dependabot version updates では、依存関係グラフは使用されません。代わりに依存関係のセマンティック バージョン管理が利用されます。 Dependabot version updates は、依存関係に脆弱性が含まれない場合でも、依存関係を最新状態に保つために役立ちます。

個人用アカウント、コード、ビルド プロセスの保護を含む、エンド ツー エンドのサプライ チェーン セキュリティに関するベスト プラクティス ガイドについては、「エンドツーエンドのサプライ チェーンのセキュリティ保護」をご覧ください。

機能の概要

依存関係グラフとは

依存関係グラフを生成するために、GitHub は、マニフェストやロックファイルで宣言されているリポジトリの明示的な依存関係を調べます。 有効にすると、依存関係グラフはリポジトリ内のすべての既知のパッケージ マニフェスト ファイルを自動的に解析し、これを使用して既知の依存関係の名前とバージョンを含むグラフを作成します。

• 依存関係グラフには、"直接" 依存関係と "推移的" 依存関係の情報が含まれます。
• 依存関係グラフが自動的に更新されるのは、サポートされるマニフェストまたはロック ファイルを既定ブランチに対して変更または追加するプッシュを GitHub にコミットするとき、およびご使用の依存関係のいずれかのリポジトリに対して任意のユーザーが変更をプッシュするときです。
• 依存関係グラフを表示するには、GitHub Enterprise Server 上でリポジトリのメイン ページを開いて [分析情報] タブに移動します。

また、エコシステムがマニフェストやロック ファイル分析の依存関係グラフでサポートされていなくても、選択したパッケージ マネージャーやエコシステムから 依存関係送信 API (ベータ) を使って依存関係を送信できます。 依存関係グラフには、エコシステム別にグループ化された送信済みの依存関係が表示されますが、マニフェストやロック ファイルから分析された依存関係とは別に表示されます。 依存関係送信 API について詳しくは、「Dependency Submission API を使用する」をご覧ください。

依存関係グラフについて詳しくは、「依存関係グラフについて」をご覧ください。

依存関係レビューとは

依存関係レビューは、レビュー担当者と共同作成者が、すべての pull request における依存関係の変更とそのセキュリティへの影響を理解するのに役立ちます。

• 依存関係レビューでは、pull request で追加、削除、または更新された依存関係がわかります。 リリース日、依存関係の評判、脆弱性情報を使用して、変更を受け入れるかどうかを判断できます。
• pull request の依存関係レビューは、 Files Changed タブの詳しい差分を表示すると確認できます。

依存関係レビューについて詳しくは、「依存関係の確認について」をご覧ください。

Dependabot とは

Dependabotは、依存関係のセキュリティ脆弱性をユーザーに通知しすることにより、依存関係を最新状態に保ち、Dependabotアラートがトリガーされたときに依存関係を次の利用可能でセキュリティ保護されたバージョンか、リリースが公開されたときに最新バージョンに更新する pull request を自動的に開きます。

「Dependabot」という用語には、次の機能が含まれます。

• Dependabot alerts— リポジトリの [セキュリティ] タブとリポジトリの依存関係グラフに表示される通知。 アラートには、プロジェクト内で影響を受けるファイルへのリンクと、修正バージョンに関する情報が含まれています。
• Dependabot updates:
  • Dependabot security updates— アラートがトリガーされたときに、更新プログラムをトリガーし、依存関係をセキュアなバージョンにアップグレードします。
  • Dependabot version updates— 更新プログラムをスケジュールして、ご使用の依存関係を最新バージョンに保ちます。

Dependabot security updates、Dependabot version updates は、GitHub Enterprise Server で実行するために GitHub Actions が必要です。 Dependabot alertsでは、GitHub Actions は必要ありません。 詳しくは、「エンタープライズ向けの Dependabot の有効化」を参照してください。

Dependabot security updates を使うと、GitHub Actions の脆弱な依存関係を修正できます。 セキュリティ更新プログラムが有効になっている場合、ワークフローで使用されている脆弱な GitHub Actions を修正プログラムが適用された最小バージョンに更新するための pull request が、Dependabot によって自動的に生成されます。 詳しくは、「Dependabot のセキュリティ アップデート」をご覧ください。

Dependabot アラートとは

Dependabot alertsでは、依存関係グラフと GitHub Advisory Database (既知の脆弱性に関するアドバイザリを含む) に基づいて、新たに検出された脆弱性の影響を受けるリポジトリを強調表示します。

• Dependabot は、次の場合に、スキャンを実行して安全ではない依存関係を検出し、Dependabot alertsを送信します。
  • 新しいアドバイザリ データが GitHub.com から 1 時間ごとに お使いの GitHub Enterprise Server インスタンス に同期されたとき。 詳しくは、「GitHub Advisory Database でのセキュリティ アドバイザリの参照」を参照してください。
  • リポジトリの依存関係グラフが変更されたとき。
• Dependabot alertsは、リポジトリの [セキュリティ] タブとリポジトリの依存関係グラフに表示されます。 アラートには、プロジェクト内で影響を受けるファイルへのリンクと、修正バージョンに関する情報が含まれています。

詳しくは、「Dependabot アラートについて」を参照してください。

Dependabot 更新プログラムとは

2 種類の Dependabot updatesがあります。Dependabot "セキュリティ" 更新プログラムと "バージョン" 更新プログラムです。 Dependabot は、どちらのケースでも依存関係を更新するために自動 pull request を生成しますが、いくつかの違いがあります。

Dependabot security updates:

• Dependabot アラートによってトリガーされます。
• 既知の脆弱性を解決する最小バージョンに依存関係を更新します。
• 依存関係グラフがサポートするエコシステムでサポートされます。
• 構成ファイルは必要ありませんが、既定の動作をオーバーライドするために使用できます

Dependabot version updates:

• 構成ファイルが必要です
• 構成したスケジュールに従って実行します。
• 構成と一致する最新バージョンに依存関係を更新します。
• さまざまな一連のエコシステムでサポートされます。

Dependabot updates について詳しくは、「Dependabot のセキュリティ アップデート」と「GitHub Dependabot のバージョンアップデートについて」をご覧ください。

使用可能な機能

• 依存関係グラフおよび Dependabot alerts — 既定で有効になっていません。 どちらの機能も、エンタープライズ所有者によってエンタープライズ レベルで構成されます。 詳細については、「企業の依存関係グラフの有効化」と「エンタープライズ向けの Dependabot の有効化」を参照してください。

• 依存関係レビュー— お使いの GitHub Enterprise Server インスタンスに対して依存関係グラフが有効になっており、Advanced Security が組織またはリポジトリで有効になっている場合に使用できます。 詳しくは、「GitHub Advanced Security について」を参照してください。

• Dependabot security updates — 既定で有効になっていません。 Dependabot alerts と依存関係グラフを使用する任意のリポジトリで Dependabot security updates を有効にすることができます。 セキュリティ更新プログラムの有効化については、「Configuring Dependabot security updates (Dependabot セキュリティ アップデートの構成)」をご覧ください。

• Dependabot version updates — 既定で有効になっていません。 リポジトリへの書き込みアクセス許可を持つユーザーは、Dependabot version updatesを有効にすることができます。 バージョン アップデートの有効化については、「Dependabot のバージョン アップデートの設定」をご覧ください。