大規模なコード スキャンの既定のセットアップを構成する

code scanning の既定のセットアップでは、Organization 全体のリポジトリ内のコードをすばやくセキュリティで保護できます。 詳しくは、「コード スキャンのセットアップの種類について」をご覧ください。

既定のセットアップに適していないリポジトリの場合は、リポジトリ レベルで、またはスクリプトを使用して組織レベルで高度なセットアップを構成できます。

[前提条件]

リポジトリは、既定のセットアップの対象となるには、次のすべての条件を満たす必要があります。

• code scanning の詳細設定がまだ有効になっていません。
• GitHub Actions が有効になっています。
• GitHub Advanced Security が有効になっている。

Organization 内のすべての対象リポジトリの既定のセットアップの構成

organization の設定の [Code security and analysis] ページで、organization 内のすべての対象リポジトリに対して既定のセットアップを有効にすることができます。

1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。

2. 組織をクリックして選択します。

3. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

   

4. サイドバーの [Security] セクションで、[ Code security and analysis] をクリックします。

5. "Code scanning" の横にある [すべて有効にする] をクリックします。

6. [code scanning の既定のセットアップを有効にする] ダイアログ ボックスの [クエリ スイート] セクションで、既定のセットアップの構成が実行されるクエリ スイートを選択します。 詳しくは、「CodeQL クエリ セット」をご覧ください。

7. 既定のセットアップの構成を有効にするには、[対象となるリポジトリの有効化] をクリックします。

8. 必要に応じて、既定のセットアップを有効にするときに organization 全体で "Extended" クエリ スイートを推奨するには、[既定のセットアップを有効にするリポジトリの拡張クエリ スイートを推奨] を選びます。

既定のセットアップでの CodeQL カバレッジの拡張

organization のセキュリティ設定ページで、organization 内のすべての対象リポジトリに対して、モデル パックを使用して既定の適用範囲を拡張できます。 詳しくは、「既定設定の構成を編集する」をご覧ください。

Organization 内のリポジトリのサブセットの既定セットアップを構成する

Organization のセキュリティの概要を通じて、既定のセットアップの対象となるリポジトリを見つけ、それらの各リポジトリで同時に既定のセットアップを有効にすることができます。

既定のセットアップの対象となるリポジトリの検索

1. GitHub で、organization のメイン ページに移動します。1. 組織名の下の [ Security ] タブをクリックします。1. サイドバーの [Coverage] をクリックして、[Security coverage] ビューを表示します。

   

2. 検索バーに、次のいずれかのクエリを入力します。

          `code-scanning-default-setup:eligible is:public` では、既定のセットアップに適した言語があり、一般に公開されているため対象となるリポジトリが示されます。
   

   - code-scanning-default-setup:eligible advanced-security:enabled では、既定のセットアップに適した言語があり、GitHub Advanced Security が有効になっているため対象となるプライベートまたは内部リポジトリが示されます。

          `code-scanning-default-setup:eligible is:private,internal advanced-security:not-enabled` では、既定のセットアップに適した言語はあるものの、GitHub Advanced Security が有効になっていないプライベートまたは内部リポジトリが示されます。 これらのリポジトリに対して GitHub Advanced Security を有効にすると、既定のセットアップに追加することもできます。
   

表示されているすべてのリポジトリまたはそれらのサブセットを選び、それらすべてに対して code scanning の既定のセットアップを同時に有効または無効にできます。 詳細については、「Organization 内の複数のリポジトリに対する大規模な既定のセットアップの構成」の手順 5 を参照してください。

Organization 内の複数のリポジトリの既定セットアップを大規模に構成する

1. GitHub で、organization のメイン ページに移動します。1. 組織名の下の [ Security ] タブをクリックします。1. サイドバーの [Coverage] をクリックして、[Security coverage] ビューを表示します。

   

2. 検索バーを使い、名前またはセキュリティ機能の有効化状態に基づいて、[セキュリティ カバレッジ] ビューに表示されるリポジトリを絞り込むことができます。 たとえば、既定のセットアップの対象であり、現在既定のセットアップが有効になっていないリポジトリをフィルター処理するには、code-scanning-default-setup:eligible を検索します。

3. リポジトリの一覧で、code scanning を有効にする各リポジトリを選択します。

   • ページ上のすべてのリポジトリに対する code scanning の有効化を確認するには、[NUMBER 個がアクティブ] の隣にあるチェックボックスを選択してください。
   • 現在の検索に一致するすべてのリポジトリに対して code scanning を有効にするには、[NUMBER 個がアクティブ] の横にあるチェック ボックスをオンにしてから、[NUMBER 個のリポジトリをすべて選択] をクリックします。

4.        **[NUMBER 個選択済み]** の横にある **[セキュリティ設定]** をクリックします。
   

5. サイド パネルの [CodeQL の既定のセットアップ] セクションで、[変更なし] を選び、[有効] をクリックしてください。

6. 選択したリポジトリに対する code scanning の有効化を確認するには、[変更の適用 NUMBER] をクリックします。 または、code scanning 有効化のリポジトリをさらに選択または選択解除するには、[] をクリックして、変更を適用せずにパネルを閉じます。

Enterprise ポリシーのために code scanning を有効にできない場合でも、[セキュリティ カバレッジ] ビューで影響を受けるリポジトリを表示して、 [セキュリティ設定] ボタンからサイド パネルにアクセスできます。 ただし、選択したリポジトリに対して code scanning を有効にできないことを示すメッセージがサイド パネルに表示されます。 Enterprise ポリシーについて詳しくは、「エンタープライズのコード セキュリティと分析のためのポリシーの適用」をご覧ください。

組織内のすべてのリポジトリのマージ保護の構成

ルールセットを使用すると、次のいずれかの条件が満たされたときにプル要求がマージされないようにできます。

• 必要なツールは、ルール セットで定義されている重大度の code scanning アラートを検索します。
• 必要なツールの分析はまだ進行中です。
• リポジトリに必要なツールが構成されていません。

詳しくは、「コード スキャンのマージ保護を設定します」をご覧ください。 ルールセットの一般情報については、「AUTOTITLE」を参照してください。