# コード スキャンの既定セットアップの構成

code scanningをすばやく設定して脆弱なコードを自動的に修正します。

既定のセットアップで code scanning の使用を開始することをお勧めします。 既定のセットアップを最初に構成したら、 code scanning を評価してそれがどのように機能しているかを確認し、ニーズに合わせてカスタマイズできます。 詳細については、「[コード スキャンのセットアップの種類について](/ja/code-security/concepts/code-scanning/setup-types)」を参照してください。

## 前提条件

次の場合、リポジトリは code scanning の既定のセットアップの対象となります。

* GitHub Actions が有効になっています。
* 一般公開されているか、GitHub Code Security が有効になっている。

## リポジトリの既定のセットアップを構成する

> \[!NOTE]
> リポジトリ内のすべてのCodeQLサポートされている言語に対して分析が失敗した場合でも、既定のセットアップは有効になりますが、別のGitHub Actionsサポートされている言語がリポジトリに追加されるか、既定のセットアップが手動で再構成され、CodeQLサポートされている言語の分析が成功するまで、スキャンは実行されず、CodeQL分も使用されません。

1. GitHub で、リポジトリのメイン ページに移動します。

   > \[!NOTE]
   > フォークで既定のセットアップを構成する場合は、最初に GitHub Actionsを有効にする必要があります。
   > GitHub Actionsを有効にするには、リポジトリ名の下にある **\[<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-play" aria-label="play" role="img"><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z"></path></svg>アクション]** をクリックし、\[ワークフローを理解する] をクリック**して有効にします**。 これにより、フォーク上のすべての既存のワークフローが有効になることに注意してください。

2. リポジトリ名の下にある **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-gear" aria-label="gear" role="img"><path d="M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z"></path></svg> \[Settings]** をクリックします。 \[設定] タブが表示されない場合は、 **\[<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="More" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>]** ドロップダウン メニューを選び、 **\[設定]** をクリックします。

   ![タブを示すリポジトリ ヘッダーのスクリーンショット。 \[設定\] タブが濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/repo-actions-settings.png)

3. サイドバーの \[Security] セクションで、**\[<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-codescan" aria-label="codescan" role="img"><path d="M8.47 4.97a.75.75 0 0 0 0 1.06L9.94 7.5 8.47 8.97a.75.75 0 1 0 1.06 1.06l2-2a.75.75 0 0 0 0-1.06l-2-2a.75.75 0 0 0-1.06 0ZM6.53 6.03a.75.75 0 0 0-1.06-1.06l-2 2a.75.75 0 0 0 0 1.06l2 2a.75.75 0 1 0 1.06-1.06L5.06 7.5l1.47-1.47Z"></path><path d="M12.246 13.307a7.501 7.501 0 1 1 1.06-1.06l2.474 2.473a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215ZM1.5 7.5a6.002 6.002 0 0 0 3.608 5.504 6.002 6.002 0 0 0 6.486-1.117.748.748 0 0 1 .292-.293A6 6 0 1 0 1.5 7.5Z"></path></svg> Advanced Security]** をクリックします。

4. \[Code Security] の下の \[CodeQL analysis] の右側で、**\[Set up <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-triangle-down" aria-label="triangle-down" role="img"><path d="m4.427 7.427 3.396 3.396a.25.25 0 0 0 .354 0l3.396-3.396A.25.25 0 0 0 11.396 7H4.604a.25.25 0 0 0-.177.427Z"></path></svg>]** を選んでから、**\[Default]** をクリックします。

   ![\[Advanced Security\] 設定の \[Code scanning\] セクションのスクリーンショット。 \[既定のセットアップ\] ボタンがオレンジ色のアウトラインで強調されています。](/assets/images/help/security/default-code-scanning-setup-ghas.png)

   その後、既定のセットアップで自動的に作成されたCodeQL構成をまとめた "既定の構成code scanning" ダイアログが表示されます。

5. 必要に応じて、code scanningセットアップをカスタマイズするには、\[**編集] <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="pencil" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg>** クリックします。
   * 既定の設定で実行される分析の言語を追加または削除するには、\[言語] セクションでその言語を選択または選択解除します。
   * 使用する CodeQL クエリ スイートを指定するには、\[クエリ スイート] セクションで任意のクエリ スイートを選択します。

6. リポジトリの既定のセットアップの設定を確認し、\[**CodeQLを有効にする**] をクリックします。 これで、自動的に生成された新しい構成をテストするワークフローがトリガーされます。

   > \[!NOTE]
   > 詳細設定から既定のセットアップに切り替える場合は、既定のセットアップが既存の code scanning 構成をオーバーライドすることを通知する警告が表示されます。 この警告は、既定のセットアップで既存のワークフロー ファイルが無効になり、 CodeQL 分析 API のアップロードがブロックされることを意味します。

7. リポジトリ内のプロジェクトがプライベート パッケージ レジストリの依存関係に依存している場合は、 code scanning アクセス権を付与できます。 これにより、分析の結果と品質を向上させることができます。 「[セキュリティ機能にプライベート レジストリへのアクセスを許可する](/ja/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries)」を参照してください。

8. 必要に応じて、既定のセットアップに影響するその他の構成オプションを調整します。 「[code scanning のリポジトリのプロパティ](/ja/code-security/concepts/code-scanning/repository-properties)」を参照してください。

9. 必要に応じて、有効化後に既定のセットアップ構成を表示するには、<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Menu" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>を選択し、**<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-gear" aria-label="gear" role="img"><path d="M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z"></path></svg>構成CodeQL表示**] をクリックします。

> \[!NOTE]
> 既定のセットアップが有効となっているリポジトリで6か月間プッシュやプルリクエストがなかった場合、週次スケジュールが無効になりますので、 GitHub Actions 分を節約できます。

## セルフホステッドまたはより大きなランナー (larger runner)での既定のセットアップの実行

セルフホステッド ランナーまたは GitHub-ホステッド ランナーで、すべてのCodeQL対応言語に対してデフォルト設定を使用できます。

> \[!NOTE]
> Code scanning では、既定のセットアップが有効になっている場合に、割り当てられたランナーが表示されます。 既にデフォルトのセットアップを実行しているリポジトリにランナーが割り当てられている場合、ランナーの使用を開始するには、既定のセットアップを無効にして再度有効にする必要があります。 ランナーを追加してその使用を開始したい場合は、構成を手動で変更でき、そうすれば既定のセットアップを無効にして再度有効にする必要はありません。

### セルフホステッド ランナーへのラベルの割り当て

既定のセットアップにセルフホステッドランナーを割り当てるには、既定の`code-scanning`ラベルを使用するか、または必要に応じてカスタムラベルを付けて、個々のリポジトリで異なるランナーを利用できるようにします。 セルフホステッド ランナーにラベルを割り当てる方法については、「 [セルフホストランナーとのラベルの利用](/ja/actions/hosting-your-own-runners/managing-self-hosted-runners/using-labels-with-self-hosted-runners)」を参照してください。

セルフホステッド ランナーにカスタム ラベルを割り当てた後、リポジトリでこれらのランナーをデフォルトセットアップとして使用できます。

```
          security configurationsを使用して、code scanningのセルフホステッド ランナーにラベルを割り当てることもできます。 「[AUTOTITLE](/code-security/securing-your-organization/meeting-your-specific-security-needs-with-custom-security-configurations/creating-a-custom-security-configuration#creating-a-custom-security-configuration)」を参照してください。
```

### 割り当てる より大きなランナー (larger runner)

```
          より大きなランナーを割り当てるには、ランナーに`code-scanning`名前を付けます。 これにより、 `code-scanning` ラベルが より大きなランナーに自動的に追加されます。 組織は、より大きなランナー ラベルを持つ`code-scanning`を 1 つだけ持つだけで、そのランナーは、ランナーのグループにアクセスできる組織内のリポジトリからのすべてのcode scanningジョブを処理します。 「[AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/configuring-larger-runners-for-default-setup#provisioning-organization-level-larger-runners-for-default-setup)」を参照してください。
```

### ビルドサポートの確認

既定のセットアップでは、`none`にC/C++、 C#、 Java および Rust ビルド モードが使用され、他のコンパイル済み言語には`autobuild` ビルド モードが使用されます。 C/C++、C#、および Swift 分析に必要なコマンドをすべて実行できるようにセルフホスト ランナーを構成する必要があります。 JavaScript/TypeScript、Go、Ruby、Python、Kotlin コードの分析では、現時点では特別な構成は必要ありません。

## 次のステップ

構成が少なくとも 1 回正常に実行されたら、 code scanning アラートの調査と解決を開始できます。
code scanningアラートの詳細については、「[Code scanningアラートについて](/ja/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts)」および[「AUTOTITLE](/ja/code-security/code-scanning/managing-code-scanning-alerts/assessing-code-scanning-alerts-for-your-repository)」を参照してください。

```
          code scanningの既定のセットアップを構成したら、その動作の評価と、それをカスタマイズするために実行できる次の手順を確認できます。 詳細については、「[AUTOTITLE](/code-security/code-scanning/enabling-code-scanning/evaluating-default-setup-for-code-scanning)」を参照してください。
```

各スキャンのタイムスタンプやスキャンされたファイルの割合など、 code scanning 構成に関する詳細情報は、ツールの状態ページで確認できます。 詳細については、「[コード スキャンにツールの状態ページを使用する](/ja/code-security/code-scanning/managing-your-code-scanning-configuration/about-the-tool-status-page)」を参照してください。

既定のセットアップを構成すると、エラーが発生する可能性があります。 特定のエラーのトラブルシューティングについては、「[コード スキャン分析エラーのトラブルシューティング](/ja/code-security/code-scanning/troubleshooting-code-scanning)」を参照してください。